{"uid":"cap_yIWr_CFBAAnLS8Vfz6yPF","slug":"ecb-reference-rate-currency-converter-72c60456","name":"ECB Reference Rate Currency Converter","description":"Currency conversion at the ECB reference rate (today or a past date) — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/records/fx-convert?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"to":{"type":"string","description":"required 3-letter code"},"date":{"type":"string","description":"optional YYYY-MM-DD"},"from":{"type":"string","description":"required 3-letter code"},"amount":{"type":"number","maximum":1000000000000000,"minimum":0,"description":"required"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"fx-convert","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.001,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"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_vUJeq40ZT0VE2YT61PMfv","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 the European Central Bank reference rate for today or a specified past date","exampleAgentPrompt":"Convert 2500 USD to EUR using the ECB reference rate from March 10, 2024.","exampleUseCases":[{"title":"Historical invoice reconciliation","prompt":"I need to convert 15000 British pounds to euros at the official ECB rate on November 5, 2023 — we're reconciling a past invoice and need the rate from that specific date."},{"title":"Travel expense reporting","prompt":"Convert 3200 Japanese yen to Swiss francs at today's ECB reference rate so I can fill out my expense report."},{"title":"Cross-currency budget planning","prompt":"What would 50000 US dollars have been worth in Swedish kronor at the ECB rate on January 1, 2024? I'm doing a year-over-year budget comparison."}],"resultDescription":"Returns the converted monetary amount computed from the ECB official reference rate for the requested currency pair and date (defaulting to today if no date is provided), along with the exchange rate applied and relevant metadata such as the date used.","failureModes":["Unsupported or invalid 3-letter currency code returns an error — ECB only publishes rates for a subset of currencies","Future dates or dates before ECB data availability will return an error or empty result","Weekend or ECB holiday dates may return no rate (ECB does not publish rates on non-business days)","Amount exceeding 1,000,000,000,000,000 is rejected by schema validation","Missing required fields (from, to, amount) result in a validation error"],"whenToPreferThis":"Choose this endpoint when you need the official ECB (European Central Bank) reference rate for currency conversion, especially for financial, accounting, or compliance use cases where the ECB rate is the authoritative source. It is particularly valuable for historical conversions on a specific past date. Prefer this over market-rate converters when regulatory or institutional accuracy is required, or when the ECB rate is contractually specified.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:44:51.385Z","isFirstParty":false,"canonicalSlug":"ecb-reference-rate-currency-converter-72c60456"}