跳到主要内容
版本:V3(BETA)

成交频道

功能说明
推送订阅交易对的最新成交(trade)。每条推送可能包含一条或多条新成交。

订阅请求参数

字段类型必填说明
methodStringSUBSCRIBE 订阅,UNSUBSCRIBE 退订。
paramsArray<String><symbol>@trade,例如 BTCUSDT@trade
idNumber客户端自定义标识,在回执中原样返回。

订阅示例

{
"method": "SUBSCRIBE",
"params": [
"BTCUSDT@trade"
],
"id": 3
}

回执示例

字段类型说明
resultBooleantrue 表示操作成功,false 表示失败。
idNumber返回请求中的 id
msgStringresultfalse 时返回错误信息。

回执示例

{
"result": true,
"id": 3
}

推送数据 (trade)

字段类型说明
eString事件类型,trade
ENumber事件时间(毫秒)。
sString交易对。
dArray<Object>成交列表。
> TNumber成交时间(毫秒)。
> tNumber成交 ID。
> pString成交价格。
> qString成交量。
> vString成交额(价格 × 成交量)。
> mBooleantrue 表示该笔成交为主动卖出(maker 为买方)。

推送示例

{
"e": "trade",
"E": 1773295739001,
"s": "BTCUSDT",
"d": [
{
"T": 1773295739001,
"t": 7423916138,
"p": "69382.20",
"q": "0.014",
"v": "971.3508",
"m": false
}
]
}

当发现成交 ID (t) 出现乱序或缺失时,请重连并重新订阅以保证数据连续性。