近期成交

类型：NONE

权重：5

GET /fapi/v1/trades

按 symbol 拉取的最近公开成交，按时间倒序。

请求

GET /fapi/v1/trades?symbol=BTCUSDT&limit=100

Query 参数

字段	类型	必填	默认值	说明
`symbol`	string	是	—	标准 pair（如 `BTCUSDT`）。
`limit`	integer	否	`100`	限制 `1..=1000`。

响应 — 200

[
  {
    "id": 8745321456987654,
    "price": "76521.340000000000000000",
    "qty": "0.000500000000000000",
    "quoteQty": "38.260670000000000000000000000",
    "time": 1748275200320,
    "isBuyerMaker": false
  }
]

字段	说明
`id`	来自成交 UUID 的稳定 63 位推导（取前 8 字节，屏蔽符号位）。同一笔成交始终对应同一个 `id`。
`quoteQty`	`price * qty` 序列化为 decimal 字符串。
`isBuyerMaker`	taker 卖出时为 `true`（即 buyer 为挂单方）。

错误

HTTP	code	msg
`400`	`-1100`	未知 `symbol`。
`400`	—	`symbol` 或 `limit` 缺失或格式错误：axum 的纯文本拒绝（`Failed to deserialize query string: …`），不是 `{code,msg}` JSON 形态。
`500`	`-1000`	数据库错误。

Rocky 也在 Web v1 原生 surface 提供：GET /v1/markets/{symbol}/recent-trades?limit=100（默认 50，最大 200）— 使用 Rocky 的 {trade_id, price, qty, side, ts_ms} 格式而不是标准形态。