sifting/io
Fundamentals · Economic calendar API

Upcoming US macro releases, timestamped in UTC.

One REST endpoint returns a UTC-timestamped schedule of upcoming US economic releases: 25 recurring event types including CPI, NFP, and FOMC, each with an impact tier, issuing agency, and scheduled release time. Filter by date, impact, agency, or event, under the same credential and JSON schema as the rest of the SiftingIO API.

Get an API keyView calendar exampleRead the API reference
Back to Fundamentals
  • 25US event types
  • RFC 3339UTC timestamps
  • RESTForward schedule
  • 1 credentialAcross the platform
Capabilities

A macro calendar, as clean JSON.

Sourced from official agency calendars and normalized into one shape. Every event carries a stable identifier, its issuing agency, an impact tier, and an RFC 3339 UTC release time, so your client stays the same as coverage grows.

Forward release schedule

A single GET returns upcoming US releases ordered by scheduled release time. All parameters are optional, so the default response is the next 30 days of events with no query to construct.

UTC timestamps on every event

Each release carries an RFC 3339 UTC scheduled_at, so you convert to any local session and align a release to the exact price bar it lands in, with no timezone guesswork.

Impact tiers

Every event is tagged low, medium, or high market-impact, so you can watch only the releases that move markets and skip the routine prints.

Issuing agency on each record

Events carry their source agency, from BLS and BEA to the Fed, Census, and more, so you can filter to a single publisher or reconcile against an official calendar.

Filter and page

Narrow by date range, country, impact tier, agency, or a specific event_id, and page with limit. The response echoes the resolved filter so a request is always reproducible.

One credential across the platform

The same API key that authenticates prices, DEX, and fundamentals reads the calendar. Add the endpoint to your workload without rotating credentials.

API · Economic calendar

One GET returns the release schedule.

Authenticate with the same API key as every other product, then filter by impact, agency, event, or date range. Results are always sorted ascending by scheduled release time.

GET · high-impact, next 10
curl -H "X-API-Key: $KEY" \
  "https://api.sifting.io/v1/fnd/economic-calendar?impact=high&limit=10"
200 OK · application/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
    }
  ],
  "count": 1,
  "filter": { "impact": "high", "limit": 10 }
}
Coverage

Events, agencies, and impact tiers covered.

A representative sample of the 25 recurring US event types is shown below, each tagged with its issuing agency and market-impact tier. Coverage is US-only at this time and expands as each dataset meets our quality bar. Need an event or region you don’t see? Request it →

Event types

25 recurring
  • Consumer Price Index (CPI)
  • Nonfarm Payrolls (NFP)
  • FOMC Rate Decision
  • FOMC Minutes
  • GDP
  • PCE Price Index
  • Retail Sales
  • ISM Manufacturing PMI
  • ISM Services PMI
  • Jobless Claims
  • Producer Price Index (PPI)
  • JOLTS Job Openings
  • Consumer Confidence
  • Michigan Sentiment

+ more

Agencies

Official sources
  • BLS
  • BEA
  • Census
  • Fed
  • DOL
  • EIA
  • ISM
  • ConferenceBoard
  • UMich
  • NAR
  • Treasury

Impact tiers

Market-impact
  • High impact
  • Medium impact
  • Low impact
Built for

Where teams put the economic calendar to work.

Release alerts (CPI, NFP)

Poll on a schedule, filter by event_id or impact tier, and fire your own notification when a new event appears or a value changes. Build CPI and NFP alerts on top of the polling endpoint.

Event-aware backtesting

Because every event is UTC-timestamped, you can align a release to the exact price bar it lands in and study pre and post-release moves across crypto, forex, and equities in one client.

Dashboards and calendars

Render an upcoming-events calendar or macro dashboard from one endpoint, tagged with impact and agency, sharing one schema and one credential with your live price feeds.

Risk and volatility windows

Flag high-impact windows ahead of time to widen spreads, pause automated strategies, or size positions around scheduled volatility, without stitching in a separate macro vendor.

FAQ

Economic calendar API, frequently asked.

What is the economic calendar API endpoint?

A single GET request to /v1/fnd/economic-calendar returns a schedule of upcoming US economic releases. All parameters are optional; by default it returns the next 30 days of US events ordered by scheduled release time. Authenticate with an X-API-Key header.

Which economic events does the API cover?

Twenty-five recurring US event types sourced from official agency calendars, including the Consumer Price Index (CPI), Nonfarm Payrolls (NFP), the FOMC rate decision, GDP, PCE, retail sales, ISM Manufacturing and Services PMIs, and weekly jobless claims. Each event carries a stable event_id, its issuing agency (for example BLS, BEA, or the Fed), and a low, medium, or high market-impact tier. Coverage is US-only at this time.

What fields does each economic event return?

event_id, name, country, currency, agency, impact, and scheduled_at, an RFC 3339 UTC timestamp for the official release time. The schema also includes actual, previous, consensus, and released_at fields for the released figures; these populate as release parsing and consensus aggregation ship, so today the endpoint reliably delivers the forward release schedule.

Does the API return actual figures and forecasts?

Not yet. The response schema carries actual, consensus (the market forecast), previous, and released_at fields alongside every scheduled event, and these are being populated as release parsing rolls out, so today the endpoint delivers the forward release schedule rather than released values. Because each record is UTC-timestamped and can be re-polled, a consumer can detect when a value changes after first release and reconcile the revision on its own side. There is no separate revisions endpoint.

What timezone are the release times in?

All release timestamps are RFC 3339 UTC, for example 2026-05-13T12:30:00Z. Date-only query bounds are ISO 8601 and interpreted as midnight UTC. Working in one fixed zone lets you convert to any local session and align a release to the exact price bar it lands in.

How do I filter and page through results?

Use optional query parameters: from and to (a date range up to 365 days), country, impact tier, agency, and event_id. Page size is set with limit (1 to 500, default 100). The response returns an events array, a count of events returned, and an echo of the resolved filter. Results are always sorted ascending by scheduled release time.

Is there a free economic calendar API tier?

Yes. The free tier allows 30 requests per minute and 5,000 per day, and higher tiers raise those limits. When you exceed a limit the API returns 429 Too Many Requests with a Retry-After header. Responses are cached for up to five minutes per unique filter.

How do I build release alerts, such as a CPI or NFP alert?

Poll the endpoint on a schedule and compare against what you last saw. Filter by event_id (for example us_cpi) or by impact tier to watch only high-impact releases, then trigger your own notification when a new event appears or a value changes. There is no native webhook; alerting is a build-your-own pattern on top of the polling endpoint.

Related guidesWhat is fundamental data?
99.9% SLA · UTC-timestamped · Same credential

Start building with the economic calendar.

Free tier included, no sales call required. Hit the economic calendar endpoint over REST with the same auth, same schema, and same SLA as every other SiftingIO product.

Get an API keyTalk to sales