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