API Reference

订阅实时K线

获取标的实时K线推送

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

订阅请求(JSON)

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

字段说明

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

订阅结果

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

数据推送

{
    "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"
}
字段名类型必填描述示例值
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