批量下单 (TRADE)

POST /capi/v3/batchOrders

请求权重

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

请求体（Request Body）

参数名	类型	是否必填	说明
batchOrders	`Array<PlaceOrder>`	是	单次最多 5 笔订单。每个元素与下单 (TRADE) 的字段一致。
仅对 `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 批量请求体示例

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"
    }
  ]
}

请求示例

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
       }
     ]
   }'

返回参数

返回一个数组，数组元素与下单 (TRADE) 的响应结构一致。

返回示例

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