sifting/io
GET/v1/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.

Auth
X-API-Key header
Format
JSON
Rate limits
Per-key, see limits

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

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.

Response fields

Field
events[]array
Upcoming economic releases, ascending by scheduled_at.
events[].event_idstring
Stable recurring-event identifier, e.g. us_cpi; same value for every recurrence.
events[].namestring
Human-readable event label.
events[].countrystring
ISO 3166-1 alpha-2 country code.
events[].currencystring
Most-affected currency (ISO 4217).
events[].agencystring
Issuing agency.
events[].impactstring
Market-impact tier: low | medium | high.
events[].scheduled_atstring (RFC 3339)
Official scheduled release time, UTC.
events[].actualfloat
Reported value once released; currently null.
events[].previousfloat
Prior period's value; currently null.
events[].consensusfloat
Consensus estimate; currently null.
events[].released_atstring (RFC 3339)
Actual release time; currently null.
countinteger
Number of events returned.
filterobject
Echo of the applied filter, including resolved defaults.
filter.fromstring (RFC 3339)
Resolved lower bound on scheduled_at.
filter.tostring (RFC 3339)
Resolved upper bound on scheduled_at.
filter.countrystring
Applied country filter.
filter.impactstring
Applied impact filter; empty when unset.
filter.agencystring
Applied agency filter; empty when unset.
filter.event_idstring
Applied event_id filter; empty when unset.
filter.limitinteger
Applied page size.

Reference

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