Update Orders
Type: POST
Description: /future/trade/v1/order/update
Content-Type =
application/x-www-form-urlencoded && application/json
Parameters
| Name | Type | Mandatory | Default | Description | Ranges |
|---|---|---|---|---|---|
| orderId | number | true | Order ID | ||
| price | number | true | Target price | ||
| origQty | number | true | Target quantity (cont) | ||
| triggerProfitPrice | number | false | N/A | Profit target price | |
| triggerStopPrice | number | false | N/A | Stop-Loss price | |
| triggerPriceType | string | false | LATEST_PRICE | Trigger price type | INDEX_PRICE; MARK_PRICE; LATEST_PRICE |
| profitDelegateOrderType | string | false | N/A | Take-Profit order type | LIMIT; MARKET |
| profitDelegateTimeInForce | string | false | N/A | Take-Profit order validity method | GTC; IOC; FOK; GTX |
| profitDelegatePrice | number | false | N/A | Take-Profit order price | |
| stopDelegateOrderType | string | false | N/A | Stop-Loss order type | LIMIT; MARKET |
| stopDelegateTimeInForce | string | false | N/A | Stop-Loss order validity method | GTC; IOC; FOK; GTX |
| stopDelegatePrice | number | false | N/A | Stop-Loss order price | |
| followUpOrder | boolean | false | N/A | If 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 Code | Description |
|---|---|
| invalid_order | Order ID does not exist |
| invalid_params | Invalid parameter setting |
| invalid_quantity | origQty must be an integer |
| invalid_price | Invalid price setting |
| invalid_trigger_profit_price | Invalid take-profit price setting |
| invalid_trigger_stop_price | Invalid stop-loss price setting |
| trigger_profit_price_less_than_order_delegate_price | Take-profit trigger price cannot be lower than the order price (Long) |
| trigger_profit_price_more_than_order_delegate_price | Take-profit trigger price cannot be higher than the order price (Short) |
| trigger_stop_price_more_than_order_delegate_price | Stop-loss trigger price cannot be higher than the order price (Long) |
| trigger_stop_price_less_than_order_delegate_price | Stop-loss trigger price cannot be lower than the order price (Short) |
| invalid_time_in_force | Invalid order time-in-force |
| on_board_30_minutes_limit_order_price_limit | Limit order price restriction within 30 minutes after listing |