# Country Macro Indicators (World Bank)

> Country Macro Indicators (World Bank) is a paid API for AI agents from macro-indicators-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

Returns official World Bank World Development Indicators (GDP, inflation, unemployment, debt, population, trade, FDI, etc.) for up to 5 countries across multiple years.

## Facts

- Endpoint: GET https://macro-indicators-production.up.railway.app/v1/macro/indicators?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-macro-indicators-world-bank-6dd514ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X8X9T2jkPtd6JiRljfRa9

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 country-macro-indicators-world-bank-6dd514ad
```

Example prompt: Pull the latest 3 years of World Bank macro indicators for Germany, France, and the US — I need GDP, GDP growth, inflation, and unemployment for a country risk report.

## When to prefer this

Choose this endpoint when you need official, authoritative macroeconomic statistics sourced directly from the World Bank WDI database — ideal for research, credit analysis, country risk, or market sizing where data provenance matters. Prefer it over scraped or aggregated sources when you need citable, standardized figures across ~217 economies with consistent WDI codes. Best for cross-country comparisons of up to 5 economies at a time.

## Known failure modes

- Invalid or unsupported ISO2/ISO3 country code returns an error or empty results
- Requesting more than 5 countries at once exceeds the limit
- Unknown or misspelled indicator short name may fall back to default set or return an error
- World Bank data gaps for recent years (data often lags 1-2 years) result in null or missing values
- Requesting years=0 or years>10 may return a validation error
- Payment failure (x402) blocks the request entirely

## How this service works

Official World Bank World Development Indicators for any of ~217 economies: GDP and GDP per capita (USD), real GDP growth, CPI inflation, unemployment, population, government debt, trade, FDI and more, latest years with the year of each value. Any WDI code, up to 5 countries. Use when an agent needs official macro figures for a country (GDP, growth, inflation, unemployment, debt, population, trade) for research, market sizing, credit or country-risk work.

## Output

A JSON object containing per-country arrays of indicator values, each with the WDI code, unit (e.g. 'annual %', 'current US$'), and year-value pairs for the requested time window, plus API status and legal metadata.

## 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": [
      "countries"
     ],
     "properties": {
      "years": {
       "type": "integer",
       "description": "Most recent years per indicator, 1-10 (default 3)"
      },
      "countries": {
       "type": "string",
       "description": "Comma list of ISO2/ISO3 codes, up to 5 (e.g. DE,DK,USA)"
      },
      "indicators": {
       "type": "string",
       "description": "Comma list of short names (gdp, gdp_per_capita, gdp_growth, inflation, unemployment, population, debt, current_account, exports, fdi, interest_rate) or WDI codes; default core set"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legal": {
   "terms": "https://macro-indicators-production.up.railway.app/terms",
   "privacy": "https://macro-indicators-production.up.railway.app/privacy"
  },
  "status": "ok",
  "use_when": "Use when an agent needs official macro figures for a country (GDP, growth, inflation, unemployment, debt, population, trade) for research, market sizing, credit or country-risk work.",
  "countries": [
   {
    "iso3": "DEU",
    "name": "Germany",
    "indicators": {
     "gdp_growth": {
      "code": "NY.GDP.MKTP.KD.ZG",
      "unit": "annual %",
      "values": [
       {
        "year": 2025,
        "value": 0.2
       }
      ]
     }
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-macro-indicators-world-bank-6dd514ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from macro-indicators-production.up.railway.app](https://www.zero.xyz/host/macro-indicators-production.up.railway.app/llms.txt)
