{"uid":"cap_3E1w9ATSJCK6HEPxNkDIo","slug":"api-acre-ecb-fx-reference-rate-converter-ac8900d2","name":"API Acre ECB FX Reference Rate Converter","description":"Convert an amount between two supported currencies using one validated ECB daily reference-rate observation. The underlying ECB statistics are available free from the ECB Data Portal; the fee covers bounded retrieval, validation, clearly labelled cross-rate calculation, and x402 delivery.","url":"https://apiacre.com/v1/data/ecb-fx-reference?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount":{"type":"string"},"on_or_before":{"anyOf":[{"type":"string"},{"type":"null"}]},"base_currency":{"enum":["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"],"type":"string"},"quote_currency":{"enum":["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"],"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"rate":"1.352573464976","basis":{"formula":"quotePerEur / basePerEur","basePerEur":"0.85585","quotePerEur":"1.1576","denomination":"EUR"},"amount":"100","source":{"dataset":"EXR daily euro foreign exchange reference rates","provider":"European Central Bank","requestUrl":"https://data-api.ecb.europa.eu/service/data/EXR/D.GBP+USD...","seriesKeys":["EXR.D.GBP.EUR.SP00.A","EXR.D.USD.EUR.SP00.A"]},"warnings":["The latest common reference observation is 1 calendar day...","API Acre derived this cross rate by dividing two unmodifi..."],"disclaimer":"Reference data only, not financial advice or a guarantee ...","inverseRate":"0.739331375259","limitations":["ECB reference rates are usually published on TARGET busin...","A converted amount is arithmetic evidence only; banks, ex...","ECB observations can be revised, interrupted, or withdraw...","Coverage is limited to the explicitly supported active EC..."],"retrievedAt":"2026-08-19T04:00:00+00:00","baseCurrency":"GBP","quoteCurrency":"USD","referenceDate":"2026-08-18","convertedAmount":"135.2573465","referenceLagDays":1,"networkRequestsMade":1,"requestedOnOrBefore":null},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[]},"service":"data.ecb-fx-reference","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jpj35iKECx4aOu87u0i5C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts an amount between two currencies using validated ECB daily foreign exchange reference rates, with transparent cross-rate calculation.","exampleAgentPrompt":"Convert 250 GBP to USD using the ECB daily reference rate — use the most recent available rate on or before today and show me the cross-rate basis.","exampleUseCases":[{"title":"Travel budget currency estimate","prompt":"I'm going to Japan next month and want to know how much 2000 EUR would be in JPY based on today's ECB reference rate."},{"title":"Cross-rate audit for accounting","prompt":"We need to record a GBP-to-USD conversion of 10000 GBP for our books using the official ECB rate from August 18, 2026 — can you get that rate and show the cross-rate formula?"},{"title":"Historical rate lookup for compliance","prompt":"What was the ECB reference rate for CAD to CHF on or before July 31, 2026? Convert 5000 CAD to CHF using that rate."}],"resultDescription":"Returns the converted amount, the exchange rate and its inverse, the ECB reference date used, cross-rate basis (formula, basePerEur and quotePerEur values), source dataset details, reference lag in days, any warnings about data freshness or derivation, and a disclaimer that the data is reference-only. Also includes request ID, duration, and cache status.","failureModes":["Unsupported currency pair — only the 30 ECB-listed currencies are accepted","No observation available on or before the requested date (e.g. market holiday, too far in past)","ECB Data Portal temporarily unavailable causing upstream retrieval failure","Invalid amount string that cannot be parsed as a numeric value","Same base and quote currency provided"],"whenToPreferThis":"Choose this endpoint when you need a single authoritative, auditable ECB daily reference rate conversion with transparent cross-rate arithmetic and source traceability. Ideal for accounting, compliance, or reporting contexts where citing an official central bank source matters. Prefer over commercial FX APIs when ECB provenance and free-of-charge underlying data (with bounded retrieval and validation) is the requirement. Not suitable for live trading rates, real-time bid/ask spreads, or currencies outside the 30 ECB-supported pairs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:39:51.525Z","isFirstParty":false,"canonicalSlug":"api-acre-ecb-fx-reference-rate-converter-ac8900d2"}