近期成交列表

类型：NONE · 权重：5

状态：已实现。

GET /api/v3/trades

某交易对最近的公开成交。每笔成交一行（taker 侧），最新在前。

请求

GET /api/v3/trades?symbol=CBTC-USDCB&limit=100

Query 参数

字段	类型	必填	默认值	说明
symbol	string	是	—
limit	integer	否	500	0 → 默认值；钳制到 1000。

响应 — 200（值仅为示意）

[
  {
    "id": "019910a4-5b2e-7c3d-9e8f-0a1b2c3d4e5f",
    "price": "60001.50",
    "qty": "0.0100",
    "quoteQty": "600.015000",
    "time": 1756600000456,
    "isBuyerMaker": false,
    "isBestMatch": true
  }
]

字段	类型	说明
id	string	成交 UUID——与 myTrades 中的 id 以及 @trade 流 中的 t 为同一个值。
price、qty	string
quoteQty	string	price × qty，未四舍五入。
time	number	成交时间，Unix 毫秒。
isBuyerMaker	boolean	taker 为卖出时为 true（买方是挂单方）。
isBestMatch	boolean	恒为 true。

未知交易对返回 []。

错误

HTTP	code	触发场景
400	—	缺少 symbol（框架拒绝）。
429	-1003	按 IP 的公开权重耗尽。

与 Binance 的差异

• id 是 UUID 字符串而非整数，因此没有 fromId 分页，也没有 GET /api/v3/historicalTrades。
• 行按最新在前返回；Binance 返回最旧在前。
• 两个 Rocky 自有机器人账户之间的成交与其他成交一样出现在这里；某笔成交是否已在链上结算，只有其交易双方可通过 myTrades 看到。