Order History

Query historical orders that have been filled or canceled (paginated).

API Information

• Method: POST
• Path: /api/v1/futures/open-api/order/history

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Filter by futures trading pair
coType	int	No	Filter by contract type
pageIndex	int	No	Page number, default 1
pageSize	int	No	Records per page, default 10, max 100

Request Example

{
  "symbol": "BTCUSDT",
  "coType": 3,
  "pageIndex": 1,
  "pageSize": 20
}

Response Fields

Field	Type	Description
id	int64	Order ID
symbol	string	Futures trading pair
price	string	Order price
avgPrice	string	Average fill price
status	int	Order status: 0=init, 1=new, 2=filled, 3=part_filled, 4=canceled, 5=pending_cancel, 6=expired
orderNo	string	Order number
openFlag	int	Open/Close: 1=Open, 2=Close
orderType	int	Order type: 1=Limit, 2=Market
longFlag	int	Direction: 1=Long (Buy), 2=Short (Sell)
vol	string	Order quantity
amtTotal	string	Total order value (USD)
leverage	string	Leverage
realPnl	string	Realized P&L
realFee	string	Actual fee
ctime	int64	Creation time (milliseconds)
tradedTime	int64	Fill time (milliseconds)
cancelTime	int64	Cancel time (milliseconds)
triggerType	int	Trigger type: 1=Normal, 2=Take profit, 3=Stop loss, 4=Liquidation
orderMargin	string	Margin
marginMode	int	Margin mode: 1=Cross, 2=Isolated
coType	int	Contract type: 1=US stocks, 2=Hong Kong stocks, 3=Cryptocurrency
total	int64	Total record count
page	int	Current page
size	int	Records per page

Response Example

{
  "code": 200,
  "data": [
    {
      "id": 123456,
      "symbol": "BTCUSDT",
      "price": "68500.00",
      "avgPrice": "68520.00",
      "status": 2,
      "orderNo": "CO2026032500001",
      "openFlag": 1,
      "orderType": 2,
      "longFlag": 1,
      "vol": "0.5",
      "amtTotal": "34260.00",
      "leverage": "10",
      "realPnl": "200.50",
      "realFee": "34.26",
      "ctime": 1737446400000
    }
  ]
}