# 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.

- Page: https://fous.com/methods/ecb.europa.eu/get-euro-exchange-rates
- Method: `ecb.europa.eu/get_euro_exchange_rates`, version 1
- Website: ecb.europa.eu
- Returns: rate date, currency names and codes, units per euro, ECB page
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `date` | string | no |  | Day to look up in YYYY-MM-DD form, for example 2026-09-26. Defaults to the latest published day. |
| `currencies` | array of string | no |  | Currency names or codes, for example ["US dollar", "JPY"]. Defaults to every currency published on the rate date. Default []. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "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"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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

## Input schema

```json
{
  "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

```json
{
  "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
}
```

## See more

- [European Union API: Convert currency](https://fous.com/methods/ecb.europa.eu/convert-currency.md): 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.
- [European Union API: Get key interest rates](https://fous.com/methods/ecb.europa.eu/get-key-interest-rates.md): Returns 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.
- [European Union API: Get Eurostat statistic for a country](https://fous.com/methods/ec.europa.eu/get-statistic.md): Looks 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.
- [European Union API: Search EU public procurement notices](https://fous.com/methods/ted.europa.eu/search-tenders.md): Finds 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.
- [European Union API: Search EU contract awards](https://fous.com/methods/ted.europa.eu/search-contract-awards.md): Finds 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.
- [European Union API: Get EU law article](https://fous.com/methods/eur-lex.europa.eu/get-law-article.md): Gets 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.
- [European Union API: Search EU law](https://fous.com/methods/eur-lex.europa.eu/search-eu-law.md): Searches 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.
- [European Union API: Validate EU VAT number](https://fous.com/methods/ec.europa.eu/validate-vat-number.md): Checks 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.
- [All European Union methods](https://fous.com/methods/europa.eu.md)