This endpoint is designed to replace an existing limit order with a new one. Upon replacement, the order will be assigned a new order_id while retaining the original customer_order_id. The operation will fail if the limit order no longer exists in the order book (e.g., if it has been canceled, filled, or otherwise removed).

When modifying quantity, providing a positive value (e.g., "0.5") has different effects depending on the order type. For LONG (BUY) orders, it increases the position size in the existing direction - for example, if the current position is BUY 1.0, setting size to "0.5" would result in BUY 1.5. However, for SHORT (SELL) orders, providing "0.5" decreases the sell quantity - if the current position is SELL 1.0, it would result in SELL 0.5.

Response Codes

Code	Description	Status
200	Successfully replaced	success
404	An order with provided id not found.	rejected
422	Order was rejected by the protocol	rejected
409	A conflict occurred, typically due to an existing order with the same customer order ID	rejected
500	Unexpected errors or blockchain node malfunction	unknown

Cost

Each request to this endpoint costs 1 API credit

200200

404404