# Yahoo API: List market movers > Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap. Unofficial. Not affiliated with or endorsed by Yahoo. - Page: https://fous.com/methods/finance.yahoo.com/list-market-movers - Method: `finance.yahoo.com/list_market_movers`, version 1 - Website: finance.yahoo.com - Returns: company name, ticker, price, change, volume, market cap, P/E, 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 | `"top_gainers"` | Which Yahoo market list to show, for example top_gainers. One of "top_gainers", "top_losers", "most_active", "trending". Default "top_gainers". | | `region` | string | no | | Region for trending tickers, for example Canada. Other lists show US stocks. One of "United States", "United Kingdom", "Canada", "Australia", "India", "Germany", "France", "Hong Kong". Default "United States". | | `max_results` | integer | no | | Maximum number of entries, for example 25 (up to 100). Default 25. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "list": "top_gainers" } ``` Its output: ```json { "as_of": "2026-10-22T20:02:36+00:00", "movers": [ { "price": 14.69, "change": 2.94, "ticker": "BHVN", "volume": 30491335, "currency": "USD", "market_cap": 2218832896, "quote_link": "https://finance.yahoo.com/quote/BHVN/", "company_name": "Biohaven Ltd.", "percent_change": 25.0213, "market_cap_display": "2.219B", "average_volume_3_months": 3027896, "price_to_earnings_ratio": null }, { "price": 197.21, "change": 24.77, "ticker": "POOL", "volume": 2194900, "currency": "USD", "market_cap": 7166758912, "quote_link": "https://finance.yahoo.com/quote/POOL/", "company_name": "Pool Corporation", "percent_change": 14.3644, "market_cap_display": "7.167B", "average_volume_3_months": 801360, "price_to_earnings_ratio": 18.09266 }, { "price": 34.25, "change": 4.145, "ticker": "CNXC", "volume": 1662098, "currency": "USD", "market_cap": 2092861312, "quote_link": "https://finance.yahoo.com/quote/CNXC/", "company_name": "Concentrix Corporation", "percent_change": 13.7685, "market_cap_display": "2.093B", "average_volume_3_months": 1535978, "price_to_earnings_ratio": null } ] } ``` ## 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":"finance.yahoo.com/list_market_movers","input":{"list":"top_gainers"}}' ``` 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 - Show me the biggest stock gainers today with their prices and market caps - What are the top losing stocks right now? List 10 with percent change and volume - Which shares are most actively traded this session on Yahoo Finance? - Give me the trending tickers in Germany with P/E ratios and quote links - Pull up the 50 largest daily movers in the UK market, including volume and market cap ## Input schema ```json { "type": "object", "required": [], "properties": { "list": { "enum": [ "top_gainers", "top_losers", "most_active", "trending" ], "type": "string", "default": "top_gainers", "description": "Which Yahoo market list to show, for example top_gainers." }, "region": { "enum": [ "United States", "United Kingdom", "Canada", "Australia", "India", "Germany", "France", "Hong Kong" ], "type": "string", "default": "United States", "description": "Region for trending tickers, for example Canada. Other lists show US stocks." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum number of entries, for example 25 (up to 100)." } } } ``` ## Output schema ```json { "type": "object", "required": [ "as_of", "movers" ], "properties": { "as_of": { "type": "string", "description": "Latest Yahoo quote time for the list, ISO 8601 with a time-zone offset." }, "movers": { "type": "array", "items": { "type": "object", "required": [ "company_name", "ticker", "price", "currency", "change", "percent_change", "volume", "average_volume_3_months", "market_cap", "market_cap_display", "price_to_earnings_ratio", "quote_link" ], "properties": { "price": { "type": [ "number", "null" ] }, "change": { "type": [ "number", "null" ] }, "ticker": { "type": "string" }, "volume": { "type": [ "integer", "null" ] }, "currency": { "type": [ "string", "null" ] }, "market_cap": { "type": [ "number", "null" ] }, "quote_link": { "type": "string" }, "company_name": { "type": [ "string", "null" ] }, "percent_change": { "type": [ "number", "null" ] }, "market_cap_display": { "type": [ "string", "null" ] }, "average_volume_3_months": { "type": [ "integer", "null" ] }, "price_to_earnings_ratio": { "type": [ "number", "null" ] } }, "additionalProperties": false }, "description": "Market tickers in Yahoo Finance order." } }, "additionalProperties": false } ``` ## See more - [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company. - [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them. - [Yahoo API: Get analyst ratings](https://fous.com/methods/finance.yahoo.com/get-analyst-ratings.md): Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance. - [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section. - [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games. - [All Yahoo methods](https://fous.com/methods/yahoo.com.md)