Skip to main content

See Trigger Orders History

Type: GET Description: /future/trade/v1/entrust/plan-list-history


Limit Flow Rules

200/s/apikey


Parameters

NameTypeMandatoryDefaultDescriptionRanges
symbolstringTRUEN/ATrading pair (if not provided, queries all pairs)
directionstringFALSENEXTQuery directionPREV; NEXT
idintegerFALSEN/ARecord ID
limitintegerFALSE10Limit number of records
startTimeintegerFALSEN/AStart time
endTimeintegerFALSEN/AEnd time

Request Example

curl -G "https://fapi.xt.com/future/trade/v1/entrust/plan-list-history" \
-H "validate-appkey: $APPKEY" # Required
-H "validate-timestamp: $TIMESTAMP" # Required
-H "validate-signature: $SIGNATURE" # Required
-H "Content-Type: application/x-www-form-urlencoded" # Required
-d "symbol=btc_usdt" # Required
-d "direction=NEXT" \
-d "limit=10"

Response Example

{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
"hasNext": false, // Whether there is a next page
"hasPrev": false, // Whether there is a previous page
"items": [
// Data list
{
"clientOrderId": "", // Client order ID
"closePosition": false, // Whether to close all positions
"createdTime": 0, // Creation time
"entrustId": 0, // Order ID
"entrustType": "", // Entrust type
"marketOrderLevel": 0, // Market order level
"orderSide": "", // Order side
"ordinary": true,
"origQty": 0, // Quantity (contracts)
"positionSide": "", // Position side
"price": 0, // Entrust price
"state": "", // Order status: NOT_TRIGGERED, TRIGGERING, TRIGGERED, USER_REVOCATION, PLATFORM_REVOCATION, EXPIRED
"stopPrice": 0, // Trigger price
"symbol": "", // Trading pair
"timeInForce": "", // Time in force
"triggerPriceType": "" // Trigger price type
}
]
},
"returnCode": 0
}

Error Codes

Error codeDescription