实时买卖盘口（Depth）订阅

API说明

该WebSocket是获取买卖盘口的实时推送

请求频率

同一个WebSocket连接，所有的请求（订阅、取消订阅、心跳）限制为1分钟60次，如果超出请求频率限制将会自动断连。如果断连次数过多被系统判定为恶意请求将会封禁API Key。请在使用过程中注意调用逻辑。

错误码说明

参考Websocket错误码说明

接口地址

请参考Websocket订阅地址

请求数量

不同的套餐对应的单Websocket订阅的产品数量不一样，具体参考Websocket限制说明

请求（协议号：10003）

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

参数名	类型	必填	描述	示例值
code	Integer	是	请求的协议号	盘口订阅协议号：10003
trace	String	是	可追溯ID（随机字符串）	423afec425004bd8a5e02e1ba5f9b2b0
data	JsonObject	是	订阅数据
<codes	String	是	订阅产品，多个用逗号分隔（一个websocket连接支持同时订阅最多600个产品）	BTCUSDT

应答（协议号：10004）

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

字段名	类型	必填	描述	示例值
code	Integer	是	响应协议号	盘口响应协议号：10004
trace	String	是	订阅传入参数可追溯id	423afec425004bd8a5e02e1ba5f9b2b0
msg	String	是	响应	ok

推送（协议号：10005）

{
    "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" ]