| yfinance_get_ticker_infoA | Retrieve comprehensive stock data including company information, financials, trading metrics and governance. Returns JSON object with fields including:
- Company: symbol, longName, sector, industry, longBusinessSummary, website, city, country
- Price: currentPrice, previousClose, open, dayHigh, dayLow, fiftyTwoWeekHigh, fiftyTwoWeekLow
- Valuation: marketCap, enterpriseValue, trailingPE, forwardPE, priceToBook, pegRatio
- Trading: volume, averageVolume, averageVolume10days, bid, ask, bidSize, askSize
- Dividends: dividendRate, dividendYield, exDividendDate, payoutRatio
- Financials: totalRevenue, revenueGrowth, earningsGrowth, profitMargins, operatingMargins
- Performance: beta, fiftyDayAverage, twoHundredDayAverage, trailingEps, forwardEps
Note: Available fields vary by security type. Timestamps are converted to readable dates.
|
| yfinance_get_ticker_newsA | Fetch recent news articles and press releases for a specific stock. Returns JSON array where each news item has:
- id: Unique article identifier
- content: Object containing:
- title: Article headline
- summary: Brief article summary
- pubDate: Publication date (ISO 8601 format)
- provider: Object with displayName (e.g., "Yahoo Finance") and url
- canonicalUrl: Object with article url, site, region, lang
- thumbnail: Object with image URLs and resolutions
- contentType: Type of content (e.g., "STORY", "VIDEO")
Use this to track company announcements, market sentiment, and breaking news.
|
| yfinance_searchA | Search Yahoo Finance for stocks, ETFs, and news articles. Returns JSON with search results based on search_type:
- 'quotes': Array of securities with:
- symbol: Ticker symbol
- shortname/longname: Company name
- quoteType: Security type (EQUITY, ETF, MUTUALFUND, etc.)
- exchange: Exchange code
- sector: Business sector
- industry: Industry classification
- score: Search relevance score
- 'news': Array of articles with:
- uuid: Article identifier
- title: Headline
- publisher: News source
- link: Article URL
- providerPublishTime: Unix timestamp
- relatedTickers: Array of related symbols
- thumbnail: Image URLs
- 'all': Object with both 'quotes' and 'news' arrays
Use this to find ticker symbols, discover related securities, or search financial news.
|
| yfinance_get_topA | Get top-ranked financial entities within a sector. This unified tool provides access to various rankings:
- ETFs and mutual funds focused on the sector
- Largest companies by market capitalization
- Fastest-growing companies by revenue/earnings
- Best-performing stocks by price appreciation
Returns JSON data with relevant metrics for each entity type.
|
| yfinance_get_price_historyA | Fetch historical price data and optionally generate technical analysis charts. When chart_type is None, returns Markdown table with columns:
- Date: Trading date (index)
- Open: Opening price
- High: Highest price
- Low: Lowest price
- Close: Closing price
- Volume: Trading volume
- Dividends: Dividend payments (if any)
- Stock Splits: Split events (if any)
When chart_type is specified, returns a chart image:
- 'price_volume': Candlestick chart with volume bars
- 'vwap': Price with Volume Weighted Average Price overlay
- 'volume_profile': Volume distribution by price level
Set prepost=True to include pre-market and post-market data when available.
Note: Not all period/interval combinations are valid. Minute intervals (1m, 5m, etc.)
only work with short periods (1d, 5d).
|
| yfinance_get_financialsA | Fetch financial statements (income statement, balance sheet, and cash flow) with historical data. Returns JSON with income statement, balance sheet, and cash flow data across reporting periods. Use the data to analyze trends, calculate ratios, or compare periods. |
| yfinance_get_option_chainA | Fetch option chain data (calls and puts) for a stock with available strike prices. Returns JSON with calls and/or puts data for each expiration date.
JSON fields include:
- contractSymbol: Option contract identifier
- strike: Strike price
- lastPrice: Last traded price
- bid/ask: Bid and ask prices
- volume: Trading volume
- openInterest: Open interest
- impliedVolatility: Implied volatility (IV)
- inTheMoney: Whether option is ITM
- contractSize: Contract size (REGULAR)
- currency: Currency (USD)
Use this to analyze options pricing, IV surfaces, and strike levels.
|
| yfinance_get_option_datesA | Fetch available option expiration dates for a stock. Returns JSON array of expiration dates in YYYY-MM-DD format.
Use these dates with the 'yfinance_get_option_chain' tool to fetch
the options chain for a specific date.
|
| yfinance_get_holdersA | Fetch major holders, institutional holders, mutual fund holders, and insider data. Returns JSON with:
- major_holders: Aggregated breakdown including insider % held, institutional % held,
institutional % float held, and institution count.
- institutional_holders: List of institutional investors with shares held, date reported,
value, and % change.
- mutualfund_holders: List of mutual fund holders with same fields.
- insider_transactions: Recent insider transactions including shares, value, transaction
type, and date.
- insider_purchases: Summary of insider buy/sell activity over the last 6 months.
- insider_roster: List of known insiders by name and position.
Use this to analyze ownership concentration, insider activity, and institutional interest.
|
