Skip to main content

See Stop Limit

Type: GET

Description: /future/trade/v1/entrust/profit-list


Limit Flow Rules

200/s/apikey


Parameters

NameTypeMandatoryDefaultDescriptionRanges
symbolstringTRUEN/ATrading pair (if not provided, query all pairs)
pageintegerFALSE1Page number
sizeintegerFALSE10Number per page
startTimeintegerFALSEN/AStart time
endTimeintegerFALSEN/AEnd time
statestringTRUEN/AOrder state: NOT_TRIGGERED (new), TRIGGERING (triggering), TRIGGERED (triggered), USER_REVOCATION (user canceled), PLATFORM_REVOCATION (platform canceled), EXPIRED (expired), UNFINISHED (unfinished), HISTORY (historical)NOT_TRIGGERED; TRIGGERING; TRIGGERED; USER_REVOCATION; PLATFORM_REVOCATION; EXPIRED; UNFINISHED; HISTORY

Request Example

curl -G "https://fapi.xt.com/future/trade/v1/entrust/profit-list" \
-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 "state=NOT_TRIGGERED" # Required
-d "page=1" \
-d "size=10"

Response Example

{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
"items": [
{
"createdTime": 0, // Time
"entryPrice": 0, // Average entry price
"executedQty": 0, // Executed quantity
"isolatedMargin": 0, // Isolated margin
"origQty": 0, // Quantity (contracts)
"positionSide": "", // Position side
"positionSize": 0, // Position size (contracts)
"profitId": 0, // Order ID
"state": "", // Order state: NOT_TRIGGERED, TRIGGERING, TRIGGERED, USER_REVOCATION, PLATFORM_REVOCATION, EXPIRED
"symbol": "", // Trading pair
"triggerProfitPrice": 0, // Take-profit price
"triggerStopPrice": 0, // Stop-loss price
"profitDelegateOrderType": "LIMIT", // Take-profit order type: LIMIT, MARKET
"profitDelegatePrice": 0, // Take-profit order price
"profitDelegateTimeInForce": "GTC", // Take-profit order time-in-force: GTC, FOK, IOC, GTX
"stopDelegateOrderType": "LIMIT", // Stop-loss order type: LIMIT, MARKET
"stopDelegatePrice": 0, // Stop-loss order price
"stopDelegateTimeInForce": "GTC" // Stop-loss order time-in-force: GTC, FOK, IOC, GTX
}
],
"page": 0,
"ps": 0,
"total": 0
},
"returnCode": 0
}

Error Codes

Error CodeDescription
invalid_symbolTrading pair does not exist
invalid_position_typeInvalid position type
invalid_position_sideInvalid position side
invalid_stateInvalid state type