Skip to content

README.md

Latest commit

 

History

History
50 lines (42 loc) · 3.79 KB

README.md

File metadata and controls

50 lines (42 loc) · 3.79 KB

Macroeconomic Data API - Finnworlds

The Macroeconomic Data API provides structured JSON data on historical and current macroeconomic indicator outcomes for countries worldwide. It covers key indicators such as employment, inflation, production, registrations, business confidence, trade balances, and other market-moving macroeconomic data. You can request event data for previous and current report outcomes with reporting dates to analyze trends and economic performance.

The Macroeconomic Data API aggregates report data for all countries, available in a single API endpoint that uses a REST structure. This simplifies the integration and allows you to use any language you want, or maintain dynamic spreadsheets powered by macroconomic indicator data. The API is ideal for trading platforms, research tools, portfolio analytics, and dashboards that need up-to-date macroeconomic outcomes and indicators.

Common Use Cases

– Track historical and current macroeconomic indicator outcomes by country
– Compare actual values with previous periods for trend analysis
– Monitor key metrics such as employment, production, registrations, and business confidence and compare countries
– Integrate indicator outcomes into trading or investment dashboards
– Support economic research, modeling, and forecasting with structured historical data

API Features

  • Indicator Coverage – Global macroeconomic indicators across all major countries
  • Historical & Current Data – Access both past and the most recent reported values
  • Units & Dates – All indicators include measurement units (e.g., percent, points, units) and reporting dates
  • 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/macroindicator?key=APIKEY&country=United_Kingdom

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "output": [
            {
                "report_name": "Electric Car Registrations",
                "previous": "47354",
                "actual": "32738",
                "unit": "Units",
                "report_date": "2025-06"
            },
            {
                "report_name": "Business Confidence",
                "previous": "-27",
                "actual": "-33",
                "unit": "points",
                "report_date": "2025-09"
            }
        ]
    }
}

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.