{"uid":"cap_3cyAPlYE09zimo5nGG2nr","slug":"3hz-daily-fx-reference-rate-82f615ff","name":"3HZ Daily FX Reference Rate","description":"Daily reference foreign-exchange rate for any supported fiat currency pair using Frankfurter/ECB reference data. Query base and quote ISO 4217 codes. For conversion, normalization, accounting and reporting; not live trading data.","url":"https://wallet-services-poc-clean-mainnet.3hz-services.workers.dev/fx-rate","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"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","default":"EUR","pattern":"^[A-Za-z]{3}$","description":"Three-letter base currency code"},"quote":{"type":"string","default":"USD","pattern":"^[A-Za-z]{3}$","description":"Three-letter quote currency code"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["base","quote","rate","date","source","source_url","rate_type","fetched_at"],"properties":{"base":{"type":"string"},"date":{"type":"string"},"rate":{"type":"number"},"quote":{"type":"string"},"source":{"type":"string"},"rate_type":{"type":"string"},"fetched_at":{"type":"string"},"source_url":{"type":"string"}}}},"additionalProperties":false}},"additionalProperties":false},"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_F1HXi7MZoKYLI_nvPvITi","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 ECB/Frankfurter daily reference exchange rate between any two ISO 4217 fiat currency codes.","exampleAgentPrompt":"What's today's ECB reference rate for converting EUR to USD? I need the official daily rate for our accounting reconciliation.","exampleUseCases":[{"title":"Multi-currency invoice normalization","prompt":"I need to normalize our invoices to USD for month-end reporting — can you look up today's ECB daily reference rates for EUR to USD and GBP to USD?"},{"title":"Travel expense reimbursement calculation","prompt":"What's the official ECB daily rate for JPY to EUR today? I need to convert a ¥45,000 expense claim into euros for our finance team."},{"title":"Cross-border accounting reconciliation","prompt":"Pull the ECB reference rate for CHF to USD for today — we need a stable, official rate to reconcile our Swiss subsidiary's accounts."}],"resultDescription":"A JSON object containing the base currency code, quote currency code, the numeric exchange rate (how many units of quote per 1 unit of base), the date the rate applies to, the data source name and URL, the rate type label, and the timestamp when the rate was fetched.","failureModes":["Unsupported currency code returns an error — only ECB-published currencies are available","Invalid three-letter code format (e.g. numeric or empty string) is rejected by schema validation","Weekend or holiday dates may return the most recent available ECB business day rate rather than today's date","Payment failure (x402) if USDC balance is insufficient — endpoint returns 402 before serving data","Network timeout on the upstream Frankfurter/ECB feed may delay or fail response"],"whenToPreferThis":"Choose this endpoint when you need an authoritative, ECB-sourced daily reference rate for accounting, financial reporting, invoice normalization, or expense reimbursement — not for live trading prices or intraday FX quotes. It is ideal when regulatory or audit requirements demand a stable, official reference rate rather than a market spread.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T06:32:57.794Z","isFirstParty":false}