Catalog
FinanceGETlive

Currency exchange rates

Fetch current or timestamped currency exchange rates.

$0.0012
per call
Success
100%
p50 latency
1.03s
p95 latency
1.18s
Calls (30d)
3

Provider contract

Call path
/routes/2sio/finance/exchange-rates
Method
GET
Selected provider
2siodefault
Provider price
$0.0012
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/2sio/finance/exchange-rates?base=USD'
CLI
h402 call 'finance/exchange-rates' --provider '2sio' --method GET --query '{"base":"USD"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

basestringrequired3–3 chars

Source ISO 4217 currency code (e.g. USD, EUR).

e.g.
symbolsstringoptional3–3 chars

Optional target ISO 4217 currency code (e.g. KRW, JPY).

e.g.
datestringoptional

Optional timestamp for the rate.

GET/routes/2sio/finance/exchange-rates
Request query
{
  "base": "USD"
}

ResponseExample response
{
  "data": {
    "data": {
      "ok": true,
      "items": [
        {
          "currency": "EUR",
          "rate": 0.87581
        }
      ],
      "total": 1,
      "source": {
        "provider": "Frankfurter — daily reference rates from the European Central Bank",
        "url": "https://frankfurter.dev/",
        "license": "ECB reference rates — free for public use with attribution."
      },
      "meta": {
        "base": "USD",
        "date": "2026-07-21",
        "amount": 1
      }
    },
    "meta": {
      "endpoint": "fx.rates",
      "version": null,
      "caller": "x402",
      "cost": {
        "usd": 0.0012
      },
      "settlement": {
        "txHash": "0xb005dfa11e41b38f2244fd162b2b92fb53c43d4142f7cb72baf8ab95fb172ab3",
        "network": "eip155:8453",
        "success": true
      }
    }
  },
  "h402": {
    "routeId": "finance/exchange-rates",
    "provider": "2sio",
    "selectedCandidateId": "finance/exchange-rates/2sio",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

2sio
x402
100
Success
100%
p50
1.03s
Calls
3
100%
$0.0012$0.0012/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider