Economic API by Fin2Dev provides access to two complementary types of macroeconomic data:
- Economic Calendar API — scheduled releases, actual, previous and consensus values, and historical events.
- Economic Data API — current GDP, CPI, PMI, employment, trade, interest rates, and other indicators.
TL;DR: One hub for global economic calendar events and current macroeconomic indicators through Fin2Dev APIs.
Economic Calendar API • Real-Time and Historical Macroeconomic Events
5–15 min updates | 12+ years history | 120+ countries | JSON | Actual / Previous / Consensus | Country & date filters | Impact & release time | CPI, GDP, NFP, PMI, Interest Rate Decisions, and more
Economic Data API • Global Economic Indicators & Current Macro Snapshots
120+ countries | 400+ indicators for major economies | 5–10 min updates | JSON REST API | GDP, CPI, PMI, Employment, Trade, Interest Rates and more | Country & indicator filters
Ready to Get Started?
Get Your API Key →Economic Calendar API vs Economic Data API
Economic Calendar API = event-based historical stream.
Economic Data API = current indicator snapshot.
| Feature | Economic Calendar API | Economic Data API |
|---|---|---|
| Data type | Economic events and releases organized by date and time | Current macroeconomic indicator values organized by country and indicator |
| Examples | CPI releases, GDP reports, NFP, PMI, interest rate decisions | GDP, CPI, PMI, unemployment, trade, interest rates |
| Main fields | datetime, report_name, actual, previous, consensus, unit, impact |
report_name, actual, previous, unit, report_date |
| Historical availability | Historical economic events available across past release dates | Current/latest indicator values; no historical time series |
| Data organization | Event-based data distributed across release dates | Indicator-based current snapshot by country |
| Typical use case | Trading calendars, release monitoring, event analysis, historical event research | Dashboards, economic monitoring, research, financial applications |
| Coverage | Global macroeconomic coverage across countries and releases | Global macroeconomic coverage across countries and indicators |
| Update frequency | 5–15 minutes | 5–10 minutes |
Global Economic Coverage & Key Metrics
Fin2Dev provides broad global coverage across economic calendar events and macroeconomic indicators.
120+ Countries
Global coverage across major and emerging economies.
400+ Indicators
Available for major economies across GDP, CPI, PMI, employment, trade, and more.
12+ Years
Historical economic calendar events across past release dates.
5–15 Min
Economic calendar update frequency after official releases.
5–10 Min
Macroeconomic indicator data refresh frequency.
REST JSON
Developer-ready API responses for financial and analytical applications.
The Macroeconomic Calendar API organizes economic releases by date and time, while the Economic Indicators API provides current indicator snapshots by country and indicator.
Developer Integration
Fin2Dev provides a developer-focused economics API for financial applications,
trading tools, dashboards, and analytical workflows.
Connect to Fin2Dev using standard REST requests. Choose the endpoint that matches the type of economic data you need.
Economic Calendar API
GET https://apidata.fin2dev.com/v1/macrocalendar?key=YOUR_API_KEY&country=United_Kingdom
Macroeconomic Calendar API Python Example
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()
for event in data['result']['output']:
print(f"{event['report_name']}: {event['actual']}")
cURL Example
curl "https://apidata.fin2dev.com/v1/macrocalendar?key=YOUR_API_KEY&country=United_Kingdom"
PHP Example
<?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";
}
?>
Economic Data API
GET https://apidata.fin2dev.com/v1/macroindicator?key=YOUR_API_KEY&country=United_Kingdom
Economic Indicators API Python Example
import requests
url = "https://apidata.fin2dev.com/v1/macroindicator"
params = {
"key": "YOUR_API_KEY",
"country": "United_Kingdom"
}
response = requests.get(url, params=params)
data = response.json()
for item in data['result']['output']:
print(
f"{item['report_name']}: "
f"{item['actual']} {item['unit']} "
f"({item['report_date']})"
)
cURL Example
curl "https://apidata.fin2dev.com/v1/macroindicator?key=YOUR_API_KEY&country=United_Kingdom"
PHP Example
<?php
$key = "YOUR_API_KEY";
$url = "https://apidata.fin2dev.com/v1/macroindicator?key=$key&country=United_Kingdom";
$json = file_get_contents($url);
$data = json_decode($json, true);
foreach ($data['result']['output'] as $item) {
echo $item['report_name'] . " - "
. $item['actual'] . " "
. $item['unit'] . " ("
. $item['report_date'] . ")\n";
}
?>
Example JSON Responses
Both services return structured JSON, but the response models are different: the calendar is event-based, while the indicator feed returns current macroeconomic snapshots.
Macroeconomic Calendar Response
{
"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"
}
]
}
}
Economic Indicator Response
{
"result": {
"output": [
{
"report_name": "Manufacturing PMI",
"previous": "51.7",
"actual": "51.9",
"unit": "points",
"report_date": "2026-09"
}
]
}
}
Economic Calendar & Data Use Cases
Use Fin2Dev data across trading, financial applications, research, dashboards, and economic monitoring workflows.
Algorithmic Trading
Track scheduled macroeconomic releases and react to new economic events as they are published.
Financial Dashboards
Display current GDP, CPI, PMI, employment, trade, interest rates, and other macroeconomic indicators.
Economic Monitoring
Monitor current indicator values and important economic releases across global markets.
Economic Research
Analyze historical release events and compare current macroeconomic conditions across countries.
Risk Analysis
Add macroeconomic context to market, portfolio, and country-risk analysis workflows.
Fintech Applications
Integrate structured economic events and macroeconomic indicators into financial and analytical products.
Pricing
Start with a small plan for testing, then scale as your application grows. This overview keeps pricing simple and easy to compare.
Popular
- 3,000 calls included
- 20 calls per minute
Premium
- 10,000 calls included
- 30 calls per minute
Frequently Asked Questions
Fin2Dev provides two complementary data services: the Macroeconomic Calendar API for scheduled and historical macroeconomic events, and the Economic Indicators API for current macroeconomic indicator values such as GDP, CPI, PMI, employment, trade, and interest rates.
The macroeconomic calendar provides an event-based historical stream organized by release date and time. The indicator feed provides a current snapshot organized by country and indicator.
Historical economic events are available through the Macroeconomic Calendar API, with more than 12 years of release history. The Economic Indicators API provides current and latest indicator values and does not provide historical time series.
Yes. GDP, CPI, PMI and many other macroeconomic indicators are available. Use the calendar for individual releases and historical events, or the indicator feed for the latest available values by country.
Yes. Both services use REST endpoints and return structured JSON responses designed for integration with financial applications, dashboards, research tools, and analytics platforms.
Fin2Dev does not currently offer a free plan. For testing, the Basic plan provides 14 days of access, 500 API requests, and up to 10 requests per minute for $9.
Plans start at $9. Higher-volume plans are available for applications that require more API requests or higher request rates. See the pricing page for full plan details.
No. Fin2Dev is not affiliated with e-conomic. Fin2Dev provides macroeconomic data and economic calendar services for developers, financial applications, and analytics platforms.
Start Building with Fin2Dev
Get access to economic calendar events and macroeconomic indicators through developer-ready REST APIs.