Skip to content

README.md

Latest commit

 

History

History
73 lines (64 loc) · 4.71 KB

README.md

File metadata and controls

73 lines (64 loc) · 4.71 KB

Macroeconomic Calendar API - Finnworlds

The Macroeconomic Calendar API provides structured JSON data on economic events, indicators, and reports outcome released worldwide. It covers key macroeconomic releases such as inflation, employment, GDP, interest rate decisions, trade balances and any other event that moves the markets. With a single API call, you can access scheduled or historical macroeconomic events data for specific countries and dates, including consensus, actual, and previous values for trend analysis.

The Macroeconomic Calendar API uses REST structure, simplyfing the integration side and reducing resources spent on data engineering while taking care of aggregating the data for you. The economic event data is ideal for trading platforms, research tools, portfolio analytics, and financial dashboards that require timely access to macroeconomic information and take investment position.

Common Use Cases

– Track upcoming economic releases and events by country
– Monitor inflation, GDP, unemployment, and other key indicators
– Compare actual values with consensus and previous releases
– Integrate economic events into trading or investment dashboards
– Analyze macroeconomic trends and market impacts with historical economic event data that goes back decades

API Features

  • Event Coverage – Global economic releases across all major countries
  • Indicator Types – Inflation, GDP, employment, retail sales, interest rates, trade balances, and more
  • Real-time & Historical Data – Access both upcoming and past economic events
  • Impact & Unit Information – Indicators include impact level and measurement unit (e.g., percent, index points)
  • REST API – Standard JSON responses for easy integration into platforms and dashboards

Access today by getting your API key on the Finnworlds website.
Looking for academic or non-profit use? Send us an email to start the conversation.

How to access the data

  • JSON REST API
  • Excel CSV download
  • PDF reports
  • Email link

Documentation

Our documentation includes input parameters, output objects with descriptions. We also have SDKs for Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift, and Scala.

Examples

https://api.finnworlds.com/api/v1/macrocalendar?key=APIKEY&country=United_Kingdom&date=2025-08-20

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "output": [
            {
                "datetime": "2025-08-20 06:00:00",
                "iso_country_code": "GB",
                "country": "United Kingdom",
                "report_name": "Core Inflation Rate YoY",
                "report_date": "07",
                "actual": "3.8",
                "previous": "3.7",
                "consensus": "3.7",
                "unit": "percent",
                "impact": "2"
            },
            {
                "datetime": "2025-08-20 06:00:00",
                "iso_country_code": "GB",
                "country": "United Kingdom",
                "report_name": "Inflation Rate MoM",
                "report_date": "07",
                "actual": "0.1",
                "previous": "0.3",
                "consensus": "-0.1",
                "unit": "percent",
                "impact": "2"
            },
            {
                "datetime": "2025-08-20 06:00:00",
                "iso_country_code": "GB",
                "country": "United Kingdom",
                "report_name": "Retail Price Index YoY",
                "report_date": "07",
                "actual": "4.8",
                "previous": "4.4",
                "consensus": "4.5",
                "unit": "percent",
                "impact": "3"
            }
        ]
    }
}

Customer Support

Need help, have questions? Get in touch with Support.

Legal

Use of the Finnworlds website, services like API and database are subject to the Finnworlds Terms & Conditions.