K线数据

接口描述

获取K线数据。K线走势图通过参数限制最多获取1500根。

HTTP请求

GET /fapi/v1/klines

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
interval	ENUM	YES	K线间隔
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间
limit	INT	NO	默认 500; 最大 1500

原生支持的间隔为 1m、5m、15m、1h、4h、1d、1w、1M。其余 Binance 间隔也会被接受，但会被静默映射到最接近的受支持间隔（3m → 5m、30m → 15m、2h → 1h、6h/8h/12h → 4h、3d → 1d）——返回的K线是映射后的粒度，而非请求的粒度。

响应示例

[
  [
    1499040000000,      // 开盘时间
    "0.01634790",       // 开盘价
    "0.80000000",       // 最高价
    "0.01575800",       // 最低价
    "0.01577100",       // 收盘价
    "148976.11427815",  // 成交量
    1499644799999,      // 收盘时间
    "2434.19055334",    // 成交额
    308,                // 成交笔数
    "0",                // 主买成交量(当前恒为 "0")
    "0",                // 主买成交额(当前恒为 "0")
    "0"                 // 忽略
  ]
]

代码示例

cURL

curl -s "https://api-sepolia.ztdx.io/fapi/v1/klines?symbol=BTCUSDT&interval=1h&limit=2"

Python

import requests

base_url = "https://api.ztdx.io"
params = {"symbol": "BTCUSDT", "interval": "1h", "limit": 5}
response = requests.get(f"{base_url}/fapi/v1/klines", params=params)
for kline in response.json():
    open_time, o, h, l, c, vol = kline[0], kline[1], kline[2], kline[3], kline[4], kline[5]
    print(f"Time={open_time} O={o} H={h} L={l} C={c} Vol={vol}")