Order execution states
Every order execution associated with an order has its own set of states to provide a more detailed picture of the status of the order processing.
| State | Description |
|---|---|
FILLED | The order was FILLED in full or in part by the trading partner, depending on the execution amount. The securities and cash positions were updated accordingly. |
SETTLED | The order execution has been settled (duration depends on the asset class, e.g., money market funds or investment funds). For sell orders, this means that the cash can now be withdrawn. |
CANCELLED | The order execution has been cancelled due to an error at the trading partner, i.e. a mistrade. |
Every time a state changes, Upvest emits a webhook event. For more information, see how to subscribe to the webhooks.
Order execution state transitions
FILLED to SETTLED
In order for an order execution to change from the FILLED to SETTLED status, the following condition must be met:
- The order execution must have been settled by our custodian bank.
For sell orders, the cash can be withdrawn as soon as the order execution changes to the SETTLED status.