Events Overview
Events are structured records of discrete market developments that may impact prices or fundamentals.
What is an Event?
An Event captures a specific market occurrence such as an outage, policy change, or supply disruption in a structured format. Events are designed to:
- Provide systematic tracking of market-moving developments
- Enable quantitative analysis of event impacts
- Support timely alerting and historical research
Event Structure
Each event includes:
| Field | Description |
|---|---|
event_key | Unique identifier, an MD5 of type, date and scope |
event_date | The date the event fired |
event_type | Category, for example GBSI_REGIME_SHIFT |
event_name | Human-readable label |
event_tier | Severity tier |
event_direction | Direction of the change, where one applies |
magnitude_score | Size of the move that triggered it |
magnitude_bucket | Banded magnitude |
str_effective_at | When the event became publicly knowable |
str_observed_at | When Snowtrail could first have held it |
str_ingested_at | When this row was written |
An event fires on a transition into a state, not on every day the state holds, so consecutive-day duplicates are not expected.
Event Categories
Events are organised by type:
- Outages - Unplanned supply disruptions
- Maintenance - Scheduled maintenance activities
- Policy - Regulatory or policy changes
- Weather - Weather-related disruptions
- Infrastructure - Capacity or infrastructure changes