{"uid":"cap_Ledjhyq5g7qEfzyOAd6FU","slug":"currency-converter-ecb-reference-rates-a995d8c5","name":"Currency Converter (ECB Reference Rates)","description":"Currency converter (ECB reference rates): convert an amount from one currency to one or more others, e.g. 250 USD to EUR, GBP and JPY, at the latest European Central Bank rate or any day in the last 90 days. Returns the rate, converted amount and rate date for each target. 30 currencies. Reference rates, not transaction rates. Source: ECB. Signed receipt.","url":"https://api.stablecoingateways.com/v1/fx/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"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["from","to","amount"],"properties":{"to":{"type":"string","pattern":"^[A-Za-z]{3}(,[A-Za-z]{3}){0,9}$","description":"Comma-separated target currencies (ISO 4217), 1-10"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Rate date YYYY-MM-DD within the last 90 days; default latest"},"from":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Source currency (ISO 4217)"},"amount":{"type":"string","pattern":"^[0-9]{1,15}(\\.[0-9]{1,8})?$","description":"Amount to convert"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","receipt"],"properties":{"data":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"from":{"type":"string"},"note":{"type":"string"},"amount":{"type":"integer"},"source":{"type":"string"},"window":{"type":"array","items":{"type":"string"}},"rate_date":{"type":"string"},"provenance":{"type":"object","description":"Additive evidence block (sg-provenance/1): per-fact source, retrieval time, limits; no score or verdict. Full schema in OpenAPI."},"conversions":{"type":"object","properties":{"EUR":{"type":"object"},"GBP":{"type":"object"},"JPY":{"type":"object"}}},"requested_date":{},"cross_rates_derived":{"type":"boolean"}},"description":"Converted amounts and rates per target currency at the ECB rate date"},"receipt":{"type":"object","required":["v","endpoint_id","ts","price","tx_hash","request_hash","response_hash","log_seq","sig"],"properties":{"evidence":{"type":"object","description":"Signed evidence (see llms.txt)"}},"description":"Ed25519-signed receipt; verify free at POST /v1/verify-receipt. New receipts also carry a signed `evidence` object."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"from":"USD","note":"ECB reference rates are for information only and are not transaction rates.","amount":250,"source":"European Central Bank euro foreign exchange reference rates. Source: ECB. This informat...","window":["2026-07-24"],"rate_date":"2026-10-21","conversions":{"EUR":{"rate":0.89015489,"amount":222.538723},"GBP":{"rate":0.74617233,"amount":186.543083},"JPY":{"rate":157.87787075,"amount":39469.467688}},"requested_date":null,"cross_rates_derived":true},"receipt":{"v":1,"ts":"2026-10-22T09:00:00Z","sig":"hex","price":{"asset":"USDC","amount":"1000","network":"eip155:84532"},"log_seq":1,"tx_hash":"0x..","endpoint_id":"fx-convert-v1","request_hash":"hex","response_hash":"hex"}}},"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_BMTMosL_WW8EdeWrGb6L5","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 from one currency to up to 10 others using the latest or historical European Central Bank reference rates, returning the rate, converted amount, and rate date for each target currency.","exampleAgentPrompt":"Can you convert 250 USD to EUR, GBP, and JPY using the latest ECB reference rate and tell me the rate and converted amount for each?","exampleUseCases":[{"title":"Multi-currency invoice pricing","prompt":"I need to invoice a client in three currencies — convert 5000 EUR to USD, GBP, and CHF at today's ECB rate so I can show the equivalent amounts on the invoice."},{"title":"Historical FX rate lookup","prompt":"What was the ECB exchange rate for USD to JPY on 2024-03-15, and how much would 10000 USD have been worth in JPY on that date?"},{"title":"Travel budget across multiple countries","prompt":"I'm planning a trip and need to know how far my 2000 USD will go — can you convert it to EUR, SEK, NOK, and DKK at the latest ECB rates?"}],"resultDescription":"Returns a JSON object with the source currency, amount, rate date, and a conversions map where each key is a target currency code containing the exchange rate and converted amount. Also includes a note that these are ECB reference (informational) rates, a cross_rates_derived boolean, and an Ed25519-signed receipt with endpoint ID, timestamp, price, transaction hash, and request/response hashes for auditability.","failureModes":["Unsupported currency code returns an error — only 30 ECB-supported currencies are available","Date older than 90 days is rejected — historical data is limited to the last 90 days","Weekend or ECB holiday dates may return the most recent available rate, not the requested date","Invalid amount format (non-numeric or too many decimal places) results in a validation error","More than 10 target currencies in the 'to' parameter will fail schema validation","Rate unavailable for cross-rate pairs not directly published by ECB — derived rates may have reduced precision"],"whenToPreferThis":"Choose this endpoint when you need authoritative, ECB-sourced reference exchange rates for up to 10 currency pairs in a single call, including historical rates within the last 90 days. It is ideal for financial reporting, invoicing, compliance, or any use case requiring a verifiable, signed receipt of the conversion. Prefer this over generic FX APIs when ECB provenance and auditability matter, or when converting from/to multiple currencies simultaneously without making multiple requests.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:06:33.495Z","isFirstParty":false,"canonicalSlug":"currency-converter-ecb-reference-rates-a995d8c5"}