批量下单

支持单次批量下20单,要求必须是同一交易对。

请求示例

POST /api/v3/batchOrders?batchOrders=[{"type": "LIMIT_ORDER","price": "40000","quantity": "0.0002","symbol": "BTCUSDT","side": "BUY","newClientOrderId": 9588234},{"type": "LIMIT_ORDER","price": "4005","quantity": "0.0003","symbol": "BTCUSDT","side": "SELL"}]

返回示例

{ //成功返回：
  [
    {   
      "symbol": "BTCUSDT",   
      "orderId": "1196315350023612316",   
      "orderListId": -1 
    },
    {   
      "symbol": "BTCUSDT",   
      "orderId": "1196315350023612318",   
      "orderListId": -1 
    }
  ],
  //有失败的返回：
  [
    { 
      "symbol": "BTCUSDT", 
      "orderId": "1196315350023612316", 
      "newClientOrderId": "hio8279hbdsds", 
      "orderListId": -1 
    },
    { 
      "newClientOrderId": "123456",
      "msg": "The minimum transaction volume cannot be less than：0.5USDT", 
      "code": 30002
    },
    { 
      "symbol": "BTCUSDT", 
      "orderId": "1196315350023612318", 
      "orderListId": -1 
    }
  ] 
}

HTTP请求

• POST /api/v3/batchOrders

接口权限要求: 现货交易信息写 / SPOT_DEAL_W

限速规则: 与撤单接口共享，12次/秒

请求参数

名称	类型	是否必需	说明
batchOrders	LIST	是	订单列表，最多支持20个订单(list of JSON格式填写订单参数,参考请求示例)
symbol	string	是	交易对
side	ENUM	是	详见枚举定义：订单方向
type	ENUM	是	详见枚举定义：订单类型
quantity	decimal	否	委托数量
quoteOrderQty	decimal	否	委托总额
price	decimal	否	委托价格
newClientOrderId	string	否	客户自定义的唯一订单ID
stpMode	string	否	""-默认值，不限制自成交。“CANCEL_MAKER”-取消maker单。“CANCEL_TAKER”-取消taker单。“CANCEL_BOTH”-双方都取消。
recvWindow	long	否	赋值不能大于 60000
timestamp	long	是

基于订单 type不同，强制要求某些参数:

类型	强制要求的参数
LIMIT	quantity, price
MARKET	quantity or quoteOrderQty

返回参数

参数名	数据类型	说明
symbol	string	交易对
orderId	string	订单id