Skip to content

Batch Order

Description

Batch order

HTTP Request

  • POST /fapi/v1/trade/batchOrders

Request Parameters

ParameterTypeRequiredDescription
futuresNameStringYesFutures name, ex:"E-BTC-USDT"
ordersList<Object>YesOrder list, maximum length: 10
>typeStringYesOrder type. LIMIT: limit order,MARKET: market order
>sideStringYesTransaction direction. BUY: Buy(one-way-mode); Long position direction(hedge-mode). SELL: Sell(one-way-mode); Short position direction(hedge-mode)
>openStringYesTrade type, OPEN: Open position, CLOSE: Close position
>priceStringNoPrice of the order, Required if order type is "LIMIT"
>volumeStringYesAmount or opening value. If order type is "LIMIT", volume is the order quantity, e.g. 1000 multiplier. If order type is "MARKET", volume is the opening value, e.g. 1000USDT to open close
>orderClientIdStringNoCustom order ID

Request Example

http
curl -X POST 'https://futuresopenapi.100ex.com/fapi/v1/trade/batchOrders' \
	-H "X-CH-TS:1736156253259" \
	-H "X-CH-SIGN:*" \
	-H "X-CH-APIKEY:********" \
	-H "Content-Type: application/json" \
	-d '{
	  "futuresName": "E-BTC-USDT",
	  "orders": [{
	 		"type": "LIMIT",
	  		"side": "BUY",
	  		"open": "OPEN",
	  		"price": "100000",
	  		"volume": "10",
             "clientOrderId": "123123"
	  	}
	]
}'

Response Parameters

ParameterTypeDescription
idPricesList<String>Successful order list, including order ID, order direction, Price of order
idsList<String>Successful order ID list

Response Example

json
{
    "code": "0",
    "msg": "suc",
    "data": {
        "idPrices": [
        "[{\"side\":\"BUY\",\"price\":\"100000\",\"id\":2523202885939469204,\"clientOrderId\":\"123123\"}"
    	],
    	"ids": [
        	"2523202885939469204"
    	]
    }
}