{"uid":"cap_c-2kDF6xijoq1JfwgkM1j","slug":"argonautworks-ecb-fx-reference-api-ad903327","name":"ArgonautWorks ECB FX Reference API","description":"Source-cited ECB foreign-exchange reference conversion with explicit cross-rate math. Underlying ECB statistics are available free; the fee covers validation, calculation, and machine-ready delivery.","url":"https://official-fx-reference.vercel.app/api/v1/convert","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","properties":{"base":{"type":"string","default":"USD","pattern":"^[A-Za-z]{3}$","description":"Three-letter source currency code. Defaults to USD."},"quote":{"type":"string","default":"EUR","pattern":"^[A-Za-z]{3}$","description":"Three-letter destination currency code. Defaults to EUR."},"amount":{"type":"number","default":1,"maximum":999999999,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"base":"USD","cache":{"stale":false,"age_ms":0},"quote":"JPY","source":{"url":"https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml","dataset":"Euro foreign exchange reference rates","provider":"European Central Bank","available_free":true},"disclaimer":"ECB reference rates are informational averages and may not reflect rates available for market transactions. This service is independent of and not endorsed by the ECB.","calculation":"quote_per_eur / base_per_eur; the cross-rate and converted amount are derived values","observed_at":"2026-08-04T21:30:00.000Z","input_amount":100,"published_date":"2026-08-04","reference_rate":154.325,"converted_amount":15432.5,"underlying_data_notice":"The underlying ECB reference-rate statistics are available free of charge from the European Central Bank; this paid API charges for validation, cross-rate calculation, and machine-ready delivery.","reference_rates_per_eur":{"JPY":177.47375,"USD":1.15}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0015","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.0015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-WbLd_i2KKMcZrXukc3Yj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a currency amount between two currencies using ECB official reference rates with explicit cross-rate calculation and source citation","exampleAgentPrompt":"Using ECB official reference rates, convert 250 US dollars to Japanese yen and show me the cross-rate calculation and the source publication date.","exampleUseCases":[{"title":"Travel budget currency planning","prompt":"I'm budgeting for a trip to Japan — can you convert 2000 USD to JPY using the ECB reference rate and tell me what rate was used and when it was published?"},{"title":"Invoice reconciliation in foreign currency","prompt":"I need to reconcile an invoice: convert 15000 GBP to EUR using the ECB official reference rate and give me the exact cross-rate so I can show the calculation in my records."},{"title":"Multi-currency financial report snapshot","prompt":"For our weekly finance report, convert 500000 CHF to USD using ECB reference data and include the source URL and the date the rate was published."}],"resultDescription":"Returns a JSON object with the converted amount, the ECB reference rate for the currency pair, the individual rates per EUR used in cross-rate math, the publication date and observation timestamp, a direct source URL to the ECB dataset, cache freshness metadata, and a disclaimer about the informational nature of ECB rates.","failureModes":["Unsupported or unrecognized 3-letter currency code returns an error — ECB only publishes rates for a limited set of currencies","Amount of zero or negative value rejected due to exclusiveMinimum constraint","Amount exceeding 999,999,999 rejected by schema maximum","Stale cache may return rates from prior business day if ECB has not yet published for the current date","ECB does not publish rates on weekends or holidays, so latest available date may lag","Network or upstream ECB feed unavailability could cause service errors"],"whenToPreferThis":"Choose this endpoint when you need auditable, source-cited FX conversions backed by ECB official reference rates with explicit cross-rate math shown — ideal for compliance, reporting, or financial workflows requiring a verifiable, non-commercial rate source. Prefer this over generic FX APIs when transparency of calculation methodology and provenance matter, or when you need the ECB specifically as the authoritative source. Not suitable for live market trading rates or real-time bid/ask spreads.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:32:41.040Z","isFirstParty":false}