订单成交记录
基于游标分页查询指定订单的成交记录。
接口信息
- 方法:
GET - 路径:
/api/v1/orders/{id}/trades - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| id | path | string | 是 | 订单 ID |
| cursor | query | integer | 否 | 游标,首次查询不传 |
| limit | query | integer | 否 | 返回数量,默认 500,最大 1000 |
请求示例
GET /api/v1/orders/1234567890123456789/trades?limit=100
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data.has_more | boolean | 是否有更多 |
| data.next_cursor | integer | 下一页游标 |
| data.trades | array | 成交列表 |
| data.trades[].id | string | 成交 ID |
| data.trades[].order_id | string | 订单 ID |
| data.trades[].symbol | string | 交易对 |
| data.trades[].price | string | 成交价格 |
| data.trades[].qty | string | 成交数量 |
| data.trades[].quote_qty | string | 成交金额 |
| data.trades[].fee | string | 手续费 |
| data.trades[].fee_asset | string | 手续费币种 |
| data.trades[].is_buyer | boolean | 是否买方 |
| data.trades[].is_maker | boolean | 是否 Maker |
| data.trades[].time | integer | 成交时间(毫秒) |
响应示例
{
"code": 0,
"message": "success",
"data": {
"has_more": false,
"next_cursor": 100,
"trades": [
{
"id": "9876543210123456789",
"order_id": "1234567890123456789",
"symbol": "BTC_USDT",
"price": "30000.00",
"qty": "0.1",
"quote_qty": "3000.00",
"fee": "0.0001",
"fee_asset": "BTC",
"is_buyer": true,
"is_maker": false,
"time": 1704067200000
}
]
}
}