Skip to main content

Modify Multiple Orders(TRADE)

API Description#

Modify Multiple Orders (TRADE)

HTTP Request#

PUT /fapi/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

NameTypeMandatoryDescription
orderIdLONGNO
origClientOrderIdSTRINGNO
symbolSTRINGYES
sideENUMYESSELL, BUY
quantityDECIMALYESOrder quantity, cannot be sent with closePosition=true
priceDECIMALYES
priceMatchENUMNOonly avaliable for LIMIT/STOP/TAKE_PROFIT order; can be set to OPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20: /QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20; Can't be passed together with price
recvWindowLONGNO
timestampLONGYES
  • Parameter rules are same with Modify Order
  • Batch modify orders are processed concurrently, and the order of matching is not guaranteed.
  • The order of returned contents for batch modify orders is the same as the order of the order list.
  • One order can only be modfied for less than 10000 times
  • selfTradePreventionMode isn't supported for modify order, modify order will set order's selfTradePreventionMode to NONE

Response Example#

[    {        "orderId": 20072994037,        "symbol": "BTCUSDT",        "pair": "BTCUSDT",        "status": "NEW",        "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW",        "price": "30005",        "avgPrice": "0.0",        "origQty": "1",        "executedQty": "0",        "cumQty": "0",        "cumBase": "0",        "timeInForce": "GTC",        "type": "LIMIT",        "reduceOnly": false,        "closePosition": false,        "side": "BUY",        "positionSide": "LONG",        "stopPrice": "0",        "workingType": "CONTRACT_PRICE",        "priceProtect": false,        "origType": "LIMIT",        "priceMatch": "NONE",              //price match mode        "selfTradePreventionMode": "NONE", //self trading preventation mode        "goodTillDate": 0,                 //order pre-set auot cancel time for TIF GTD order        "updateTime": 1629182711600    },    {        "code": -2022,         "msg": "ReduceOnly Order is rejected."    }]