Market Streams

Browse the available public WebSocket channels below. For connection details and message format, see the WebSocket Overview. For rate limits, see WebSocket Rate Limits.

Managing subscriptions

Each subscribe request defines the complete set of markets for that channel on the connection. A new subscribe replaces the channel’s previous subscription rather than adding to it — the server does not merge incremental subscribes. The Order Book Depth channel is the exception: the multiple subscription flag set to true adds the market to the existing subscriptions of the channel.

• Add a market — resubscribe with the full target list, including the markets already being received.
• Remove a market — resubscribe with the reduced list. The Order Book Depth and Book Ticker channels also accept a market name in the unsubscribe params and remove the named market only. For the other channels, sending the channel’s unsubscribe method with an empty params array clears the whole subscription.
• Manage markets independently — on channels other than Order Book Depth, a connection holds one subscription per channel. To add or drop markets without touching the others, place those markets on separate connections. Weigh the connection limit and added latency described in WebSocket Rate Limits.

On channels that send an initial snapshot on subscribe — such as Market Trades when subscribed to specific markets — resubscribing to add or remove a market backfills the markets carried into the new list. A Market Trades request accepts up to 100 markets, and each market replays up to 100 latest trades. Deduplicate by record id to handle the replayed snapshot.