# Official Macro & FX Data — ECB Exchange Rates

> Official Macro & FX Data — ECB Exchange Rates is a paid API for AI agents from x402-apis.pages.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-22).

Returns ECB official euro reference exchange rates for ~30 currencies, supporting any base currency and any date since 1999, with cross-rate computation.

## Facts

- Endpoint: GET https://x402-apis.pages.dev/v1/fx-rates?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/official-macro-fx-data-ecb-exchange-rates-7a9a3c37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aqcZHa3Bf2buuv1wB-Wd-

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 official-macro-fx-data-ecb-exchange-rates-7a9a3c37
```

Example prompt: What's the official ECB exchange rate to convert EUR to USD, GBP, and JPY today? Use the euro as the base currency.

## When to prefer this

Choose this endpoint when you need authoritative, official central bank exchange rates (not market mid-rates or broker rates) sourced directly from the ECB, especially for compliance, accounting, invoicing, or regulatory purposes. It covers ~30 major currencies with full historical depth back to 1999 and supports cross-rate computation from any ECB reference currency as base — making it superior to generic FX APIs when official sourcing and exact rate-date traceability matter.

## Known failure modes

- HTTP 400 for invalid or malformed currency codes or date format — returned before any charge
- Unknown currency code returns an error without billing
- ECB outage or unavailable data returns an error without billing
- Dates before 1999-01-04 are out of range
- Weekend or holiday dates return rates from the previous ECB fixing day, not the exact date requested

## How this service works

Use when an agent needs an official exchange rate to convert prices, invoices or portfolios: ECB euro reference rates for ~30 currencies (USD, GBP, CHF, JPY, CNY …), latest or for any day since 1999, with any base currency (cross rates computed from the ECB fix). Returns the exact rate date. Source named in every answer. Bad input: HTTP 400 before payment; unknown currency or outage is not charged.

## Output

A JSON object containing the base currency, the exact ECB fix date (adjusted for weekends/holidays to the previous business day), a rates map of target currency codes to their exchange rates, and a named source attribution string.

## 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",
     "properties": {
      "base": {
       "type": "string",
       "description": "Base currency, 3 letters, default EUR. Any ECB reference currency."
      },
      "date": {
       "type": "string",
       "description": "Day as YYYY-MM-DD (1999-01-04 or later). Default: latest. Weekends/holidays return the previous ECB fix."
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated target currencies, e.g. USD,CHF,GBP. Default: all."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "base",
      "date",
      "rates",
      "source"
     ],
     "properties": {
      "base": {
       "type": "string"
      },
      "date": {
       "type": "string"
      },
      "rates": {
       "type": "object"
      },
      "source": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/official-macro-fx-data-ecb-exchange-rates-7a9a3c37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-apis.pages.dev](https://www.zero.xyz/host/x402-apis.pages.dev/llms.txt)