Get OHLCV candles
Market Data
Get OHLCV candles
Historical open/high/low/close/volume candles for a market.
GET
Get OHLCV candles
Returns historical OHLCV candles for a market at a chosen interval.
Notes
- Query window is capped at 5000 buckets per request, not by elapsed time — so the ceiling scales with
interval. A 30-day1dwindow is 30 buckets and fine; a 30-day1mwindow is 43,200 buckets and returns400. Walkstart_timestampforward to page through longer windows. limitdefaults to 500, below the bucket cap, and this endpoint returns no pagination cursor. A window spanning more buckets thanlimitis truncated with no next-page signal, so raiselimit(max 5000) when requesting a wide window.- Last bucket is mutable. If
end_timestampis “now”, the most recent candle keeps updating until its interval closes. Clients polling live data should refresh or discard the last bucket. - Empty buckets are omitted. Zero-volume intervals are not padded; interpolate client-side if you need a dense series.
volumeis base-asset volume, not USD notional.
Coming soon
volume_quote — quote-denominated (USD) volume — is not yet returned. For now, approximate it as volume × mid. To request prioritization, reach out to your account manager.Authorizations
Path Parameters
Canonical market slug, {venue}:{instrument_type}:{pair}.
Query Parameters
Candle interval.
Available options:
1m, 5m, 15m, 1h, 4h, 1d Start of the window (ISO 8601; naive datetimes treated as UTC).
End of the window (ISO 8601).
Maximum candles to return (1–5000).
Required range:
1 <= x <= 5000Response
200 - application/json
Candles, ascending by time.