# 批量下单 (TRADE)

- **POST** ```/capi/v3/batchOrders```

<strong>请求权重</strong>

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


<div class='api-content-wrap'>
<div>


<strong>请求体（Request Body）</strong>


| 参数名         | 类型                  | 是否必填   | 说明                                                                        |
|-------------|---------------------|--------|---------------------------------------------------------------------------|
| batchOrders | `Array<PlaceOrder>` | 是      | 单次最多 5 笔订单。每个元素与[下单 (TRADE)](/zh-CN/products/futures/Transaction_API/PlaceOrder) 的字段一致。 |
仅对 `LIMIT` 订单有效；不能与 `price` 参数同时传入，`timeInForce` 必须为 `GTC`。枚举值：`OPPONENT`、`OPPONENT_5`、`QUEUE`、`QUEUE_5`。示例：`OPPONENT`。 BBO 下单规则：仅当 `type=LIMIT` 且传入 `priceMatch` 时启用；`timeInForce` 必须显式传 `GTC`。请省略 `price`；传正数价格会报错（兼容接受 `price=0`，服务向交易所传价格 `0`）。`NONE` 仅用于查询响应，不能用于下单。不传 `priceMatch` 时保留普通订单逻辑；非 `LIMIT` 订单忽略 `priceMatch`。


**批量订单元素参数**

| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| batchOrders[].priceMatch | enum | 否 | 仅对 `LIMIT` 订单有效；不能与 `price` 参数同时传入，`timeInForce` 必须为 `GTC`。枚举值：`OPPONENT`、`OPPONENT_5`、`QUEUE`、`QUEUE_5`。示例：`OPPONENT`。 |

**BBO 批量请求体示例**

```json
{
  "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"
    }
  ]
}
```

<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
<br/>
</div>
<div class='api-align'>
  <div class='code-wrap'>
<strong>请求示例</strong>

```powershell
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
       }
     ]
   }'
```
  </div>
  </div>

</div>

<div class='api-content-wrap'>
  <div>
<strong>返回参数</strong>


返回一个数组，数组元素与[下单 (TRADE)](/zh-CN/products/futures/Transaction_API/PlaceOrder) 的响应结构一致。

  </div>
  <div class='api-align'>

  <div class='code-wrap'>
<strong>返回示例</strong>

```json
[
  {
    "orderId": "702345678901234567",
    "clientOrderId": "batch-1",
    "success": true,
    "errorCode": "",
    "errorMessage": ""
  }
]
```
  </div>
    </div>
</div>