See Stop Limit
Type: GET
Description: /future/trade/v1/entrust/profit-list
Limit Flow Rules
200/s/apikey
Parameters
| Name | Type | Mandatory | Default | Description | Ranges |
|---|---|---|---|---|---|
| symbol | string | TRUE | N/A | Trading pair (if not provided, query all pairs) | — |
| page | integer | FALSE | 1 | Page number | — |
| size | integer | FALSE | 10 | Number per page | — |
| startTime | integer | FALSE | N/A | Start time | — |
| endTime | integer | FALSE | N/A | End time | — |
| state | string | TRUE | N/A | Order 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 Code | Description |
|---|---|
| invalid_symbol | Trading pair does not exist |
| invalid_position_type | Invalid position type |
| invalid_position_side | Invalid position side |
| invalid_state | Invalid state type |