RadarPricesOrder

Home › APIs › Finance & rates

Finance & rates

Economic Calendar API

In plain words

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

FieldTypeDescription
modestringupcoming = 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 =
daysintegerFor mode upcoming: how many days ahead (1-120).
fromstringFor mode range: start date YYYY-MM-DD (UTC).
tostringFor mode range: end date YYYY-MM-DD (UTC). Empty = From + 30 days.
countryarrayFilter by country code: US, GB (UK) or EA (euro area). Empty = all.
importancestringhigh = market movers only (CPI, jobs report, GDP, PCE, retail sales, PPI, FOMC, ECB, UK CPI/labour/GDP). Empty = all.
categorystringOnly releases of this category. Empty = all.
agencystringOnly releases of this agency. Empty = all.
searchstringText in the indicator name, e.g. cpi, nonfarm, gdp, pce, retail sales, fomc, labour market. Required for mode next.
limitintegerMaximum number of rows (1-1000).
onlyNewbooleanReturn only releases that are new, moved to another time or changed status since the last run with the same Monitor ID. Schedule daily.
monitorIdstringName 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.

Related APIs

Central Bank Rates APIToday's official interest rates from central banks like the US Fed and the European Central Bank.
Currency Exchange Rates APIConverts an amount between 30 currencies with the official European Central Bank rate of today or a past day.
Fuel Prices APIDiesel and petrol prices at fuel stations near any place in France, Spain and Italy, cheapest first.
Gas Prices APIOfficial weekly petrol and diesel prices in the US, by region.
Inflation APIHow fast prices are rising in any country, plus GDP numbers, from official statistics.
Mortgage Rates APICurrent home loan rates (30-year and 15-year fixed) from official weekly surveys.