Market Data Streaming

Don’t have an API key? Start your free trial — WebSocket access is included from the Pro plan onwards. No credit card required.

Install WebSocket client

We recommend using websocat for testing WebSocket connections.

brew install websocat

wget -qO websocat https://github.com/vi/websocat/releases/latest/download/websocat.x86_64-unknown-linux-musl
chmod a+x websocat
sudo mv websocat /usr/local/bin/

Pre-built binaries for Windows, OS X and Android are available on the releases page: https://github.com/vi/websocat/releases

Connect

Connect to the WebSocket API using your API key. Replace <YOUR_API_KEY> with your actual key. You can connect to any of the supported channels, such as currencies/quotes.

websocat -H='api-key: <YOUR-API-KEY>' wss://api.tradewatch.io/currencies/quotes

Upon connecting, you will receive a status message indicating the current subscriptions (initially empty):

{"event": "status", "symbols": []}

Once connected, paste the following JSON message to subscribe to currency pairs:

{
  "action": "subscribe",
  "symbols": [
    "EURUSD",
    "GBPUSD"
  ]
}

Receive Data

You will receive a status message confirming your subscription, followed by live quote updates.

{"event": "status", "symbols": ["EURUSD", "GBPUSD"]}
{"symbol": "EURUSD", "timestamp": "1767389239253", "ask": "1.17174", "bid": "1.17164", "mid": "1.17169"}
{"symbol": "GBPUSD", "timestamp": "1767389242294", "ask": "1.34556", "bid": "1.34543", "mid": "1.3455"}

Unsubscribe

To stop receiving updates for specific symbols, send an unsubscribe message:

{
  "action": "unsubscribe",
  "symbols": [
    "EURUSD"
  ]
}

You will receive a confirmation message with the list of remaining subscribed symbols:

{"event": "status", "symbols": ["GBPUSD"]}

What’s Next

Now that you’re connected, check out these resources to build your integration:

API Reference

Explore the full WebSocket API reference documentation.

HTTP API Quickstart

Need on-demand data? Get started with the REST API.

If the connection closes unexpectedly or a subscription does not produce data, see Errors & Troubleshooting.

Start streaming live market data →

Get your API key and connect to real-time Forex, Crypto, Stocks, and Indices feeds in minutes.

Platform

REST API reference

WebSocket API reference

What’s Next

API Reference

HTTP API Quickstart

Start streaming live market data →

​What’s Next

API Reference

HTTP API Quickstart

Start streaming live market data →

What’s Next