# Finance Calendar

> A source-linked calendar of recorded economic releases, central bank decisions, selected crypto events and exchange holidays, with public release articles and a free REST API. Coverage and timing precision vary by source and series.

## Explore the calendar

- [Economic calendar: search recorded data](https://www.financecalendar.com/events/)
- [Crypto events: original sources and date confidence](https://www.financecalendar.com/crypto/)
- [Current month calendar](https://www.financecalendar.com/events/month/)
- [Today's economic calendar](https://www.financecalendar.com/today/)
- [This week and next week](https://www.financecalendar.com/this-week/)
- [Release schedule directory](https://www.financecalendar.com/schedules/)
- [Measured coverage, estimates and source collection status](https://www.financecalendar.com/api/coverage/)

## Developer entry points

- [Economic calendar API: quick start and reference](https://www.financecalendar.com/api/)
- [Full REST reference: every endpoint, parameter and response model](https://www.financecalendar.com/api/reference/)
- [Calendar endpoint: filters, pagination and missing values](https://www.financecalendar.com/api/economic-calendar/)
- [MCP: local stdio server and 11 tools](https://www.financecalendar.com/api/mcp/)
- [CLI and Python: install from source](https://www.financecalendar.com/api/cli/)
- [OpenAPI 3.1 JSON](https://www.financecalendar.com/wp-json/fc/v1/openapi)
- [Public full calendar snapshot (JSON)](https://www.financecalendar.com/wp-content/uploads/fc/calendar.json)
- [API and source collection status (JSON)](https://www.financecalendar.com/wp-json/fc/v1/status)
- [Keyless example: next FOMC release (JSON)](https://www.financecalendar.com/wp-json/fc/v1/next?series=fomc)
- [Public source repository](https://github.com/awarenessdays/financecalendar-api)

## Access and installation

The REST API base is https://www.financecalendar.com/wp-json/fc/v1. JSON, CSV and ICS calendar responses use the same recorded dataset. Keyless access allows 2,000 requests per day per IP address; an optional free key raises the limit to 10,000 and returns the same fields. Browser workspace signup supports saved views, pagination and exports; it does not hide missing results. Public event articles, source links, the API, snapshot and OpenAPI remain accessible. Data is free for commercial use with attribution; preserve each record’s source_license credit, licence link and adaptation note where supplied. Company earnings are excluded from the API, even where editorial earnings articles exist on the site.

npm and PyPI registry publication is pending. Install current clients from source:

```sh
git clone https://github.com/awarenessdays/financecalendar-api.git
cd financecalendar-api/clients/node
npm ci
```

Node 20+ is required. Configure the MCP client to run `node` with the absolute path to this checkout's `mcp.js`; transport is local stdio. For the Node CLI, run `npm link` in the same directory, then `financecalendar --help`. See https://www.financecalendar.com/api/mcp/ and https://www.financecalendar.com/api/cli/ for complete instructions.

The Python client requires Python 3.10+. From `clients/python` in the same checkout:

```sh
python -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/financecalendar --help
```

On Windows, use `.venv\Scripts\python` and `.venv\Scripts\financecalendar`.

## Scope, timing and missing values

Selected free official schedule sources include BLS, BEA, Census, the Federal Reserve, DOL, EIA and Treasury in the US; ONS in the UK; Eurostat; Japan e-Stat; and China's NBS. These are selected release families and published horizons, not every event from every agency. Other calendars include central bank decisions and exchange holidays. Some future records are estimated or provisional, including rule-based fallbacks and publisher-specific provisional calendars. A holiday-only country is not evidence of macroeconomic-release coverage.

A scheduled date is not evidence that an actual result was collected. Previous, consensus, actual, reference period and release stage can be null; null never means zero. Official schedule feeds generally do not supply market consensus. Results are incomplete; Treasury auction results are a separate collected source, not evidence of comprehensive macroeconomic actuals.

Known instants are represented by `release_at_utc`; it can be null. Date-only records retain the publisher date and do not imply midnight. Published ranges use `time_window_start` and `time_window_end` with `time_precision=range`; the range start is not an exact release time. Treasury `time_role=auction-close` means bidding closes, not results publication. Crypto month/quarter/year targets use date_window_start and date_window_end, with date as a lower-bound index rather than an exact activation date; date filters include overlapping windows. Global crypto records have country=null and canonical assets IDs. Initial coverage is selected Ethereum upgrades, including separately labelled testnets, not every coin. API date filters use the recorded publisher date for dated releases; the browser explorer groups known instants in its selected display timezone.

Inspect each row's `status`, `source_url`, `last_verified_at`, `time_precision` and stale flags where reported. The snapshot build workflow is scheduled hourly, but a new build does not establish a fresh publisher fetch or timely delivery of results. Source outages can retain last-good records marked stale. Check the coverage and source-status links above before relying on a record.

## Public schedule hubs and guides

Evergreen hubs explain release series and show their recorded schedules. Dated articles provide context for selected releases. Many database records have no article; use the full calendar or snapshot to discover those records.

- [ASX Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/asx-holidays/)
- [Australia CPI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/australia-cpi/)
- [Australia Labour Force: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/australia-jobs-report/)
- [Bank of Canada Rate Decision: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/bank-of-canada-rate-decisions/)
- [Beige Book: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/beige-book/)
- [Bond Market Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/bond-market-holidays/)
- [Canada CPI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/canada-cpi/)
- [Canada Labour Force Survey: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/canada-jobs-report/)
- [China Caixin Manufacturing PMI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/china-caixin-pmi/)
- [China CPI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/china-cpi/)
- [China GDP: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/china-gdp/)
- [China Official PMI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/china-pmi/)
- [CME Futures Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/futures-market-holidays/)
- [Economic calendar guides](https://www.financecalendar.com/guides/)
- [Euronext Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/euronext-holidays/)
- [Eurozone Flash CPI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/eurozone-cpi-flash/)
- [Eurozone GDP Flash: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/eurozone-gdp/)
- [Eurozone Unemployment: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/eurozone-unemployment/)
- [Fed Chair Semiannual Testimony: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/fed-chair-testimony/)
- [FOMC Minutes: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/fomc-minutes/)
- [Central Bank Calendar API: 14 Rate Decision Schedules](https://www.financecalendar.com/api/central-bank-calendar/)
- [CPI Release Dates API: US, UK, Eurozone, Japan, Canada, Australia](https://www.financecalendar.com/api/cpi-release-dates/)
- [Finance Calendar API Changelog](https://www.financecalendar.com/api/changelog/)
- [FOMC Dates API: Fed Meeting Dates as JSON and ICS](https://www.financecalendar.com/api/fomc-dates/)
- [Forex Economic Calendar API (a free Forex Factory alternative)](https://www.financecalendar.com/api/forex-calendar/)
- [Free API Key: Higher Limits for the Finance Calendar API](https://www.financecalendar.com/api/key/)
- [GDP Release Dates API](https://www.financecalendar.com/api/gdp-release-dates/)
- [Is the Stock Market Open? Market Status API](https://www.financecalendar.com/api/market-status/)
- [Jobs Report (NFP) Release Dates API](https://www.financecalendar.com/api/nfp-release-dates/)
- [Stock Market Holidays API: 12 Exchanges as JSON and ICS](https://www.financecalendar.com/api/market-holidays/)
- [Free Economic Calendar Widget for Your Website](https://www.financecalendar.com/widget/)
- [Germany CPI Flash: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/germany-cpi/)
- [Germany Ifo Business Climate: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/germany-ifo/)
- [HKEX Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/hkex-holidays/)
- [Japan CPI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/japan-cpi/)
- [Japan GDP: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/japan-gdp/)
- [LSE Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/lse-holidays/)
- [Norges Bank Rate Decision: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/norges-bank-rate-decisions/)
- [NSE India Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/nse-india-holidays/)
- [PBoC Loan Prime Rate: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/pboc-lpr/)
- [RBNZ Rate Decision: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/rbnz-rate-decisions/)
- [Riksbank Rate Decision: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/riksbank-rate-decisions/)
- [SIX Swiss Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/six-swiss-exchange-holidays/)
- [SNB Rate Decision: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/snb-rate-decisions/)
- [Stock Market Holidays 2026: Full NYSE & Nasdaq Schedule](https://www.financecalendar.com/stock-market-holidays/)
- [TSE/JPX Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/tse-jpx-holidays/)
- [TSX Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/tsx-holidays/)
- [UK CPI Inflation: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/uk-cpi-report/)
- [UK GDP: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/uk-gdp-report/)
- [UK Labour Market Report: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/uk-jobs-report/)
- [UK Retail Sales: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/uk-retail-sales/)
- [US ADP Employment Report: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-adp-employment/)
- [US Consumer Confidence: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-consumer-confidence/)
- [US Existing Home Sales: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-existing-home-sales/)
- [US Industrial Production: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-industrial-production/)
- [US Initial Jobless Claims: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/weekly-jobless-claims/)
- [US ISM Manufacturing PMI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-ism-manufacturing-pmi/)
- [US ISM Services PMI: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-ism-services-pmi/)
- [US JOLTS Job Openings: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-jolts/)
- [US New Home Sales: 2026 Schedule, Dates and What to Expect](https://www.financecalendar.com/us-new-home-sales/)
- [When Is the Next Bank of England Meeting? 2026 MPC Dates](https://www.financecalendar.com/bank-of-england-mpc-meetings/)
- [When Is the Next Bank of Japan Meeting? 2026 Schedule](https://www.financecalendar.com/bank-of-japan-rate-decisions/)
- [When Is the Next CPI Report? 2026 Release Dates & Times](https://www.financecalendar.com/us-cpi-report/)
- [When Is the Next ECB Meeting? 2026 Rate Decision Schedule](https://www.financecalendar.com/ecb-rate-decisions/)
- [When Is the Next FOMC Meeting? Full 2026 Schedule](https://www.financecalendar.com/fomc-meetings/)
- [When Is the Next GDP Report? 2026 Release Dates](https://www.financecalendar.com/us-gdp-report/)
- [When Is the Next Jobs Report? 2026 Release Schedule](https://www.financecalendar.com/us-jobs-report/)
- [When Is the Next PCE Report? 2026 Release Dates](https://www.financecalendar.com/us-pce-report/)
- [When Is the Next US Retail Sales Report? 2026 Release Dates](https://www.financecalendar.com/us-retail-sales/)
- [Xetra Holidays 2026 and 2027: Full Trading Calendar](https://www.financecalendar.com/frankfurt-stock-exchange-holidays/)

## Upcoming release articles

The following are published article links, not a complete database listing. Their dates and available figures should be checked on the page and against its recorded source.

- 2026-10-22 [US Initial Jobless Claims: October 22, 2026](https://www.financecalendar.com/?p=2303)
- 2026-10-22 [Japan CPI October 2026](https://www.financecalendar.com/?p=2305)
- 2026-10-23 [UK Retail Sales October 2026](https://www.financecalendar.com/?p=2375)
- 2026-10-23 [US University of Michigan Consumer Sentiment October 2026](https://www.financecalendar.com/?p=1337)
- 2026-10-26 [Germany Ifo Business Climate October 2026](https://www.financecalendar.com/?p=2377)
- 2026-10-27 [US Consumer Confidence October 2026](https://www.financecalendar.com/?p=2379)
- 2026-10-27 [US New Home Sales October 2026](https://www.financecalendar.com/?p=2381)
- 2026-10-27 [Australia CPI October 2026](https://www.financecalendar.com/?p=2195)
- 2026-10-27 [RBNZ Rate Decision October 2026](https://www.financecalendar.com/?p=2383)
- 2026-10-28 [Bank of Canada Rate Decision October 2026](https://www.financecalendar.com/?p=2199)
- 2026-10-28 [GOOGL Earnings October 2026](https://www.financecalendar.com/?p=2197)
- 2026-10-28 [MSFT Earnings October 2026](https://www.financecalendar.com/?p=2201)
- 2026-10-28 [META Earnings October 2026](https://www.financecalendar.com/?p=2205)
- 2026-10-28 [FOMC Rate Decision October 2026](https://www.financecalendar.com/?p=1228)
- 2026-10-29 [US Personal Income and Outlays (PCE) October 2026](https://www.financecalendar.com/?p=1311)
- 2026-10-29 [US Gross Domestic Product October 2026](https://www.financecalendar.com/?p=1313)
- 2026-10-29 [US Initial Jobless Claims: October 29, 2026](https://www.financecalendar.com/?p=2387)
- 2026-10-29 [ECB Rate Decision October 2026](https://www.financecalendar.com/?p=1238)
- 2026-10-29 [Germany CPI Flash October 2026](https://www.financecalendar.com/?p=2385)
- 2026-10-29 [AMZN Earnings October 2026](https://www.financecalendar.com/?p=2209)
- 2026-10-29 [AAPL Earnings October 2026](https://www.financecalendar.com/?p=2207)
- 2026-10-30 [Bank of Japan Rate Decision October 2026](https://www.financecalendar.com/?p=1256)
- 2026-10-30 [Eurozone Unemployment October 2026 (30)](https://www.financecalendar.com/?p=2559)
- 2026-10-30 [Eurozone GDP Flash October 2026](https://www.financecalendar.com/?p=2389)
- 2026-10-30 [China Official PMI October 2026](https://www.financecalendar.com/?p=2391)
- 2026-11-01 [China Caixin Manufacturing PMI November 2026](https://www.financecalendar.com/?p=2393)
- 2026-11-02 [US ISM Manufacturing PMI November 2026](https://www.financecalendar.com/?p=2211)
- 2026-11-03 [Is the Stock Market Open on Culture Day 2026? TSE/JPX Hours](https://www.financecalendar.com/?p=2561)
- 2026-11-03 [RBA Rate Decision November 2026](https://www.financecalendar.com/?p=1250)
- 2026-11-03 [US JOLTS Job Openings November 2026](https://www.financecalendar.com/?p=2395)
- 2026-11-04 [Riksbank Rate Decision November 2026](https://www.financecalendar.com/?p=2397)
- 2026-11-04 [Eurozone Flash CPI November 2026](https://www.financecalendar.com/?p=2213)
- 2026-11-04 [US ADP Employment Report November 2026](https://www.financecalendar.com/?p=2401)
- 2026-11-04 [US International Trade Balance November 2026](https://www.financecalendar.com/?p=1338)
- 2026-11-04 [US ISM Services PMI November 2026](https://www.financecalendar.com/?p=2399)
- 2026-11-05 [Norges Bank Rate Decision November 2026](https://www.financecalendar.com/?p=2403)
- 2026-11-05 [Bank of England MPC Rate Decision November 2026](https://www.financecalendar.com/?p=1240)
- 2026-11-05 [US Initial Jobless Claims: November 5, 2026](https://www.financecalendar.com/?p=2405)
- 2026-11-06 [US Employment Situation (Non-Farm Payrolls) November 2026](https://www.financecalendar.com/?p=1293)
- 2026-11-06 [Canada Labour Force Survey November 2026](https://www.financecalendar.com/?p=2215)

## Feeds and sitemap

- [Published article archive calendar (ICS; not the full data snapshot)](https://www.financecalendar.com/events/?ical=1)
- [Recorded upcoming economic calendar (ICS; API window and pagination apply)](https://www.financecalendar.com/wp-json/fc/v1/calendar?format=ics)
- [Sitemap](https://www.financecalendar.com/sitemap_index.xml)

Some schedule hubs also offer a series-specific calendar feed; use the feed link published on that hub.

## Citation

Cite as "Finance Calendar (financecalendar.com)" and link to the specific public event, schedule hub or dataset endpoint used. Keep the API's attribution object when redistributing files. Report estimated or provisional dates and unavailable values accurately; cite the recorded publisher source where useful. Visible page update times and snapshot generation times do not by themselves prove all dates or results were freshly verified.