历史订单
获取用户历史订单列表(已完成/已撤销/已拒绝),支持游标分页。
接口信息
- 方法:
GET - 路径:
/fapi/v1/orders - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| symbol | query | string | 否 | 交易对筛选 |
| status | query | integer | 否 | 状态筛选:3=全部成交,4=已撤销,5=已拒绝 |
| side | query | integer | 否 | 方向:1=买,2=卖 |
| start_time | query | integer | 否 | 开始时间(毫秒时间戳) |
| end_time | query | integer | 否 | 结束时间(毫秒时间戳) |
| cursor | query | string | 否 | 分页游标 |
| limit | query | integer | 否 | 每页数量,默认 100 |
请求示例
GET /fapi/v1/orders?symbol=BTC_USDT&limit=50
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data.has_more | boolean | 是否有更多 |
| data.next_cursor | string | 下一页游标 |
| data.items | array | 订单列表(字段同订单详情) |
响应示例
{
"code": 0,
"message": "success",
"data": {
"has_more": true,
"next_cursor": "1711929600000",
"items": [
{
"id": "1234567890123456789",
"symbol": "BTC_USDT",
"client_order_id": "my-order-001",
"side": 1,
"type": 1,
"status": 3,
"price": "68500.00",
"qty": "0.1",
"filled_qty": "0.1",
"filled_quote": "6850.00",
"avg_price": "68500.00",
"total_fee": "3.42",
"fee_asset": "USDT",
"leverage": 10,
"margin_mode": 1,
"position_action": 1,
"position_side": 1,
"created_at": 1711929600000,
"updated_at": 1711929700000
}
]
}
}