# FX Reference Rates API – Country Macroeconomic Indicators

> FX Reference Rates API – Country Macroeconomic Indicators is a paid API for AI agents from fx-reference-rates.regnotes.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Returns World Bank macroeconomic indicators (GDP, inflation, unemployment, debt, population, and more) for a specified country, covering ~217 economies.

## Facts

- Endpoint: GET https://fx-reference-rates.regnotes.workers.dev/v1/macro/country?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fx-reference-rates-api-country-macroeconomic-indicators-6846aa1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0PTn3VHlWDqPgQX70sceY

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 fx-reference-rates-api-country-macroeconomic-indicators-6846aa1e
```

Example prompt: Pull up the latest macroeconomic indicators for Japan — GDP growth, inflation, unemployment, and debt — going back 5 years.

## When to prefer this

Choose this endpoint when you need structured, multi-indicator macroeconomic data for a specific country sourced from the authoritative World Bank WDI dataset. It is ideal for country risk analysis, investment research, economic comparisons, or populating dashboards with official statistics. Prefer this over general web search when you need clean, machine-readable, consistently formatted economic data across ~217 economies with historical time series.

## Known failure modes

- Missing or invalid 'country' parameter returns an error — the country query param is required
- Unrecognized country name or code may return no results or an error
- Requesting more than the available historical coverage may return fewer years than requested
- Some indicators may have null or missing values for certain countries where World Bank data is unavailable
- Network or upstream World Bank data issues may cause intermittent failures

## How this service works

Daily ECB euro foreign exchange reference rates for 30 currencies (incl. EUR), any base via cross rates, conversion, historical dates (2024-09-24 onward) and time series. Updated daily. Source: ECB (European Central Bank euro foreign exchange reference rates). Reference rates are published around 16:00 CET on TARGET business days for information purposes only; not for transaction pricing. Cross rates are derived via EUR. Also: AI infrastructure price reference data (cloud GPU instance list prices on AWS and Azure, LLM API token prices), refreshed daily. Also: country macroeconomic indicators (GDP, growth, inflation, unemployment, debt, current account, reserves, FDI, population and more) for ~217 economies from the World Bank World Development Indicators (CC BY 4.0).

## Output

A JSON object containing country metadata (ISO3 code, name, income group, region) and a dictionary of macroeconomic indicators. Each indicator includes the latest value with its year and a history array of [year, value] pairs going back as many years as requested.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "years": {
       "type": "string",
       "pattern": "^\\d{1,2}$"
      },
      "country": {
       "type": "string",
       "minLength": 2
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "country": {
   "iso3": "JPN",
   "name": "Japan",
   "income": "High income",
   "region": "East Asia & Pacific"
  },
  "indicators": {
   "gdp_growth_pct": {
    "latest": {
     "year": 2025,
     "value": 1.19311
    },
    "history": [
     [
      2024,
      -0.240084
     ],
     [
      2025,
      1.19311
     ]
    ]
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fx-reference-rates-api-country-macroeconomic-indicators-6846aa1e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fx-reference-rates.regnotes.workers.dev](https://www.zero.xyz/host/fx-reference-rates.regnotes.workers.dev/llms.txt)