Skip to main content

See Transaction Details

Type: GET

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

Parameters

NameTypeMandatoryDefaultDescriptionRanges
orderIdintegerfalseN/AOrder ID
symbolstringfalseN/ATrading pair
pageintegerfalse1Page
sizeintegerfalse10Quantity of a single page
startTimeintegerfalseN/AStart time
endTimeintegerfalseN/AEnd time

Limit Flow Rules

200/s/apikey

Request Example

Request
curl -G "https://fapi.xt.com/future/trade/v1/order/trade-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=eth_usdt" \
-d "page=1" \
-d "size=10"

Response Example

Response
{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
"items": [
{
"fee": 0, // Fee
"feeCoin": "", // Currency of fee
"orderId": 0, // Order ID
"execId": 0, // Trade ID
"price": 0, // Price
"quantity": 0, // Volume
"symbol": "", // Trading pair
"timestamp": 0, // Time
"takerMaker": "TAKER" // taker or maker
}
],
"page": 0,
"ps": 0,
"total": 0
},
"returnCode": 0
}

Error Codes

Error CodeDescription
invalid_pagePage number must be a positive integer
invalid_sizeThe maximum value of size is 100
invalid_symbolThe trading pair does not exist