Get a fast, lightweight current-price snapshot for a symbol.

Returns last price, previous close, open, day high/low, volume, market cap, shares, currency, exchange and 52-week range via yfinance fast_info. Use this for quick price checks; use get_ticker_info for the full profile.

Get the full company/security profile dictionary for a symbol.

This is yfinance .info: a large dict with business summary, sector, industry, valuation ratios (PE, PEG, price-to-book), margins, dividend yield, beta, analyst target prices, address, employee count, and dozens of other fields. Best single source for fundamentals + descriptive data.

Get the ISIN (International Securities Identification Number) for a symbol.

Get historical OHLCV price data for a symbol.

Provide either period (e.g. "1y") OR an explicit start/end date range ("YYYY-MM-DD"); if start/end are given they take precedence over period. interval controls granularity — intraday intervals (1m..1h) are only available for recent ranges (Yahoo limits ~7-60 days). Returns a dict keyed by ISO timestamp with Open/High/Low/Close/Volume (and Dividends/Splits when actions is true). history_metadata includes timezone & instrument info.

Download historical prices for MULTIPLE symbols at once.

Efficient batch alternative to calling get_historical_prices repeatedly. Returns a per-symbol dict of date-indexed OHLCV data.

Get dividends, stock splits and capital gains history for a symbol.

Returns three date-keyed series: dividends (per-share amounts), splits (split ratios) and capital_gains (mainly for funds).

Get financial statements (income statement, balance sheet, cash flow).

statement selects one statement or "all" (default). freq toggles annual vs quarterly. Values are keyed by line item, with periods as columns. Data goes back several years/quarters depending on Yahoo coverage.

Get earnings calendar, upcoming/historical earnings dates and estimates.

Returns the calendar (next earnings & dividend dates), earnings_dates (reported vs estimated EPS per period with surprise %), and the various forward estimate tables (EPS estimate, revenue estimate, EPS trend & growth).

Get analyst recommendations, price targets and upgrade/downgrade history.

Returns recommendations and recommendations_summary (buy/hold/sell counts over recent months), analyst_price_targets (current/high/low/mean target), and upgrades_downgrades (firm-by-firm rating changes).

Get ownership breakdown: major, institutional, mutual fund and insiders.

Returns major_holders (% insider/institutional), institutional_holders and mutualfund_holders (top holders with shares & value), plus insider data: insider_purchases, insider_transactions, insider_roster_holders.

Get historical shares outstanding over time (optionally a date range).

Get ESG / sustainability scores (environment, social, governance risk).

List the available option expiration dates for a symbol.

Pass one of these dates to get_option_chain to get the calls/puts table.

Get the option chain (calls and puts) for a symbol and expiration date.

expiration is a "YYYY-MM-DD" date from get_option_expirations; if omitted the nearest expiry is used. Each contract includes strike, bid/ask, last price, volume, open interest, implied volatility and in-the-money flag.

Get recent news articles related to a symbol (title, publisher, link, time).

Get recent SEC filings (10-K, 10-Q, 8-K, etc.) with dates and document links.

Get ETF / mutual fund specifics: description, holdings, sector & asset allocation, top holdings, bond ratings and fund operations.

Only meaningful for funds/ETFs (e.g. SPY, VTI, QQQ). For ordinary stocks this returns little or an error.

Search Yahoo Finance for symbols and related news by free-text query.

Use this to resolve a company name (e.g. "Apple") to a ticker symbol, or to find related instruments and news. Returns matching quotes (symbol, name, exchange, type) and recent news.

Look up instruments matching a query, optionally filtered by asset type.

More precise than search for enumerating instruments of a given type (e.g. all ETFs matching "gold"). Returns matching symbols with metadata.

Get sector overview data by sector key (e.g. "technology", "healthcare", "financial-services", "energy", "consumer-cyclical").

Returns the sector's overview, top companies, top ETFs/mutual funds, research reports and industry breakdown.

Get industry overview data by industry key (e.g. "semiconductors", "software-infrastructure", "biotechnology", "banks-diversified").

Returns the industry overview, top performing/growth companies and top ETFs.

Get market status and summary for a region (e.g. "US", "GB", "ASIA", "EUROPE"). Returns whether the market is open and a summary of major indices.

Run a predefined Yahoo Finance stock/fund screen.

Handy preset screens like "day_gainers", "most_actives", "day_losers", "undervalued_growth_stocks", etc. Returns the matching quotes with key fields. For custom criteria use screen_custom.

Run a custom equity screen with a single numeric criterion + region.

Example: field="intradaymarketcap", operator="gt", values=[1e9] finds companies with market cap over $1B. Common fields: intradaymarketcap, intradayprice, dayvolume, trailingpe, pegratio, epsgrowth, dividendyield, percentchange. operator "btwn" expects two values [low, high]. Results are filtered to region (e.g. "us"). Sorted by sort_field if given.