Skip to main content

Query All Trade Details(No pagination)

Type: GET
Description: /future/trade/v1/order/trade-list-all

Rate Limit

200/s/apikey

Parameters

NameTypeRequiredDefaultDescriptionRange
orderIdintegerFALSEN/AOrder ID
startTimeintegerFALSEN/AStart time
endTimeintegerFALSEN/AEnd time
symbolstringFALSEN/ATrading pair

Request Example

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

Response Example

{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
[
{
"orderId": "1876543210987654321", // string, Long → converted to string
"execId": "2876543210987654322", // string, trade ID → Long converted to string
"symbol": "BTCUSDT", // string, trading pair
"contractSize": 0.001, // number, contract size (e.g. 1 BTC contract = 0.001 BTC)
"quantity": "0.015", // string, trade quantity (contracts)
"price": "67234.80", // string, trade price
"fee": "10.08522", // string, total fee
"couponDeductFee": "3.00000", // string, coupon deduction
"bonusDeductFee": "2.00000", // string, bonus deduction
"feeCoin": "USDT", // string, fee currency
"timestamp": 1735698765432, // number, trade timestamp (ms)
"takerMaker": "TAKER", // string, enum: TAKER / MAKER
"orderSide": "BUY", // string, BUY / SELL
"positionSide": "LONG" // string, LONG / SHORT / BOTH
}
]
},
"returnCode": 0
}

Error Codes

Error codeDescription
invalid_limitInvalid limit parameter setting