Skip to main content

Update Orders

Type: POST

Description: /future/trade/v1/order/update

Content-Type = application/x-www-form-urlencoded && application/json

Parameters

NameTypeMandatoryDefaultDescriptionRanges
orderIdnumbertrueOrder ID
pricenumbertrueTarget price
origQtynumbertrueTarget quantity (cont)
triggerProfitPricenumberfalseN/AProfit target price
triggerStopPricenumberfalseN/AStop-Loss price
triggerPriceTypestringfalseLATEST_PRICETrigger price typeINDEX_PRICE; MARK_PRICE; LATEST_PRICE
profitDelegateOrderTypestringfalseN/ATake-Profit order typeLIMIT; MARKET
profitDelegateTimeInForcestringfalseN/ATake-Profit order validity methodGTC; IOC; FOK; GTX
profitDelegatePricenumberfalseN/ATake-Profit order price
stopDelegateOrderTypestringfalseN/AStop-Loss order typeLIMIT; MARKET
stopDelegateTimeInForcestringfalseN/AStop-Loss order validity methodGTC; IOC; FOK; GTX
stopDelegatePricenumberfalseN/AStop-Loss order price
followUpOrderbooleanfalseN/AIf true, indicates chase order

Limit Flow Rules

200/s/apikey

Request Example

Request
REQUEST_BODY='{
"orderId":"1234567890",
"price":"3800",
"origQty":1
}'

# The above three parameters are required. For optional parameters, please refer to the optional parameters list.

curl -X POST "https://fapi.xt.com/future/trade/v1/order/update" \
-H "validate-appkey: $APPKEY" \ # Required
-H "validate-timestamp: $TIMESTAMP" \ # Required
-H "validate-singature: $SINGATURE" \ # Required
-H "Content-Type: application/json" \ # Required
-d "${REQUEST_BODY}" # Required

Response Example

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

Error Codes

Error CodeDescription
invalid_orderOrder ID does not exist
invalid_paramsInvalid parameter setting
invalid_quantityorigQty must be an integer
invalid_priceInvalid price setting
invalid_trigger_profit_priceInvalid take-profit price setting
invalid_trigger_stop_priceInvalid stop-loss price setting
trigger_profit_price_less_than_order_delegate_priceTake-profit trigger price cannot be lower than the order price (Long)
trigger_profit_price_more_than_order_delegate_priceTake-profit trigger price cannot be higher than the order price (Short)
trigger_stop_price_more_than_order_delegate_priceStop-loss trigger price cannot be higher than the order price (Long)
trigger_stop_price_less_than_order_delegate_priceStop-loss trigger price cannot be lower than the order price (Short)
invalid_time_in_forceInvalid order time-in-force
on_board_30_minutes_limit_order_price_limitLimit order price restriction within 30 minutes after listing