Skip to main content
Query or subscribe to collateral (margin) balance updates. The response includes total balance, borrowed amount, and available amounts with and without borrowing. Updates are pushed every 1.5 seconds when the margin balance changes. Use the query operation for a one-time snapshot; use subscribe for continuous updates.
Balance available for margin trade equals balance × leverage and depends on orderbook liquidity and open positions. When a position opens, the balance does not change, but the amount available for trading decreases.
Connect to wss://api.whitebit.com/ws — see WebSocket Overview for protocol details and keepalive requirements.

Rate limits

Query margin balance (one-time)

Fetch current margin 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 margin balance

Update frequency

The server pushes updates every 1.5 seconds when the margin balance changes.

Error codes

Balance object