# Google Finance API

> Google Finance returns quotes, market data, currency conversions, and company financials as a workflow and API.

Google Finance returns quote details for a stock, fund, index, or cryptocurrency when you provide an asset name or ticker. Its market methods list gainers, losers, active stocks, and major indexes; choose a mover list or optionally a region. Currency conversion needs an amount and source and destination currencies; company financials need a company and can specify a period and statement.

- Page: https://fous.com/tools/google-finance
- Handle: `@google-finance`
- Category: [Finance](https://fous.com/tools/category/finance)
- Source website: https://google.com/finance
- Last verified: Sep 28, 2026

## Methods

### Convert currency

Operation `convert_currency`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Convert an amount between currencies using the current Google Finance quote. Rates may be delayed; unavailable currency pairs cannot be converted.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `amount` | number | yes | `250` | Amount of money to convert, for example 250. |
| `to_currency` | string | yes | `"euro"` | Currency to convert to, such as euro or EUR. |
| `from_currency` | string | yes | `"US dollars"` | Currency to convert from, such as US dollars or USD. |

**Input schema**

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

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `amount` | number | `250` |  |
| `rate_time` | string or null | `"2026-09-28T22:57:19+00:00"` | Time of the quoted rate, with timezone offset. |
| `inverse_rate` | number | `1.1371500001408361` | Units of the source currency for one unit of the destination currency. |
| `exchange_rate` | number | `0.879391461` | Units of the destination currency for one unit of the source currency. |
| `converted_amount` | number | `219.85` | Converted amount rounded to two decimals. |
| `to_currency_code` | string | `"EUR"` |  |
| `to_currency_name` | string | `"Euro"` |  |
| `day_change_percent` | number or null | `0.05477932` | Percentage change over the day. |
| `from_currency_code` | string | `"USD"` |  |
| `from_currency_name` | string | `"United States Dollar"` |  |
| `google_finance_link` | string | `"https://www.google.com/finance/quote/USD-EUR"` |  |
| `previous_close_rate` | number or null | `0.87891` | Previous closing rate in destination currency per source currency. |

**Example input**

```json
{
  "amount": 250,
  "to_currency": "euro",
  "from_currency": "US dollars"
}
```

**Example output**

```json
{
  "amount": 250,
  "rate_time": "2026-09-28T22:57:19+00:00",
  "inverse_rate": 1.1371500001408361,
  "exchange_rate": 0.879391461,
  "converted_amount": 219.85,
  "to_currency_code": "EUR",
  "to_currency_name": "Euro",
  "day_change_percent": 0.05477932,
  "from_currency_code": "USD",
  "from_currency_name": "United States Dollar",
  "google_finance_link": "https://www.google.com/finance/quote/USD-EUR",
  "previous_close_rate": 0.87891
}
```

### Get company financials

Operation `get_company_financials`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a company’s quarterly or annual financial statement lines, exact reported amounts, and year-over-year changes from its Google Finance quote page. Returns up to five displayed periods; unavailable lines are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `period` | string | no | `"annual"` | Financial reporting period, for example annual. |
| `company` | string | yes | `"Apple"` | Company name or ticker, for example Apple or AAPL. |
| `statement` | string | no | `"balance_sheet"` | Statement to read, for example balance_sheet. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "period": {
      "enum": [
        "quarterly",
        "annual"
      ],
      "type": "string",
      "default": "quarterly",
      "description": "Financial reporting period, for example annual.",
      "examples": [
        "annual",
        "quarterly"
      ]
    },
    "company": {
      "type": "string",
      "description": "Company name or ticker, for example Apple or AAPL.",
      "examples": [
        "Apple",
        "Microsoft",
        "AAPL"
      ]
    },
    "statement": {
      "enum": [
        "income_statement",
        "balance_sheet",
        "cash_flow"
      ],
      "type": "string",
      "default": "income_statement",
      "description": "Statement to read, for example balance_sheet.",
      "examples": [
        "balance_sheet",
        "cash_flow"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "Apple"
    },
    {
      "period": "annual",
      "company": "Microsoft",
      "statement": "balance_sheet"
    },
    {
      "period": "quarterly",
      "company": "AAPL",
      "statement": "cash_flow"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `period` | string | `"quarterly"` |  |
| `ticker` | string | `"AAPL:NASDAQ"` | Ticker with exchange, such as AAPL:NASDAQ. |
| `periods` | array |  |  |
| `periods[].cash` | number or null | `20935000000` | Reported full-unit value. |
| `periods[].ebitda` | number or null | `39015000000` | Reported full-unit value. |
| `periods[].revenue` | number or null | `109417000000` | Reported full-unit value. |
| `periods[].page_url` | string | `"https://www.google.com/finance/quote/AAPL:NASDAQ"` | Google Finance quote page for this company. |
| `periods[].net_income` | number or null | `29789000000` | Reported full-unit value. |
| `periods[].period_label` | string | `"Q3 2026"` | Fiscal period label, such as Q3 2026 or 2025. |
| `periods[].total_assets` | number or null | `758376000000` | Reported full-unit value. |
| `periods[].total_equity` | number or null | `442387000000` | Reported full-unit value. |
| `periods[].free_cash_flow` | number or null | `26751375000` | Reported full-unit value. |
| `periods[].period_end_date` | string | `"2026-06-27"` | Actual reporting period end date. |
| `periods[].net_profit_margin` | number or null | `27.23` | Reported percentage value. |
| `periods[].operating_expense` | number or null | `19075000000` | Reported full-unit value. |
| `periods[].total_liabilities` | number or null | `315989000000` | Reported full-unit value. |
| `periods[].earnings_per_share` | number or null | `2.02` | Reported full-unit value. |
| `periods[].effective_tax_rate` | number or null | `17.86` | Reported percentage value. |
| `periods[].financing_cash_flow` | number or null | `-32640000000` | Reported full-unit value. |
| `periods[].investing_cash_flow` | number or null | `-7757000000` | Reported full-unit value. |
| `periods[].operating_cash_flow` | number or null | `34369000000` | Reported full-unit value. |
| `periods[].cash_yoy_change_percent` | number or null | `-30.78` | Change versus the same period one year earlier, as a percentage. |
| `periods[].ebitda_yoy_change_percent` | number or null | `25.73` | Change versus the same period one year earlier, as a percentage. |
| `periods[].revenue_yoy_change_percent` | number or null | `16.36` | Change versus the same period one year earlier, as a percentage. |
| `periods[].net_income_yoy_change_percent` | number or null | `27.12` | Change versus the same period one year earlier, as a percentage. |
| `periods[].total_assets_yoy_change_percent` | number or null | `22.52` | Change versus the same period one year earlier, as a percentage. |
| `periods[].total_equity_yoy_change_percent` | number or null | `28.8` | Change versus the same period one year earlier, as a percentage. |
| `periods[].free_cash_flow_yoy_change_percent` | number or null | `32.96` | Change versus the same period one year earlier, as a percentage. |
| `periods[].net_profit_margin_yoy_change_percent` | number or null | `9.27` | Change versus the same period one year earlier, as a percentage. |
| `periods[].operating_expense_yoy_change_percent` | number or null | `22.94` | Change versus the same period one year earlier, as a percentage. |
| `periods[].total_liabilities_yoy_change_percent` | number or null | `14.69` | Change versus the same period one year earlier, as a percentage. |
| `periods[].earnings_per_share_yoy_change_percent` | number or null | `28.66` | Change versus the same period one year earlier, as a percentage. |
| `periods[].effective_tax_rate_yoy_change_percent` | number or null | `8.9` | Change versus the same period one year earlier, as a percentage. |
| `periods[].financing_cash_flow_yoy_change_percent` | number or null | `-31.44` | Change versus the same period one year earlier, as a percentage. |
| `periods[].investing_cash_flow_yoy_change_percent` | number or null | `-252.91` | Change versus the same period one year earlier, as a percentage. |
| `periods[].operating_cash_flow_yoy_change_percent` | number or null | `23.33` | Change versus the same period one year earlier, as a percentage. |
| `currency` | string | `"USD"` | Financial reporting currency code. |
| `statement` | string | `"income_statement"` |  |
| `company_name` | string | `"Apple Inc"` |  |

**Example input**

```json
{
  "company": "Apple"
}
```

**Example output**

```json
{
  "period": "quarterly",
  "ticker": "AAPL:NASDAQ",
  "periods": [
    {
      "ebitda": 39015000000,
      "revenue": 109417000000,
      "page_url": "https://www.google.com/finance/quote/AAPL:NASDAQ",
      "net_income": 29789000000,
      "period_label": "Q3 2026",
      "period_end_date": "2026-06-27",
      "net_profit_margin": 27.23,
      "operating_expense": 19075000000,
      "earnings_per_share": 2.02,
      "effective_tax_rate": 17.86,
      "ebitda_yoy_change_percent": 25.73,
      "revenue_yoy_change_percent": 16.36,
      "net_income_yoy_change_percent": 27.12,
      "net_profit_margin_yoy_change_percent": 9.27,
      "operating_expense_yoy_change_percent": 22.94,
      "earnings_per_share_yoy_change_percent": 28.66,
      "effective_tax_rate_yoy_change_percent": 8.9
    },
    {
      "ebitda": 39324000000,
      "revenue": 111184000000,
      "page_url": "https://www.google.com/finance/quote/AAPL:NASDAQ",
      "net_income": 29578000000,
      "period_label": "Q2 2026",
      "period_end_date": "2026-03-28",
      "net_profit_margin": 26.6,
      "operating_expense": 18896000000,
      "earnings_per_share": 2.01,
      "effective_tax_rate": 17.46,
      "ebitda_yoy_change_percent": 21.93,
      "revenue_yoy_change_percent": 16.6,
      "net_income_yoy_change_percent": 19.36,
      "net_profit_margin_yoy_change_percent": 2.35,
      "operating_expense_yoy_change_percent": 23.68,
      "earnings_per_share_yoy_change_percent": 21.82,
      "effective_tax_rate_yoy_change_percent": 12.94
    }
  ],
  "currency": "USD",
  "statement": "income_statement",
  "company_name": "Apple Inc"
}
```

### Get quote

Operation `get_quote`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the current quoted price and key figures for a stock, fund, index, or cryptocurrency by name or ticker. Prices may be delayed; unavailable figures are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `asset` | string | yes | `"AAPL"` | Asset name or ticker, such as Apple, AAPL, or Bitcoin. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "Asset name or ticker, such as Apple, AAPL, or Bitcoin.",
      "examples": [
        "AAPL",
        "Apple",
        "VTI"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "asset": "AAPL"
    },
    {
      "asset": "Apple"
    },
    {
      "asset": "VTI"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `name` | string | `"Apple Inc"` |  |
| `as_of` | string or null | `"2026-09-28T16:00:01-04:00"` | The time displayed with the regular-session quote, including its UTC offset. |
| `price` | number or null | `338.4` |  |
| `ticker` | string | `"AAPL (NASDAQ)"` |  |
| `currency` | string or null | `"USD"` |  |
| `pe_ratio` | number or null | `38.79` |  |
| `day_range` | object |  |  |
| `day_range.low` | number or null | `338.04` |  |
| `day_range.high` | number or null | `342.99` |  |
| `market_cap` | number or null | `4940000000000` |  |
| `change_today` | number or null | `-2.67` |  |
| `week_52_range` | object |  |  |
| `week_52_range.low` | number or null | `243.42` |  |
| `week_52_range.high` | number or null | `345.34` |  |
| `previous_close` | number or null | `341.07` |  |
| `google_finance_link` | string | `"https://www.google.com/finance/quote/AAPL:NASDAQ"` |  |
| `percent_change_today` | number or null | `-0.78` |  |
| `dividend_yield_percent` | number or null | `0.32` |  |

**Example input**

```json
{
  "asset": "AAPL"
}
```

**Example output**

```json
{
  "name": "Apple Inc",
  "as_of": "2026-09-28T16:00:01-04:00",
  "price": 338.4,
  "ticker": "AAPL (NASDAQ)",
  "currency": "USD",
  "pe_ratio": 38.79,
  "day_range": {
    "low": 338.04,
    "high": 342.99
  },
  "market_cap": 4940000000000,
  "change_today": -2.67,
  "week_52_range": {
    "low": 243.42,
    "high": 345.34
  },
  "previous_close": 341.07,
  "google_finance_link": "https://www.google.com/finance/quote/AAPL:NASDAQ",
  "percent_change_today": -0.78,
  "dividend_yield_percent": 0.32
}
```

### List market indexes

Operation `list_market_indexes`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List major stock market indexes shown on Google Finance, with current levels, changes and quote times. Quotes may be delayed; indexes not shown are omitted.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `region` | string | no | `"europe_middle_east_africa"` | Region to list, for example "asia_pacific". Default: all. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "region": {
      "enum": [
        "all",
        "americas",
        "europe_middle_east_africa",
        "asia_pacific"
      ],
      "type": "string",
      "default": "all",
      "description": "Region to list, for example \"asia_pacific\". Default: all.",
      "examples": [
        "europe_middle_east_africa",
        "asia_pacific"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "region": "europe_middle_east_africa"
    },
    {
      "region": "asia_pacific"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `indexes` | array |  | Market indexes grouped by region, with the order of indexes preserved within each region. |
| `indexes[].region` | string | `"americas"` | Region of the index. |
| `indexes[].as_of_time` | string or null | `"2026-09-28T16:36:51-04:00"` | Local quote time in ISO 8601 with its UTC offset; null if no dated time is available. |
| `indexes[].index_name` | string | `"Dow Jones"` | Name displayed by Google Finance. |
| `indexes[].change_points` | number | `-347.11` | Displayed change in points. |
| `indexes[].current_level` | number | `51481.51` | Current displayed index level. |
| `indexes[].percent_change` | number | `-0.67` | Displayed percentage change, in percent units. |
| `indexes[].google_finance_link` | string | `"https://www.google.com/finance/quote/.DJI:INDEXDJX"` | Google Finance page for this index. |
| `indexes[].google_index_symbol` | string | `".DJI:INDEXDJX"` | Google index symbol. |

**Example input**

```json
{}
```

**Example output**

```json
{
  "indexes": [
    {
      "region": "americas",
      "as_of_time": "2026-09-28T16:36:51-04:00",
      "index_name": "Dow Jones",
      "change_points": -347.11,
      "current_level": 51481.51,
      "percent_change": -0.67,
      "google_finance_link": "https://www.google.com/finance/quote/.DJI:INDEXDJX",
      "google_index_symbol": ".DJI:INDEXDJX"
    },
    {
      "region": "americas",
      "as_of_time": "2026-09-28T16:36:12-04:00",
      "index_name": "S&P 500",
      "change_points": -59.72,
      "current_level": 7683.69,
      "percent_change": -0.77,
      "google_finance_link": "https://www.google.com/finance/quote/.INX:INDEXSP",
      "google_index_symbol": ".INX:INDEXSP"
    },
    {
      "region": "americas",
      "as_of_time": "2026-09-28T17:15:59-04:00",
      "index_name": "Nasdaq",
      "change_points": -248.34,
      "current_level": 26820.38,
      "percent_change": -0.92,
      "google_finance_link": "https://www.google.com/finance/quote/.IXIC:INDEXNASDAQ",
      "google_index_symbol": ".IXIC:INDEXNASDAQ"
    }
  ]
}
```

### List market movers

Operation `list_market_movers`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List today's leading gainers, losers, or most active stocks in Google Finance order. The current public layout displays up to four stocks per list; quotes may be delayed. The list time is the oldest displayed quote time among its stocks.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `list` | string | no | `"gainers"` | Mover list to view, for example gainers. |
| `max_results` | integer | no | `20` | Maximum stocks to return, for example 20; the current page shows up to four. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "list": {
      "enum": [
        "gainers",
        "losers",
        "most_active"
      ],
      "type": "string",
      "default": "gainers",
      "description": "Mover list to view, for example gainers.",
      "examples": [
        "gainers",
        "losers",
        "most_active"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum stocks to return, for example 20; the current page shows up to four.",
      "x-fous-developer": true,
      "examples": [
        20,
        2,
        50
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "list": "gainers",
      "max_results": 20
    },
    {
      "list": "losers",
      "max_results": 2
    },
    {
      "list": "most_active",
      "max_results": 50
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stocks` | array |  | Stocks in Google Finance display order. |
| `stocks[].currency` | string | `"USD"` | Currency code for the price and price change, for example USD. |
| `stocks[].quote_link` | string | `"https://www.google.com/finance/quote/KOD:NASDAQ"` | Google Finance quote page for this stock. |
| `stocks[].company_name` | string | `"Kodiak Sciences Inc"` | Company or security name. |
| `stocks[].latest_price` | number | `89.92` | Price shown on Google Finance. |
| `stocks[].price_change` | number | `57.57` | Change from the previous close in the listed currency. |
| `stocks[].percent_change` | number | `177.96` | Percentage change from the previous close. |
| `stocks[].ticker_with_exchange` | string | `"KOD (NASDAQ)"` | Symbol and exchange, for example NVDA (NASDAQ). |
| `as_of_time` | string or null | `"2026-09-28T16:00:01-04:00"` | Oldest quote update time for the returned stocks, with the exchange offset; null when no timestamp is shown. |

**Example input**

```json
{
  "list": "gainers",
  "max_results": 20
}
```

**Example output**

```json
{
  "stocks": [
    {
      "currency": "USD",
      "quote_link": "https://www.google.com/finance/quote/KOD:NASDAQ",
      "company_name": "Kodiak Sciences Inc",
      "latest_price": 89.92,
      "price_change": 57.57,
      "percent_change": 177.96,
      "ticker_with_exchange": "KOD (NASDAQ)"
    },
    {
      "currency": "USD",
      "quote_link": "https://www.google.com/finance/quote/MAAS:NASDAQ",
      "company_name": "Maase Inc",
      "latest_price": 17.95,
      "price_change": 2.58,
      "percent_change": 16.79,
      "ticker_with_exchange": "MAAS (NASDAQ)"
    },
    {
      "currency": "USD",
      "quote_link": "https://www.google.com/finance/quote/GDXD:NYSEARCA",
      "company_name": "MicroSectors Gold Miners 3X Inverse Leveraged ETN",
      "latest_price": 22.2,
      "price_change": 3.13,
      "percent_change": 16.41,
      "ticker_with_exchange": "GDXD (NYSEARCA)"
    }
  ],
  "as_of_time": "2026-09-28T16:00:01-04:00"
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@google-finance",
  "visibility": "public",
  "operation": "convert_currency",
  "version": 1,
  "input": {
    "amount": 250,
    "to_currency": "euro",
    "from_currency": "US dollars"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@google-finance\",\n  \"visibility\": \"public\",\n  \"operation\": \"convert_currency\",\n  \"version\": 1,\n  \"input\": {\n    \"amount\": 250,\n    \"to_currency\": \"euro\",\n    \"from_currency\": \"US dollars\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@google-finance",
  "visibility": "public",
  "operation": "convert_currency",
  "version": 1,
  "input": {
    "amount": 250,
    "to_currency": "euro",
    "from_currency": "US dollars"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/google-finance`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `convert_currency`: Convert currency. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_company_financials`: Get company financials. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_quote`: Get quote. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_market_indexes`: List market indexes. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_market_movers`: List market movers. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-google-finance https://api.fous.com/mcp/tools/google-finance --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare stock quotes and key figures across assets
- Review leading market gainers, losers, or active stocks
- Track displayed index levels and changes by region
- Convert amounts between currencies
- Compare company financial statement figures across periods

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Google Finance tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Google Finance account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from google.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.

### What is a stock's current quoted price?

Use Get quote with the asset name or ticker to return its displayed price and key figures.

### Which stocks are today's leading gainers or losers?

Use List market movers with the desired list, such as gainers or losers.

### What were a company's financial results across periods?

Use Get company financials with the company name or ticker, and optionally specify a period and statement.

## Related

- [Yahoo Finance API](https://fous.com/tools/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [MSN Money API](https://fous.com/tools/msn-money.md): MSN Money provides stock quotes, key facts, financial news, and market data, including current market movers; quotes and prices may be delayed.
- [Stock Analysis API](https://fous.com/tools/stock-analysis.md): Stock Analysis returns free-period company statements, statistics current as of its displayed date, typically top-25 ETF holdings, and US IPOs since 2019 with potentially missing prices or returns.
- [CoinMarketCap API](https://fous.com/tools/coinmarketcap.md): CoinMarketCap returns prices, rankings and current Fear and Greed readings; gainers and losers include up to 30 top-100 coins above $50,000 in 24-hour volume.
- [XE API](https://fous.com/tools/xe.md): XE returns currency conversions and mid-market rates, including current displayed rates for information and published historical daily rates for available UTC dates.
- [SEC EDGAR API](https://fous.com/tools/sec-edgar.md): SEC EDGAR provides filings, annual and quarterly financials, exact-phrase matches, up to 200 insider trades, and quarterly 13F manager holdings; older filings appear when available.
- [CNBC API](https://fous.com/tools/cnbc.md): CNBC provides business news, page-view headlines, searchable CNBC articles excluding videos, wire stories and press releases, and potentially delayed major index and U.S. futures quotes.
- [Macrotrends API](https://fous.com/tools/macrotrends.md): Macrotrends provides long-term financial and economic charts, company metric histories, and yearly commodity and index prices; current-year prices may be incomplete.
- [All Finance tools](https://fous.com/tools/category/finance)