{"uid":"cap_tMTmGUzjl96ys1yp7GxMS","slug":"fx-reference-rates-api-currency-conversion-03037fa6","name":"FX Reference Rates API – Currency Conversion","description":"Convert an amount using ECB reference rates (latest, or as of a past date).","url":"https://fx-reference-rates.regnotes.workers.dev/v1/convert?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":["from","to","amount"],"properties":{"to":{"type":"string","pattern":"^[A-Z]{3}$","description":"One of: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"from":{"type":"string","pattern":"^[A-Z]{3}$","description":"One of: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"JPY","from":"USD","rate":156.8034,"as_of":"2026-10-23","amount":100,"result":15680.335924}},"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_OzBlDlFrkp2EfB8C0nmGB","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":"Converts a monetary amount between two currencies using ECB official reference rates, either at today's rate or a specified historical date.","exampleAgentPrompt":"Using ECB reference rates, convert 100 USD to JPY — and use the rate from October 23, 2026.","exampleUseCases":[{"title":"Invoice reconciliation in foreign currency","prompt":"I have an invoice for 2500 EUR that was issued on March 10 2024 — what was that worth in USD on that date according to ECB rates?"},{"title":"Real-time travel budget estimate","prompt":"I'm heading to Tokyo next week and want to know how much 800 USD converts to in JPY at today's ECB reference rate."},{"title":"Historical FX rate audit","prompt":"What was the official ECB exchange rate from GBP to CHF on June 15 2023, and how much would 10000 GBP have been worth in CHF on that day?"}],"resultDescription":"Returns a JSON object with the source currency (from), target currency (to), the ECB reference rate used, the as_of date of the rate, the input amount, and the computed converted result value.","failureModes":["Unsupported currency code returns an error — only the 30 ECB-covered currencies are valid","Date falls on a non-publication day (weekend or ECB holiday) — the API falls back to the previous publication date","Invalid date format (not YYYY-MM-DD) triggers a validation error","Amount not parseable as a number returns a bad request error","Future dates may return the latest available rate rather than a true future rate"],"whenToPreferThis":"Prefer this endpoint when you need official, authoritative ECB reference rates for currency conversion — especially for financial, accounting, or compliance use cases where the ECB rate is the required standard. It supports 30 major currencies and historical date lookups, making it ideal for auditing past transactions or reconciling invoices. Choose this over market-rate APIs when regulatory or institutional accuracy (ECB standard) is more important than real-time mid-market rates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:23.742Z","isFirstParty":false,"canonicalSlug":"fx-reference-rates-api-currency-conversion-03037fa6"}