实时成交明细（Trade）订阅

API说明

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

请求频率

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

错误码说明

参考Websocket错误码说明

接口地址

请参考Websocket订阅地址

请求数量

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

请求（协议号：10000）

{
    "code": 10000,
    "trace": "423afec425004bd8a5e02e1ba5f9b2b0",
    "data": {
        "codes": "BTCUSDT",
        "includeTy": false
    }
}

参数名	类型	必填	描述	示例值
code	Integer	是	请求的协议号	实时成交明细订阅协议号：10000
trace	String	是	可追溯ID（随机字符串）	423afec425004bd8a5e02e1ba5f9b2b0
data	JSON	是	订阅数据
<codes	String	是	订阅产品，多个用逗号分隔（一个websocket连接支持同时订阅最多600个产品）	BTCUSDT
<includeTy	Boolean	否	是否推送trade类型。不传或者传false不推送	false

应答（协议号：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	是	交易方向	交易方向：0为默认值，1为Buy，2为SELL
<v	String	是	成交量	0.00096
<vw	String	是	成交额	99.3436224
<tp	String	否	交易类型	参考下面交易类型说明

交易类型

港股

• * - 场外交易

• D - 碎股交易

• M - 非自动对盘

• P - 开市前成交盘

• U - 竞价交易

• X - 同一券商非自动对盘

• Y - 同一券商自动对盘

• - 自动对盘

美股

• - 自动对盘

• A - 收购

• B - 批量交易

• D - 分配

• F - 跨市扫盘单

• G - 批量卖出

• H - 离价交易

• I - 碎股交易

• K - 第 155 条交易（纽交所规则）

• M - 交易所收盘价

• P - 前参考价

• Q - 交易所开盘价

• S - 拆单交易

• V - 附属交易

• W - 平均价成交

• X - 跨市场交易

• 1 - 停售股票（常规交易）