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

- Page: https://fous.com/methods/ecb.europa.eu/convert-currency
- Method: `ecb.europa.eu/convert_currency`, version 1
- Website: ecb.europa.eu
- Returns: converted amount, rate, rate date, currency codes and names
- 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 |  | 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` | number | yes | `250` | Amount of money to convert, for example 250. |
| `to_currency` | string | yes | `"GBP"` | Currency name or three-letter code to convert to, for example GBP or pound sterling. |
| `from_currency` | string | yes | `"US dollar"` | Currency name or three-letter code to convert from, for example US dollar or USD. |

## Output

From a run on Oct 27, 2026. Its input:

```json
{
  "amount": 250,
  "to_currency": "GBP",
  "from_currency": "US dollar"
}
```

Its output:

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

## 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/convert_currency","input":{"amount":250,"to_currency":"GBP","from_currency":"US dollar"}}'
```

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

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

## Input schema

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

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

## See more

- [European Union API: Get euro exchange rates](https://fous.com/methods/ecb.europa.eu/get-euro-exchange-rates.md): 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.
- [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)