API Reference

订阅实时K线

获取标的实时K线推送

支持实时推送K线数据,不同的套餐支持不同的连接数以及请求产品上限

订阅请求(JSON)

{
    "code": 10006,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "arr": [
            {
                "type": 1,
                "codes": "BTCUSDT"
            }
        ]
    }
}

字段说明

参数名类型必填描述示例值
codeInteger请求的协议号K线请求协议号:10006
traceString可追溯ID(随机字符串)423afec425004bd8a5e02e1ba5f9b2b0
dataJsonObject订阅数据
<arrJsonArray多个订阅实体类
<<typeIntegerkline类型:1:一分钟,2:五分钟,3:十五分钟,4:三十分钟,5:一小时,6:二小时,7:四小时,8:一日,9:一周,10:一月,11:一季,12:一年1
<<codesString订阅产品,多个用逗号分隔BTCUSDT

订阅结果

{
    "code": 10007,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "msg": "ok"
}
字段名类型必填描述示例值
codeInteger响应协议号订阅成功响应协议号:10007
traceString订阅传入参数可追溯id423afec425004bd8a5e02e1ba5f9b2b0
msgString响应ok

数据推送

{
    "code": 10008,
    "data": {
        "c": "103478.27",
        "h": "103478.27",
        "l": "103478.26",
        "o": "103478.26",
        "pca": "0.00",
        "pfr": "0.00%",
        "s": "BTCUSDT",
        "t": 1747550648097,
        "ty": 1,
        "v": "0.34716",
        "vw": "35923.5149678"
    }
}
字段名类型必填描述示例值
codeIntegerKline线推送协议号10008
dataJSONKline线推送实体
<sString标的名称BTCUSDT
<cString收盘价103478.27
<hString最高价103478.27
<lString最低价103478.26
<oString开盘价103478.26
<pcaString涨跌额0.00
<pfrString涨跌幅0.00%
<tLongK线时间(秒时间戳)1747550648097
<tyIntegerK线类型,参考入参1
<vString成交量0.34716
<vwString成交额35923.5149678