Kline/Candlestick Data

Type: NONE

Weight: 5 (varies with limit)

GET /fapi/v1/klines

Kline/candlestick bars for a symbol. Public endpoint: no X-MBX-APIKEY, timestamp or signature required.

Request

GET /fapi/v1/klines?symbol=BTCUSDT&interval=1m&limit=500

Query params

Name	Type	Required	Default	Notes
`symbol`	string	yes	—
`interval`	string	yes	—	`1m` `3m` `5m` `15m` `30m` `1h` `2h` `4h` `6h` `8h` `12h` `1d` `3d` `1w` `1M`
`startTime`	long	no	—	ms
`endTime`	long	no	—	ms
`limit`	integer	no	`500`	max `1500`

Response — 200

[
  [
    1714261234000,   // open time (ms)
    "60000.50",      // open
    "60100.00",      // high
    "59950.00",      // low
    "60050.50",      // close
    "12.345",        // volume (base asset)
    1714261293999,   // close time
    "740921.05",     // quote asset volume
    100,             // number of trades
    "0",             // taker buy base volume  (not tracked — always "0")
    "0",             // taker buy quote volume (not tracked — always "0")
    "0"              // ignore
  ]
]

Sparky differences

Only 1m / 5m / 15m / 1h / 4h / 1d / 1w / 1M are stored natively. Other intervals are served from the nearest coarser bucket: 3m → 5m, 30m → 15m, 2h → 1h, 6h/8h/12h → 4h, 3d → 1d. openTime / closeTime are computed from the interval you asked for, so several requested candles may share one underlying bucket's OHLCV.
Taker-buy volumes are always "0". For buy/sell pressure use /futures/data/takerlongshortRatio.

Errors

HTTP	code	msg
`400`	`-1120`	Invalid interval.
`400`	`-1121`	Invalid symbol.