Economic Calendar API: FOMC, ECB, CPI, GDP

This Actor returns an official economic calendar. It reads the release calendars of statistics offices and the meeting calendars of central banks. Every row is one scheduled event: a data release, a central bank rate decision or a set of minutes.

Each row has the country, the agency, the event name, the local date and time with its time zone, the exact UTC time, the period the release covers and a link to the official page. Central bank rows carry the current policy rate. With your own free FRED key, main U.S. releases also get their actual and previous values.

Use it to plan trading days, set alerts before CPI or a rate decision, fill a market dashboard, or give an AI agent the dates it needs. Turn on change-only mode and schedule it to hear about new dates, moved dates and new values.

Economic calendar coverage

Counted on 21 October 2026 for 1 January 2026 to 31 December 2027, without a FRED key. That run returned 1,012 events.

Country	Agency	Code	Events	Time of day	Values
United States	Bureau of Economic Analysis	BEA	GDP, personal income and outlays (PCE), trade, regional data	Yes	With FRED key: real GDP, PCE price index
United States	Census Bureau	CENSUS	Retail sales, housing starts, durable goods, construction, wholesale and more	Yes	With FRED key: retail sales, housing starts
United States	Bureau of Labor Statistics	BLS	CPI, jobs report, PPI, JOLTS (dates come from FRED)	No	With FRED key: all four
United States	Federal Reserve	FED	FOMC meetings and minutes; G.17 industrial production with FRED key	No	With FRED key: target range upper limit, industrial production
United Kingdom	Office for National Statistics	ONS	GDP, CPI inflation, labour market, retail sales, trade, public finances	Yes	No
Euro area and EU	Eurostat	EUROSTAT	Euro indicators: flash HICP inflation, GDP, unemployment, industry, retail	No	No
Euro area	European Central Bank	ECB	Governing Council monetary policy decisions	No	Deposit facility rate
Canada	Bank of Canada	BOC	Interest rate announcements and Monetary Policy Reports	No	Target for the overnight rate
Japan	Statistics Bureau of Japan	SBJ	CPI (Japan and Tokyo), Labour Force Survey	No	No

Events per source in that run: BEA 110, Census 313, FOMC 22, ONS 337, Eurostat 154, ECB 10, Bank of Canada 16, Statistics Bureau of Japan 50.

"Time of day: No" means the source gives the date only. Those rows have an empty scheduledTime and scheduledAtUtc. The Actor does not guess a time.

There are no consensus forecasts. Forecasts are made by private data firms and are not in any official source.

Economic calendar data returned

Field	Meaning
country	US, GB, EU, CA or JP
currency	Currency of the country or area: USD, GBP, EUR, CAD or JPY
impact	high, medium or low, from the impact table below
countryName	Country or area in English
agency	Agency code from the table above
agencyName	Agency name
eventType	data-release, central-bank-meeting or central-bank-minutes
eventName	Release or event name as the agency writes it
scheduledDate	Local date at the agency
scheduledTime	Local time, 24-hour. Empty when the source gives none
timezone	Time zone of the local date and time, for example America/New_York
scheduledAtUtc	Exact time in UTC. Empty when the source gives no time
dateStatus	confirmed, or provisional for ONS dates not yet fixed
status	upcoming, released or cancelled at run time
periodCovered	Reference period, for example September 2026
actualValue	Value published at this event
actualValuePeriod	Observation date of the actual value
previousValue	Value before this event
previousValuePeriod	Observation date of the previous value
valueUnit	Unit and measure of the values
valueSeriesId	Official series id of the values
valueSource	FRED, ALFRED, Bank of Canada Valet API or ECB Data Portal
sourceUrl	Official page for the event or the calendar
id	Stable event id, used by change-only mode
changeType	new or changed in change-only mode
scrapedAt	When the Actor collected the event

How the values work:

• Bank of Canada: previousValue is the target rate on the announcement day. For a past announcement, actualValue is the rate on the next business day, when a change takes effect.
• ECB: the calendar lists future meetings only. previousValue is the latest deposit facility rate.
• FRED (your key): for a past release, actualValue and previousValue are the values as first published on the release day (ALFRED vintage). Later revisions do not change them. For an upcoming release, previousValue is the latest value. FOMC rows get the upper limit of the target range before and after the meeting.

Economic calendar impact levels

Every event has an impact level. The level is our own fixed rating by event type. No official source rates impact, so the table below is the whole rule. Use the Minimum impact input to keep only high or medium events. Rows below the minimum are not saved and not charged.

Impact	Events
high	Rate decisions (FOMC, ECB, Bank of Canada). CPI inflation (US BLS, UK ONS, euro area flash and HICP, Japan). Jobs reports (US Employment Situation, UK Labour Market). GDP (US advance, second and third estimates, UK first quarterly and monthly estimates, euro area flash). US Personal Income and Outlays (PCE)
medium	FOMC minutes. Retail sales. Producer prices. Trade balance (US, UK, euro area). Industrial production. US durable goods, housing starts, new home sales and JOLTS. UK quarterly national accounts. Euro area unemployment and GDP main aggregates. Tokyo CPI. Japan Labour Force Survey basic tabulation
low	Every other release, for example construction, public finances, business formation and regional data

How to get an economic calendar

1. Set Days ahead for the upcoming window (default 30) and Days back for recent events (default 7). Or set a Start date and End date.
2. Pick Countries, Agencies or Event types, or leave them empty for all.
3. Add Keywords such as GDP, inflation or retail to narrow the list. Or set Minimum impact to high for market-moving events only.
4. Optional: paste your free FRED API key to add BLS dates and U.S. values. Get a key at fred.stlouisfed.org.
5. Run the Actor. Download the events as JSON, CSV or Excel, or read them through the API.

