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

OrderTriggered

OrderTriggered records that a limit‑style conditional order has triggered. The execution pipeline applies it to the order, updates the Cache, and publishes it on the MessageBus. A trading venue, simulated matching engine, or reconciliation can report the trigger for a StopLimit, LimitIfTouched, or TrailingStopLimit order.

Typical transition: ACCEPTED -> TRIGGERED. Handler: on_order_triggered.

Fields

Beyond the common Python order event fields, OrderTriggered carries:

FieldPython typeRequired/defaultDescription
venue_order_idVenueOrderId or NoneNoneThe venue‑assigned order identifier, if known.
account_idAccountId or NoneNoneThe account associated with the order, if known.
reconciliationboolRequiredIf generated during reconciliation.

Example

Reading the event in a strategy handler:

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

On this page