# World Bank Country Macro Profile

> World Bank Country Macro Profile is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.02/call, status unknown (last checked 2026-09-13).

Returns a country's latest macroeconomic indicators (GDP, inflation, unemployment, population, government debt, exports, FDI, etc.) from the World Bank's World Development Indicators in a single call.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/world-bank/country/{iso}
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-world-bank-country-macro-profile-def5fa39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t31AZtSwJaWmIsOJmX3MI

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 agents-x402stock-xyz-world-bank-country-macro-profile-def5fa39
```

Example prompt: Pull the full macro profile for Germany — GDP, inflation, unemployment, government debt, and FDI — from the World Bank.

## When to prefer this

Choose this endpoint when you need a broad international macroeconomic snapshot for any country in a single call — especially when US-specific sources like FRED or BLS don't cover the country. Ideal for country risk analysis, investment due diligence, economic research, and comparative international studies. Prefer this over assembling individual World Bank API calls when you want GDP, inflation, unemployment, debt, and trade data in one structured response.

## Known failure modes

- Invalid or unrecognized ISO country code returns an error or empty indicators array
- World Bank data lag: some indicators may have values only through 2022 or 2023, leaving 'latest' null for very recent years
- Small or non-sovereign territories may have incomplete or missing indicator coverage
- Network or upstream World Bank API timeout causing a 5xx response
- Payment failure via x402 if agent wallet has insufficient USDC

## How this service works

A country's macro profile in one call: latest GDP, GDP growth, GDP per capita, inflation, unemployment, population, government debt, current account, exports, and FDI, from the World Bank's World Development Indicators. Pass an ISO country code in the path (e.g. US, CN, IN, DE). International macro the US-only FRED/BLS endpoints don't cover. Source: World Bank (CC BY 4.0). From x402stock

## Output

A JSON object containing the country's ISO codes and name, an as_of timestamp, and an array of indicator objects each with a short label, World Bank indicator code, full indicator name, and the latest available value and year. Indicators cover GDP (absolute, growth, per capita), inflation, unemployment, population, government debt, current account, exports, and FDI. Also includes a source field ('world_bank') and an attribution string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "iso"
 ],
 "properties": {
  "iso": {
   "type": "string",
   "description": "ISO 3166 country code (2- or 3-letter), e.g. US or USA."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "country",
  "indicators",
  "attribution"
 ],
 "properties": {
  "as_of": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "source": {
   "type": "string",
   "const": "world_bank"
  },
  "country": {
   "type": "object",
   "required": [
    "code",
    "name",
    "iso3"
   ],
   "properties": {
    "code": {
     "type": "string"
    },
    "iso3": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "name": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "indicators": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "indicator",
     "indicator_code",
     "indicator_name",
     "latest"
    ],
    "properties": {
     "latest": {
      "anyOf": [
       {
        "type": "object",
        "required": [
         "year",
         "value"
        ],
        "properties": {
         "year": {
          "type": "string"
         },
         "value": {
          "type": "number"
         }
        },
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ]
     },
     "indicator": {
      "type": "string"
     },
     "indicator_code": {
      "type": "string"
     },
     "indicator_name": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "attribution": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-world-bank-country-macro-profile-def5fa39/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)