API Reference

订阅实时盘口数据

获取标的实时盘口 (Depth) 推送

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

订阅请求(JSON)

{
    "code": 10003,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "codes": "BTCUSDT"
    }
}

字段说明

参数名类型必填描述示例值
codeInteger请求的协议号盘口订阅协议号:10003
traceString可追溯ID(随机字符串)423afec425004bd8a5e02e1ba5f9b2b0
dataJsonObject订阅数据
<codesString订阅产品,多个用逗号分隔BTCUSDT

订阅结果

{
    "code": 10004,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "msg": "ok"
}

字段说明

字段名类型必填描述示例值
codeInteger响应协议号盘口响应协议号:10004
traceString订阅传入参数可追溯id423afec425004bd8a5e02e1ba5f9b2b0
msgString响应ok

数据推送

{
    "code": 10005,
    "data": {
        "a": [
            [
                "103594.12000000",
                "103594.13000000",
                "103594.38000000",
                "103594.39000000",
                "103594.40000000"
            ],
            [
                "3.50039000",
                "0.00016000",
                "0.00006000",
                "0.00006000",
                "0.00006000"
            ]
        ],
        "b": [
            [
                "103594.11000000",
                "103594.10000000",
                "103594.09000000",
                "103594.08000000",
                "103594.07000000"
            ],
            [
                "3.55117000",
                "0.05942000",
                "0.00006000",
                "0.00006000",
                "0.00006000"
            ]
        ],
        "s": "BTCUSDT",
        "t": 1747553102161
    }
}

字段说明

字段名

类型

必填

描述

示例值

code

Integer

盘口推送协议号

10005

data

JSON

盘口推送实体

<s

String

标的名称

BTCUSDT

<t

Long

Depth时间戳

1747552358393

<a

JsonArray

卖盘,两个数组,分别是价格数组和成交量数组

<a[0]

JsonArray

卖盘价格集合(通过下标跟卖盘成交量对应)

["103594.12000000","103594.13000000" ,"103594.38000000","103594.39000000" ,"103594.40000000" ]

<a[1]

JsonArray

卖盘成交量集合(通过下标跟卖盘价格对应)

["3.50039000","0.00016000" ,"0.00006000","0.00006000" ,"0.00006000" ]

<b

JsonArray

买盘,两个数组,分别是价格数组和成交量数组

<b[0]

JsonArray

买盘价格集合(通过下标跟卖盘成交量对应)

["103594.11000000","103594.10000000" ,"103594.09000000","103594.08000000" ,"103594.07000000" ]

<b[1]

JsonArray

买盘成交量集合(通过下标跟卖盘价格对应)

["3.55117000","0.05942000" ,"0.00006000","0.00006000" ,"0.00006000" ]