Modify active order
PATCH/v1/trading/accounts/:account_id/orders/:order_id
Modifies active pending or SLTP order parameters.
Runtime restrictions:
- unavailable if trade_mode is trading_disabled
- unavailable if account_status is close_only
Supported changes:
- price
- stop_loss_price
- take_profit_price
For stop_loss_price and take_profit_price:
- omitted field is not changed
- string value sets a new SL/TP price
nullremoves the corresponding SL/TP value
The method returns ACK response. Final transaction result is delivered through Server Events.
Consistency and recovery notes:
- Closed positions and final-state orders are retained for 1 month (subject to clarification).
- If
operation_idis not received in the REST ACK response, or is not received in Server events subscription, or an unknownoperation_idis received, the client should restart Server events subscription and reconcile state using snapshots of currently open positions and pending orders.
Request
Responses
- 202
- 400
- 401
- 403
- 410
- 500
ACK
Bad Request
Authorization failed
Forbidden
The API key does not have permission to perform trading operations. For example, ReadOnly API keys can only call read methods.
Invalid account
Internal Server Error
The server encountered an unexpected condition that prevented it from fulfilling the request.