{"uid":"cap_p8Gyf5zuw0_dLxZpVQRZF","slug":"ecb-euro-fx-reference-rates-and-conversion-e7bcd9ae","name":"ECB Euro FX Reference Rates and Conversion","description":"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.","url":"https://ecb-fx-production.up.railway.app/v1/fx/rates?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UIQP7Nmm_ae2nkZSPMmJ5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches official ECB euro foreign exchange reference rates for ~30 currencies and converts amounts between currencies for any business day since 1999.","exampleAgentPrompt":"What is the official ECB euro reference rate for USD and GBP today, and how much is 1000 EUR worth in each?","exampleUseCases":[{"title":"VAT return exchange rate lookup","prompt":"I need the official ECB euro reference rate for USD on March 31 2025 to fill out my quarterly VAT return — can you get that and also convert 8500 EUR to USD at that rate?"},{"title":"Multi-currency invoice conversion","prompt":"I'm invoicing a client for 2500 EUR and need the official ECB reference rates for GBP, CHF, and SEK as of today so I can show the equivalent amounts on the invoice."},{"title":"Historical FX rate audit","prompt":"Can you pull the official ECB euro to Japanese yen reference rate for June 15 2022? I need a citable rate for an accounting audit."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:38:18.088Z","isFirstParty":false,"canonicalSlug":"ecb-euro-fx-reference-rates-and-conversion-e7bcd9ae"}