Kline/Candlestick Data

Type: NONE · Weight: 5

Status: Implemented.

GET /api/v3/klines

OHLCV bars aggregated from fills. Oldest first, Binance 12-element array form.

Request

GET /api/v3/klines?symbol=CBTC-USDCB&interval=1m&limit=200

Query params

Name	Type	Required	Default	Notes
`symbol`	string	yes	—
`interval`	string	yes	—	One of `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1d`. Any other value returns `[]` with HTTP 200 (not an error).
`limit`	integer	no	`500`	`0` → default; clamped to `1000`.

Response — 200 (values illustrative)

[
  [
    1756599960000,        // 0  open time (ms)
    "59990.00",           // 1  open
    "60020.00",           // 2  high
    "59980.00",           // 3  low
    "60001.50",           // 4  close
    "1.2345",             // 5  volume (base asset)
    1756600019999,        // 6  close time = open + interval − 1 ms
    "74061.123456",       // 7  quote asset volume (rounded to 18 dp)
    17,                   // 8  number of trades
    "0",                  // 9  taker buy base volume — always "0"
    "0",                  // 10 taker buy quote volume — always "0"
    "0"                   // 11 unused — always "0"
  ]
]

Semantics

The response covers the latest limit intervals ending at the interval of the symbol's most recent trade. Intervals with no trades are omitted, so you may receive fewer than limit bars — a quiet market yields fewer bars, not older ones. There are no startTime / endTime parameters.
Bars are built from taker-side fills plus, for the earliest history of a market, a seeded historical series; the two never overlap.
Positions 9–11 are always "0": the aggregate is not split by aggressor side.

Errors

HTTP	code	When
`400`	—	`symbol` or `interval` missing (framework rejection).
`429`	`-1003`	Per-IP public weight exhausted.

Differences from Binance

Supported intervals are the seven listed above; unsupported intervals return an empty array rather than -1120.
No startTime / endTime / timeZone; no synthetic flat bars for empty intervals.
Live 1-minute bars are also available on the @kline_1m stream.