{"uid":"cap_1uj1qmpPh-jSRHkS9Txvc","slug":"toll402-fx-rate-ecb-reference-rates-a6dee560","name":"Toll402 FX Rate (ECB Reference Rates)","description":"Exchange rate between two ISO currencies (ECB reference rates), optionally converting an amount. (GET: pass the input as query parameters)","url":"https://toll402.dev/v1/fx","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","maxLength":3,"minLength":3,"description":"ISO 4217 base currency"},"quote":{"type":"string","maxLength":3,"minLength":3,"description":"ISO 4217 quote currency; omit for all rates"},"amount":{"type":"number","default":1,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ms":{"type":"integer"},"ok":{"type":"boolean"},"tool":{"type":"string"},"result":{"type":"object","properties":{"base":{"type":"string"},"date":{"type":"string"},"rate":{"type":"number"},"quote":{"type":"string"},"amount":{"type":"integer"},"converted":{"type":"integer"}}}}}}}}},"responseSchema":{"type":"json","example":{"base":"USD","date":"2026-09-05","rate":18.42,"quote":"MXN","amount":100,"converted":1842}},"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_DnoQq3npbK2d9O4J9MZt2","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 reference exchange rate between two ISO 4217 currencies, optionally converting a specific amount.","exampleAgentPrompt":"What's the current ECB reference exchange rate from EUR to USD, and how much would 750 EUR convert to?","exampleUseCases":[{"title":"Travel budget currency conversion","prompt":"I'm heading to Japan and have 2000 USD saved — how much is that in JPY using the current ECB reference rate?"},{"title":"Invoice multi-currency pricing","prompt":"What's today's ECB rate from EUR to GBP? I need to convert a 5000 EUR invoice into pounds for a UK client."},{"title":"Cross-currency financial reporting","prompt":"Get me the current ECB reference exchange rates for USD, GBP, and CHF all quoted against EUR so I can update our monthly report."}],"resultDescription":"Returns a JSON object with the base currency, quote currency, the ECB reference rate (a floating-point number), the date the rate was published, the requested amount, and the converted amount. Also includes response time in milliseconds and an ok status flag.","failureModes":["Invalid or unsupported ISO 4217 currency code returns an error","ECB may not publish rates for all currency pairs (e.g. exotic currencies)","If the ECB has not yet published today's rate, yesterday's rate may be returned","Network or upstream ECB data unavailability may cause failures","Passing a non-3-letter string for base or quote will fail schema validation"],"whenToPreferThis":"Choose this endpoint when you need official, authoritative ECB reference exchange rates rather than real-time market rates. Ideal for financial reporting, invoicing, regulatory compliance, or any use case that requires the European Central Bank's published daily rates. Not suitable if you need live mid-market or interbank rates updated intraday.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:45:04.677Z","isFirstParty":false}