Input example

{
    "daysAhead": 30,
    "daysBack": 7,
    "countries": ["US", "EU"],
    "eventTypes": ["central-bank-meeting", "data-release"],
    "keywords": ["GDP", "inflation", "FOMC", "ECB"],
    "minImpact": "medium",
    "changeOnly": false,
    "maxItems": 100
}

Output example

This is a real row from a run on 21 October 2026, with the impact and currency fields added on 23 October 2026.

{
    "id": "BOC:BOC rate announcement|2026-01",
    "country": "CA",
    "currency": "CAD",
    "countryName": "Canada",
    "agency": "BOC",
    "agencyName": "Bank of Canada",
    "eventType": "central-bank-meeting",
    "eventName": "Bank of Canada interest rate announcement and Monetary Policy Report",
    "impact": "high",
    "scheduledDate": "2026-01-28",
    "scheduledTime": null,
    "timezone": "America/Toronto",
    "scheduledAtUtc": null,
    "dateStatus": "confirmed",
    "periodCovered": null,
    "sourceUrl": "https://www.bankofcanada.ca/2026/01/fad-press-release-2026-01-28/",
    "actualValue": 2.25,
    "actualValuePeriod": "2026-01-29",
    "previousValue": 2.25,
    "previousValuePeriod": "2026-01-28",
    "valueUnit": "Percent (target for the overnight rate)",
    "valueSeriesId": "V39079",
    "valueSource": "Bank of Canada Valet API",
    "status": "released",
    "changeType": null,
    "scrapedAt": "2026-10-21T14:51:43.750Z"
}

A UK release row from the same run:

{
    "id": "ONS:Consumer price inflation, UK|October 2026",
    "country": "GB",
    "currency": "GBP",
    "agency": "ONS",
    "eventType": "data-release",
    "eventName": "Consumer price inflation, UK: October 2026",
    "impact": "high",
    "scheduledDate": "2026-11-18",
    "scheduledTime": "07:00",
    "timezone": "Europe/London",
    "scheduledAtUtc": "2026-11-18T07:00:00Z",
    "dateStatus": "confirmed",
    "periodCovered": "October 2026",
    "sourceUrl": "https://www.ons.gov.uk/releases/consumerpriceinflationukoctober2026",
    "status": "upcoming"
}

Change-only mode for economic calendar alerts

Turn on Change-only mode and schedule the Actor, for example every morning. The first run returns every event in the window. Later runs with the same Monitor name return only:

• events that were not seen before (changeType: "new")
• events whose date, time, date status, status, actual value or previous value changed (changeType: "changed")

The id stays the same when a release moves, so a moved date shows up as changed. Eurostat gives no period, so a moved Eurostat date shows as a new event. Use a different monitor name for each watch list. The old field stateKey still works.

How much does an economic calendar cost?

You pay per event saved, plus a small fee per run. The default window (7 days back, 30 days ahead) returned 81 events on 21 October 2026. A run that saves nothing in change-only mode pays the start fee only.

Event	Price
Run start	$0.02
Calendar event	$0.003 ($3.00 per 1,000)

Calendar events in one run	Cost, start fee included
100	$0.32
1,000	$3.02

Sources and terms

The Actor reads public calendars and official APIs only. It sends a few slow requests per source and respects each robots.txt.

• U.S. Federal Reserve Board, Bureau of Economic Analysis and Census Bureau: U.S. government information.
• UK Office for National Statistics: Open Government Licence v3.0.
• Eurostat: Creative Commons Attribution 4.0 (CC BY 4.0). Source: Eurostat.
• European Central Bank: the source is the ECB. This information is available free of charge at ecb.europa.eu.
• Bank of Canada: the source is the Bank of Canada. This information is available free of charge at bankofcanada.ca.
• Statistics Bureau of Japan, Ministry of Internal Affairs and Communications: Government of Japan Standard Terms of Use (compatible with CC BY 4.0). Edited: dates are converted to ISO format.
• FRED: This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. By using your FRED key you agree to the FRED API Terms of Use. Series that FRED marks as third-party copyright are skipped.

Not included: Bank of England, Bank of Japan and China's National Bureau of Statistics. Their terms limit commercial reuse of their web content. Statistics Canada was offline during the build and may come in a later version.

Related Actors

• Inflation and CPI Tracker: official CPI values and release dates from ONS, Statistics Canada, ABS, Eurostat and OECD.
• Central Bank Exchange Rates API: official FX reference rates from five central banks.

FAQ

Does it include forecasts? No. Consensus forecasts are private data. The Actor returns official dates and official values only.

Why are some times empty? Eurostat, the ECB, the Bank of Canada, the FOMC, FRED and the Statistics Bureau of Japan publish dates without times in the pages the Actor reads.

Why are BLS releases missing? The BLS website blocks automated access in its robots.txt. With a FRED key, the Actor gets BLS release dates and values from FRED.

How is the impact level set? By a fixed table of event types, shown in the impact levels section. We wrote the table ourselves. No agency publishes an impact rating.

Can I filter by currency? Every row has a currency code, such as EUR for the euro area. Pick the matching Countries in the input: US for USD, GB for GBP, EU for EUR, CA for CAD and JP for JPY.

Can I get past events? Yes. Set a Start date. History goes back as far as each calendar lists it. The ECB calendar shows future meetings only.