最近成交

获取指定交易对的最近公开成交记录。

接口

GET /v1/market/trades

权重： 5。

鉴权： 公开（可选签名）。

查询参数

名称	类型	必填	说明
symbol	string	是	交易对，大写，例如 BTCUSDT。
limit	integer	否	返回的成交数量。范围 1–1000。默认 500。

成交按 time 降序返回（最新的在前）。

响应

[
  {
    "id": 4823917221,
    "price": "67432.15",
    "qty": "0.0421",
    "quoteQty": "2840.91",
    "time": 1745923199821,
    "isBuyerMaker": false
  },
  {
    "id": 4823917220,
    "price": "67432.10",
    "qty": "0.1100",
    "quoteQty": "7417.53",
    "time": 1745923199734,
    "isBuyerMaker": true
  },
  {
    "id": 4823917219,
    "price": "67432.20",
    "qty": "0.0050",
    "quoteQty": "337.16",
    "time": 1745923199610,
    "isBuyerMaker": false
  }
]

响应字段

字段	类型	说明
id	integer	全局唯一、单调递增的成交 id。
price	string (decimal)	成交价。
qty	string (decimal)	成交数量（基础资产）。
quoteQty	string (decimal)	成交数量（计价资产，等于 price * qty）。
time	integer	成交时间，Unix 毫秒（ms）。
isBuyerMaker	boolean	当买方为挂单方（即此次成交由卖方主动）时为 true。

错误

HTTP	错误码	含义
400	INVALID_PARAMETER	缺少 symbol，或 limit 超出范围。
400	UNKNOWN_SYMBOL	交易对不存在。
429	RATE_LIMITED	单个 Key 的请求权重已超限。

示例

curl -s "https://api.pipai.io/v1/market/trades?symbol=BTCUSDT&limit=100"