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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Amount, required
amount Amount of money to convert, for example 250.
75.5
Number.
- To Currency, required
to_currency Currency to convert to, such as euro or EUR.
JPY
- From Currency, required
from_currency Currency to convert from, such as US dollars or USD.
GBP
Input as JSON
{ "amount": 75.5, "to_currency": "JPY", "from_currency": "GBP"}Output
{ "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}Code
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"}}' # 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": "google.com/convert_currency" , "input": { "amount": 75.5, "to_currency": "JPY", "from_currency": "GBP" }})# 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": "google.com/convert_currency" , "input": { "amount": 75.5, "to_currency": "JPY", "from_currency": "GBP" } }), 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 google.com/convert_currency# with {"amount":75.5,"to_currency":"JPY","from_currency":"GBP"}"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", "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
{ "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." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
google.com/convert_currency- Returns
- converted amount, exchange rate, inverse rate, previous close, day change, rate time, quote link
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 google.com/convert_currency with the inputs above.
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?
See more
All Google methodsGets 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.com/get_quoteTranslates 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.
translate.google.com/translate_textGets 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.com/get_company_financialsLists 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.com/list_market_indexesFinds 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.com/search_hotelsFinds 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.com/search_flightsLists 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.com/list_market_moversFinds 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.
google.com/get_hotel_reviews