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
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| symbols | query | string | Yes | Trading pair list, comma-separated, max 20 |
| interval | query | string | Yes | Time interval (see below) |
| limit | query | integer | No | Latest 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:
| Index | Description |
|---|---|
| 0 | Open timestamp (milliseconds) |
| 1 | Close timestamp (milliseconds) |
| 2 | Open price |
| 3 | High price |
| 4 | Low price |
| 5 | Close price |
| 6 | Volume |
| 7 | Turnover |
| 8 | Number of trades |
| 9 | Taker buy volume |
| 10 | Taker buy turnover |
| 11 | Whether 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
]
]
}