# World Bank Macroeconomic Indicators by Country

> World Bank Macroeconomic Indicators by Country is a paid API for AI agents from fx-reference-rates.regnotes.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Retrieves historical macroeconomic indicator time series (GDP, inflation, unemployment, etc.) for up to 217 economies from World Bank World Development Indicators data.

## Facts

- Endpoint: GET https://fx-reference-rates.regnotes.workers.dev/v1/macro/indicator?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/world-bank-macroeconomic-indicators-by-country-3a764ac0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l08CtTYIHufPIUUXmEYdJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability world-bank-macroeconomic-indicators-by-country-3a764ac0
```

Example prompt: Can you pull the inflation_cpi_pct time series for USA, GBR, and DEU from 2015 to 2023 using the World Bank macro indicator data?

## When to prefer this

Use this endpoint when you need historical macroeconomic time series data for sovereign economies — GDP, inflation, unemployment, debt, FDI, population, and similar World Bank WDI indicators. It covers ~217 countries with annual data sourced directly from the World Bank. Prefer this over FX rate endpoints for macro fundamentals research, country risk analysis, or economic comparisons across nations. Not suitable for real-time or sub-annual data.

## Known failure modes

- Missing required 'indicator' or 'countries' query parameters returns a 400 error
- Invalid indicator enum value returns a validation error
- Country codes not recognized by World Bank may return empty series
- Data unavailable for very recent years (World Bank publication lag) results in missing or null values
- Requesting years before World Bank coverage starts returns empty arrays
- Rate limiting or payment failure (x402) blocks the request

## How this service works

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).

## Output

Returns a JSON object containing the requested indicator name and a 'series' map keyed by country code, where each value is an array of [year, value] pairs covering the requested date range. Example: {"indicator": "inflation_cpi_pct", "series": {"USA": [[2023, 4.116], [2024, 2.949]]}}

## Request schema (JSON Schema)

```json
{
 "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",
      "countries"
     ],
     "properties": {
      "end": {
       "type": "string",
       "pattern": "^\\d{4}$"
      },
      "start": {
       "type": "string",
       "pattern": "^\\d{4}$"
      },
      "countries": {
       "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"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "series": {
   "USA": [
    [
     2023,
     4.11634
    ],
    [
     2024,
     2.94953
    ]
   ]
  },
  "indicator": "inflation_cpi_pct"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/world-bank-macroeconomic-indicators-by-country-3a764ac0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fx-reference-rates.regnotes.workers.dev](https://www.zero.xyz/host/fx-reference-rates.regnotes.workers.dev/llms.txt)