{"id":2022,"date":"2020-11-24T16:02:26","date_gmt":"2020-11-24T16:02:26","guid":{"rendered":"https:\/\/eodhd.com\/financial-apis\/?p=2022"},"modified":"2026-05-27T11:34:43","modified_gmt":"2026-05-27T09:34:43","slug":"macroeconomics-data-and-macro-indicators-api","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/macroeconomics-data-and-macro-indicators-api","title":{"rendered":"Macroeconomic Indicators API: GDP, Inflation & Demographics by Country"},"content":{"rendered":"\n

The EODHD Macro Indicators API exposes 39 macroeconomic time series per country \u2014 GDP, inflation, unemployment, demographics, trade balances, debt ratios and more. Data is sourced from the World Bank World Development Indicators<\/strong> (WDI) and refreshed annually as the World Bank publishes new vintages. Most series start in 1960; the latest available year is typically the previous calendar year.<\/p>\n\n\n\n

<\/p>\n\n\n\n

<\/div>\n\n\n\n

API Endpoint<\/h2>\n\n\n
\n
https:\/\/eodhd.com\/api\/macro-indicator\/{country}<\/code><\/pre>\n<\/div>\n\n\n
<\/div>\n\n\n\n
Path Parameter<\/h2>\n\n\n\n
Parameter<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
country<\/td>Yes<\/td>ISO 3166-1 alpha-3 country code (e.g. USA, FRA, DEU, GBR, JPN). Case-insensitive \u2014 usa and USA are equivalent. World Bank aggregate codes are also accepted (see Country Codes section).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Query Parameters<\/h2>\n\n\n\n
Parameter<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
api_token<\/td>Yes<\/td>Your EODHD API token<\/td><\/tr>
indicator<\/td>No<\/td>Indicator key from the list below. Default is gdp_current_usd<\/td><\/tr>
fmt<\/td>No<\/td>Response format, json (default) or csv. Note that csv truncates decimal values to integers<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Available Indicators<\/h2>\n\n\n\n
39 indicators are exposed. The Status column reflects how regularly the underlying World Bank series is updated and whether the data is suitable for current analysis. See Known Limitations for the indicators flagged as data issue<\/strong> or historical<\/strong>.<\/p>\n\n\n\n
National Accounts and Growth<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
gdp_current_usd<\/td>GDP, current US$<\/td>Active<\/td><\/tr>
gdp_per_capita_usd<\/td>GDP per capita, current US$<\/td>Active<\/td><\/tr>
gdp_growth_annual<\/td>GDP growth, annual %<\/td>Active<\/td><\/tr>
gni_usd<\/td>GNI, Atlas method, current US$<\/td>Active<\/td><\/tr>
gni_per_capita_usd<\/td>GNI per capita, Atlas method, current US$<\/td>Active<\/td><\/tr>
gni_ppp_usd<\/td>GNI, PPP, current international $<\/td>Active (from 1990)<\/td><\/tr>
gni_per_capita_ppp_usd<\/td>GNI per capita, PPP, current international $<\/td>Active (from 1990)<\/td><\/tr>
gross_capital_formation_percent_gdp<\/td>Gross capital formation, % of GDP<\/td>Active<\/td><\/tr>
agriculture_value_added_percent_gdp<\/td>Agriculture, value added, % of GDP<\/td>Active (coverage varies by country)<\/td><\/tr>
industry_value_added_percent_gdp<\/td>Industry, value added, % of GDP<\/td>Active (coverage varies by country)<\/td><\/tr>
services_value_added_percent_gdp<\/td>Services, value added, % of GDP<\/td>Active (coverage varies by country)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Prices and Inflation<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
inflation_consumer_prices_annual<\/td>Inflation, consumer prices, annual %<\/td>Active<\/td><\/tr>
consumer_price_index<\/td>Consumer Price Index, 2010 = 100<\/td>Active<\/td><\/tr>
inflation_gdp_deflator_annual<\/td>Inflation, GDP deflator, annual %<\/td>Active<\/td><\/tr>
real_interest_rate<\/td>Real interest rate, %<\/td>Stale \u2014 last update 2021, missing for several countries<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Trade and External Sector<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
net_trades_goods_services<\/td>Net trades in goods and services, current US$<\/td>Active<\/td><\/tr>
exports_of_goods_services_percent_gdp<\/td>Exports of goods and services, % of GDP<\/td>Active<\/td><\/tr>
imports_of_goods_services_percent_gdp<\/td>Imports of goods and services, % of GDP<\/td>Active<\/td><\/tr>
merchandise_trade_percent_gdp<\/td>Merchandise trade, % of GDP<\/td>Active<\/td><\/tr>
high_technology_exports_percent_total<\/td>High-technology exports, % of manufactured exports<\/td>Active (from 2007)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Government Finance and Debt<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
debt_percent_gdp<\/td>Central government debt, % of GDP<\/td>Active (limited country coverage)<\/td><\/tr>
revenue_excluding_grants_percent_gdp<\/td>Revenue, excluding grants, % of GDP<\/td>Active<\/td><\/tr>
cash_surplus_deficit_percent_gdp<\/td>Cash surplus\/deficit, % of GDP<\/td>Historical \u2014 last update 2014. Values look implausible, see Known Limitations<\/td><\/tr>
total_debt_service_percent_gni<\/td>Total debt service, % of GNI<\/td>Active for IBRD\/IDA borrowers only \u2014 empty for high-income countries<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Population and Demographics<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
population_total<\/td>Population, total<\/td>Active<\/td><\/tr>
population_growth_annual<\/td>Population growth, annual %<\/td>Active<\/td><\/tr>
net_migration<\/td>Net migration, absolute value (5-year totals)<\/td>Active<\/td><\/tr>
life_expectancy<\/td>Life expectancy at birth, total years<\/td>Active<\/td><\/tr>
fertility_rate<\/td>Fertility rate, total births per woman<\/td>Active<\/td><\/tr>
prevalence_hiv_total<\/td>Prevalence of HIV, total, % of population ages 15-49<\/td>Active for low- and middle-income countries \u2014 empty for the US and several high-income countries<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Labour, Poverty and Income<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
unemployment_total_percent<\/td>Unemployment, total, % of labour force<\/td>Active<\/td><\/tr>
income_share_lowest_twenty<\/td>Income share held by lowest 20%, %<\/td>Active (sparse \u2014 based on national household surveys)<\/td><\/tr>
poverty_poverty_lines_percent_population<\/td>Poverty headcount ratio at national poverty lines, % of population<\/td>Sparse \u2014 based on national surveys, often only a handful of data points per country, empty for the US<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Financial Markets and Business Environment<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
market_cap_domestic_companies_percent_gdp<\/td>Market capitalization of listed domestic companies, % of GDP<\/td>Active (coverage varies by country)<\/td><\/tr>
mobile_subscriptions_per_hundred<\/td>Mobile cellular subscriptions per 100 people<\/td>Active<\/td><\/tr>
internet_users_per_hundred<\/td>Internet users per 100 people<\/td>Historical \u2014 last update 2015. Values look implausible, see Known Limitations<\/td><\/tr>
startup_procedures_register<\/td>Start-up procedures to register a business, number<\/td>Historical \u2014 World Bank discontinued the Doing Business programme in 2021. Final data point is 2019<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Environment and Geography<\/h3>\n\n\n\n
Indicator key<\/th>Description<\/th>Status<\/th><\/tr><\/thead>
co2_emissions_tons_per_capita<\/td>CO2 emissions, metric tons per capita<\/td>Stale \u2014 last update 2020. Values look implausible, see Known Limitations<\/td><\/tr>
surface_area_km<\/td>Surface area, sq. km<\/td>Active<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
Country Codes<\/h2>\n\n\n\n
The country path parameter accepts ISO 3166-1 alpha-3 codes \u2014 three letters, case-insensitive. Common examples: USA<\/strong> (United States), FRA<\/strong> (France), DEU<\/strong> (Germany), GBR<\/strong> (United Kingdom), JPN<\/strong> (Japan), CHN<\/strong> (China), IND<\/strong> (India), BRA<\/strong> (Brazil).<\/p>\n\n\n\n
The endpoint also accepts World Bank aggregate codes<\/strong>, which return aggregated regional or income-group data. The most useful aggregates:<\/p>\n\n\n\n
Code<\/th>Aggregate<\/th><\/tr><\/thead>
WLD<\/td>World<\/td><\/tr>
EUU<\/td>European Union<\/td><\/tr>
EMU<\/td>Euro area<\/td><\/tr>
OED<\/td>OECD members<\/td><\/tr>
LCN<\/td>Latin America and Caribbean<\/td><\/tr>
SSF<\/td>Sub-Saharan Africa<\/td><\/tr>
EAS<\/td>East Asia and Pacific<\/td><\/tr>
MEA<\/td>Middle East and North Africa<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
The full list of World Bank country and aggregate codes is published at api.worldbank.org\/v2\/country<\/a>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Request Example<\/h2>\n\n\n\n
    
\n                
\n            
\n                                                                        URL<\/button>\n                                                                            cURL<\/button>\n                                                                            PHP<\/button>\n                                                                            Python<\/button>\n                                                                            R<\/button>\n                                                                            Chat GPT<\/button>\n                                                <\/div>\n            
\n