Skip to main content
Subscribe to real-time trade execution updates for one or more markets. Each message delivers a batch of trade objects containing price, quantity, trade direction, and execution timestamp. The channel supports both targeted subscriptions for specific markets and a wildcard subscription for all available markets.
Connect to wss://api.whitebit.com/ws — see WebSocket Overview for protocol details and keepalive requirements.

​
Rate limits

​
Query recent trades (one-time)

Fetch recent trades for a market without subscribing. Request Response

​
Subscribe to trades

For each WebSocket connection, subscribe to either specific markets or all markets. Every new subscription replaces the existing one.
To add or remove markets on an active subscription, resubscribe with the full target list — see Managing subscriptions.
Initial snapshot. On subscribe, the server first sends a snapshot — one trades_update carrying up to 100 of the latest trades per market, ordered newest first — then streams new trades in real time. Resubscribing replays this snapshot, so deduplicate by trade id.
Subscribe to all markets:

​
Update frequency

Updates are pushed in real time on each trade execution.

​
Unsubscribe

Send trades_unsubscribe with an empty params array to stop receiving trade updates on the connection. There is no per-market unsubscribe — to keep a subset of markets, resubscribe with the markets you want to retain. See Managing subscriptions.

​
Error codes

​
RPI orders in trade updates

Trade updates can include executions originating from RPI orders:
  • rpi: true — the trade involved a Retail Price Improvement (RPI) order
  • rpi: false or absent — regular trade
Public market data feeds do not expose RPI orders as visible liquidity in depth or bookTicker. RPI orders remain visible only in private active orders and in the exchange UI order book (web and mobile).

​
Trade object