European Union API: Convert currency
Converts an amount between currencies using ECB euro reference rates, including euro and cross-currency conversions. Uses the latest preceding published rate when the date has none.
Unofficial. Not affiliated with or endorsed by European Union.
Inputs
Values from the run on Oct 27, 2026, shown under Output.
- Date optional
date Requested rate date in YYYY-MM-DD, for example 2026-09-26. Defaults to the latest published day; non-publication dates use the preceding published rate.
Not set
- Amount, required
amount Amount of money to convert, for example 250.
250
Number.
- To Currency, required
to_currency Currency name or three-letter code to convert to, for example GBP or pound sterling.
GBP
- From Currency, required
from_currency Currency name or three-letter code to convert from, for example US dollar or USD.
US dollar
Input as JSON
{ "amount": 250, "to_currency": "GBP", "from_currency": "US dollar"}Output
{ "rate": 0.749196, "page_url": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html" , "rate_date": "2026-10-26", "converted_amount": 187.3, "to_currency_code": "GBP", "to_currency_name": "Pound sterling", "from_currency_code": "USD", "from_currency_name": "US dollar"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ecb.europa.eu/convert_currency","input":{"amount":250,"to_currency":"GBP","from_currency":"US dollar"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "ecb.europa.eu/convert_currency" , "input": { "amount": 250, "to_currency": "GBP", "from_currency": "US dollar" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "ecb.europa.eu/convert_currency" , "input": { "amount": 250, "to_currency": "GBP", "from_currency": "US dollar" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run ecb.europa.eu/convert_currency# with {"amount":250,"to_currency":"GBP","from_currency":"US dollar"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "amount", "from_currency", "to_currency" ], "properties": { "date": { "type": "string", "examples": [ "2026-09-26" ], "description": "Requested rate date in YYYY-MM-DD, for example 2026-09-26. Defaults to the latest published day; non-publication dates use the preceding published rate." }, "amount": { "type": "number", "examples": [ 250 ], "description": "Amount of money to convert, for example 250." }, "to_currency": { "type": "string", "examples": [ "GBP" ], "description": "Currency name or three-letter code to convert to, for example GBP or pound sterling." }, "from_currency": { "type": "string", "examples": [ "US dollar" ], "description": "Currency name or three-letter code to convert from, for example US dollar or USD." } }}Output schema
{ "type": "object", "required": [ "converted_amount", "rate", "rate_date", "from_currency_code", "from_currency_name", "to_currency_code", "to_currency_name", "page_url" ], "properties": { "rate": { "type": "number", "description": "Units of the To currency per one unit of the From currency, rounded to six decimal places." }, "page_url": { "type": "string", "description": "ECB euro reference rates page." }, "rate_date": { "type": "string", "format": "date", "description": "Date of the ECB reference rates actually used." }, "converted_amount": { "type": "number", "description": "Converted amount, rounded to two decimal places." }, "to_currency_code": { "type": "string", "description": "Three-letter code of the destination currency." }, "to_currency_name": { "type": "string", "description": "Name of the destination currency." }, "from_currency_code": { "type": "string", "description": "Three-letter code of the source currency." }, "from_currency_name": { "type": "string", "description": "Name of the source currency." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ecb.europa.eu/convert_currency- Returns
- converted amount, rate, rate date, currency codes and names
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method ecb.europa.eu/convert_currency with the inputs above.
Ask your agent
- How many British pounds is 250 US dollars worth according to the ECB rate on 2026-09-26?
- Convert 1200 Japanese yen into euros using the latest ECB reference rate.
- What would 75 euros be in Swiss francs on a past date like 2025-03-14?
- I need 500 Canadian dollars converted to pound sterling, using whatever the most recent published rate is before the 2026-09-27 weekend.
- Using europa.eu, convert 980 Polish zloty to Norwegian krone and tell me the rate and the date it applies to.
See more
All European Union methodsGets the official ECB euro reference exchange rates for a day, or the latest published day. Weekends, holidays and dates before publication return the previous published day.
ecb.europa.eu/get_euro_exchange_ratesReturns the ECB's current deposit facility, main refinancing operations and marginal lending facility rates with their effective date. Optionally includes earlier rate changes, newest first.
ecb.europa.eu/get_key_interest_ratesLooks up an official Eurostat statistic for an EU or EEA country and the EU27 figure for the same period. Quarterly and half-yearly series return the reporting period that contains a requested month.
ec.europa.eu/get_statisticFinds recently published EU procurement notices matching what is being bought, with buyer, estimated value, submission deadline and TED notice link. Open-only results must have a future submission deadline.
ted.europa.eu/search_tendersFinds published EU contract award notices on Tenders Electronic Daily by contract topic or winning company, newest publication first, optionally limited to a buyer country and a start date. Values and tender counts are included when published; counts across lots are summed.
ted.europa.eu/search_contract_awardsGets the official text and key dates of one article of an EU regulation or directive from EUR-Lex, in the latest consolidated version when there is one, in any official EU language.
eur-lex.europa.eu/get_law_articleSearches EUR-Lex legal acts by topic, ranked by the site's relevance, filtered by document type, year of adoption and in-force status. Short names and ELI links are included when shown in the results.
eur-lex.europa.eu/search_eu_lawChecks an EU VAT number in the European Commission's VIES service and returns whether it is valid, with the registered name and address when the country makes them available.
ec.europa.eu/validate_vat_number