Batch Place Orders

Place multiple futures orders in a single request for the same symbol.

HTTP Request

POST /api/v1/future/order/batch-place-order

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
marginMode	string	Yes	Margin mode: "CROSSED" or "ISOLATED"
orderList	array	Yes	Array of orders to place

Order List Item Parameters

Parameter	Type	Required	Description
size	string	Yes	Order size
side	string	Yes	Position side: "LONG" or "SHORT"
tradeSide	string	Yes	Trade side: "OPEN" or "CLOSE"
orderType	string	Yes	Order type: "LIMIT" or "MARKET"
price	string	No	Order price (required for LIMIT orders)
force	string	No	Time in force: "POST_ONLY"
clientOid	string	No	Client order ID
presetTakeProfitPrice	string	No	Take profit trigger price
presetStopLossPrice	string	No	Stop loss trigger price
presetTakeProfitExecutePrice	string	No	Take profit execution price
presetStopLossExecutePrice	string	No	Stop loss execution price

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/order/batch-place-order" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "marginMode": "CROSSED",
    "orderList": [
      {
        "size": "0.5",
        "side": "LONG",
        "tradeSide": "OPEN",
        "orderType": "LIMIT",
        "price": "40000.00",
        "clientOid": "my-order-001"
      },
      {
        "size": "0.3",
        "side": "SHORT",
        "tradeSide": "OPEN",
        "orderType": "MARKET",
        "clientOid": "my-order-002"
      }
    ]
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Batch order result
> successList	array	Array of successfully placed orders
>> orderId	string	Order ID
>> clientOid	string	Client order ID
> failureList	array	Array of failed orders
>> orderId	string	Order ID (empty if failed)
>> clientOid	string	Client order ID
>> errorMsg	string	Error message
>> errorCode	string	Error code

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763459280000,
  "data": {
    "successList": [
      {
        "orderId": "fu-123456789",
        "clientOid": "my-order-001"
      }
    ],
    "failureList": [
      {
        "orderId": "",
        "clientOid": "my-order-002",
        "errorMsg": "Insufficient balance",
        "errorCode": "40001"
      }
    ]
  }
}

Error Codes

Code
Same error codes as place-order, returned in failureList