Order List

Query user order list using cursor-based pagination, supports filtering by trading pair, status, side, and time range.

API Information

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

Request Parameters

Parameter	Location	Type	Required	Description
symbol	query	string	No	Trading pair, e.g. BTC_USDT
status	query	integer	No	Status: 1=new, 2=partially filled, 3=fully filled, 4=canceled
side	query	integer	No	Side: 1=buy, 2=sell, 0=all
start_time	query	integer	No	Start time (milliseconds timestamp)
end_time	query	integer	No	End time (milliseconds timestamp)
cursor	query	integer	No	Cursor (order ID), do not pass for first query
limit	query	integer	No	Page size, default 20, max 100

Request Example

GET /api/v1/orders?symbol=BTC_USDT&status=3&limit=20

Response Fields

Field	Type	Description
code	integer	Status code
message	string	Response message
data.has_more	boolean	Has more data
data.next_cursor	integer	Next page cursor
data.orders	array	Order list (fields refer to "Order Detail")

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "has_more": false,
    "next_cursor": 1234567890123456800,
    "orders": [
      {
        "id": "1234567890123456789",
        "client_order_id": "my-order-001",
        "symbol": "BTC/USDT",
        "side": 1,
        "type": 1,
        "status": 2,
        "price": "30000",
        "qty": "0.1",
        "quote_qty": "0",
        "filled_qty": "0.05",
        "filled_quote": "1500",
        "avg_price": "30000",
        "total_fee": "0.0001",
        "fee_asset": "BTC",
        "cancel_reason": "USER",
        "created_at": 1704067200000,
        "updated_at": 1704067200000,
        "user_id": "user123"
      }
    ]
  }
}