Currency exchange rates API (ECB reference rates)

Updated 2026-10-13

Use when an agent must convert an amount between currencies at ECB reference rates, latest or from the last 90 days.

From an MCP client, add https://tanod.dev/mcp and call get_fx_rates; its free daily calls are applied automatically, no key or signup.

POST a base currency, and optionally the symbols and a date, to /v1/fx. It returns the European Central Bank (ECB) euro foreign exchange reference rates, as cross rates when the base is not EUR.

Request

symbols (1 to 40 ISO 4217 codes) and date (YYYY-MM-DD, within the last 90 days) are optional. A date with no publication uses the previous publication day.

curl, using the free tier
curl -s -X POST https://tanod.dev/v1/fx \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"base":"USD","symbols":["EUR","JPY","GBP"]}'

Response

Response (a real call, attribution shortened)
{
  "base": "USD",
  "date": "2026-10-06",
  "rates": {"EUR": "0.88739019", "JPY": "158.08856", "GBP": "0.75321679"},
  "cached": true,
  "stale": false,
  "attribution": {
    "source": "European Central Bank (ECB), euro foreign exchange reference rates",
    "free_of_charge": "The ECB reference rates are available free of charge from the ECB website (url above).",
    "modification": "Rates for a base other than EUR are cross rates computed by this service ...",
    "disclaimer": "The ECB publishes the reference rates for information purposes only; using them for transaction purposes is strongly discouraged."
  }
}

How it compares

Other pay-per-call exchange-rate APIs that the Agent402 router returned for "convert currency exchange rate" on 13 October 2026, with their listed price per call:

This route costs USD 0.001. It returns ECB reference rates for any base and the symbols you choose, for today or a date within the last 90 days. For a live rate from on-chain stablecoin pools instead, see live FX rates (USD 0.002). Prices are as listed on that date and change; check each 402.

Recipe: FX timing in backtests

When you convert prices from one market into another currency for a backtest, the time of the FX rate matters. ECB reference rates come from a daily concertation between central banks at about 14:10 CET and are published at about 16:00 CET on working days. They are not a close. US equity closes come later, at 22:00 CET, and European closes come about an hour and a half after the fixing. A rate from date D paired with a close from date D is therefore close in time for European stocks but several hours early for US stocks. If your backtest must not see anything later than the trade decision, use the rate from the previous publication day (pass date as the day before; for a date with no publication, the route returns the previous publication day and says so in date). Run the test once with same-day rates and once lagged by one session: if the ranking changes, the FX timing is driving part of your result. For a live rate instead of a fixing, see live FX rates.

When converting currency amounts for travel budgeting, the ECB reference rates give a consistent daily benchmark (that link is idoletsgo's guide), which helps couples who are maximizing wedding expenses through curated credit card strategies for earning travel points.

Limits and caveats

Source and attribution. The rates are the European Central Bank euro foreign exchange reference rates, which the ECB makes available free of charge at ecb.europa.eu. The response attribution field carries the source URL and terms; keep it when you republish.

Cross rates. For a base other than EUR, the rate is computed from the ECB EUR rates (rate of the symbol divided by rate of the base) and rounded to 8 significant digits. EUR-base rates are the ECB figures unchanged.

Not for transactions. The ECB publishes the rates for information only and discourages using them for transaction purposes. They are daily reference rates, not live market prices.

Price and free allowance

USD 0.001 per call, paid in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum with x402. 10 free calls per IP per UTC day with the header X-Tanod-Free: 1. The pool is shared with QR, geocode and holidays. MCP tool: get_fx_rates at https://tanod.dev/mcp, where the free tier is automatic.

All endpoints →

Use it from Claude without writing code: in claude.ai or Claude Desktop, add https://tanod.dev/mcp/finance?via=exchange-rates-api as a custom connector (steps), then ask in plain words, for example "Convert 250 euros to US dollars at the ECB rate." The free daily allowance is applied automatically over MCP. Beyond it a call needs an x402 payment, which these clients can make.

Related guides: What currency exchange rate APIs cost over x402, Public holidays API, Weather forecast API without an API key, Pay-per-call APIs for AI agents with x402. Back to tanod.dev or the guide index. Results are automated and heuristic.