逐笔交易
流:<symbol>@trade · 更新速度:实时
状态:已实现。
每笔成交一帧,实时取自撮合引擎的成交流。这与稍后出现在 GET /api/v3/trades 中、以及对其交易双方出现在 myTrades 中的是同一个事件。
帧(值仅为示意)
{
"e": "trade",
"E": 1756600000456,
"s": "CBTC-USDCB",
"t": "019910a4-5b2e-7c3d-9e8f-0a1b2c3d4e5f",
"p": "60001.50",
"q": "0.0100",
"T": 1756600000456,
"m": false
}
| 字段 | 类型 | 说明 |
|---|---|---|
e | string | 恒为 "trade"。 |
E | number | 事件时间,Unix 毫秒(网关接收时间)。 |
s | string | 规范交易对,大写带连字符。 |
t | string | 成交 id——UUID 字符串。等于 GET /api/v3/trades 与 myTrades 中的 id。 |
p、q | string | 价格与基础资产数量。 |
T | number | 成交时间,Unix 毫秒。与 E 相同:引擎的成交事件不携带单独的时间戳。 |
m | boolean | 买方为 maker(taker 卖出)时为 true。 |
刻意不包含的字段: b / a(买方/卖方订单 id)、M,以及任何 party 或账户标识。这是一个公开流;其中没有任何信息能让观察者把某笔成交归属 到某个参与者。
语义
- 引擎内部的非成交事件(例如 MARKET 单未成交剩余部分的撤销)会被过滤,绝不出现在这里。
- 成交按引擎顺序投递。超出 256 帧队列的慢消费者会向前跳过并错过成交;若检测到墙钟时间上的缺口,请用
GET /api/v3/trades(最新在前)对账。 - 交易场所内的每一笔成交都会出现,包括 Rocky 自有账户之间的成交。
与 Binance 的差异
t为 UUID 字符串,不是整数。- 没有
b、a、M字段;E与T相同。 - 没有
@aggTrade流。