NautilusTrader
ConceptsEvents
These docs track the unreleased nightly build and may change without notice. Switch to the latest stable docs.

OrderUpdated

OrderUpdated represents an order having been updated at the trading venue. The ExecutionEngine applies it to the order, updates the Cache, and publishes it on the MessageBus. It fires when the venue confirms a modification to quantity, price, or trigger price.

Transition: PENDING_UPDATE -> previous status (for example ACCEPTED). Handler: on_order_updated.

Fields

Beyond the common order event fields, OrderUpdated carries:

FieldPython typeRequired/defaultDescription
quantityQuantityRequiredThe order's current quantity.
pricePrice or NoneRequiredThe order's current price.
trigger_pricePrice or NoneRequiredThe order's current trigger price.
is_quote_quantityboolFalseIf the order quantity is denominated in the quote currency.

On this event, venue_order_id and account_id are usually populated but may be None, and reconciliation carries a real value.

Example

Reading the event in a strategy handler:

def on_order_updated(self, event: OrderUpdated) -> None:
    self.log.info(
        f"Order {event.client_order_id} updated: "
        f"qty={event.quantity} price={event.price}",
    )
  • Events - Event categories, dispatch, and the common order event fields.
  • Orders - Order types and the state machine.

On this page