Skip to main content

Place Multiple Orders(TRADE)

API Description#

Place multiple orders

  • Parameter rules are same with New Order
  • Batch orders are processed concurrently, and the order of matching is not guaranteed.
  • The order of returned contents for batch orders is the same as the order of the order list.

HTTP请求#

POST /dapi/v1/batchOrders

Request Weight#

5

Request Parameters#

NameTypeMandatoryDescription
batchOrdersLIST\<JSON>YESorder list. Max 5 orders
recvWindowLONGNO
timestampLONGYES

Where batchOrders is the list of order parameters in JSON

  • Example: /dapi/v1/batchOrders?batchOrders=[{"type":"LIMIT","timeInForce":"GTC",
    "symbol":"BTCUSD_PERP","side":"BUY","price":"10001","quantity":"1"}]
NameTypeMandatoryDescription
symbolSTRINGYES
sideENUMYES
positionSideENUMNODefault BOTH for One-way Mode ; LONG or SHORT for Hedge Mode. It must be sent with Hedge Mode.
typeENUMYES
timeInForceENUMNO
quantityDECIMALYES
reduceOnlySTRINGNO"true" or "false". default "false".
priceDECIMALNO
newClientOrderIdSTRINGNOA unique id among open orders. Automatically generated if not sent. Can only be string following the rule: ^[\.A-Z\:/a-z0-9_-]{1,36}$
stopPriceDECIMALNOUsed with STOP/STOP_MARKET or TAKE_PROFIT/TAKE_PROFIT_MARKET orders.
activationPriceDECIMALNOUsed with TRAILING_STOP_MARKET orders, default as the latest price(supporting different workingType)
callbackRateDECIMALNOUsed with TRAILING_STOP_MARKET orders, min 0.1, max 4 where 1 for 1%
workingTypeENUMNOstopPrice triggered by: "MARK_PRICE", "CONTRACT_PRICE". Default "CONTRACT_PRICE"
priceProtectSTRINGNO"TRUE" or "FALSE", default "FALSE". Used with STOP/STOP_MARKET or TAKE_PROFIT/TAKE_PROFIT_MARKET orders.
newOrderRespTypeENUMNO"ACK", "RESULT", default "ACK"

Response Example#

[    {        "clientOrderId": "testOrder",        "cumQty": "0",        "cumBase": "0",        "executedQty": "0",        "orderId": 22542179,        "avgPrice": "0.0",        "origQty": "10",        "price": "0",        "reduceOnly": false,        "side": "BUY",        "positionSide": "SHORT",        "status": "NEW",        "stopPrice": "9300",             // please ignore when order type is TRAILING_STOP_MARKET        "symbol": "BTCUSD_200925",        "pair": "BTCUSD",        "timeInForce": "GTC",        "type": "TRAILING_STOP_MARKET",        "origType": "TRAILING_STOP_MARKET",        "activatePrice": "9020",         // activation price, only return with TRAILING_STOP_MARKET order        "priceRate": "0.3",              // callback rate, only return with TRAILING_STOP_MARKET order        "updateTime": 1566818724722,        "workingType": "CONTRACT_PRICE",        "priceProtect": false            // if conditional order trigger is protected    },    {        "code": -2022,         "msg": "ReduceOnly Order is rejected."    }]