跳到主要内容

历史订单

获取用户历史订单列表(已完成/已撤销/已拒绝),支持游标分页。

接口信息

请求参数

参数位置类型必填说明
symbolquerystring交易对筛选
statusqueryinteger状态筛选:3=全部成交,4=已撤销,5=已拒绝
sidequeryinteger方向:1=买,2=卖
start_timequeryinteger开始时间(毫秒时间戳)
end_timequeryinteger结束时间(毫秒时间戳)
cursorquerystring分页游标
limitqueryinteger每页数量,默认 100

请求示例

GET /fapi/v1/orders?symbol=BTC_USDT&limit=50

响应字段

字段类型说明
codeinteger状态码
messagestring返回消息
data.has_moreboolean是否有更多
data.next_cursorstring下一页游标
data.itemsarray订单列表(字段同订单详情)

响应示例

{
"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
}
]
}
}