Economic API

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

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

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.

Basic

Entry plan for testing
Intro offer
$9
  • 500 calls included
  • 10 calls per minute
25% OFF

Premium

For scaling applications
Higher volume
$37 $49
Special price for the first month
  • 10,000 calls included
  • 30 calls per minute
Note: This is a simplified pricing overview for quick comparison. Full plan details can be found on the pricing page.

Frequently Asked Questions

What is included in the Fin2Dev economic data suite?

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.

What is the difference between the Macroeconomic Calendar API and Economic Indicators API?

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.

Can I access historical economic data?

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.

Can I access GDP, CPI and PMI data?

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.

Are the APIs available in JSON format?

Yes. Both services use REST endpoints and return structured JSON responses designed for integration with financial applications, dashboards, research tools, and analytics platforms.

Do you offer a free plan?

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.

How much does access cost?

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.

Is Fin2Dev related to the e-conomic accounting software?

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.