# x402stock World Bank Economic Indicator API

> x402stock World Bank Economic Indicator API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-08).

Fetches World Bank development indicator data (e.g. GDP, population, inflation) for a given country, returning latest value, prior year, change, and historical series — paid per call in USDC via x402.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/world-bank/%7Bindicator%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-world-bank-economic-indicator-api-03d898ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J0OV41N_z524sFiLeskuA

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 x402stock-world-bank-economic-indicator-api-03d898ff
```

Example prompt: Pull the World Bank GDP indicator for the United States — give me the latest value, the prior year, and the last 10 years of history.

## When to prefer this

Choose this endpoint when you need authoritative, sourced World Bank development indicator data for any country without managing API keys or accounts. Ideal for global macro research, country comparison, economic modeling, or enriching reports with official international statistics. Prefer over scraping World Bank directly or using general-purpose search because it returns structured, normalized JSON with change calculations and attribution already included.

## Known failure modes

- Unknown indicator code returns 404 or empty result
- Invalid country code (not matching ^[A-Za-z]{2,3}$) returns validation error
- Limit out of range (0 or above 66) returns schema validation error
- World Bank data unavailable for a given indicator/country combination returns null latest/prior
- Payment failure via x402 returns 402 with payment instructions
- Network timeout or upstream World Bank API outage returns 5xx error

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing: the World Bank indicator slug and full name, the country (code, name, ISO3), the latest data point (year + value), the prior year data point, absolute and percent change, a historical array of up to N year/value pairs, the last updated date, and an attribution string citing World Bank CC BY 4.0.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "country",
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 66,
       "exclusiveMinimum": 0
      },
      "country": {
       "type": "string",
       "default": "US",
       "pattern": "^[A-Za-z]{2,3}$"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "indicator",
      "indicator_code",
      "indicator_name",
      "country",
      "last_updated",
      "latest",
      "prior",
      "change",
      "change_percent",
      "history",
      "attribution"
     ],
     "properties": {
      "as_of": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "prior": {
       "anyOf": [
        {
         "type": "object",
         "required": [
          "year",
          "value"
         ],
         "properties": {
          "year": {
           "type": "string"
          },
          "value": {
           "type": "number"
          }
         },
         "additionalProperties": false
        },
        {
         "type": "null"
        }
       ]
      },
      "change": {
       "anyOf": [
        {
         "type": "number"
        },
        {
         "type": "null"
        }
       ]
      },
      "latest": {
       "anyOf": [
        {
         "type": "object",
         "required": [
          "year",
          "value"
         ],
         "properties": {
          "year": {
           "type": "string"
          },
          "value": {
           "type": "number"
          }
         },
         "additionalProperties": false
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2024-12-31T00:00:00.000Z",
  "prior": {
   "year": "2023",
   "value": 27292170793214.4
  },
  "change": 1458785337516.8,
  "latest": {
   "year": "2024",
   "value": 28750956130731.2
  },
  "source": "world_bank",
  "country": {
   "code": "US",
   "iso3": "USA",
   "name": "United States"
  },
  "history": [
   {
    "year": "2024",
    "value": 28750956130731.2
   },
   {
    "year": "2023",
    "value": 27292170793214.4
   }
  ],
  "indicator": "gdp",
  "attribution": "Source: World Bank, World Development Indicators (CC BY 4.0)",
  "last_updated": "2026-04-08",
  "change_percent": 5.35,
  "indicator_code": "NY.GDP.MKTP.CD",
  "indicator_name": "GDP (current US$)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-world-bank-economic-indicator-api-03d898ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)