{"uid":"cap_IvkvBnkJ4-wqBJoTBQcBd","slug":"soren-fx-oracle-ecb-reference-rate-with-cryptographic-attestation-10ad784e","name":"Soren FX Oracle — ECB Reference Rate with Cryptographic Attestation","description":"A signed, timestamped euro reference exchange rate from the European Central Bank, for any pair among the ~30 currencies it publishes. Returns the rate, the ECB reference date, the underlying euro base rates, a SHA-256 of the exact bytes returned, and an Ed25519 signature. Non-EUR pairs are crossed via EUR and that is stated in the response, because it is our calculation and not an ECB figure.","url":"https://soren.com/v1/oracle/fx?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["pair"],"properties":{"pair":{"type":"string","examples":["EURUSD"],"description":"Six-letter currency pair, e.g. EURUSD. Any pair among the ECB reference currencies; non-EUR pairs are crossed via EUR."}}}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"value":{"pair":"EURUSD","rate":"<number>","derivation":"<text>","reference_date":"<YYYY-MM-DD>"},"source":{"name":"European Central Bank","notice":"Available free of charge from the ECB."},"provenance":{"signature":{"value":"<base64>","algorithm":"Ed25519"},"observed_at":"<ISO-8601 UTC>","upstream_sha256":"<hex>"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FWv6vms5Pbofj3wEPo0Gx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a signed, timestamped European Central Bank reference exchange rate for any supported currency pair, including a SHA-256 hash and Ed25519 signature for verifiability.","exampleAgentPrompt":"Can you fetch me the current ECB reference exchange rate for EURUSD — I need it signed and timestamped so I can verify it later?","exampleUseCases":[{"title":"Smart contract FX oracle feed","prompt":"I need a cryptographically signed ECB exchange rate for EURUSD that I can use as a verifiable on-chain oracle input — get me the rate with its Ed25519 signature and SHA-256 hash."},{"title":"Cross-currency invoice reconciliation","prompt":"What's the official ECB reference rate for GBPJPY right now? I need the exact rate and the ECB date it's based on so I can reconcile a cross-currency invoice."},{"title":"Compliance audit trail for FX conversion","prompt":"Fetch me the ECB reference rate for USDCHF today and include the signature and hash — I need it for an auditable record of the rate we used in our compliance report."}],"resultDescription":"A JSON response containing: the requested currency pair rate, the ECB reference date, the individual EUR-based rates used to derive the figure, a SHA-256 hash of the exact response bytes, an Ed25519 signature for cryptographic verification, and a note if the rate was crossed via EUR (indicating it is Soren's calculation rather than a direct ECB figure).","failureModes":["Unsupported currency pair — ECB only publishes ~30 currencies, so exotic pairs will return an error","Invalid pair format — must be exactly six uppercase letters (e.g. EURUSD), malformed input returns a 4xx error","ECB data unavailability — if the ECB has not published rates for the current day (weekends, holidays), the latest available date is returned or an error is raised","Network/payment failure — x402 payment of $0.01 USDC must succeed before the rate is returned"],"whenToPreferThis":"Choose this endpoint when you need a cryptographically attested, auditable FX rate traceable to ECB reference data — ideal for compliance workflows, smart contract oracles, financial audit trails, or any system where tamper-evidence matters. Prefer this over generic FX APIs when you need an Ed25519 signature and SHA-256 hash proving the exact data returned. Note that non-EUR pairs are crossed via EUR, which is disclosed in the response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:37:47.476Z","isFirstParty":false,"canonicalSlug":"soren-fx-oracle-ecb-reference-rate-with-cryptographic-attestation-10ad784e"}