> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whitebit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Balance Spot

> Subscribe to real-time spot balance updates for a WhiteBIT account via WebSocket.

Get and subscribe to [spot balance](/glossary#balance-spotbalance-trade) 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.

<Note>Connect to `wss://api.whitebit.com/ws` — see [WebSocket Overview](/websocket/overview) for protocol details and keepalive requirements.</Note>

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

<Tip>
  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](/guides/websocket-quickstart#state-recovery-after-reconnect) for the full pattern.
</Tip>

## Update frequency

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

## Error codes

## Balance object

* [Trading balance](/api-reference/spot-trading/trading-balance) — spot balance snapshot via REST.
