Home › APIs › Finance & rates
Economic Calendar API
Shows when official numbers like US inflation, jobs, Fed rate decisions, UK and euro area data come out, with the exact time in your time zone.
Used by: Finance apps, brokers, analysts, comparison sites.
Economic calendar from official agency schedules only, no API key: US (BLS, BEA, Census, Federal Reserve FOMC), UK (ONS) and euro area (ECB). Exact release time in UTC and local time, importance, category and period for CPI, jobs report, GDP, PCE, retail sales, FOMC and ECB rate decisions. Upcoming, today, week, date range, next release per indicator, event list. Monitor mode returns only new or moved releases.
Try it live, no sign-up
Run the example as is, or change the input. 5 own tries a day without a key.
Example request
curl -X POST https://radarbg.com/v1/economic-calendar-api \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"mode": "upcoming", "days": 7, "limit": 20, "onlyNew": false}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
mode | string | upcoming = releases from now for the next Days; today / week = this UTC day or ISO week; range = From..To (past dates allowed, max 370 days); next = the next release of each indicator matching Search (e.g. cpi, nonfarm, gdp, fomc); events = |
days | integer | For mode upcoming: how many days ahead (1-120). |
from | string | For mode range: start date YYYY-MM-DD (UTC). |
to | string | For mode range: end date YYYY-MM-DD (UTC). Empty = From + 30 days. |
country | array | Filter by country code: US, GB (UK) or EA (euro area). Empty = all. |
importance | string | high = market movers only (CPI, jobs report, GDP, PCE, retail sales, PPI, FOMC, ECB, UK CPI/labour/GDP). Empty = all. |
category | string | Only releases of this category. Empty = all. |
agency | string | Only releases of this agency. Empty = all. |
search | string | Text in the indicator name, e.g. cpi, nonfarm, gdp, pce, retail sales, fomc, labour market. Required for mode next. |
limit | integer | Maximum number of rows (1-1000). |
onlyNew | boolean | Return only releases that are new, moved to another time or changed status since the last run with the same Monitor ID. Schedule daily. |
monitorId | string | Name of this watch (any text). Each Monitor ID keeps its own memory of releases already returned. |
Price
Included in every plan: 500 calls a month free, then from €9 a month for 5,000 calls across all APIs. Pro, €29 for 25,000 calls, is the one we recommend.
Questions
What does the Economic Calendar API do?
Shows when official numbers like US inflation, jobs, Fed rate decisions, UK and euro area data come out, with the exact time in your time zone.
Where does the data come from?
Economic calendar from official agency schedules only, no API key: US (BLS, BEA, Census, Federal Reserve FOMC), UK (ONS) and euro area (ECB). Exact release time in UTC and local time, importance, category and period for CPI, jobs report, GDP, PCE, retail sales, FOMC and ECB rate decisions. Upcoming, today, week, date range, next release per indicator, event list. Monitor mode returns only new or m
How much does it cost?
500 calls a month are free with no card. Paid plans start at EUR 9 a month for 5,000 calls and include every API on Radar. Failed calls are not counted.
Can I use it without writing code?
Yes. Try it live on this page, use our free browser tools, or ask us to run it on your list as a service.