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.
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.

​
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