用途：通过 yfinance Python 库从 Yahoo Finance 获取金融与市场数据，适用于股票报价、历史行情、财务报表、公司行动、期权、分析师与持仓等研究场景。yfinance 与 Yahoo 无隶属关系，数据仅供研究与教育用途。
主要能力：当前价格可用 ticker.info 或 ticker.fast_info；历史 OHLCV 用 ticker.history() 或 yf.download()；财务报表含 ticker.balance_sheet、ticker.income_stmt、ticker.cashflow，季度数据加 quarterly_ 前缀；公司行动含 ticker.dividends、ticker.splits；期权用 ticker.option_chain()；分析类含 ticker.earnings_history、ticker.analyst_price_targets、ticker.recommendations、ticker.upgrades_downgrades；持仓类含 ticker.institutional_holders、ticker.insider_transactions；另有 ticker.news、yf.Sector / yf.Industry、yf.screen() 与 yf.EquityQuery 筛选。
使用方式：先确认环境是否已安装 yfinance，未安装时执行 pip install -q yfinance。基本模式为 import yfinance as yf 后创建 yf.Ticker("AAPL") 并调用对应方法；多股比较用 yf.download()。期权需先用 ticker.options 列出到期日再调用 option_chain(date)。有效 period 含 1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max；interval 含 1m、2m、5m、15m、30m、60m、90m、1h、1d、5d、1wk、1mo、3mo。
限制：Yahoo Finance 可能限流或返回空数据，代码应包 try/except；1m 数据仅回溯约 7 天，1h 约 730 天；返回的时间索引带时区，比较日期需用 pd.Timestamp(..., tz=...) 或 .tz_localize(None)。完整方法签名与边界处理见 references/api_reference.md。