Skip to main content

Events

GBSI-US Events surface discrete developments that materially affect the US gas balance.

They highlight periods where conditions deviate meaningfully from normal behaviour, complementing the continuous view provided by signals.

What GBSI-US Events capture​

Events may reflect:

  • Abrupt changes in demand conditions
  • Supply disruptions or recoveries
  • Structural shifts in balance dynamics
  • Periods where stress thresholds are breached

Events are time-bounded, allowing users to analyse when a development began, how long it persisted, and how conditions evolved thereafter.

Recent weeks are provisional: the daily run restates the last 180 days as late supply and power-burn data arrive. When a restatement removes a regime transition, the event is kept and marked event_status = 'SUPERSEDED' (superseded_by_source = DATA_REVISION, with superseded_at). Filter on event_status = 'ACTIVE' for the current set.

Typical use cases​

  • Monitoring emerging stress conditions
  • Post-event analysis and attribution
  • Reviewing historical stress episodes

Accessing GBSI-US Events​

from snowtrail import Snowtrail
client = Snowtrail(api_key="your-api-key")

# Fetch GBSI-US events (e.g. storage surprise)
df = client.gbsi_us.storage_surprise(date_from="2024-01-01")

# All methods return pandas DataFrames
print(df.head())

GBSI-US Events provide discrete context around changes in balance conditions.