K 线数据

类型：NONE · 权重：5

状态：已实现。

GET /api/v3/klines

由成交聚合而成的 OHLCV 柱。最旧在前，Binance 的 12 元素数组格式。

请求

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

Query 参数

字段	类型	必填	默认值	说明
symbol	string	是	—
interval	string	是	—	1m、5m、15m、30m、1h、4h、1d 之一。其他任何值返回 [] 且 HTTP 200（不是错误）。
limit	integer	否	500	0 → 默认值；钳制到 1000。

响应 — 200（值仅为示意）

[
  [
    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"
  ]
]

语义

• 响应覆盖的是以该交易对最近一笔成交所在周期为终点、最近 limit 个周期。没有成交的周期会被省略，因此你收到的柱数可能少于 limit——冷清的市场得到的是更少的柱，而不是更早的柱。没有 startTime / endTime 参数。
• 柱由 taker 侧成交构建；对于市场最早期的历史，另有一段预置的历史序列，两者绝不重叠。
• 第 9–11 位恒为 "0"：聚合数据不按主动方拆分。

错误

HTTP	code	触发场景
400	—	缺少 symbol 或 interval（框架拒绝）。
429	-1003	按 IP 的公开权重耗尽。

与 Binance 的差异

• 支持的周期仅为上面列出的七种；不支持的周期返回空数组而不是 -1120。
• 没有 startTime / endTime / timeZone；空周期不会合成平坦柱。
• 实时 1 分钟柱也可通过 @kline_1m 流 获取。