Modify Order (TRADE)

API Description

Order modify function, currently only LIMIT order modification is supported, modified orders will be reordered in the match queue

HTTP Request

PUT /dapi/v1/order

Request Weight

1

Request Parameters

Name	Type	Mandatory	Description
orderId	LONG	NO
origClientOrderId	STRING	NO
symbol	STRING	YES
side	ENUM	YES	SELL, BUY
quantity	DECIMAL	NO	Order quantity, cannot be sent with closePosition=true. After CM migration, this parameter becomes mandatory (must be sent together with price).
price	DECIMAL	NO	After CM migration, this parameter becomes mandatory (must be sent together with quantity).
priceMatch	ENUM	NO	only 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
modifyId	INT	NO	User-defined modification identifier, returned as-is in the response. Optional; not validated for uniqueness.
recvWindow	LONG	NO
timestamp	LONG	YES

• Either orderId or origClientOrderId must be sent, and the orderId will prevail if both are sent.
• Either quantity or price must be sent. (After CM migration, both quantity and price are required.)
• When the new quantity or price doesn't satisfy PRICE_FILTER / PERCENT_FILTER / LOT_SIZE, amendment will be rejected and the order will stay as it is.
• However the order will be cancelled by the amendment in the following situations:
  • when the order is in partially filled status and the new quantity <= executedQty
  • When the order is GTX and the new price will cause it to be executed immediately
• One order can only be modfied for less than 10000 times
• modifyId is an optional user-defined identifier passed through as-is; the server does not validate its uniqueness. If omitted, it is not included in the response.

Response Example

{
 	"orderId": 20072994037,
 	"symbol": "BTCUSD_PERP",
 	"pair": "BTCUSD",
 	"status": "NEW",
 	"clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW",
 	"modifyId": 1,                      //user-defined modification identifier, only returned if provided in the request
 	"price": "30005",
 	"origQty": "1",
 	"executedQty": "0",
 	"cumQty": "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": "EXPIRE_MAKER",  //self trading preventation mode
 	"updateTime": 1629182711600
}