v2

latestOpenAPI 3.1.0Proprietary2026-08-05143259.2 KB

calendar

Scheduled US macro releases (economic calendar)

The official forward schedule of US macro releases: FOMC decisions (with SEP and press-conference markers) and minutes, CPI, PPI, the jobs report (nonfarm payrolls), GDP estimates (advance/second/third), PCE, advance retail sales, weekly jobless claims and JOLTS — sourced from the agencies' own schedule pages (Fed, BLS, BEA, Census, DOL).

Each occurrence carries a stable uid (US-CPI-2026-07) that survives reschedules: a moved release keeps its identity, updates scheduled_at and reports schedule_status. phase says only whether the scheduled moment has passed (upcoming/elapsed) — it deliberately does not claim the agency actually published. Pair the calendar with /api/news/macro/ to read what a release meant once it's out.

The window is [from_date, to_date) — from inclusive, to exclusive; date-only values mean UTC midnight; defaults are today (UTC) → +7 days; the span is capped at 400 days. No pagination: a full year of every series is ~250 rows (hard cap 500), ordered by scheduled_at ascending. Cancelled and postponed occurrences stay in the response with their schedule_status.

get/api/calendar/

Query parameters

from_datestring

Example:2026-08-07

Window start, inclusive. YYYY-MM-DD (UTC midnight) or an ISO datetime (naive = UTC). Default: today, UTC midnight.

to_datestring

Example:2026-08-14

Window end, exclusive. Same formats. Default from_date + 7 days; span capped at 400 days.

event_keystring

Example:cpi,nfp,fomc_decision

Narrow to specific series, comma-separated. Unknown keys return 400.

importance'high' | 'medium' | 'low'

Narrow by importance tier.

country'US'

v1 covers US releases only.

Response

Occurrences within the window, scheduled_at ascending.

Example response

{
  "events": [
    {
      "uid": "US-CPI-2026-07",
      "title": "CPI (Consumer Price Index)",
      "reference_period": "2026-07",
      "country": "US"
    }
  ]
}