{"uid":"cap_obuPVBKonOu2GwrrhUY6P","slug":"fx-reference-rates-api-country-macroeconomic-indicator-ranking-c000ead8","name":"FX Reference Rates API – Country Macroeconomic Indicator Ranking","description":"Daily ECB euro foreign exchange reference rates for 30 currencies (incl. EUR), any base via cross rates, conversion, historical dates (2024-09-24 onward) and time series. Updated daily. Source: ECB (European Central Bank euro foreign exchange reference rates). Reference rates are published around 16:00 CET on TARGET business days for information purposes only; not for transaction pricing. Cross rates are derived via EUR. Also: AI infrastructure price reference data (cloud GPU instance list prices on AWS and Azure, LLM API token prices), refreshed daily. Also: country macroeconomic indicators (GDP, growth, inflation, unemployment, debt, current account, reserves, FDI, population and more) for ~217 economies from the World Bank World Development Indicators (CC BY 4.0).","url":"https://fx-reference-rates.regnotes.workers.dev/v1/macro/rank?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["indicator"],"properties":{"year":{"type":"string","pattern":"^\\d{4}$"},"limit":{"type":"string","pattern":"^\\d{1,3}$"},"order":{"enum":["desc","asc"],"type":"string"},"income":{"type":"string"},"region":{"type":"string"},"indicator":{"enum":["gdp_usd","gdp_growth_pct","gdp_per_capita_usd","gni_per_capita_ppp_usd","inflation_cpi_pct","unemployment_pct","population","exports_pct_gdp","imports_pct_gdp","current_account_pct_gdp","central_govt_debt_pct_gdp","tax_revenue_pct_gdp","real_interest_rate_pct","lending_rate_pct","fdi_net_inflows_pct_gdp","total_reserves_usd","official_fx_lcu_per_usd","remittances_pct_gdp","gini_index","life_expectancy_years","internet_users_pct"],"type":"string"},"aggregates":{"enum":["true","false"],"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ranked":[{"iso3":"IRL","name":"Ireland","rank":1,"year":2025,"value":12.3376}],"indicator":"gdp_growth_pct"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3bm50WsFS9boFonPjpMLd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks ~217 countries by a chosen macroeconomic indicator (GDP, inflation, unemployment, etc.) from World Bank data, with optional filters by year, income group, region, and result count.","exampleAgentPrompt":"Show me the top 20 countries ranked by GDP growth rate in descending order for 2023, excluding regional aggregates.","exampleUseCases":[{"title":"Identify fastest-growing economies","prompt":"Which 15 countries had the highest GDP growth percentage in 2022? Rank them from highest to lowest and exclude aggregate regions."},{"title":"Compare inflation across income groups","prompt":"Rank all lower-middle-income countries by their CPI inflation rate for 2023, from highest to lowest — I want to see which ones are struggling most with inflation."},{"title":"Assess debt levels in European region","prompt":"List European countries ranked by central government debt as a percentage of GDP for the most recent available year, in descending order, top 30."}],"resultDescription":"Returns a JSON object with a 'ranked' array where each element contains the country's ISO3 code, full name, rank number, year of data, and numeric indicator value, plus the indicator name used for ranking.","failureModes":["Missing required 'indicator' query parameter returns a validation error","Invalid indicator enum value returns a 400-level error","Requesting a year before World Bank data coverage returns empty or null results","Invalid region or income group filter silently returns empty array","Non-numeric or malformed 'limit' parameter fails schema validation"],"whenToPreferThis":"Use this endpoint when you need a ranked, cross-country comparison of a specific macroeconomic indicator from World Bank data, especially when filtering by income group or region matters. Prefer it over raw data downloads when you need a ready-made leaderboard or bottom-N list. Not suitable for transaction FX pricing or historical time-series analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:44.585Z","isFirstParty":false,"canonicalSlug":"fx-reference-rates-api-country-macroeconomic-indicator-ranking-c000ead8"}