{"uid":"cap_GUjqncOdrlXgx0ymyREZC","slug":"ecb-euro-foreign-exchange-reference-rate-2cc664c8","name":"ECB Euro Foreign Exchange Reference Rate","description":"The latest ECB euro foreign exchange reference rate for a currency (units per 1 euro) and its date, unmodified, as JSON. The same data is available free of charge from the ECB website; reference rates are for information purposes only.","url":"https://pennydatahq.com/api/fx/:currency?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"},"pathParams":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","description":"ISO 4217 currency code, any case, for a currency the ECB publishes a reference rate for (about 30, such as USD, GBP, JPY, CHF). Not EUR: every rate is against the euro."}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["currency","base","rate","date","notice"],"properties":{"base":{"type":"string","const":"EUR"},"date":{"type":"string","description":"YYYY-MM-DD, the reference date"},"rate":{"type":"number","description":"Units of the currency per 1 euro, as published by the ECB"},"notice":{"type":"string","description":"ECB source and free-availability notice"},"currency":{"type":"string"},"currency_name":{"type":["string","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OAQBwbvyq7hA9WVuWpjew","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest ECB euro foreign exchange reference rate (units of a given currency per 1 EUR) and its publication date as JSON.","exampleAgentPrompt":"What is the latest ECB official reference rate for USD — how many US dollars per euro is the ECB quoting today?","exampleUseCases":[{"title":"Currency conversion for invoice pricing","prompt":"I need to invoice a client in Japanese yen but my base price is in euros — what is the ECB's official EUR/JPY reference rate today?"},{"title":"Compliance FX rate reporting","prompt":"For our monthly regulatory report we need the official ECB reference rate for GBP against the euro — can you pull today's published rate?"},{"title":"Travel budget estimation","prompt":"We're planning a trip and need to know the ECB's official rate for Swiss francs against the euro right now — what's the CHF rate?"}],"resultDescription":"A JSON object containing the currency code, base currency (always EUR), the exchange rate as a number (units of the requested currency per 1 euro), the reference date in YYYY-MM-DD format, and an ECB source/free-availability notice. Optionally includes a human-readable currency name.","failureModes":["Unsupported or misspelled currency code returns an error or empty result — only ~30 ECB-published currencies are supported","Requesting EUR itself is not valid as all rates are expressed against the euro","Rates are not updated in real time; the ECB publishes reference rates typically once per business day around 16:00 CET, so the date may be the previous business day on weekends or holidays","Network or payment (x402) failure may prevent the response from being returned"],"whenToPreferThis":"Use this endpoint when you need the official ECB euro reference rate for a specific currency — particularly for regulatory, compliance, or financial reporting use cases where the ECB's authoritative rate is required rather than a live market rate. It covers roughly 30 major and regional currencies and is priced at a fraction of a cent per call, making it ideal for lightweight, pay-per-use agent workflows via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:55.663Z","isFirstParty":false,"canonicalSlug":"ecb-euro-foreign-exchange-reference-rate-2cc664c8"}