Use for "what's the price of X" or a quick single-stock snapshot. For several stocks side by side use compare_stocks; for the full company profile use get_company_info; for a past price series use get_historical_prices.

Returns Markdown by default, or structured JSON when response_format='json'. An unknown ticker or an upstream/rate-limit error returns a short error message rather than raising.

Use for performance, trends, or charting ("how has X done over the last year"). For a single current price use get_stock_quote; for dividend/split events use get_dividends_splits. Note: intraday intervals (1m-90m) are only available for short recent periods, and long periods return many rows, so prefer JSON or a shorter period if the output is truncated.

Returns Markdown (summary stats plus the last 10 rows) by default, or the full series as JSON when response_format='json'. An empty or unsupported period/interval combination returns a short message.

Use for "what does X do", company background, or a business overview. For the statement-level numbers (income/balance/cash flow) use get_financial_statements; for just the live price use get_stock_quote.

Returns Markdown by default, or JSON when response_format='json'. An unknown ticker or upstream error returns a short error message.

Use for revenue, earnings, assets/liabilities, cash flow, or fundamental analysis. For headline ratios only use get_company_info; for forward projections use get_analyst_estimates. Quarterly data is not returned; request JSON for the complete machine-readable export.

Returns Markdown by default, or JSON when response_format='json'. Companies without filed statements (for example some ETFs or ADRs) return empty sections or a short message.

Use for "which is better, X or Y", peer/relative comparison, or screening a small set. For a deep dive on a single name use get_stock_quote or get_company_info.

Pass 2-10 tickers in the tickers list. Returns a Markdown comparison table by default, or JSON when response_format='json'. A ticker that fails to resolve is reported per-symbol rather than failing the whole call.

Use for "what do analysts think of X", ratings, or sentiment. For forward EPS/revenue/growth projections use get_analyst_estimates instead: this tool is ratings and targets, that one is the numeric estimates. Not for news-driven sentiment (use get_market_news). Small caps often have few or no covering analysts, so a thin consensus carries little weight.

Returns Markdown by default, or JSON when response_format='json'. A stock with no analyst coverage returns the available fields as N/A; errors return a short message.

Use for "what's the latest news on X", recent headlines, or catalysts. Returns news only: for price use get_stock_quote, for fundamentals use the financials tools.

count sets how many articles to return (1-20, default 10). Returns Markdown by default, or JSON when response_format='json'. No recent news returns a short message.

Use for options pricing, implied volatility, or open-interest analysis. option_type selects 'calls', 'puts', or 'both'. Always discover the valid dates first (call with no date) before requesting a chain, since only listed expirations work.

Returns Markdown by default, or JSON when response_format='json'. A ticker with no listed options returns a short message.

Use for "who owns X", institutional ownership, or insider trading activity. One holder_type per call: call again to get a different view. Not for share count, float or valuation (use get_company_info) or for analyst opinion (use get_analyst_recommendations). Institutional and fund holdings come from quarterly filings, so they can be a few months old; insider trades are filed within days and are the fresher signal.

Returns Markdown by default, or JSON when response_format='json'. Missing data for the chosen category returns a short message.

Use for dividend-income analysis, payment dates and amounts, dividend growth, or past split events. For the current/forward dividend yield use get_stock_quote; for price history use get_historical_prices.

Returns Markdown by default, or JSON when response_format='json'. A stock that pays no dividend or has never split returns a short message noting that none exist.

Use for projected/expected numbers and forecasts. This complements get_analyst_recommendations: that tool returns ratings and the recommendation trend, this one returns the numeric forward estimates.

Returns Markdown by default, or JSON when response_format='json'. A stock without analyst coverage returns the available fields as N/A or a short message.

Use this first when you have a company or brand name but not its ticker, then pass the resolved symbol to the other tools. Skip it when you already have a valid ticker. Not for fetching prices or fundamentals. A name often matches several listings (the US share, foreign listings, ETFs): choose by exchange and type, not just the first row.

query is the name/keyword to search; count caps the number of matches (1-20, default 8). Returns Markdown by default, or JSON when response_format='json'. No matches returns a short message.

Use for "is the US market open", market hours, or a quick index overview. region is one of US (default), GB, ASIA or EUROPE for equity markets, or RATES, COMMODITIES, CURRENCIES or CRYPTOCURRENCIES for those asset classes; other country codes are not accepted. This is market-wide, not per-stock: use get_stock_quote for an individual price, and get_sector_overview for sector performance.

Returns Markdown by default, or JSON when response_format='json'. An unrecognized region returns a short message.

Use before opening or holding a position through earnings, to check the earnings track record (beats vs misses), or for "when does X report". For forward EPS/revenue estimates by period use get_analyst_estimates; for every company reporting in a date range use get_earnings_calendar; for full income statements use get_financial_statements. limit counts upcoming and past dates together, newest first.

Returns Markdown by default, or JSON when response_format='json'. A symbol with no earnings (an ETF, an index) returns a short message.

Use for "who reports this week", building a catalyst watchlist, or checking which holdings report soon. Not for one stock's history: use get_earnings for that. Results are sorted by market cap, largest first.

Returns Markdown by default, or JSON when response_format='json'. An empty range returns a short message.

Use to discover candidates you don't have yet: today's movers, unusual volume, heavily shorted names, undervalued growth or large caps, or top ETFs and funds. Not for a symbol you already know (use get_stock_quote) and not for custom filters: only Yahoo's predefined screeners exist, so pick the closest one. Results are live and reorder through the trading day, so two calls minutes apart can differ. count takes the top N in the screener's own ranking; there is no paging. Follow up on a symbol with get_stock_quote, get_company_info or get_earnings.

Returns Markdown by default, or JSON when response_format='json'.

Use for "what's in SPY", fund overlap and concentration checks, or comparing fund costs. Not for individual stocks: use get_company_info for those.

Returns Markdown by default, or JSON when response_format='json'. A symbol that is not a fund returns a short message.

Use for sector rotation, "biggest semiconductor companies", finding peers for a stock, or exploring an industry before picking names. Call without industry first, then pass one of the returned industry keys.

Returns Markdown by default, or JSON when response_format='json'. An unknown industry key returns a short message listing the valid ones.