Economic calendar

Scheduled economic releases with forecasts, actual figures, revisions and each series' history - the terminal's calendar panel.

The calendar is the one the terminal's calendar panel shows: official US release schedules and figures (statistics agencies and the central bank), other countries' events and crypto events, each with its importance (1 to 3), unit, previous figure, forecast and, once released, the actual figure and when ChartDeck saw it.

An event is one scheduled release (status scheduled, released, delayed or cancelled). actual is null until the release; revised is the previous period's figure as the release revised it.
A series is the indicator behind events (for example US CPI month on month); its history lists every released figure.
forecast_kind says what the forecast is (a published consensus, a nowcast ...); the attribution names who published each figure.

#Operations

Operation	Summary
`GET /v1/calendar/events`	Economic calendar events in a time range (scheduled, released, revised)
`GET /v1/calendar/events/{id}`	One event with its revision history and change log
`GET /v1/calendar/series`	The calendar series (indicators) with country, category, unit and importance
`GET /v1/calendar/series/{id}/history`	A series' released figures, newest first

#Typical calls

Shell

# this week's high-importance US events
curl "https://api.chartdeck.trade/v1/calendar/events?from=2026-11-02T00:00:00Z&to=2026-11-09T00:00:00Z&country=US&importance=3" \
  -H "Authorization: Bearer $CHARTDECK_API_KEY"

Python

for ev in client.calendar.iter_list_events(from_="2026-11-02T00:00:00Z", country="US", importance=3):
    print(ev["at"], ev["name"], ev["forecast"], ev["actual"])

For releases the moment they happen, subscribe to the calendar stream channel or a calendar.release webhook instead of polling.