GET
cURL
This operation serves spot markets only. Send a spot symbol in the BASE/QUOTE format. Read Which symbol format.

Path Parameters

symbol
string
required
Minimum string length: 1

Query Parameters

timeframe
enum<string>
default:1m

Unified timeframe. Defaults to 1m.

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

Optional inclusive Unix timestamp in integer milliseconds.

Required range: x >= 0
limit
integer
default:100

Maximum number of candles, from 1 to 100. Defaults to 100.

Required range: x <= 100
series
enum<string>

Exchange-specific source series. Defaults to index. series=mark is declared but not served yet: HTTP 400 operation_not_available (NotSupported), retryable=false.

Available options:
trade,
index,
mark

Response

Success

[0]
integer

Start of the candle bucket as a Unix timestamp in milliseconds.

Required range: x >= 0
[1]
number

First price in the bucket in quote units per base unit, encoded as a JSON number.

[2]
number

Highest price in the bucket in quote units per base unit, encoded as a JSON number.

[3]
number

Lowest price in the bucket in quote units per base unit, encoded as a JSON number.

[4]
number

Last price in the bucket in quote units per base unit, encoded as a JSON number.

[5]
number

The v1 candle volume converted to a JSON number without unit scaling. For trade candles this is traded quote notional in quote-asset atoms, not base-asset quantity; divide by 10 raised to the quote asset's decimals for quote units. Index candles carry provider reference volume in its source units when available, or zero for live index observations.

Required range: x >= 0