Order History

Get the user's historical order list (filled / canceled / rejected) using cursor pagination.

API Information

• Method: GET
• Path: /fapi/v1/orders
• Authentication: Requires signature authentication (see Common Module · Signature Specification)

Request Parameters

Parameter	Location	Type	Required	Description
symbol	query	string	No	Trading pair filter
status	query	integer	No	Status filter: 3=filled, 4=canceled, 5=rejected
side	query	integer	No	Side: 1=buy, 2=sell
start_time	query	integer	No	Start time (milliseconds timestamp)
end_time	query	integer	No	End time (milliseconds timestamp)
cursor	query	string	No	Pagination cursor
limit	query	integer	No	Page size, default 100

Request Example

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

Response Fields

Field	Type	Description
code	integer	Status code
message	string	Response message
data.has_more	boolean	Whether more records exist
data.next_cursor	string	Next page cursor
data.items	array	Order list (same fields as order detail)

Response Example

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