# Suverse Macro GDP - World Bank GDP Time Series

> Suverse Macro GDP - World Bank GDP Time Series is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns annual GDP in current US dollars for any country as a time series, sourced from World Bank data, keyed by ISO country code.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-macro-gdp
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-macro-gdp-world-bank-gdp-time-series-0d8d78d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cBTK571-Srf1kSSzPaE0F

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 suverse-macro-gdp-world-bank-gdp-time-series-0d8d78d4 -d '<json body>'
```

Example prompt: Pull the full annual GDP time series in current US dollars for Germany (ISO code DE) from the World Bank so I can chart economic growth over the past two decades.

## When to prefer this

Use this endpoint when you need structured, authoritative annual GDP data in current USD for any sovereign country, especially for macro analysis, economy sizing, or growth computation — without needing a World Bank API key. Prefer over manual World Bank API calls when working in an agent context with x402 micropayment support.

## Known failure modes

- Invalid or unrecognized ISO country code returns an error or empty series
- Countries with incomplete World Bank coverage may have missing years or null values
- Network or proxy timeout may return a 5xx error
- Malformed request body (missing required fields) returns a 4xx validation error
- Payment failure via x402 protocol results in 402 response and no data

## How this service works

Gross Domestic Product in current US dollars for any country by ISO code as a yearly time series from World Bank: country, year, GDP value. For AI agents sizing economies, computing growth, building macro dashboards, and comparing national output.

## Output

Returns a yearly time series of GDP in current US dollars for the requested country, including the country name, ISO code, and an array of {year, value} records sourced from the World Bank.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-macro-gdp-world-bank-gdp-time-series-0d8d78d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)