K线数据
查询 K线数据
获取指定交易对的 K线（蜡烛图）历史数据。
HTTP 请求
GET
/api/perp-market-api/kline/history请求频率限制:
- 建议不超过 3 次/秒
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对符号，如 ETH-PERP |
| interval | string | 是 | K线类型：1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, D, W, M |
| startTime | integer | 是 | 开始时间（秒级时间戳），例如：1553320321 |
| endTime | integer | 是 | 结束时间（秒级时间戳），例如：1553339535 |
K线类型说明
| 参数值 | 对应周期 |
|---|---|
| 1m | 1分钟 |
| 3m | 3分钟 |
| 5m | 5分钟 |
| 15m | 15分钟 |
| 30m | 30分钟 |
| 1h | 1小时 |
| 2h | 2小时 |
| 4h | 4小时 |
| 6h | 6小时 |
| 12h | 12小时 |
| D | 1天 |
| W | 1周 |
| M | 1月 |
响应字段说明
返回 K线数据数组，每个元素为： - [0]: 开盘时间（秒级时间戳） - [1]: 开盘价 - [2]: 最高价 - [3]: 最低价 - [4]: 收盘价 - [5]: 成交量
响应示例
{
"code": 200,
"message": "success",
"data": [
[1553320321, "2500.0", "2510.0", "2495.0", "2505.0", "1000.5"],
[1553320381, "2505.0", "2515.0", "2500.0", "2510.0", "1200.3"],
[1553320441, "2510.0", "2520.0", "2505.0", "2515.0", "1500.8"]
]
}
注意
- 时间戳为秒级，不是毫秒级
- 如果 startTime <= 0 或 endTime <= 0 或 startTime > endTime，将返回空数组