Skip to main content
Query or subscribe to real-time trade execution (deal) notifications. Each deal represents a matched trade with price, amount, fee, and counterparty details. Update interval: real-time.
Connect to wss://api.whitebit.com/ws — see WebSocket Overview for protocol details and keepalive requirements.

​
Rate limits

​
Query deals (one-time)

Fetch historical deal records for a market without subscribing. Request Response

​
Subscribe to deals

Trade events during a disconnection are not replayed. After reconnecting, use deals_request to query recent deals, or call the REST Executed Order History endpoint to backfill fills missed during the disconnection. See Reconnection and state recovery.

​
Update frequency

Updates are pushed in real time on each trade execution for the account.

​
Error codes

​
Deal object

​
Used in these guides

  • Copy Trading — mirror a lead trader’s orders into followers’ own accounts via OAuth-issued keys.
  • Market Maker integration — bulk quoting, RPI, kill-switch, and market-data streams.