European Union API: Get euro exchange rates
Gets 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.
Unofficial. Not affiliated with or endorsed by European Union.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Date optional
date Day to look up in YYYY-MM-DD form, for example 2026-09-26. Defaults to the latest published day.
Not set
- Currencies optional
currencies Currency names or codes, for example ["US dollar", "JPY"]. Defaults to every currency published on the rate date.
[] (default)
List of text.
Input as JSON
{}Output
{ "rates": [ { "page_url": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/eurofxref-graph-usd.en.html" , "currency_code": "USD", "currency_name": "US dollar", "units_per_euro": 1.1205 }, { "page_url": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/eurofxref-graph-jpy.en.html" , "currency_code": "JPY", "currency_name": "Japanese yen", "units_per_euro": 175.97 }, { "page_url": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/eurofxref-graph-czk.en.html" , "currency_code": "CZK", "currency_name": "Czech koruna", "units_per_euro": 24.26 } ], "rate_date": "2026-10-22"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ecb.europa.eu/get_euro_exchange_rates","input":{}}' # 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/get_euro_exchange_rates" , "input": {}})# 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/get_euro_exchange_rates" , "input": {} }), 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/get_euro_exchange_rates# with {}"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", "properties": { "date": { "type": "string", "description": "Day to look up in YYYY-MM-DD form, for example 2026-09-26. Defaults to the latest published day." }, "currencies": { "type": "array", "items": { "type": "string" }, "default": [], "description": "Currency names or codes, for example [\"US dollar\", \"JPY\"]. Defaults to every currency published on the rate date." } }}Output schema
{ "type": "object", "required": [ "rate_date", "rates" ], "properties": { "rates": { "type": "array", "items": { "type": "object", "required": [ "currency_name", "currency_code", "units_per_euro", "page_url" ], "properties": { "page_url": { "type": "string", "description": "ECB page for this currency." }, "currency_code": { "type": "string" }, "currency_name": { "type": "string" }, "units_per_euro": { "type": "number", "description": "Units of this currency for 1 euro." } }, "additionalProperties": false }, "description": "Exchange rates in ECB order." }, "rate_date": { "type": "string", "description": "Date of the published rates." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ecb.europa.eu/get_euro_exchange_rates- Returns
- rate date, currency names and codes, units per euro, ECB page
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/get_euro_exchange_rates with the inputs above.
Ask your agent
- What was the ECB euro reference rate for US dollars on 2026-09-26?
- Give me today's official euro exchange rates for JPY and GBP
- Look up the latest published euro reference rates for every currency
- I need the euro to Swiss franc rate from the European Central Bank for last Friday, 2026-03-13
- Check the ECB euro rates on europa.eu for Japanese yen and Polish zloty on 2025-12-31
See more
All European Union methodsConverts 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.
ecb.europa.eu/convert_currencyReturns 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