yfinance 是 Python 生态中使用最广泛的金融数据获取库之一，提供对 Yahoo Finance 公开 API 的 Pythonic 封装。它可以获取全球股票、ETF、指数、期权、加密货币的历史行情（日/周/月/分钟级）、实时报价、财务报表（资产负债表/利润表/现金流量表）、公司基本面、分析师评级、持仓变动、股息和拆股信息等。GitHub 超过 22000 星，PyPI 月下载量超百万。

yfinance 的核心设计是 Ticker 对象：通过 yf.Ticker('AAPL') 创建后，可以链式调用 .history()、.financials、.balance_sheet、.cashflow、.recommendations、.options 等属性获取不同维度的数据。yf.download() 函数支持批量获取多支股票的历史行情，并返回标准 pandas DataFrame，方便与 QuantStats、backtrader 等工具链无缝衔接。

在银行和金融机构场景中，yfinance 适合作为学习项目和原型验证的数据源。例如：投研团队想快速验证一个“基于财务指标的选股策略“原型，可以用 yfinance 获取 S&P 500 成份股的历史行情和财报数据；风控团队可以用它拉取主要指数的波动率做宏观风险监控原型。

需要特别注意：yfinance 依赖 Yahoo Finance 的非官方 API，不保证 SLA，不适合生产环境实时交易系统或对数据稳定性要求极高的场景。Yahoo 的 Terms of Use 明确限制商业用途。数据质量方面，部分小众市场或非美股数据的覆盖度和准确性可能不如专业数据提供商（Bloomberg、Refinitiv、Wind）。

主要局限在于：非官方 API 可能随时变更导致失效；数据延迟通常在 15-30 分钟（非实时）；对港股/A股等非英语市场数据的覆盖度有限；不适合作为银行生产系统的唯一数据源；免费版不支持高频请求。

• 一行代码获取全球股票行情/财报/基本面
• 支持 Ticker 对象链式调用，API 直观
• 返回标准 pandas DataFrame，生态兼容性强
• 支持批量下载、期权链、分析师评级等

• 理解金融市场数据结构（OHLCV、财报三表、期权链）
• 学习将外部数据源 Python 封装应用到银行投研原型

• 投研策略原型验证的数据源
• 量化选股/择时研究的基础数据
• 宏观风险监控原型的市场数据输入
• 金融 AI 模型训练数据获取

非官方 API，无 SLA 保障，可能随时失效；Yahoo Terms 限制商业使用；数据延迟 15-30 分钟；非美股覆盖度有限；不适合银行生产环境。

• 项目地址：https://github.com/ranaroussi/yfinance ↗
• 开源协议：Apache-2.0