{"uid":"cap_lQGqMlqkB9VSX9ma1R1xs","slug":"macro-data-api-ecb-fx-reference-rate-15f635b0","name":"Macro Data API – ECB FX Reference Rate","description":"Returns the ECB euro reference exchange rate between two currencies for a date, including cross rates such as CHF/USD, with source attribution.","url":"https://macro-data-api-313m.onrender.com/v1/fx?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["quote"],"properties":{"base":{"type":"string","description":"ISO currency code, default EUR"},"date":{"type":"string","description":"Optional date YYYY-MM-DD. Default: latest available."},"quote":{"type":"string","description":"ISO currency code, e.g. USD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.011","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dBKgV7Pi8sQHI0mX3JzQL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ECB euro reference exchange rate between two currencies for a given date, including cross rates such as CHF/USD, with source attribution.","exampleAgentPrompt":"What's the ECB reference exchange rate for EUR to USD today? And also, what was the CHF/USD cross rate on 2024-03-15?","exampleUseCases":[{"title":"Historical FX rate for accounting","prompt":"I need the official ECB euro reference rate for EUR to GBP on 2023-12-31 for our year-end financial statements."},{"title":"Cross rate lookup for travel planning","prompt":"What's the ECB cross rate between CHF and USD for today? I need the official rate, not a market quote."},{"title":"Monitoring rate changes over time","prompt":"Can you pull the ECB reference rate for EUR to JPY for January 10th, 2024? I want to compare it with another date."}],"resultDescription":"Returns the ECB official reference exchange rate for the requested currency pair on the specified date (or the latest available date), including the base currency, quote currency, rate value, date of the rate, and source attribution indicating the data comes from the European Central Bank.","failureModes":["Unsupported currency pair not covered by ECB reference rates returns an error or empty result","Date falls on a weekend or ECB non-publication day, returning the closest available rate or an error","Invalid ISO currency code format causes a validation error","Future dates return an error as rates are not forecasted","Rate not yet published for today if requested before ECB daily publication time"],"whenToPreferThis":"Choose this endpoint when you need the official ECB euro reference exchange rate — authoritative, source-attributed central bank data — rather than real-time market rates. Ideal for accounting, compliance, financial reporting, or any use case requiring a recognized official benchmark rate. Also useful when you need historical cross rates (e.g. CHF/USD) derived from ECB euro reference data. Prefer this over live market data feeds when regulatory or audit-grade sourcing is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T17:25:51.436Z","isFirstParty":false,"canonicalSlug":"macro-data-api-ecb-fx-reference-rate-15f635b0"}