Skip to main content
Query or subscribe to candlestick (OHLCV) data for a market and interval. Update interval: 0.5 seconds.

Query candlesticks (one-time)

Fetch historical candlestick data for a time range. params: [market, start_time, end_time, interval]. Times are Unix timestamps. 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

Candle object