# ECB Euro Foreign Exchange Reference Rates > ECB Euro Foreign Exchange Reference Rates is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23). Returns ECB euro reference rates for ~30 currencies, rebased to any currency as cross rates, with optional amount conversion ## Facts - Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-rates?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-23 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/ecb-euro-foreign-exchange-reference-rates-8a3a652d - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zg-gMIQ61fXLfeHvf5rgn 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-foreign-exchange-reference-rates-8a3a652d -d '' ``` Example prompt: What's today's ECB exchange rate for USD, JPY, and GBP against the euro, and how much is 1000 EUR in each of those currencies? ## When to prefer this Use this endpoint when you need official ECB euro reference rates for ~30 major fiat currencies for accounting, reporting, or end-of-day financial reconciliation purposes. Prefer this over live forex APIs when regulatory or audit-grade official rates are needed and intraday precision is not required. Not suitable for live trading quotes, intraday rates, or cryptocurrency pairs. ## Known failure modes - Unsupported currency code returns an error or empty rates (ECB covers ~30 currencies, not all ISO 4217 codes) - Rates are only updated once per ECB business day — stale if requested before the daily ECB publication - Network/gateway timeout may occur given ~1500ms p95 latency - Invalid ISO 4217 format (not 3 alpha chars) rejected by schema validation - Amount of 0 or negative rejected (exclusiveMinimum: 0) - Crypto or exotic currency pairs not available — ECB does not publish those ## How this service works Use when you need currency exchange rates, fx rates or forex conversion of an amount between two currencies like EUR and GBP. Do not use for live trading quotes, intraday or crypto rates (ECB rates update once per business day). Returns JSON with currency exchange rates: official ECB euro reference FX rates (free at ecb.europa.eu) for about 30 currencies, rebased to any base as cross rates, with optional conversion for 0.005 USDC per call. Typical response time 1500 ms (p95). Category: Data. ## Output A JSON object containing the ECB publication date, the base currency, a map of currency codes to exchange rates (cross rates rebased from EUR to the requested base), and optionally the input amount with its converted values in each requested currency. Also includes an attribution field and a note about ECB update frequency. ## 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", "bodyType", "body" ], "properties": { "body": { "type": "object", "required": [], "properties": { "base": { "type": "string", "pattern": "^[A-Za-z]{3}$", "description": "Base currency, ISO 4217 (EUR when omitted), e.g. USD" }, "amount": { "type": "number", "maximum": 1000000000000, "description": "Amount in the base currency to convert, e.g. 100", "exclusiveMinimum": 0 }, "symbols": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z]{3}$" }, "maxItems": 40, "minItems": 1, "description": "Currencies to return, e.g. [\"BRL\", \"JPY\"] (all ECB currencies when omitted)" } } }, "type": { "type": "string", "const": "http" }, "method": { "enum": [ "POST" ], "type": "string" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "date", "base", "rates", "amount", "converted", "attribution", "note" ], "properties": { "base": { "type": "string" }, "date": { "type": "string" }, "next": { "type": "object", "required": [ "service", "tool", "method", "url", "useWhen", "sample" ], "properties": { "url": { "type": "string", "description": "Paid route of the next call" }, "tool": { "type": "string", "description": "MCP tool name of the same call" }, "method": { "enum": [ "GET", "POST" ], "type": "string" }, "sample": { "type": "string", "description": "Free fixed sample of the whole family" }, "service": { "type": "string", "description": "Service id of the suggested next paid ca … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "base": "USD", "date": "2026-10-16", "note": "ECB reference rates are for information purposes only, published once per business day; they are not trading rates. Rates against a base other than EUR and converted amounts are calculated by Blackwood State from the ECB euro rates.", "rates": { "BRL": 5.08282, "EUR": 0.888652, "GBP": 0.749889, "JPY": 158.02 }, "amount": 100, "converted": { "BRL": 508.28, "EUR": 88.87, "GBP": 74.99, "JPY": 15802 }, "attribution": "Source: European Central Bank (ECB) euro foreign exchange reference rates, available free of charge at ecb.europa.eu" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-euro-foreign-exchange-reference-rates-8a3a652d/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)