{"uid":"cap_z-CXUR8vFmS8U-_9K9uF-","slug":"fx-rates-ecb-historical-rate-lookup-bc70609e","name":"FX Rates ECB – Historical Rate Lookup","description":"ECB reference exchange rate on a past date (since 1999) and the change since then; weekends use the prior working day.","url":"https://fx-ecb.x402tookit.com/fx-historical?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","required":["base","quote","date"],"properties":{"base":{"type":"string","description":"Base currency"},"date":{"type":"string","description":"YYYY-MM-DD"},"quote":{"type":"string","description":"Quote currency"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"base":{"type":["null","string"]},"rate":{"type":["null","number"]},"quote":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"fixingDate":{"type":["null","string"]},"latestRate":{"type":["null","number"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"requestedDate":{"type":["null","string"]},"changeSincePct":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tLcLX39t4meedLrVxkgEz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ECB reference exchange rate for a currency pair on a specific past date (since 1999), plus the percentage change from that date to today.","exampleAgentPrompt":"What was the ECB reference rate for EUR to USD on March 15, 2022, and how much has the rate changed since then?","exampleUseCases":[{"title":"Historical invoice rate reconciliation","prompt":"I need the official ECB exchange rate for EUR to GBP on July 10, 2023 — that's the date on an invoice I'm reconciling, and I also want to know how much the rate has moved since then."},{"title":"Tracking currency impact since a past event","prompt":"What was the ECB reference rate for USD to JPY on January 24, 2020, right before COVID hit, and what's the percentage change from that rate to now?"},{"title":"Historical FX rate for tax reporting","prompt":"For my tax return I need the official ECB exchange rate for CHF to EUR on December 31, 2022 — can you pull that along with how much the pair has shifted since that date?"}],"resultDescription":"Returns a JSON object with the exact ECB reference exchange rate for the requested currency pair on or before the requested date (adjusted to prior working day for weekends/holidays), the fixing date used, the latest available rate, the percentage change between the historical rate and today's rate, source URL, attribution, and any degraded-mode warnings.","failureModes":["Unsupported currency pair (only 30 ECB-published currencies available) — returns error or null rate","Date before 1999 ECB data start — no data available","Weekend or holiday date — automatically adjusted to prior working day, fixingDate will differ from requestedDate","Malformed date format (non YYYY-MM-DD) — validation error","Rate temporarily unavailable due to ECB data feed issues — degraded flag set to true"],"whenToPreferThis":"Choose this endpoint when you need the official ECB reference rate for a specific past date — ideal for accounting, invoice reconciliation, tax reporting, or measuring how much a currency pair has moved since a historical event. It covers all 30 ECB-published currencies dating back to 1999 and returns both the point-in-time rate and the percentage change to the present, which no generic spot-rate endpoint provides.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:39:35.017Z","isFirstParty":false,"canonicalSlug":"fx-rates-ecb-historical-rate-lookup-bc70609e"}