Skip to main content

Modify Order

POST

{BASE_URL}/orders/modify

Replaces a working whole-quantity order with a new order that has its own replacement_order_id. Symbol, side, position effect, account and end customer are carried over from the original; everything in the request body describes the replacement. time_in_force is carried over when omitted, but trading_session_ids is not.

The request is asynchronous. 201 means the replacement was accepted; the outcome arrives on the WebSocket as replaced or replace_rejected.

Fails with DisallowedOrderAction_Error when the original order is in a terminal state, expired, suspended, or already pending replace or cancel. IPO orders cannot be modified; cancel and place a new order instead.

Request​

Responses​

Replacement accepted.