Place Orders Batch (TRADE)

POST /capi/v3/batchOrders

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 Body

Parameter	Type	Required?	Description
batchOrders	`Array<PlaceOrder>`	Yes	Up to 5 orders per request. Each element uses the same fields as Place Order (TRADE).

Only effective for LIMIT orders; do not send together with price. timeInForce must be GTC. Enum: OPPONENT, OPPONENT_5, QUEUE, QUEUE_5. Example: OPPONENT. BBO rules: enabled only when type=LIMIT and priceMatch is provided. Explicitly set timeInForce=GTC and omit price. A positive price is rejected (price=0 is accepted for compatibility; the exchange receives price 0). NONE is response-only and cannot be submitted. Requests without priceMatch keep the regular order flow; non-LIMIT orders ignore priceMatch.

Batch order item parameters

Parameter	Type	Required?	Description
batchOrders[].priceMatch	enum	No	Only effective for `LIMIT` orders; do not send together with `price`. `timeInForce` must be `GTC`. Enum: `OPPONENT`, `OPPONENT_5`, `QUEUE`, `QUEUE_5`. Example: `OPPONENT`.

BBO batch request body example

Code
{
  "batchOrders": [
    {
      "symbol": "ETHUSDT",
      "side": "BUY",
      "positionSide": "LONG",
      "type": "LIMIT",
      "timeInForce": "GTC",
      "quantity": "0.001",
      "priceMatch": "OPPONENT",
      "newClientOrderId": "bbo-batch-0001"
    },
    {
      "symbol": "ETHUSDT",
      "side": "BUY",
      "positionSide": "LONG",
      "type": "LIMIT",
      "timeInForce": "GTC",
      "quantity": "0.001",
      "priceMatch": "QUEUE_5",
      "newClientOrderId": "bbo-batch-0002"
    }
  ]
}

Request example

Code
curl -X POST "https://api-contract.weex.com/capi/v3/batchOrders" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "Content-Type: application/json" \
   -d '{
     "batchOrders": [
       {
         "symbol": "BTCUSDT",
         "side": "BUY",
         "positionSide": "LONG",
         "type": "LIMIT",
         "timeInForce": "GTC",
         "quantity": "0.01",
         "price": "69000",
         "newClientOrderId": "batch-1",
         "reduceOnly": false
       }
     ]
   }'

Response parameters

A JSON array where each element matches the response schema of Place Order (TRADE).

Response example

Code
[
  {
    "orderId": "702345678901234567",
    "clientOrderId": "batch-1",
    "success": true,
    "errorCode": "",
    "errorMessage": ""
  }
]