# Google API: List Google Finance market movers

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

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/google.com/list-market-movers
- Method: `google.com/list_market_movers`, version 1
- Website: google.com
- Returns: as_of_time, stocks (company name, ticker and exchange, latest price, currency, price change, percent change, 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 |
|---|---|---|---|---|
| `list` | string | no | `"gainers"` | Mover list to view, for example gainers. One of "gainers", "losers", "most_active". Default "gainers". |
| `max_results` | integer | no | `20` | Maximum stocks to return, for example 20; the current page shows up to four. Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

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

Its 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"
}
```

## 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/list_market_movers","input":{"list":"gainers","max_results":20}}'
```

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

- What are the top stock gainers today on Google Finance?
- Show me the biggest losers in the stock market right now, with their percent drop.
- Which stocks are the most actively traded today? Just give me the top 3.
- Pull today's leading decliners from Google Finance with price, change and currency.
- Give me the 4 best-performing stocks of the day with their latest price and percent gain.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "list": {
      "enum": [
        "gainers",
        "losers",
        "most_active"
      ],
      "type": "string",
      "default": "gainers",
      "description": "Mover list to view, for example gainers."
    },
    "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."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "as_of_time",
    "stocks"
  ],
  "properties": {
    "stocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "company_name",
          "ticker_with_exchange",
          "latest_price",
          "currency",
          "price_change",
          "percent_change",
          "quote_link"
        ],
        "properties": {
          "currency": {
            "type": "string",
            "description": "Currency code for the price and price change, for example USD."
          },
          "quote_link": {
            "type": "string",
            "description": "Google Finance quote page for this stock."
          },
          "company_name": {
            "type": "string",
            "description": "Company or security name."
          },
          "latest_price": {
            "type": "number",
            "description": "Price shown on Google Finance."
          },
          "price_change": {
            "type": "number",
            "description": "Change from the previous close in the listed currency."
          },
          "percent_change": {
            "type": "number",
            "description": "Percentage change from the previous close."
          },
          "ticker_with_exchange": {
            "type": "string",
            "description": "Symbol and exchange, for example NVDA (NASDAQ)."
          }
        },
        "additionalProperties": false
      },
      "description": "Stocks in Google Finance display order."
    },
    "as_of_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Oldest quote update time for the returned stocks, with the exchange offset; null when no timestamp is shown.",
      "x-fous-developer": true
    }
  },
  "additionalProperties": false
}
```

## See more

- [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: 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: 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 trending searches](https://fous.com/methods/trends.google.com/list-trending-searches.md): Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.
- [Google API: Get company ads](https://fous.com/methods/adstransparency.google.com/get-company-ads.md): Finds a verified advertiser in the Google Ads Transparency Center by company name or website domain and returns its Google ads with dates, regions, previews and ad pages. Counts may be approximate; regions and media previews are read for the first 40 ads.
- [Google API: List top stories](https://fous.com/methods/news.google.com/list-top-stories.md): Lists the current top Google News stories, overall or for one topic, in a chosen country and language edition.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [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.
- [All Google methods](https://fous.com/methods/google.com.md)
