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

OrderSubmitted

OrderSubmitted represents an order having been submitted by the system to the trading venue. The ExecutionEngine applies it to the order, updates the Cache, and publishes it on the MessageBus. It fires when the system sends the order to the venue and awaits acknowledgement.

Transition: INITIALIZED / RELEASED -> SUBMITTED. Handler: on_order_submitted.

Fields

OrderSubmitted carries only the common order event fields. On this event, account_id is populated, venue_order_id is not yet assigned (None), and reconciliation is always False.

Example

Reading the event in a strategy handler:

def on_order_submitted(self, event: OrderSubmitted) -> None:
    self.log.info(f"Order {event.client_order_id} submitted ({event.account_id})")
  • Events - Event categories, dispatch, and the common order event fields.
  • Orders - Order types and the state machine.

On this page