# Country Economic Data API

> Country Economic Data API is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-28).

Returns World Bank macroeconomic indicators (GDP, inflation, unemployment, population, growth), live USD exchange rates, and upcoming public holidays for up to 3 countries per call, identified by ISO-2 code.

## Facts

- Endpoint: POST https://agent-data.centorprat.workers.dev/tools/world-bank-country-economic-data?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-economic-data-api-0f4c351c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_02FVkcv9y36ZH0WDTra6A

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-economic-data-api-0f4c351c -d '<json body>'
```

Example prompt: Pull the World Bank economic snapshot for Germany, Japan, and Brazil — I need GDP, GDP per capita, population, inflation, unemployment, growth rate, the current USD exchange rate, and the next 3 public holidays for each.

## When to prefer this

Choose this endpoint when you need a single structured call combining World Bank macroeconomic indicators, live FX rates, and public holidays for 1–3 countries simultaneously. It is ideal for market research agents, financial due diligence workflows, or international operations dashboards that need breadth of economic context without assembling multiple separate APIs. It is keyless and priced per call, making it suitable for lightweight or infrequent lookups without API key management overhead.

## Known failure modes

- Invalid or unrecognized ISO-2 country code returns a failed lookup (not charged)
- More than 3 countries in a single call exceeds the maxItems limit and may be rejected
- World Bank data may be unavailable or stale for very small or sanctioned countries
- Exchange rate data may be delayed or unavailable for non-standard currencies
- holidaysCount exceeding available data returns fewer entries than requested

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

A structured record per country containing: World Bank GDP (current USD), GDP per capita, total population, annual GDP growth rate, inflation rate, unemployment rate, live exchange rate against USD (or a specified base currency), and a list of upcoming public holidays with dates and names. Failed lookups are excluded from the response and not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "description": "A single ISO 3166-1 alpha-2 country code. Example: ES (Spain), US, JP."
  },
  "countries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 3,
   "description": "An array of ISO-2 codes, e.g. [\"ES\",\"JP\",\"US\"]. Billed per country."
  },
  "baseCurrency": {
   "type": "string",
   "description": "ISO-4217 base currency for the exchange-rate block. Default USD."
  },
  "holidaysCount": {
   "type": "integer",
   "description": "How many upcoming public holidays to return per country."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "fx": {
     "base": "USD",
     "majors": {
      "CNY": 6.684864,
      "EUR": 0.892784,
      "GBP": 0.747655,
      "JPY": 156.839696,
      "USD": 1
     },
     "updated": "Sat, 24 Oct 2026 00:02:31 +0000",
     "localPerBase": 0.892784,
     "localCurrency": "EUR"
    },
    "_ok": true,
    "name": "Spain",
    "region": "Europe & Central Asia",
    "capital": "Madrid",
    "country": "ES",
    "sources": [
     "worldbank.org",
     "open.er-api.com",
     "date.nager.at"
    ],
    "latitude": 40.4167,
    "longitude": -3.70327,
    "capturedAt": "2026-10-24T13:49:06.148133+00:00",
    "indicators": {
     "population": {
      "year": "2025",
      "value": 49355143
     },
     "gdpGrowthPct": {
      "year": "2025",
      "value": 2.82495400578509
     },
     "inflationPct": {
      "year": "2025",
      "value": 2.67326741144651
     },
     "gdpPerCapitaUsd": {
      "year": "2025",
      "value": 38627.2472148623
     },
     "unemploymentPct": {
      "year": "2025",
      "value": 10.376
     }
    },
    "incomeLevel": "High income",
    "upcomingHolidays": [
     {
      "date": "2026-11-01",
      "name": "All Saints Day",
      "localName": "Día de todos los Santos"
     },
     {
      "date": "2026-12-06",
      "name": "Constitution Day",
      "localName": "Día de la Constitución"
     },
     {
      "date": "2026-12-08",
      "name": "Immaculate Conception",
      "localName": "Inmaculada Concepción"
     },
     {
      "date": "2026-12-25",
      "name": "Christmas Day",
      "localName": "Navidad"
     },
     {
      "date": "2026-12-26",
      "name": "St. Stephen's Day",
      "localName": "Feast of Saint Stephen"
     }
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-economic-data-api-0f4c351c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)