# FX Reference Rates API – Macro Dataset

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

Returns World Bank macroeconomic indicators (GDP, inflation, unemployment, debt, etc.) for ~217 economies, plus country-level metadata.

## Facts

- Endpoint: GET https://fx-reference-rates.regnotes.workers.dev/v1/macro/dataset?utm_source=zero.xyz
- Price: $0.2/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-macro-dataset-36d19009
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fOaIZFO4sl43ysAbHuoMI

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-macro-dataset-36d19009
```

Example prompt: Pull the World Bank macroeconomic dataset for Japan — I need GDP, inflation, unemployment, and debt figures from the latest available year.

## When to prefer this

Choose this endpoint when you need broad, multi-indicator macroeconomic data for a large number of countries sourced from the World Bank WDI — especially for research, dashboards, or investment screening requiring GDP, inflation, unemployment, debt, FDI, and population in a single call. Prefer this over FX rate endpoints when the focus is on economic fundamentals rather than currency pricing.

## Known failure modes

- Missing or unavailable data for a specific country-indicator combination returns null or omitted values
- Invalid properties parameter returns an error or empty dataset
- World Bank source data lag may mean latest year is not yet available
- Rate limiting or payment failure returns 402 or 429 status
- Some small or non-reporting economies may have sparse indicator coverage

## 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 macroeconomic indicator values keyed by country code and year (e.g. gdp_usd for Japan), indicator metadata including World Bank series codes, and a generated_at timestamp. Covers ~217 economies and indicators such as GDP, growth, inflation, unemployment, debt, current account, reserves, FDI, and population.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "values": {
   "gdp_usd": {
    "JPN": [
     [
      2024,
      4190010000000
     ]
    ]
   }
  },
  "indicators": {
   "gdp_usd": {
    "code": "NY.GDP.MKTP.CD"
   }
  },
  "generated_at": "2026-10-25T14:49:45Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fx-reference-rates-api-macro-dataset-36d19009/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)