# ECB Euro Reference Exchange Rates

> ECB Euro Reference Exchange Rates is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Returns the official European Central Bank euro reference rate for a given currency pair, optionally for a specific date or frequency.

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/ecb/exchange-rate
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecb-euro-reference-exchange-rates-0d4b9714
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8TsOyP6M9sjWCfTYfn09C

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-euro-reference-exchange-rates-0d4b9714
```

Example prompt: What's the official ECB euro reference rate for USD today? And can you also pull the rate for GBP on 2024-11-15?

## When to prefer this

Use this endpoint when you need the official ECB euro reference rate (not live market rates) for regulatory, compliance, accounting, or reporting purposes. Prefer this over commercial FX APIs when ECB-authoritative rates are required, or when working with EU financial data. Covers ~29 major currencies. Not suitable for real-time trading or live market pricing.

## Known failure modes

- Unsupported currency code returns an error — ECB only covers ~29 currencies
- Weekend or public holiday dates return no data (rates only published on ECB working days)
- Future dates return an error or empty result
- Invalid date format (non-ISO YYYY-MM-DD) causes a validation error
- Service may be slow to respond if the Render instance is cold-starting

## How this service works

Official European Central Bank (ECB) euro reference exchange rates — convert EUR to/from any currency (FX / forex rates), reference rate lookup by currency (29 currencies), latest or by date. Reference rates (published ~16:00 CET on working days), not live market rates. EU/worldwide coverage.

## Output

Returns the ECB official reference rate for the requested currency pair (EUR base), including the rate value, currency code, and the observation date. Data is sourced from ECB statistical data warehouse, published around 16:00 CET on working days. May return daily or monthly rates depending on the frequency parameter.

## 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",
     "required": [
      "currency"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "Optional observation date ISO YYYY-MM-DD; default = latest available"
      },
      "currency": {
       "type": "string",
       "description": "3-letter ISO currency code, e.g. 'USD', 'GBP', 'CHF', 'JPY'"
      },
      "frequency": {
       "type": "string",
       "description": "D (daily, default) or M (monthly)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "EUR",
  "rate": 1.134,
  "cached": false,
  "source": "European Central Bank — euro reference rates, SDMX 2.1 (data-api.ecb.europa.eu)",
  "currency": "USD",
  "frequency": "D",
  "timestamp": "2026-06-25T12:00:00Z",
  "disclaimer": "ECB reference rates (informational, published ~16:00 CET on working days), not a real-time market rate.",
  "series_key": "D.USD.EUR.SP00.A",
  "observation_date": "2026-06-24"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-euro-reference-exchange-rates-0d4b9714/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)