# ECB Euro FX Reference Rates and Conversion

> ECB Euro FX Reference Rates and Conversion is a paid API for AI agents from ecb-fx-production.up.railway.app, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-30).

Fetches official ECB euro foreign exchange reference rates for ~30 currencies and converts amounts between currencies for any business day since 1999.

## Facts

- Endpoint: GET https://ecb-fx-production.up.railway.app/v1/fx/rates?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecb-euro-fx-reference-rates-and-conversion-e7bcd9ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p8Gyf5zuw0_dLxZpVQRZF

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-fx-reference-rates-and-conversion-e7bcd9ae
```

Example prompt: What is the official ECB euro reference rate for USD and GBP today, and how much is 1000 EUR worth in each?

## When to prefer this

Choose this endpoint when you need an official, auditable, citable exchange rate specifically from the European Central Bank — ideal for legal, accounting, tax, VAT, invoicing, or regulatory reporting contexts where ECB rates are required or preferred. Use when you need historical rates back to 1999 or when EUR is the base currency. Prefer over commercial FX APIs when official provenance and a source citation are required.

## Known failure modes

- Requested date is a weekend or holiday — endpoint returns the previous ECB business day's rate instead
- Unsupported or misspelled currency symbol returns an error or omits the currency from results
- Dates before 1999 are out of range and will not return data
- Network or upstream ECB data unavailability may cause transient failures

## How this service works

Official ECB euro foreign exchange reference rates (about 30 currencies) for the latest business day or any date since 1999, with base-currency cross rates and amount conversion. Returns the ECB reference date used (previous business day if none that day), the raw EUR rates and a source link. Use when you need an official, citable exchange rate (ECB euro reference rate) for invoicing, accounting, VAT/tax returns or reporting, for today or any business day since 1999.

## Output

Returns a JSON object with: the base currency, the ECB reference date used (previous business day if the requested date had no ECB rate), raw ECB EUR-based rates for requested currencies, converted amounts at the specified amount, and a link to the official ECB source page. Also includes legal terms and a usage guidance field.

## 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 ISO 4217 (default EUR)"
      },
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD (default latest); weekends/holidays use the previous ECB business day"
      },
      "amount": {
       "type": "number",
       "description": "Amount in base currency to convert (default 1)"
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated target currencies (default all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "EUR",
  "legal": {
   "terms": "https://ecb-fx-production.up.railway.app/terms",
   "privacy": "https://ecb-fx-production.up.railway.app/privacy"
  },
  "rates": {
   "DKK": 7.4608,
   "GBP": 0.8431,
   "USD": 1.0712
  },
  "amount": 1,
  "status": "ok",
  "use_when": "Use when you need an official, citable exchange rate (ECB euro reference rate) for invoicing, accounting, VAT/tax returns or reporting, for today or any business day since 1999.",
  "converted": {
   "DKK": 7.4608,
   "GBP": 0.8431,
   "USD": 1.0712
  },
  "source_link": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html",
  "ecb_eur_rates": {
   "DKK": 7.4608,
   "GBP": 0.8431,
   "USD": 1.0712
  },
  "reference_date": "2026-10-16",
  "requested_date": "latest"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-euro-fx-reference-rates-and-conversion-e7bcd9ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ecb-fx-production.up.railway.app](https://www.zero.xyz/host/ecb-fx-production.up.railway.app/llms.txt)