Skip to main content
GET
curl
The response body shown here is a static example, not live data. After you click Send, your live result appears in a separate panel headed 200 OK. The panel under the status-code tabs is a fixed sample from the spec — its field values (fees, prices, sizes, IDs, timestamps) are placeholders. Use Send, or call the endpoint, for current values.
Returns OHLCV candlestick bars for a market and timeframe. Results include closed bars (gap-filled with O=H=L=C=prev_close, vol=0 for empty buckets) plus the current open bar. Bars are returned oldest-first; the last entry is the in-progress bar with isFinal: false. Bar prices (open/high/low/close) are derived from the market’s oracle price feed, not from executed trades. volume, takerBuyVolume, the notional volumes, and tradeCount remain trade-derived statistics for the bucket. Buckets in which the oracle price did not move are flat at the previous oracle close.

Query Parameters

market
string
required

Market identifier, e.g. "BTC-USD".

Example:

"BTC-USD"

timeframe
enum<string>
required

Candle interval.

Available options:
1m,
3m,
5m,
15m,
30m,
1h,
2h,
4h,
8h,
12h,
1d,
3d,
1w
Example:

"1m"

to
integer<int64>
required

Upper bound of the requested window, expressed as a Unix timestamp in microseconds. The returned bars cover the half-open interval [from, to) or the countback bars ending at this point. Seconds- or milliseconds-scale values are rejected (the server requires at least 1e14, which any microseconds timestamp after ~1973 satisfies).

Required range: x >= 100000000000000
Example:

1700000000000000

from
integer<int64>

Lower bound of the requested window in Unix microseconds. Mutually exclusive with countback; if both are omitted the most recent bars up to to are returned (up to the server maximum). Seconds- or milliseconds-scale values are rejected (the server requires at least 1e14).

Required range: x >= 100000000000000
Example:

1699900000000000

countback
integer

Number of closed bars to return, counting backwards from to. Mutually exclusive with from; if both are omitted the server returns the most recent bars ending at to. Values above 1500 are clamped to the server maximum.

Required range: 1 <= x <= 1500
Example:

200

Response

Candle bars, oldest-first.

candles
object[]
required