K线数据

获取合约交易对的K线历史数据。

接口信息

• 方法: GET
• 路径: /api/v1/futures/open-api/kline

请求参数

参数	类型	必填	说明
symbol	string	是	合约交易对，如 BTCUSDT
interval	string	否	K线周期，默认1m
startTime	int64	否	起始时间戳（毫秒）
endTime	int64	否	结束时间戳（毫秒）
limit	int	否	返回数量，默认500，最大1000

支持的K线周期：
1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo

请求示例

GET /api/v1/futures/open-api/kline?symbol=BTCUSDT&interval=1m&limit=100

响应字段

字段	类型	说明
code	int	状态码，200 表示成功
msg	string	返回消息
data	array	K线数据列表

K线数据对象：

• t: 开盘时间戳（毫秒）
• o: 开盘价
• h: 最高价
• l: 最低价
• c: 收盘价
• v: 成交量
• f: true 表示无交易时填充的横盘K线

响应示例

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "t": 1737446400000,
      "o": "68637.5",
      "h": "68637.5",
      "l": "68637.5",
      "c": "68637.5",
      "v": "0",
      "f": true
    },
    {
      "t": 1737446460000,
      "o": "68580.0",
      "h": "68650.2",
      "l": "68550.8",
      "c": "68620.5",
      "v": "12.5"
    }
  ]
}