Skip to main content
Query or subscribe to candlestick (OHLCV) data for a market and interval. Each candle contains open, high, low, close, and volume values for the specified interval. The server pushes updates every 0.5 seconds while a candle is active, reflecting the latest trade activity. Use this channel to power real-time charting or detect price movements as they occur.
Connect to wss://api.whitebit.com/ws — see WebSocket Overview for protocol details and keepalive requirements.

​
Rate limits

​
Query candlesticks (one-time)

Fetch historical candlestick data for a time range. Request Response Each record is a positional array in the same format as the subscription update.

​
Interval constraints

The interval must meet specific alignment rules to ensure candles align with natural time boundaries.
60 must be divisible by the interval.Valid: 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30Invalid: 7, 11, 13, 17
Interval must be divisible by 60, and 3600 must be divisible by the interval.Valid: 60 (1m), 120 (2m), 180 (3m), 300 (5m), 900 (15m), 1800 (30m)Invalid: 420 (7m), 660 (11m)
Interval must be divisible by 3600, and 86400 must be divisible by the interval.Valid: 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h)Invalid: 18000 (5h), 25200 (7h)
Valid: 86400 (1d), 172800 (2d), 259200 (3d), 604800 (1w), 2592000 (1mo)
The constraints above ensure candles align with natural time boundaries (minutes, hours, days) for consistent charting.

​
Subscribe to candlesticks

​
Update frequency

The server pushes updates every 0.5 seconds while the candle is active.

​
Error codes

​
Candle object