{"uid":"cap_Zg-gMIQ61fXLfeHvf5rgn","slug":"ecb-euro-foreign-exchange-reference-rates-8a3a652d","name":"ECB Euro Foreign Exchange Reference Rates","description":"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.","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-rates?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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 call"},"useWhen":{"type":"string","description":"When the next call is the right one"}},"description":"Suggested next paid call in the same family (call it in a loop when the task continues)","additionalProperties":false},"note":{"type":"string"},"rates":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"amount":{"type":["number","null"]},"converted":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},{"type":"null"}]},"attribution":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iBmfZ4GPbo07uNokpqFnX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ECB euro reference rates for ~30 currencies, rebased to any currency as cross rates, with optional amount conversion","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Travel budget currency conversion","prompt":"I'm traveling to Japan and the UK next month with 2000 EUR — can you tell me how much that is in JPY and GBP using today's official ECB rates?"},{"title":"Invoice reconciliation in reporting currency","prompt":"Our invoices are in USD but we report in CHF — what's today's ECB cross rate between USD and CHF so I can restate our $450,000 revenue figure?"},{"title":"Multi-currency dashboard snapshot","prompt":"Pull today's ECB reference rates for EUR, USD, GBP, JPY, CNY, and BRL so I can update our weekly currency snapshot report."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:01:17.255Z","isFirstParty":false,"canonicalSlug":"ecb-euro-foreign-exchange-reference-rates-8a3a652d"}