# Yahoo API: Get quote > 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. Unofficial. Not affiliated with or endorsed by Yahoo. - Page: https://fous.com/methods/finance.yahoo.com/get-quote - Method: `finance.yahoo.com/get_quote`, version 1 - Website: finance.yahoo.com - Returns: name, ticker, exchange, latest price, change, day and 52-week ranges, volume, market cap, P/E, dividend, next earnings date, market state - 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 3, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `asset` | string | yes | `"MSFT"` | Asset name or Yahoo Finance ticker, for example Microsoft, MSFT, S&P 500, or Bitcoin. | ## Output From a run on Oct 23, 2026. Its input: ```json { "asset": "MSFT" } ``` Its output: ```json { "link": "https://finance.yahoo.com/quote/MSFT/", "name": "Microsoft Corporation", "open": 532.7, "as_of": "2026-10-23T04:03:29-04:00", "change": -3.4850464, "ticker": "MSFT", "volume": 21246740, "currency": "USD", "dividend": 3.92, "exchange": "NasdaqGS", "pe_ratio": 29.69117, "day_range": "520.30 - 533.60", "market_cap": 3869303373824, "latest_price": 517.595, "market_state": "pre-market", "average_volume": 26209732, "dividend_yield": 0.75, "percent_change": -0.6688121699999999, "previous_close": 532.95, "earnings_per_share": 17.55, "market_cap_display": "3.869T", "next_earnings_date": "2026-10-28", "fifty_two_week_range": "349.20 - 553.72" } ``` ## 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/get_quote","input":{"asset":"MSFT"}}' ``` 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's the current price and P/E ratio for Tesla stock? - Pull up the latest quote for BTC-USD, including its 52-week range. - Can you check how the S&P 500 index is doing today and what its day range is? - I need the market cap and next earnings date for NVDA on Yahoo. - Look up the Vanguard S&P 500 ETF (VOO) and tell me its dividend and trading volume. ## Input schema ```json { "type": "object", "required": [ "asset" ], "properties": { "asset": { "type": "string", "description": "Asset name or Yahoo Finance ticker, for example Microsoft, MSFT, S&P 500, or Bitcoin." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "ticker", "exchange", "currency", "latest_price", "change", "percent_change", "previous_close", "open", "day_range", "fifty_two_week_range", "volume", "average_volume", "market_cap", "market_cap_display", "pe_ratio", "earnings_per_share", "dividend", "dividend_yield", "next_earnings_date", "market_state", "as_of", "link" ], "properties": { "link": { "type": [ "string", "null" ], "format": "uri", "description": "Yahoo Finance quote page" }, "name": { "type": [ "string", "null" ], "description": "Asset name on Yahoo Finance" }, "open": { "type": [ "number", "null" ], "description": "Regular-session open price" }, "as_of": { "type": [ "string", "null" ], "format": "date-time", "description": "Timestamp of the latest displayed price with UTC offset" }, "change": { "type": [ "number", "null" ], "description": "Price change in the displayed trading session" }, "ticker": { "type": [ "string", "null" ], "description": "Yahoo Finance ticker" }, "volume": { "type": [ "number", "null" ], "description": "Regular-session volume" }, "currency": { "type": [ "string", "null" ], "description": "Quote currency code" }, "dividend": { "type": [ "number", "null" ], "description": "Forward annual dividend per unit" }, "exchange": { "type": [ "string", "null" ], "description": "Full exchange name or quote venue" }, "pe_ratio": { "type": [ "number", "null" ], "description": "Trailing price-to-earnings ratio" }, "day_range": { "type": [ "string", "null" ], "description": "Regular-session low and high as displayed" }, "market_cap": { "type": [ "number", "null" ], "description": "Market capitalization" }, "latest_price": { "type": [ "number", "null" ], "description": "Most recent displayed trading price" }, "market_state": { "type": [ "string", "null" ], "description": "Market status: open, closed, pre-market, or after-hours" }, "average_volume": { "type": [ "number", "null" ], "description": "Average daily volume" }, "dividend_yield": { "type": [ "number", "null" ], "description": "Forward annual dividend yield in percent units" }, "percent_change": { "type": [ "number", "null" ], "description": "Percent change in the displayed trading session, in percent units" }, "previous_close": { "type": [ "number", "null" ], "description": "Previous regular closing price" }, "earnings_per_share": { "type": [ "number", "null" ], "description": "Trailing twelve-month earnings per share" }, "market_cap_display": { "type": [ "string", "null" ], "description": "Market capitalization as displayed, for example 3.1T" }, "next_earnings_date": { "type": [ "string", "null" ], "format": "date", "description": "Next earnings date in YYYY-MM-DD format" }, "fifty_two_week_range": { "type": [ "string", "null" ], "description": "52-week low and high as displayed" } } } ``` ## See more - [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 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: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): 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. - [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: Get player stats](https://fous.com/methods/sports.yahoo.com/get-player-stats.md): Looks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values. - [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: 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 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)