# World Bank Indicator Annual Time Series by Country

> World Bank Indicator Annual Time Series by Country is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-11).

Returns an annual time series for a named World Bank macro indicator (e.g. GDP, inflation, unemployment) for a given country, including latest value, prior year, and year-over-year change.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/world-bank/{indicator}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-11
- 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-indicator-annual-time-series-by-country-10e14e9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hSzbpDCTOV9dDvbFrsA-j

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-indicator-annual-time-series-by-country-10e14e9a
```

Example prompt: Pull the World Bank GDP growth time series for India over the last 15 years and tell me the latest value, what it was the year before, and how much it changed.

## When to prefer this

Use this endpoint when you need structured, World Bank-sourced annual macro data for a specific country and indicator, including year-over-year change context. It is preferred over raw World Bank API calls because it normalises the response into a consistent schema with latest/prior/change fields pre-computed, supports simple indicator slug names (e.g. 'gdp' instead of 'NY.GDP.MKTP.CD'), and is accessible pay-per-call without API keys. It covers cross-country reference for 10 named macro indicators spanning GDP, inflation, unemployment, population, debt, trade, FDI, and more.

## Known failure modes

- Unknown indicator slug returns a 404 or error response
- Invalid or unrecognized country code returns an error
- World Bank data may have a 1-2 year lag so 'latest' may not be the current calendar year
- Some country-indicator combinations have sparse or missing data, resulting in null values in history
- limit values outside the allowed range (1–66) return a validation error

## How this service works

Annual time series of one World Bank indicator for a country, with latest value, prior year, and change. Indicators: gdp, gdp-growth, gdp-per-capita, inflation, unemployment, population, govt-debt, current-account, exports, fdi. Pick the country with `?country=US` (ISO2/ISO3, default US) and the span with `?limit=` years (default 10). Cross-country macro reference. Source: World Bank (CC BY 4.0).

## Output

A JSON object containing the indicator slug and full World Bank indicator code and name, country code and name, the latest available year and value, the prior year and value, absolute and percent change, a full array of annual {year, value} history entries up to the requested limit, a source tag ('world_bank'), an as_of date, last_updated timestamp, and a CC BY 4.0 attribution string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "indicator"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 66,
   "exclusiveMinimum": 0
  },
  "country": {
   "type": "string",
   "default": "US",
   "pattern": "^[A-Za-z]{2,3}$"
  },
  "indicator": {
   "type": "string",
   "description": "World Bank WDI indicator code, e.g. NY.GDP.MKTP.CD."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "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
    },
    {
     "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
  },
  "history": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "year",
     "value"
    ],
    "properties": {
     "year": {
      "type": "string"
     },
     "value": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   }
  },
  "indicator": {
   "type": "string"
  },
  "attribution": {
   "type": "string"
  },
  "last_updated": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "change_percent": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "indicator_code": {
   "type": "string"
  },
  "indicator_name": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-world-bank-indicator-annual-time-series-by-country-10e14e9a/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)