Skip to main content

Create Track

Type: POST

Description: /future/trade/v1/entrust/create-track


Limit Flow Rules

200/s/apikey


Parameters

NameTypeMandatoryDefaultDescriptionRanges
callbackstringTRUEN/ACallback type configurationFIXED; PROPORTION
callbackValnumberTRUEN/ACallback value (must be > 0)>0
orderSidestringTRUEN/AOrder sideBUY; SELL
origQtynumberTRUEN/AOriginal quantity (contracts)
positionSidestringTRUEN/APosition sideBOTH; LONG; SHORT
positionTypestringTRUEN/APosition typeCROSSED; ISOLATED
symbolstringTRUEN/ATrading pair
triggerPriceTypestringTRUEN/ATrigger price typeINDEX_PRICE; MARK_PRICE; LATEST_PRICE
activationPricenumberFALSEN/AActivation price
clientMediastringFALSEN/AClient media
clientMediaChannelstringFALSEN/AClient media channel
clientOrderIdstringFALSEN/AClient order ID
expireTimeintegerFALSEN/AExpiration time

Request Example

curl -X POST "https://fapi.xt.com/future/trade/v1/entrust/create-track" \
-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 "callback=FIXED" # Required
-d "callbackVal=1" # Required
-d "orderSide=BUY" # Required
-d "origQty=1" # Required
-d "positionSide=LONG" # Required
-d "positionType=CROSSED" # Required
-d "triggerPriceType=INDEX_PRICE" # Required
-d "activationPrice=999"

Response Example

{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {},
"returnCode": 0
}

Error Codes

Error CodeDescription
invalid_symbolTrading pair does not exist
symbol_is_not_tradingTrading pair is not available for trading
The trading pair currently does not support placing orders through the OpenAPI.The trading pair currently does not support placing orders via OpenAPI
deposit_coupon_existsThe coupon has been claimed or already bound
exist_bonus_positon_not_create_reverse_positionReverse position cannot be created
invalid_paramsInvalid or missing parameters
invalid_exceed_max_rate_limitCallback ratio exceeds maximum limit
invalid_below_min_rate_limitCallback ratio below minimum limit
invalid_exceed_max_price_limitCallback ratio exceeds latest transaction price limit
invalid_exceed_min_price_limitCallback ratio below latest transaction price limit
invalid_activation_priceInvalid activation price
invalid_quantity_scaleQuantity must be an integer
user_can_not_tradeAccount prohibited from trading
sub_account_not_tradeSub-account cannot trade
user_can_not_open_positionAccount restricted from opening positions
symbol_is_not_open_positionThe trading pair is not open for new positions