Skip to main content
Get and subscribe to spot balance updates. The server sends incremental updates — only assets whose balance changed are included in each message. To retrieve the current state at any time without maintaining a subscription, use the one-time query operation. The server pushes updates every 1 second when a balance changes.
Connect to wss://api.whitebit.com/ws — see WebSocket Overview for protocol details and keepalive requirements.

​
Rate limits

​
Query spot balance (one-time)

Fetch current spot balances for specific assets without subscribing. params: [asset, asset, ...]. Pass asset tickers to query specific balances. Pass an empty array to query all assets. Request Response

​
Subscribe to spot balance

Updates include only assets whose balance changed. To hydrate full state on startup or after reconnection, send a balanceSpot_request query before subscribing. See Reconnection and state recovery for the full pattern.

​
Update frequency

The server pushes updates every 1 second when the balance changes.

​
Error codes

​
Balance object