实时成交明细(Trade)订阅

API说明

该Websocket是获取成交明细的实时推送

请求频率

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

错误码说明

参考Websocket错误码说明

接口地址

请参考Websocket订阅地址

请求数量

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

请求(协议号:10000)

{
    "code": 10000,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "codes": "BTCUSDT"
    }
}
参数名
类型
必填
描述
示例值

code

Integer

请求的协议号

实时成交明细订阅协议号:10000

trace

String

可追溯ID(随机字符串)

423afec425004bd8a5e02e1ba5f9b2b0

data

JSON

订阅数据

<codes

String

订阅产品,多个用逗号分隔

BTCUSDT

应答(协议号:10001)

{
    "code": 10001,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "msg": "ok"
}
字段名
类型
必填
描述
示例值

code

Integer

响应协议号

订阅实时成交明细响应协议号:10001

trace

String

订阅传入参数可追溯id

423afec425004bd8a5e02e1ba5f9b2b0

msg

String

响应

ok

推送(协议号:10002)

{
    "code": 10002,
    "data": {
        "p": "103482.94",
        "s": "BTCUSDT",
        "t": 1747552358393,
        "td": 2,
        "v": "0.00096",
        "vw": "99.3436224"
    }
}
字段名
类型
必填
描述
示例值

code

Integer

推送协议号

实时成交明细推送协议号:10002

data

JSON

推送数据实体

<s

String

标的名称

BTCUSDT

<p

String

当前价格

103482.94

<t

Long

Trade时间戳

1747552358393

<td

Integer

K线类型,参考入参

交易方向:0为默认值,1为Buy,2为SELL

<v

String

成交量

0.00096

<vw

String

成交额

99.3436224

Last updated