# Google API: Convert currency amount

> Converts an amount between two currencies using the current Google Finance quote. Rates may be delayed.

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/google.com/convert-currency
- Method: `google.com/convert_currency`, version 1
- Website: google.com
- Returns: converted amount, exchange rate, inverse rate, previous close, day change, rate time, quote 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 | `75.5` | Amount of money to convert, for example 250. |
| `to_currency` | string | yes | `"JPY"` | Currency to convert to, such as euro or EUR. |
| `from_currency` | string | yes | `"GBP"` | Currency to convert from, such as US dollars or USD. |

## Output

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

```json
{
  "amount": 75.5,
  "to_currency": "JPY",
  "from_currency": "GBP"
}
```

Its output:

```json
{
  "amount": 75.5,
  "rate_time": "2026-10-23T08:12:19+00:00",
  "inverse_rate": 0.004762040820213911,
  "exchange_rate": 209.994,
  "converted_amount": 15854.55,
  "to_currency_code": "JPY",
  "to_currency_name": "Japanese Yen",
  "day_change_percent": 0.1072608,
  "from_currency_code": "GBP",
  "from_currency_name": "Pound sterling",
  "google_finance_link": "https://www.google.com/finance/quote/GBP-JPY",
  "previous_close_rate": 209.77554
}
```

## 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":"google.com/convert_currency","input":{"amount":75.5,"to_currency":"JPY","from_currency":"GBP"}}'
```

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 US dollars in euros right now?
- Convert 1200 USD to EUR using today's rate
- What's the current exchange rate from yen to dollars for 50000 JPY?
- I need 75 British pounds converted into Canadian dollars, what's the rate and previous close?
- On Google, how many Swiss francs would 500 US dollars get me today?

## Input schema

```json
{
  "type": "object",
  "required": [
    "amount",
    "from_currency",
    "to_currency"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount of money to convert, for example 250."
    },
    "to_currency": {
      "type": "string",
      "description": "Currency to convert to, such as euro or EUR."
    },
    "from_currency": {
      "type": "string",
      "description": "Currency to convert from, such as US dollars or USD."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "amount",
    "from_currency_code",
    "from_currency_name",
    "to_currency_code",
    "to_currency_name",
    "converted_amount",
    "exchange_rate",
    "inverse_rate",
    "previous_close_rate",
    "day_change_percent",
    "rate_time",
    "google_finance_link"
  ],
  "properties": {
    "amount": {
      "type": "number"
    },
    "rate_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Time of the quoted rate, with timezone offset."
    },
    "inverse_rate": {
      "type": "number",
      "description": "Units of the source currency for one unit of the destination currency."
    },
    "exchange_rate": {
      "type": "number",
      "description": "Units of the destination currency for one unit of the source currency."
    },
    "converted_amount": {
      "type": "number",
      "description": "Converted amount rounded to two decimals."
    },
    "to_currency_code": {
      "type": "string"
    },
    "to_currency_name": {
      "type": "string"
    },
    "day_change_percent": {
      "type": [
        "number",
        "null"
      ],
      "description": "Percentage change over the day."
    },
    "from_currency_code": {
      "type": "string"
    },
    "from_currency_name": {
      "type": "string"
    },
    "google_finance_link": {
      "type": "string",
      "format": "uri"
    },
    "previous_close_rate": {
      "type": [
        "number",
        "null"
      ],
      "description": "Previous closing rate in destination currency per source currency."
    }
  }
}
```

## See more

- [Google API: Get quote](https://fous.com/methods/google.com/get-quote.md): Gets the current quoted price and key figures for a stock, fund, index, or cryptocurrency on Google Finance, by name or ticker. Prices may be delayed, and figures Google does not show are null.
- [Google API: Translate text](https://fous.com/methods/translate.google.com/translate-text.md): Translates up to 5,000 characters on Google Translate, with the detected source language, Latin-letter pronunciation when shown, and dictionary alternatives for words or short phrases.
- [Google API: Get company financials](https://fous.com/methods/google.com/get-company-financials.md): Gets a company's quarterly or annual income statement, balance sheet or cash flow lines from its Google Finance quote page, with exact reported amounts and year-over-year changes.
- [Google API: List market indexes](https://fous.com/methods/google.com/list-market-indexes.md): Lists major stock market indexes on Google Finance with their current levels, changes and quote times. Quotes may be delayed, and indexes Google does not show are left out.
- [Google API: Search Google Hotels](https://fous.com/methods/google.com/search-hotels.md): Finds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change.
- [Google API: Search Google Flights](https://fous.com/methods/google.com/search-flights.md): Finds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares.
- [Google API: List Google Finance market movers](https://fous.com/methods/google.com/list-market-movers.md): Lists today's leading gainers, losers or most active stocks in Google Finance display order, with price, change, percent change and currency; the public page shows up to four stocks per list.
- [Google API: Get hotel reviews from Google Hotels](https://fous.com/methods/google.com/get-hotel-reviews.md): Finds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic.
- [All Google methods](https://fous.com/methods/google.com.md)