# ECB FX Rates API (x402)

> ECB FX Rates API (x402) is a paid API for AI agents from x402-data-api-x6da.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-20).

Returns European Central Bank foreign exchange reference rates for a given base currency, date, and set of currency symbols, billed per call via USDC on Base.

## Facts

- Endpoint: GET https://x402-data-api-x6da.onrender.com/v1/fx/rates?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecb-fx-rates-api-x402-7ec43320
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ADaQme6Rwkt0CjvPXQ-Y2

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 ecb-fx-rates-api-x402-7ec43320
```

Example prompt: What are the official ECB exchange rates for USD, GBP, and JPY as of yesterday, using EUR as the base currency?

## When to prefer this

Choose this endpoint when you need official ECB foreign exchange reference rates — particularly for compliance, accounting, or financial reporting where ECB authority matters. Prefer it over commercial FX APIs when official euro-area data is required, historical rates within the last 90 days are needed, or when you want a pay-per-call model without subscription sign-up via x402/USDC.

## Known failure modes

- Date outside last 90 days returns an error or no data
- Invalid ISO 4217 currency code returns an error
- Unsupported symbol in comma list may be omitted or cause an error
- Payment failure (insufficient USDC balance) returns HTTP 402
- Rate not yet published for today (ECB publishes once daily around 16:00 CET) may return previous day's rate

## How this service works

Pay-per-call data and web utilities for AI agents: web page to Markdown, SEO audit, email check, domain RDAP/DNS and mail security, ECB FX rates, time zones and business days, SEC EDGAR search and fundamentals, Federal Register, USAspending, weather and NWS alerts, VIN, NPI, ATS jobs. USDC on Base via x402, no sign-up.

## Output

A JSON object containing the base currency, the effective rate date, an amount field, a rates map of requested symbols to their exchange rates (relative to the base), the full set of EUR reference rates from the ECB, and an attribution string crediting ECB statistics. Cross-rates are derived from EUR reference rates.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "base": {
       "type": "string",
       "description": "ISO 4217, default EUR"
      },
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD within last 90 days; uses the latest fixing on or before it"
      },
      "amount": {
       "type": "number",
       "description": "default 1"
      },
      "symbols": {
       "type": "string",
       "description": "comma list, default all"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "base": {
       "type": "string"
      },
      "date": {
       "type": "string"
      },
      "rates": {
       "type": "object",
       "properties": {
        "EUR": {
         "type": "number"
        },
        "GBP": {
         "type": "number"
        },
        "JPY": {
         "type": "number"
        }
       }
      },
      "amount": {
       "type": "number"
      },
      "attribution": {
       "type": "string"
      },
      "requested_date": {},
      "eur_reference_rates": {
       "type": "object",
       "properties": {
        "AUD": {
         "type": "number"
        },
        "BRL": {
         "type": "number"
        },
        "CAD": {
         "type": "number"
        },
        "CHF": {
         "type": "number"
        },
        "CNY": {
         "type": "number"
        },
        "CZK": {
         "type": "number"
        },
        "DKK": {
         "type": "number"
        },
        "GBP": {
         "type": "number"
        },
        "HKD": {
         "type": "number"
        },
        "HUF": {
         "type": "number"
        },
        "IDR": {
         "type": "number"
        },
        "ILS": {
         "type": "number"
        },
        "INR": {
         "type": "number"
        },
        "ISK": {
         "type": "number"
        },
        "JPY": {
         "type": "number"
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "date": "2026-10-23",
  "rates": {
   "EUR": 89.341553,
   "GBP": 74.803895,
   "JPY": 15680.335924
  },
  "amount": 100,
  "attribution": "Source: ECB statistics (euro foreign exchange reference rates, https://www.ecb.europa.eu/stats/eurofxref/). Published for information purposes only; cross rates are derived from EUR rates.",
  "requested_date": null,
  "eur_reference_rates": {
   "AUD": 1.5939,
   "BRL": 5.6485,
   "CAD": 1.5665,
   "CHF": 0.9227,
   "CNY": 7.466,
   "CZK": 24.327,
   "DKK": 7.4748,
   "GBP": 0.83728,
   "HKD": 8.7793,
   "HUF": 366.73,
   "IDR": 20268.06,
   "ILS": 3.4939,
   "INR": 106.272,
   "ISK": 136.2,
   "JPY": 175.51,
   "KRW": 1482.46,
   "MXN": 21.0226,
   "MYR": 4.5729,
   "NOK": 10.4665,
   "NZD": 1.9682,
   "PLN": 4.3945,
   "RON": 5.3492,
   "SEK": 11.131,
   "TRY": 55.6715,
   "USD": 1.1193
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-fx-rates-api-x402-7ec43320/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api-x6da.onrender.com](https://www.zero.xyz/host/x402-data-api-x6da.onrender.com/llms.txt)
