Batch Place Orders

Place multiple orders in a single request. Supports both single symbol and multiple symbols modes.

HTTP Request

POST /api/v1/spot/trade/batch-orders

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Trading pair symbol (required when batchMode is "single")
batchMode	string	No	Batch mode: "single" or "multiple" (default: "single")
orderList	array	Yes	Array of orders to place

Order List Item Parameters

Parameter	Type	Required	Description
symbol	string	No	Trading pair symbol (required when batchMode is "multiple")
side	string	Yes	Order side: "buy" or "sell"
orderType	string	Yes	Order type: "limit" or "market"
price	string	No	Order price (required when orderType is "limit")
size	string	Yes	Order size

Request Example

Single Symbol Mode

curl -X POST "https://open-api.bydoxe.com/api/v1/spot/trade/batch-orders" \
  -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",
    "batchMode": "single",
    "orderList": [
      {
        "side": "buy",
        "orderType": "limit",
        "price": "90000.00",
        "size": "0.001"
      },
      {
        "side": "buy",
        "orderType": "limit",
        "price": "89000.00",
        "size": "0.002"
      }
    ]
  }'

Multiple Symbols Mode

curl -X POST "https://open-api.bydoxe.com/api/v1/spot/trade/batch-orders" \
  -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 '{
    "batchMode": "multiple",
    "orderList": [
      {
        "symbol": "BTCUSDT",
        "side": "buy",
        "orderType": "limit",
        "price": "90000.00",
        "size": "0.001"
      },
      {
        "symbol": "ETHUSDT",
        "side": "sell",
        "orderType": "limit",
        "price": "3500.00",
        "size": "0.1"
      }
    ]
  }'

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
> failureList	array	Array of failed orders
>> errorMsg	string	Error message
>> errorCode	string	Error code

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "successList": [
      {
        "orderId": "123456789"
      },
      {
        "orderId": "123456790"
      }
    ],
    "failureList": [
      {
        "errorMsg": "insufficient balance",
        "errorCode": "40001"
      }
    ]
  }
}

Error Codes

Code	Message
40001	Parameter cannot be empty
40001	Maximum 50 orders allowed
40001	Symbol is required in single mode
40001	Symbol is required in orderList for multiple mode
40001	Missing required parameters (side, orderType, size)
40002	Unauthorized
43000	Invalid symbol format: symbol