批量下单

描述

该接口支持现货、杠杆及合约的批量下单，并可以自定义包括价格、数量和订单类型等参数。

• 单次调用最多支持20笔订单

• 部分成功处理
  批量中的每笔订单独立处理，某一笔订单失败不影响同批次其他订单的下单。返回结果中每笔订单各自带一个结果对象，包含独立的 code 和 msg，请逐一检查返回列表中的每一项以确认每笔订单的实际执行结果。

• 合约交易
  暂不支持reduce-only订单

• 杠杆交易
  杠杆下单会自动借贷

• 订单检查

  • 合约：Price下单价格要满足价格乘数priceMultiplier的倍数，并且符合pricePrecision小数位。qty要满足大于 minTradeUSDT并且满足sizeMultiplier的倍数

  • 现货：price要满足小数位。qty下单数量必须要大于minTradeUSDT

  • 相关参数可以通过这里获取；

• 开仓逻辑

  • 双向持仓
    开多： side=buy & posSide=long
    开空：side=sell & posSide=short
    平多：side=sell & posSide=long
    平空：side=buy & posSide=short
    

  • 单向持仓
    开多 side
    开空 side
    平多 side reduceOnly
    平空 side reduceOnly
    

• 订单持有上限:

  • 具体上限可以通过这里获取，相关字段：
    • maxSymbolOrderNum：单个交易对维度的最大委托数量
    • maxProductOrderNum：同一业务线下所有交易对的最大委托数量

• 请求监控:
  将针对您的 API 请求进行统计监控，当单日 (UTC 0点 - UTC 24点) 单账号（母账号和子账号整体运算）订单总数超过一定上限，平台将保留提醒、警告，以及进行必要性限制的权利。 使用API的客户预设接收本条款并负有配合调整的义务。

• API Broker返佣标识:
  需在HTTP Header请求头中添加如下代码块

  "X-CHANNEL-API-CODE":"your-channel-api-code"

• 币本位合约说明:
  

  • 新币本位业务线symbol格式为"XXXUSD_CM"，例如BTCUSD交易对在币本位合约的格式为BTCUSD_CM
  • 新币本位暂时不支持修改订单

• 注意：操作订单时出现 40010 40725 45001 错误码，请用clientOid查询订单详情，以确认操作的最终结果

Code
{
    "op": "trade",
    "id": "1750035029506",
    "category": "spot",
    "topic": "batch-place",
    "args": [
        {
            "clientOid": "xxxxxxxx",
            "orderType": "limit",
            "price": "100",
            "qty": "0.1",
            "side": "buy",
            "symbol": "BTCUSDT",
            "timeInForce": "gtc"
        },
        {
            "clientOid": "xxxxxxxx",
            "orderType": "limit",
            "price": "100",
            "qty": "0.15",
            "side": "buy",
            "symbol": "BTCUSDT",
            "timeInForce": "gtc"
        }
    ]
}

Code
{
  "event": "trade",
  "id": "1750035029506",
  "category": "spot",
  "topic": "batch-place",
  "args": [
    {
      "code": "0",
      "msg": "Success",
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx",
      "receiveTime": "1750034396998123",
      "pushTime": "1750034397076456"
    },
    {
      "code": "0",
      "msg": "Success",
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx",
      "receiveTime": "1750034396999456",
      "pushTime": "1750034397077789"
    }
  ],
  "code": "0",
  "msg": "Success",
  "connId": "xxxxxxxxxx",
  "rateLimit": [
    {
      "limit": "10",
      "remaining": "9"
    }
  ],
  "ts": "1750035029925"
}