# Economic Calendar API > Live macroeconomic-event calendar — the macro releases that move currencies, rates and the whole market — served straight from Nasdaq's public economic calendar feed (no key, nothing cached). These are GDP, CPI and inflation, central-bank rate decisions, unemployment and non-farm payrolls, industrial production, trade balances, PMI and consumer sentiment, across every major economy. For any date the events endpoint lists each release with its scheduled GMT time, the country, the event name, the actual print once released, the consensus forecast, the previous reading and a description of what the indicator measures and why it matters — you can filter by country or by event name. The week endpoint returns the whole week ahead from a date in a single call — the calendar every forex and rates trader plans around — and the countries endpoint shows which economies report on a date and how many events each has. This is the macro-event layer for any trading, forex, research or dashboard app: what prints, when, and what the market expects. Live from Nasdaq, nothing stored. Distinct from corporate-events APIs (earnings, dividends, splits) and from price and FX-rate APIs — this is the macroeconomic calendar. 4 endpoints. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/economiccalendar-api/..." ``` ## Pricing - **Free** (Free) — 11,000 calls/Mo, 3 req/s - **Starter** ($10/Mo) — 140,000 calls/Mo, 8 req/s - **Pro** ($27/Mo) — 650,000 calls/Mo, 15 req/s - **Scale** ($63/Mo) — 3,300,000 calls/Mo, 30 req/s ## Endpoints ### Calendar #### `GET /v1/countries` — Countries reporting on a date **Parameters:** - `date` (query, optional, string) — Date YYYY-MM-DD (default today) Example: `2026-06-10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/economiccalendar-api/v1/countries?date=2026-06-10" ``` **Response:** ```json { "data": { "date": "2026-06-10", "countries": [ { "count": 14, "country": "United States" }, { "count": 5, "country": "Germany" }, { "count": 4, "country": "Japan" }, { "count": 3, "country": "Canada" }, { "count": 3, "country": "Australia" }, { "count": 3, "country": "China" }, { "count": 2, "country": "South Africa" }, { "count": 1, "country": "Spain" }, { "count": 1, "country": "Brazil" }, { "count": 1, "country": "Euro Zone" } ], "total_events": 37 }, "meta": { "timestamp": "2026-06-09T11:39:57.175Z", "request_id": "10290f19-4cf5-4acc-a094-fc9991f421f5" }, "status": "ok", "message": "Countries retrieved successfully", "success": true } ``` #### `GET /v1/events` — Economic events on a date **Parameters:** - `date` (query, optional, string) — Date YYYY-MM-DD (default today) Example: `2026-06-10` - `country` (query, optional, string) — Filter by country Example: `United States` - `q` (query, optional, string) — Filter by event name Example: `CPI` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/economiccalendar-api/v1/events?date=2026-06-10&country=United+States&q=CPI" ``` **Response:** ```json { "data": { "date": "2026-06-10", "count": 0, "events": [] }, "meta": { "timestamp": "2026-06-09T11:39:57.321Z", "request_id": "33e9d896-251a-4de9-8cc7-1665596a8304" }, "status": "ok", "message": "Economic events retrieved successfully", "success": true } ``` #### `GET /v1/week` — The week ahead from a date **Parameters:** - `date` (query, optional, string) — Start date YYYY-MM-DD (default today) Example: `2026-06-08` - `country` (query, optional, string) — Filter by country Example: `United States` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/economiccalendar-api/v1/week?date=2026-06-08&country=United+States" ``` **Response:** ```json { "data": { "end": "2026-06-14", "days": [ { "date": "2026-06-08", "count": 1, "events": [ { "event": "OPEC Meeting", "actual": null, "country": "United States", "previous": null, "time_gmt": "06:00", "consensus": null, "description": "OPEC meetings are attended by representatives from 13 oil-rich nations. They discuss a range of topics regarding energy markets and agree on how much oil they will produce. OPEC is responsible for nearly 40% of the world's oil supply." } ] }, { "date": "2026-06-09", "count": 4, "events": [ { "event": "CB Employment Trends Index", "actual": "107.01", "country": "United States", "previous": "107.88", "time_gmt": "10:00", "consensus": null, "description": "The eight labor-market indicators listed below aggregated into the Employment Trends Index.
Percentage of respondents who say they find ""Jobs Hard to Get"" (The Conference Board Consumer Confidence Survey).Initial Cl …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/economiccalendar-api/v1/meta" ``` **Response:** ```json { "data": { "source": "Nasdaq public economic calendar API (live)", "service": "economiccalendar-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/week": "The whole week ahead from a date (date=, optional country=, q=).", "GET /v1/events": "Economic events on a date (date=YYYY-MM-DD, optional country=, q=event name).", "GET /v1/countries": "Which countries report on a date and how many events each (date=)." }, "description": "Live macroeconomic-event calendar from Nasdaq: for any date, each release with GMT time, country, event name, actual print, consensus forecast, previous reading and a description — GDP, CPI/inflation, central-bank rate decisions, unemployment/NFP, industrial production, trade balances, PMI and more, across every major economy. Filter by country or event name, get the whole week ahead in one call, or see which countries report on a date. Live, nothing stored. Distinct from corporate-events (earnings/dividends/splits) and price APIs — this is the macroeconomic calendar.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-09T11:39:57.901Z", "request_id": "5f9bcf0f-92c6-46ef-857c-6e0d391f21b5" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/economiccalendar-api OpenAPI spec: https://www.oanor.com/api/economiccalendar-api/openapi.json