Skip to main content

Batch K-lines

Query the latest K-line data for multiple trading pairs at once. All trading pairs use the same interval and limit parameter.

API Information

  • Method: GET
  • Path: /fapi/v1/klines/batch

Request Parameters

ParameterLocationTypeRequiredDescription
symbolsquerystringYesTrading pair list, comma-separated, max 20
intervalquerystringYesTime interval (see below)
limitqueryintegerNoLatest N records returned for each trading pair, default 500, max 1500

interval Enum

1s 1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M

Request Example

GET /fapi/v1/klines/batch?symbols=BTC_USDT,ETH_USDT&interval=1m&limit=100

Response Fields

Returns a JSON object where the key is the trading pair name and the value is the K-line array for that trading pair.

Each K-line is an array of 12 elements:

IndexDescription
0Open timestamp (milliseconds)
1Close timestamp (milliseconds)
2Open price
3High price
4Low price
5Close price
6Volume
7Turnover
8Number of trades
9Taker buy volume
10Taker buy turnover
11Whether the candle is closed

K-lines for each trading pair are sorted in descending time order (latest first), including the current unclosed K-line.

Response Example

{
"BTC_USDT": [
[
1704153600000,
1704153659999,
"42150.50",
"42180.00",
"42140.00",
"42165.30",
"125.45",
"5289456.75",
2580,
"68.20",
"2876543.21",
false
]
],
"ETH_USDT": [
[
1704153600000,
1704153659999,
"2420.50",
"2425.00",
"2418.00",
"2422.30",
"1250.45",
"3028456.75",
1580,
"680.20",
"1646543.21",
false
]
]
}