Skip to main content

See Orders

Type: GET

Description: /future/trade/v1/order/list

Parameters

NameTypeMandatoryDefaultDescriptionRanges
clientOrderIdstringfalseN/AClient order ID
pageintegerfalse1Page
sizeintegerfalse10Quantity of a single page
startTimeintegerfalseN/AStart time
endTimeintegerfalseN/AEnd time
statestringfalseNEWOrder state: NEW (New order, unfilled); PARTIALLY_FILLED (Partial deal); PARTIALLY_CANCELED (Partial revocation); FILLED (Filled); CANCELED (Cancelled); REJECTED (Order failed); EXPIRED (Expired); UNFINISHED (Unfinished); HISTORY (History)PREV; NEXT
symbolstringfalseN/ATrading pair

Limit Flow Rules

200/s/apikey

Request Example

Request
curl -G "https://fapi.xt.com/future/trade/v1/order/list" -H "validate-appkey: $APPKEY"   # Required
-H "validate-timestamp: $TIMESTAMP" # Required
-H "validate-singature: $SINGATURE" # Required
-H "Content-Type: application/x-www-form-urlencoded" # Required
-d "symbol=btc_usdt" -d "size=10" -d "page=1"

Response Example

Response
{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
"items": [
{
"clientOrderId": "", // Client order ID
"avgPrice": 0, // Average price
"closePosition": false, // Whether to close all when order condition is triggered
"closeProfit": 0, // Offset profit and loss
"createdTime": 0, // Create time
"executedQty": 0, // Volume (Cont)
"forceClose": false, // Is it a liquidation order
"marginFrozen": 0, // Occupied margin
"orderId": 0, // Order ID
"orderSide": "", // Order side
"orderType": "", // Order type
"origQty": 0, // Quantity (Cont)
"positionSide": "", // Position side
"price": 0, // Order price
"sourceId": 0, // Triggering conditions ID
"state": "", // Order state
"symbol": "", // Trading pair
"timeInForce": "", // Valid type
"triggerProfitPrice": 0, // TP trigger price
"triggerStopPrice": 0 // SL trigger price
}
],
"page": 0,
"ps": 0,
"total": 0
},
"returnCode": 0
}

Error Codes

Error codeDescription
invalid stateInvalid state parameter
invalid_symbolThe trading pair does not exist