Skip to main content

Bulk Orders

Type: POST

Description: /future/trade/v2/order/create-batch

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

Limit Flow Rules

200/s/apikey

Parameters

NameTypeMandatoryDefaultDescriptionRanges
liststringtrueN/AList collection of order data

Request Example

Request
curl -X POST "https://fapi.xt.com/future/trade/v1/order/create-batch" \
-H "validate-appkey: $APPKEY" \ # Required
-H "validate-timestamp: $TIMESTAMP" \ # Required
-H "validate-singature: $SINGATURE" \ # Required
-H "Content-Type: application/x-www-form-urlencoded" \ # Required
-d "" \ # Required

Response Example

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

Error Codes

Error CodeDescription
gateway_decommission_ip_countryUnfortunately, we are unable to provide services to users from restricted countries/regions. Please contact customer support for assistance.
gateway_decommission_kyc_countryUnfortunately, we are unable to provide services to users from restricted countries/regions. Please contact customer support for assistance.
GATEWAY_0003The current user has triggered a risk control rule, and your operation has been temporarily disabled.
GATEWAY_0006Your account is locked due to risk control for【{hour} hour(s) and {minutes} minute(s)】. Please contact customer support or your account manager for details.
GATEWAY_0007Your account is locked due to risk control for【{minutes} minute(s)】. Please contact customer support or your account manager for details.
invalid_symbolThe trading pair does not exist.
symbol_is_not_tradingThe trading pair is not currently tradable.
openapi_not_supportedThe trading pair currently does not support API operations.
symbol_is_not_open_positionThe trading pair cannot hold positions at this time.
invalid_paramsInvalid parameter settings.
invalid_quantityorigQty must be an integer.
quantity_can_not_less_than *origQty must be greater than *.
user_can_not_tradeThe account is currently prohibited from trading.
sub_account_not_tradeSub-account is not allowed to trade.
user_can_not_open_positionThe account cannot open positions at this time.
invalid_time_in_forceInvalid time-in-force setting.
invalid_priceInvalid price setting.
invalid_trigger_profit_priceInvalid take-profit price.
invalid_trigger_stop_priceInvalid stop-loss price.
trigger_profit_price_more_than_sell_one_priceTake-profit trigger price must be higher than the best ask (long).
trigger_profit_price_less_than_buy_one_priceTake-profit trigger price must be lower than the best bid (short).
trigger_stop_price_more_than_sell_one_priceStop-loss trigger price must be lower than the best ask (long).
trigger_stop_price_less_than_buy_one_priceStop-loss trigger price must be higher than the best bid (short).
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).
on_board_30_minutes_limit_order_price_limitLimit order price is restricted within 30 minutes after listing.