sifting/io
GET/fnd/economic-calendar

Upcoming US economic events

Schedule of upcoming US economic releases, CPI, NFP, FOMC, GDP, etc., sourced from official agency calendars. Filter by date range, impact tier, agency, or specific event_id. All parameters are optional; defaults return the next 30 days of US events ordered by scheduled_at.

Parameters

Parameter
fromISO date / RFC3339 · query
Inclusive lower bound on scheduled_at. Defaults to now (UTC). Accepts 2026-05-13 (interpreted as midnight UTC) or 2026-05-13T12:30:00Z.
toISO date / RFC3339 · query
Exclusive upper bound on scheduled_at. Defaults to from + 30 days. Must be strictly after from. Max range = 365 days.
countrystring (ISO 3166-1 α-2) · query
Filter by country code. Defaults to US (US events only at this time).
impactenum · query
low | medium | high, relative market-impact tier.
agencyenum · query
BLS | BEA | Census | Fed | DOL | EIA | ISM | ConferenceBoard | UMich | NAR | Treasury, issuing agency.
event_idstring · query
Recurring event identifier (e.g. us_cpi). See the coverage table above for valid IDs.
limitinteger · query
Page size, 1–500. Default 100.

Example

request · shell
curl -H "X-API-Key: $KEY" \
  "https://api.sifting.io/v1/fnd/economic-calendar?impact=high&limit=10"
200OKapplication/json
{  "events": [    {      "event_id": "us_cpi",      "name": "US Consumer Price Index",      "country": "US",      "currency": "USD",      "agency": "BLS",      "impact": "high",      "scheduled_at": "2026-05-13T12:30:00Z",      "actual": null,      "previous": null,      "consensus": null,      "released_at": null    },    {      "event_id": "us_fomc_decision",      "name": "FOMC Rate Decision",      "country": "US",      "currency": "USD",      "agency": "Fed",      "impact": "high",      "scheduled_at": "2026-06-17T18:00:00Z",      "actual": null,      "previous": null,      "consensus": null,      "released_at": null    }  ],  "count": 2,  "filter": {    "from": "2026-05-04T00:00:00Z",    "to": "2026-06-30T00:00:00Z",    "country": "US",    "impact": "high",    "agency": "",    "event_id": "",    "limit": 100  }}
Loading runner…
First load only

Reference

Field reference
event_id
Stable identifier for the recurring event, same value for every monthly recurrence
name
Human-readable label
country
ISO 3166-1 α-2 code
currency
Most-affected currency (ISO 4217)
agency
Issuing agency
impact
low / medium / high, market-impact tier
scheduled_at
RFC3339 UTC timestamp, official scheduled release time
actual / previous / consensus / released_at
Currently null, populated as release-page parsers and consensus aggregation ship
count
Number of events returned
filter
Echo of the applied filter, including resolved defaults
Caching & sort
sort
Always ascending by scheduled_at
Server-side cache
5 minutes per unique filter, upper bound on how long a newly-published date takes to surface
HTTP
Cache-Control: public, max-age=60
Rate limits by tier
Free
30 calls/minute · 5,000 calls/day
Pro
300 calls/minute · 100,000 calls/day
Business
1,500 calls/minute · unlimited per day
429
Too Many Requests with a Retry-After header on overage
Example variations
all CPI · year
?event_id=us_cpi&from=2026-05-04&to=2026-12-31
Fed · next month
?agency=Fed&from=2026-06-01&to=2026-07-01
top 10 upcoming
?limit=10