Finance Calendar API: Free Economic Calendar Data (JSON, CSV, MCP)

Base URL

https://www.financecalendar.com/wp-json/fc/v1

No API key. No rate limits (responses are edge-cached for 5 minutes). CORS is open, so you can call it straight from a browser.

Endpoints

Endpoint	What it returns	Parameters
/calendar	Events in a date range, soonest first	from, to (YYYY-MM-DD, max 92 days), impact (high | medium | low), category, limit (max 500), format=csv
/next	The next occurrence of a series	series — fomc, cpi, jobs, nfp, gdp, pce, ppi, retail-sales, jobless-claims, ism, jolts, ecb, boe, boj, boc, rba, rbnz, snb, or any keyword
/holidays	NYSE & Nasdaq holidays and early closes, 2026-27	year
/today	Today’s events plus live NYSE open/closed status	none

Examples

When is the next Fed decision?

curl "https://www.financecalendar.com/wp-json/fc/v1/next?series=fomc"

Every high-impact release in the next two weeks:

curl "https://www.financecalendar.com/wp-json/fc/v1/calendar?impact=high"

From a browser or app:

const r = await fetch("https://www.financecalendar.com/wp-json/fc/v1/today");
const { market, events } = await r.json();

Response shape

{
  "series": "fomc",
  "next": {
    "date": "2026-09-16",
    "time_utc": "2026-09-16T18:00:00+00:00",
    "time_et": "14:00",
    "all_day": false,
    "name": "FOMC decision",
    "title": "FOMC Rate Decision September 2026",
    "impact": "high",
    "category": "central-banks-monetary-policy",
    "consensus": "Hold at 3.50-3.75%",
    "prior": "Hold",
    "actual": null,
    "url": "https://www.financecalendar.com/event/fomc-rate-decision-september-2026/"
  },
  "attribution": { "source": "financecalendar.com", "terms": "...", "docs": "..." }
}

consensus appears roughly two days before a release; actual is filled within the hour of the official print.

CSV downloads

Add format=csv to any /calendar query, or use these ready-made files:

• September – November 2026, every release (CSV)
• September – November 2026, high impact only (CSV)
• NYSE holidays 2027 (JSON)

Calendar feeds

Prefer a calendar subscription? Every schedule hub on this site serves a live .ics feed (add ?fc_ics=1 to any hub URL), and the full calendar feed covers everything.

MCP server and CLI

For AI assistants and the terminal, one package wraps this API:

npx financecalendar-mcp        # MCP server (Claude Desktop, Cursor, any MCP client)
npx financecalendar next fomc  # CLI
npx financecalendar today

Claude Desktop config:

{ "mcpServers": { "financecalendar": { "command": "npx", "args": ["financecalendar-mcp"] } } }

Attribution and fair use

• Attribution means a visible link to https://www.financecalendar.com near where the data is shown (or in your app’s about/credits page).
• The feed covers economic data, central bank decisions and market holidays. Earnings dates are not included in the API.
• Please cache responses on your side where you can; the data changes at most hourly.
• Building something with this? We may feature it — get in touch.