{"service":"macro","description":"Normalized country-level macroeconomic and development indicators, fused from free authoritative sources with per-value provenance.","routes":{"/macro/indicator":"one indicator, one or more countries, cited time-series","/macro/country":"curated headline basket for one country (composite)","/macro/compare":"one indicator across N countries + rank/min/max/spread signals","/macro/forecast":"IMF WEO forecasts (real GDP growth, inflation, debt, ...)"},"indicators":[{"indicator":"gdp_current_usd","label":"GDP (current US$)","unit":"USD","category":"economy","sources":["worldbank"],"primary_code":"NY.GDP.MKTP.CD"},{"indicator":"gdp_per_capita_usd","label":"GDP per capita (current US$)","unit":"USD","category":"economy","sources":["worldbank"],"primary_code":"NY.GDP.PCAP.CD"},{"indicator":"gdp_growth","label":"GDP growth (annual %)","unit":"percent","category":"economy","sources":["worldbank","imf"],"primary_code":"NY.GDP.MKTP.KD.ZG"},{"indicator":"gni_per_capita_atlas","label":"GNI per capita, Atlas method (current US$)","unit":"USD","category":"economy","sources":["worldbank"],"primary_code":"NY.GNP.PCAP.CD"},{"indicator":"gross_savings_gdp","label":"Gross savings (% of GDP)","unit":"percent","category":"economy","sources":["worldbank"],"primary_code":"NY.GNS.ICTR.ZS"},{"indicator":"inflation_cpi","label":"Inflation, consumer prices (annual %)","unit":"percent","category":"prices","sources":["worldbank","imf"],"primary_code":"FP.CPI.TOTL.ZG"},{"indicator":"real_interest_rate","label":"Real interest rate (%)","unit":"percent","category":"prices","sources":["worldbank"],"primary_code":"FR.INR.RINR"},{"indicator":"broad_money_gdp","label":"Broad money (% of GDP)","unit":"percent","category":"prices","sources":["worldbank"],"primary_code":"FM.LBL.BMNY.GD.ZS"},{"indicator":"unemployment","label":"Unemployment, total (% of labor force)","unit":"percent","category":"labor","sources":["worldbank","imf"],"primary_code":"SL.UEM.TOTL.ZS"},{"indicator":"labor_force","label":"Labor force, total","unit":"persons","category":"labor","sources":["worldbank"],"primary_code":"SL.TLF.TOTL.IN"},{"indicator":"govt_debt_gdp","label":"Central government debt (% of GDP)","unit":"percent","category":"fiscal","sources":["worldbank","imf"],"primary_code":"GC.DOD.TOTL.GD.ZS"},{"indicator":"govt_health_exp_gdp","label":"Current health expenditure (% of GDP)","unit":"percent","category":"fiscal","sources":["worldbank"],"primary_code":"SH.XPD.CHEX.GD.ZS"},{"indicator":"govt_education_exp_gdp","label":"Government expenditure on education (% of GDP)","unit":"percent","category":"fiscal","sources":["worldbank"],"primary_code":"SE.XPD.TOTL.GD.ZS"},{"indicator":"trade_balance_gdp","label":"External balance on goods and services (% of GDP)","unit":"percent","category":"external","sources":["worldbank"],"primary_code":"NE.RSB.GNFS.ZS"},{"indicator":"current_account_gdp","label":"Current account balance (% of GDP)","unit":"percent","category":"external","sources":["worldbank","imf"],"primary_code":"BN.CAB.XOKA.GD.ZS"},{"indicator":"exports_gdp","label":"Exports of goods and services (% of GDP)","unit":"percent","category":"external","sources":["worldbank"],"primary_code":"NE.EXP.GNFS.ZS"},{"indicator":"imports_gdp","label":"Imports of goods and services (% of GDP)","unit":"percent","category":"external","sources":["worldbank"],"primary_code":"NE.IMP.GNFS.ZS"},{"indicator":"fdi_net_inflows_gdp","label":"Foreign direct investment, net inflows (% of GDP)","unit":"percent","category":"external","sources":["worldbank"],"primary_code":"BX.KLT.DINV.WD.GD.ZS"},{"indicator":"population","label":"Population, total","unit":"persons","category":"social","sources":["worldbank"],"primary_code":"SP.POP.TOTL"},{"indicator":"population_growth","label":"Population growth (annual %)","unit":"percent","category":"social","sources":["worldbank"],"primary_code":"SP.POP.GROW"},{"indicator":"life_expectancy","label":"Life expectancy at birth (years)","unit":"years","category":"social","sources":["worldbank"],"primary_code":"SP.DYN.LE00.IN"},{"indicator":"gini","label":"Gini index","unit":"index","category":"social","sources":["worldbank"],"primary_code":"SI.POV.GINI"},{"indicator":"poverty_headcount_national","label":"Poverty headcount ratio at national poverty line (% of population)","unit":"percent","category":"social","sources":["worldbank"],"primary_code":"SI.POV.NAHC"},{"indicator":"urban_population_pct","label":"Urban population (% of total)","unit":"percent","category":"social","sources":["worldbank"],"primary_code":"SP.URB.TOTL.IN.ZS"},{"indicator":"co2_per_capita","label":"CO2 emissions (metric tons per capita)","unit":"tCO2/capita","category":"environment","sources":["worldbank"],"primary_code":"EN.GHG.CO2.PC.CE.AR5"},{"indicator":"renewable_energy_pct","label":"Renewable energy consumption (% of total final energy)","unit":"percent","category":"environment","sources":["worldbank"],"primary_code":"EG.FEC.RNEW.ZS"},{"indicator":"electricity_access_pct","label":"Access to electricity (% of population)","unit":"percent","category":"environment","sources":["worldbank"],"primary_code":"EG.ELC.ACCS.ZS"},{"indicator":"internet_users_pct","label":"Individuals using the Internet (% of population)","unit":"percent","category":"tech","sources":["worldbank"],"primary_code":"IT.NET.USER.ZS"},{"indicator":"mobile_subscriptions_per_100","label":"Mobile cellular subscriptions (per 100 people)","unit":"per_100","category":"tech","sources":["worldbank"],"primary_code":"IT.CEL.SETS.P2"}],"forecast_indicators":[{"indicator":"real_gdp_growth","label":"Real GDP growth (annual %)","unit":"percent","source_code":"NGDP_RPCH"},{"indicator":"inflation","label":"Inflation, average consumer prices (annual %)","unit":"percent","source_code":"PCPIPCH"},{"indicator":"gdp_usd","label":"GDP, current prices (US$ billions)","unit":"USD_billions","source_code":"NGDPD"},{"indicator":"gdp_per_capita_usd","label":"GDP per capita, current prices (US$)","unit":"USD","source_code":"NGDPDPC"},{"indicator":"govt_debt_gdp","label":"General government gross debt (% of GDP)","unit":"percent","source_code":"GGXWDG_NGDP"},{"indicator":"current_account_gdp","label":"Current account balance (% of GDP)","unit":"percent","source_code":"BCA_NGDPD"},{"indicator":"unemployment","label":"Unemployment rate (%)","unit":"percent","source_code":"LUR"}],"country_basket":["gdp_current_usd","gdp_per_capita_usd","gdp_growth","inflation_cpi","unemployment","population","govt_debt_gdp","current_account_gdp","life_expectancy","co2_per_capita"],"aggregates":{"WLD":"World","EUU":"European Union","EMU":"Euro area","OED":"OECD members","NAC":"North America","ECS":"Europe & Central Asia","EAS":"East Asia & Pacific","LCN":"Latin America & Caribbean","MEA":"Middle East & North Africa","SAS":"South Asia","SSF":"Sub-Saharan Africa","ARB":"Arab World","HIC":"High income","MIC":"Middle income","LIC":"Low income","LMY":"Low & middle income"},"sources":{"worldbank":{"attribution":"Source: World Bank, World Development Indicators (CC-BY 4.0)","license":"CC-BY 4.0","keyless":true,"enabled":true,"cache_ttl_seconds":43200,"note":"Keyless. JSON [meta, [obs...]]. The core source (~90% of coverage)."},"imf":{"attribution":"Source: IMF World Economic Outlook","license":"IMF terms (attribution)","keyless":true,"enabled":true,"cache_ttl_seconds":86400,"note":"Keyless. Gives FORECASTS. Gotcha: transient 403 -> retry (handled)."},"fred":{"attribution":"Source: Federal Reserve Bank of St. Louis (FRED)","license":"St. Louis Fed terms (attribution)","keyless":false,"enabled":true,"cache_ttl_seconds":21600,"note":"Needs a FREE key (FRED_API_KEY, runtime-only). US high-freq enrichment tier."},"eurostat":{"attribution":"Source: Eurostat","license":"Eurostat free reuse (attribution)","keyless":true,"enabled":false,"cache_ttl_seconds":43200,"note":"JSON-stat; EU granularity. Enable = pin dataset dims per indicator (a row)."}},"attribution":["Source: World Bank, World Development Indicators (CC-BY 4.0)","Source: IMF World Economic Outlook","Source: Federal Reserve Bank of St. Louis (FRED)","Source: Eurostat"],"country_input":"ISO-3166 alpha-2, alpha-3, common name, or a World Bank aggregate code"}