yfinance
获取 Yahoo Finance 行情和金融信息的 Python 工具，适合从一份价格表开始研究。
为什么值得学
代码入口直观，可以练习时间索引、多标的拼接、复权口径与网络请求处理。
需要的基础
- Python 函数
- pandas 时间序列
涉及哪些内容
数据与控制流程
- 1证券与日期
- 2网络请求
- 3历史价格解析
- 4复权和时区处理
- 5单标的或批量 DataFrame
此流程为教学归纳，便于建立整体认识；完整条件分支与运行细节请对照下方源码。
架构拆解 · 4 个核心模块
每个入口均已核对，点击可阅读源码单标的入口
Ticker 把单个证券的信息和相关查询组织为统一对象。
- 输入
- 证券代码与查询参数
- 输出
- 单标的数据访问接口
yfinance/ticker.py批量下载
download 协调多个标的下载，并对齐时间和列结构。
- 输入
- 证券列表与日期范围
- 输出
- 多标的行情表
yfinance/multi.py历史价格处理
PriceHistory 解析历史行情并处理复权、事件及价格修复等逻辑。
- 输入
- 价格响应与调整选项
- 输出
- 时间索引行情与公司行动
yfinance/scrapers/history.py请求共享层
YfData 管理底层请求、认证相关状态及缓存等网络细节。
- 输入
- 请求 URL 与参数
- 输出
- 响应数据或请求错误
yfinance/data.py建议阅读顺序
- 先对照 Ticker 与 download 的返回结构
- 深入 PriceHistory 比较复权选项
- 再读 multi 的日期对齐
- 最后看 YfData 的缓存与错误处理
动手做一次
导出三只证券的日线与收益率，并建立下载参数记录。
完成后，检查这些证据
- 明确 auto_adjust 与收益率口径
- 检查重复日期、缺失值与时区
- 保存原始价格、处理结果和抓取日期
适用边界与版本说明
这是第三方研究工具，不是 Yahoo 官方 SDK；数据可用性、使用条款及复权默认值应按当前文档核对。
Star 快照：25,568 · 核验日期：2026-10-20 · GitHub 归档标记：未归档
核验默认分支：main · 源码固定提交：2081dca0b224 ↗
来源：GitHub 仓库与 Star 页面、README及上述源文件。分层、阅读顺序与练习为本站归纳；未逐一安装运行这些框架，源码提交不等于推荐安装版本。