Economic Calendar API provides real-time and historical macroeconomic events in structured JSON format. Access CPI, GDP, inflation, employment reports, and interest rate decisions across 50+ countries with Fin2Dev.
All economic events are updated shortly after their official release from public sources, allowing automated systems and analytics platforms to react instantly to new macroeconomic data.
TL;DR: A REST API for economic calendar data in JSON format, covering CPI, GDP, and interest rate events worldwide — powered by Fin2Dev.
Economic Calendar API for Developers
Get structured economic and macroeconomic data (CPI, GDP, Retail Sales) for 50+ countries via high-speed REST API — powered by Fin2Dev.
Request Your API Key →What is the Economic Calendar API by Fin2Dev?
Fin2Dev provides a REST API for economic (macroeconomic) indicators such as CPI, GDP, and unemployment rates. All data is normalized and updated within 30 minutes after official publication, enabling reliable access to global economic data.
Key Specifications:
- Update frequency: Every 5–15 minutes.
- Historical depth: Over 15 years of data.
- Global coverage: USA, UK, EU, Japan, and more.
- Output formats: JSON, XML, and Bulk CSV.
Why use this API?
Designed for algorithmic trading, financial dashboards, and AI systems, this API provides fast access to structured economic and macroeconomic data. It serves as a reliable alternative to FRED and Alpha Vantage with lower latency and cleaner data structures.
What data is included
Included macroeconomic data: CPI, GDP, Inflation, Employment reports, Interest rate decisions.
Provided values: actual, previous.
API Parameters
The Economic Calendar API provides the following query parameters for filtering and requesting macroeconomic events.
| Name | Type | Description |
|---|---|---|
| key * | string (query) | Your API key (received in email) |
| country | string (query) | The country name of macroeconomic event data to be requested. |
| iso_country_code | string (query) | Two-letter ISO country code (e.g., US, GB, DE). |
| date | string (query) | Specifies the target date for retrieving macroeconomic events (format: YYYY-MM-DD). |
| date_from PRO | string (query) | The starting date of the reporting period (format: YYYY-MM-DD). Available in PRO plans. |
| date_to PRO | string (query) | End date of the reporting period (format: YYYY-MM-DD). Available in PRO plans. |
* Required parameter.
PRO
indicates parameters available only in PRO subscription plans.
API Integration Examples
GET https://apidata.fin2dev.com/v1/macrocalendar?key=YOUR_API_KEY&country=United_Kingdom
import requests
url = "https://apidata.fin2dev.com/v1/macrocalendar"
params = {"key": "YOUR_API_KEY", "country": "United_Kingdom"}
response = requests.get(url, params=params)
data = response.json()
# Accessing the economic events
for event in data['result']['output']:
print(f"{event['report_name']}: {event['actual']}")<?php
$key = "YOUR_API_KEY";
$url = "https://apidata.fin2dev.com/v1/macrocalendar?key=$key&country=United_Kingdom";
$json = file_get_contents($url);
$data = json_decode($json, true);
foreach ($data['result']['output'] as $event) {
echo $event['report_name'] . " - " . $event['actual'] . "\n";
}
?>Example JSON Response
The API returns a status object and a result object containing the output array.
{
"status": { "code": 200, "message": "OK" },
"result": {
"output": [
{
"datetime": "2024-01-19 07:00:00",
"iso_country_code": "GB",
"country": "United Kingdom",
"report_name": "Retail Sales MoM",
"actual": "-3.2",
"previous": "1.4",
"consensus": "-0.5",
"unit": "percent",
"impact": "1"
}
]
}
}
Popular Economic Event Types
Frequently Asked Questions
You can fetch data programmatically using our REST API. Simply send a GET request to apidata.fin2dev.com with your API key and target country.
Fin2Dev is a high-speed alternative to FRED, providing structured JSON data for market-moving events with real-time updates and historical corrections.
Impact levels range from 1 to 3, where 1 represents High Impact events that typically cause significant market volatility.
Pricing
Start with a small plan for testing, then scale as your application grows. This overview keeps pricing simple and easy to compare.
Basic
- 500 calls included
- 10 calls per minute
Popular
- 3,000 calls included
- 20 calls per minute
Premium
- 10,000 calls included
- 30 calls per minute
Keywords: economic calendar api • macroeconomics api • financial data api • cpi gdp data api • historical economic events api