# XE API: Convert currency

> Converts an amount between two currencies using XE's displayed mid-market rate. It also returns the rate time and an XE converter link. Rates are informational, not transfer quotes.

Unofficial. Not affiliated with or endorsed by XE.

- Page: https://fous.com/methods/xe.com/convert-currency
- Method: `xe.com/convert_currency`, version 1
- Website: xe.com
- Returns: converted amount, rate, inverse rate, rate time, currency names, XE link
- 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 |
|---|---|---|---|---|
| `amount` | number | yes | `100` | Amount to convert, for example 100. |
| `to_currency` | string | yes | `"Japanese yen"` | Currency to convert to, for example Japanese yen or JPY. |
| `from_currency` | string | yes | `"euro"` | Currency to convert from, for example euro or EUR. |

## Output

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

```json
{
  "amount": 100,
  "to_currency": "Japanese yen",
  "from_currency": "euro"
}
```

Its output:

```json
{
  "rate": 176.1223594853344,
  "amount": 100,
  "rate_time": "2026-10-23T07:03:00Z",
  "inverse_rate": 0.005677870787798919,
  "converted_amount": 17612,
  "to_currency_code": "JPY",
  "to_currency_name": "Japanese Yen",
  "xe_converter_link": "https://www.xe.com/currencyconverter/convert/?Amount=100&From=EUR&To=JPY",
  "from_currency_code": "EUR",
  "from_currency_name": "Euro"
}
```

## 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":"xe.com/convert_currency","input":{"amount":100,"to_currency":"Japanese yen","from_currency":"euro"}}'
```

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 much is 250 euros in Japanese yen right now?
- Convert 1000 US dollars to British pounds at today's rate
- What is the current EUR to JPY rate for 75 euros?
- I need to know how many Canadian dollars 500 Mexican pesos equals
- On xe.com, what does 320 Swiss francs come to in Australian dollars?

## Input schema

```json
{
  "type": "object",
  "required": [
    "amount",
    "from_currency",
    "to_currency"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 0,
      "description": "Amount to convert, for example 100."
    },
    "to_currency": {
      "type": "string",
      "minLength": 1,
      "description": "Currency to convert to, for example Japanese yen or JPY."
    },
    "from_currency": {
      "type": "string",
      "minLength": 1,
      "description": "Currency to convert from, for example euro or EUR."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "amount",
    "from_currency_code",
    "from_currency_name",
    "to_currency_code",
    "to_currency_name",
    "converted_amount",
    "rate",
    "inverse_rate",
    "rate_time",
    "xe_converter_link"
  ],
  "properties": {
    "rate": {
      "type": "number"
    },
    "amount": {
      "type": "number"
    },
    "rate_time": {
      "type": "string"
    },
    "inverse_rate": {
      "type": "number"
    },
    "converted_amount": {
      "type": "number"
    },
    "to_currency_code": {
      "type": "string"
    },
    "to_currency_name": {
      "type": "string"
    },
    "xe_converter_link": {
      "type": "string"
    },
    "from_currency_code": {
      "type": "string"
    },
    "from_currency_name": {
      "type": "string"
    }
  }
}
```

## See more

- [XE API: Get historical exchange rate](https://fous.com/methods/xe.com/get-historical-rate.md): Gets XE's daily mid-market exchange rate for a past UTC date and converts an amount with it.
- [Google API: Convert currency amount](https://fous.com/methods/google.com/convert-currency.md): Converts an amount between two currencies using the current Google Finance quote. Rates may be delayed.
- [Wise API: Get exchange rate](https://fous.com/methods/wise.com/get-exchange-rate.md): Gets Wise's current mid-market exchange rate and converted amount for two currencies, with optional daily rate history.
- [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.
- [Wise API: Compare transfer costs](https://fous.com/methods/wise.com/compare-transfer-costs.md): Compares what recipients get from Wise and other providers for a transfer amount and currency pair, with fees, rates and delivery times.
- [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.
- [BLS API: Convert US dollars between months with CPI](https://fous.com/methods/bls.gov/calculate-inflation.md): Converts a US dollar amount from one month or annual average to another using the US city average CPI-U for all items, not seasonally adjusted. Defaults to the latest published month.
- [Numbeo API: Compare cost of living between two cities](https://fous.com/methods/numbeo.com/compare-cost-of-living.md): Compares living costs in two Numbeo cities: six price and purchasing-power differences, plus the monthly take-home salary needed in the destination for a similar standard of living (rent assumed in both cities).
- [All XE methods](https://fous.com/methods/xe.com.md)