Batch Place Orders (TRADE)

POST /api/v3/order/batch

Request Weight

5 on 10s order rate limit(X-ORDER-COUNT-10S); 5 on 1min order rate limit(X-ORDER-COUNT-1M); 0 on IP rate limit(X-USED-WEIGHT-1M);

Request parameters

Parameter	Type	Required?	Description
symbol	String	Yes	Trading pair, e.g. `BTCUSDT`.
orderList	Array<Object>	Yes	Up to 10 order definitions.

Each element of orderList supports the following fields:

Field	Type	Required?	Description
side	String	Yes	`BUY` or `SELL`.
type	String	Yes	`LIMIT` or `MARKET`.
timeInForce	String	Conditional	Required when `type = LIMIT`. Values: `GTC`, `IOC`, `FOK`.
quantity	String	Yes	Order quantity.
price	String	Conditional	Limit price when `type = LIMIT`.
newClientOrderId	String	No	Client-defined order ID.

Request example

Code
curl -X POST "https://api-spot.weex.com/api/v3/order/batch" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "Content-Type: application/json" \
   -d '{
     "symbol": "BTCUSDT",
     "orderList": [
       {
         "side": "BUY",
         "type": "LIMIT",
         "timeInForce": "GTC",
         "quantity": "0.01",
         "price": "68850",
         "newClientOrderId": "batch-1"
       },
       {
         "side": "SELL",
         "type": "MARKET",
         "quantity": "0.02",
         "newClientOrderId": "batch-2"
       }
     ]
   }'

Response parameters

Field	Type	Description
orderList	Array<Object>	Per-order result list.
→ symbol	String	Trading pair.
→ orderId	Long	Created order ID (present when successful).
→ clientOrderId	String	Client-defined order ID.
→ transactTime	Long	Order acceptance time (ms).
→ errorCode	String	Error code when the order failed.
→ errorMsg	String	Error message when the order failed.

Response example

Code
{
  "orderList": [
    {
      "symbol": "BTCUSDT",
      "orderId": 702345678901234700,
      "clientOrderId": "batch-1",
      "transactTime": 1764506000456
    },
    {
      "symbol": "BTCUSDT",
      "clientOrderId": "batch-2",
      "errorCode": "INSUFFICIENT_BALANCE",
      "errorMsg": "insufficient balance"
    }
  ]
}