Soren · Oracle FX

by Soren

GETBasebase

$0.01

per call · USD Coin on Base

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.

Endpoint

GET https://soren.com/v1/oracle/fx

2

Calls / 30d

1

Unique payers / 30d

Aug 26

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://soren.com/v1/oracle/fx", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://soren.com/v1/oracle/fx?pair=EURUSD" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "provenance": {
    "observed_at": "<ISO-8601 UTC>",
    "signature": {
      "algorithm": "Ed25519",
      "value": "<base64>"
    },
    "upstream_sha256": "<hex>"
  },
  "source": {
    "name": "European Central Bank",
    "notice": "Available free of charge from the ECB."
  },
  "value": {
    "derivation": "<text>",
    "pair": "EURUSD",
    "rate": "<number>",
    "reference_date": "<YYYY-MM-DD>"
  }
}

Payment details

Pay to0xadc3a47efbd82ed724a0e9a3d08d5a1a8e6586fd
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, base
Schemesexact

Is this your API?

Pin it to the top of Market Data and the homepage with a featured placement.

Get featured →

More from Soren & similar services