Get OHLCV candles
Returns OHLCV candlestick bars for a market and timeframe.
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 identifier, e.g. "BTC-USD".
"BTC-USD"
Candle interval.
1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w "1m"
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).
x >= 1000000000000001700000000000000
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).
x >= 1000000000000001699900000000000
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.
1 <= x <= 1500200
Response
Candle bars, oldest-first.