event condition

Back to builder reference

Condition

event

entrygate

React to external events (FOMC, earnings)

Required fields

FieldTypeDescription

eventreqoneOf (2 variants)Which event to trigger on (custom event_type_id)

Optional fields

FieldTypeDescription

modeenum: within, outsideTrigger behavior: within = condition is True inside the window, outside = condition is True outside the window (for blocking)

offset_barsanyOf (2 variants)Bars before/after event for pre/post triggers. For in_window: PRE-event side.

offset_minutesanyOf (2 variants)Minutes before/after event for pre/post triggers (wall-clock). For in_window: PRE-event side.

trigger_typeenum: pre_event, post_event, in_windowWhen to trigger relative to event: pre_event = N units before, post_event = N units after, in_window = asymmetric window from `offset_*` units before to `window_*` units after the event (window_* falls back to offset_* if omitted, giving a symmetric window). NOTE: forward-looking triggers (pre_event, in_window) on a SYSTEM event require a scheduled event with a forward release calendar (currently macro.cpi, macro.nonfarm_payrolls, macro.unemployment). Using them on any other system event (e.g. corporate.split, earnings.filing, un-scheduled macro releases) is rejected at compile time, because the platform cannot anticipate the event ahead of time — use post_event to react after it occurs. Custom events are unrestricted.

typestring-

window_barsanyOf (2 variants)For in_window: POST-event side in bars. Falls back to offset_bars if omitted (symmetric window).

window_minutesanyOf (2 variants)For in_window: POST-event side in minutes. Falls back to offset_minutes if omitted (symmetric window).