跳到主要内容

逐笔交易

流:<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
}
字段类型说明
estring恒为 "trade"。
Enumber事件时间,Unix 毫秒(网关接收时间)。
sstring规范交易对,大写带连字符。
tstring成交 id——UUID 字符串。等于 GET /api/v3/trades 与 myTrades 中的 id。
p、qstring价格与基础资产数量。
Tnumber成交时间,Unix 毫秒。与 E 相同:引擎的成交事件不携带单独的时间戳。
mboolean买方为 maker(taker 卖出)时为 true。

刻意不包含的字段: b / a(买方/卖方订单 id)、M,以及任何 party 或账户标识。这是一个公开流;其中没有任何信息能让观察者把某笔成交归属到某个参与者。

语义

  • 引擎内部的非成交事件(例如 MARKET 单未成交剩余部分的撤销)会被过滤,绝不出现在这里。
  • 成交按引擎顺序投递。超出 256 帧队列的慢消费者会向前跳过并错过成交;若检测到墙钟时间上的缺口,请用 GET /api/v3/trades(最新在前)对账。
  • 交易场所内的每一笔成交都会出现,包括 Rocky 自有账户之间的成交。

与 Binance 的差异

  • t 为 UUID 字符串,不是整数。
  • 没有 b、a、M 字段;E 与 T 相同。
  • 没有 @aggTrade 流。