跳到主要内容

批量 K 线

一次性查询多个交易对的最新 K 线数据，所有交易对使用相同的时间周期和 limit 参数。

接口信息​

  • 方法: GET
  • 路径: /fapi/v1/klines/batch

请求参数​

参数位置类型必填说明
symbolsquerystring是交易对列表，逗号分隔，最多 20 个
intervalquerystring是时间周期（见下）
limitqueryinteger否每个交易对返回最新 N 条，默认 500，最大 1500

interval 枚举​

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

请求示例​

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

响应字段​

返回 JSON 对象，key 为交易对名称，value 为该交易对的 K 线数组。

每条 K 线为 12 个元素的数组：

索引说明
0开盘时间戳（毫秒）
1收盘时间戳（毫秒）
2开盘价
3最高价
4最低价
5收盘价
6成交量
7成交额
8成交笔数
9主动买入量
10主动买入额
11是否已收盘

每个交易对的 K 线按时间降序排列（最新的在前），包含未收盘的当前 K 线。

响应示例​

{
  "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
    ]
  ]
}