获取K线数据
/sapi/v1/market/history/kline
请求类型: GET
是否验签: 否
接口权限: 读取
限频: 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录： （1） restful接口：同一个IP, 所有业务（交割合约、币本位永续合约和U本位合约）总共1秒最多800个请求
接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。
请求地址
线上环境（aws客户首选）
请求参数
contract_code
string
true
合约代码 或 合约标识
永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
period
string
true
K线类型
1min, 5min, 15min, 30min, 60min,4hour,1day,1week,1mon
size
int
false
获取数量，默认150
[1,2000]
from
long
false
开始时间戳 10位 单位S
to
long
false
结束时间戳 10位 单位S
备注: 1、size与from&to 必填其一，若全不填则返回空数据。 2、如果填写from，也要填写to。最多可获取连续两年的数据。 3、如果size、from、to 均填写，会忽略from、to参数。
响应参数
ch
string
true
数据所属的 channel，格式： market.period
<data>
object array
true
id
long
true
K线ID,也就是K线时间戳，K线起始时间
vol
decimal
true
成交量(张)。 值是买卖双边之和
count
decimal
true
成交笔数。 值是买卖双边之和
open
decimal
true
开盘价
close
decimal
true
收盘价,当K线为最晚的一根时，是最新成交价
low
decimal
true
最低价
high
decimal
true
最高价
amount
decimal
true
成交量(币), 即 (成交量(张) * 单张合约面值)。 值是买卖双边之和
trade_turnover
decimal
true
成交额，即 sum（每一笔成交张数 * 合约面值 * 成交价格）。 值是买卖双边之和
</data>
false
status
string
true
请求处理结果
ok , "error"
ts
long
true
响应生成时间点，单位：毫秒
请求示例
响应示例
最后更新于