global-stock-data

> 📦 项目主页：https://github.com/simonlin1212/global-stock-data — 更新、反馈、支持作者 > > 作者：Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱：simonlin0423@gmail.com # 美股港股全栈数据工具包 V2.2 — 官方源优先 十六层数据架构，50+ 个端点，17 个数据源，全部零鉴权，实测可用（2026-07-24 全量回归验证；V2.1 新增与修复部分 2026-10-11 实测；V2.2 新增部分 2026-10-12 实测）。层数按「原有八层 + V2.0 五层（CBOE 期权链单算一层）+ V2.1 一层 + V2.2 两层（台股、能源）」计；V2.2 的波动率指数、做空余额、Form 4 / 13F 解析是原有层里的新小节，不另计层。 **V2.0 设计原则：官方源优先。** 新增层的主力数据取自美国政府（SEC EDGAR / Treasury / CFTC）、 自律组织（FINRA）与交易所（CBOE / Nasdaq）的公开端点；V2.1 再加国际清算银行、欧洲央行、 美联储、纽约联储四家官方机构；V2.2 再加台湾证交所、柜买中心与美国能源信息署 EIA。**每个数据源都标注了合规级别与条款原文** （见下方「数据源合规分级」）——"官方"不等于"可自由使用"，各源差异极大。 **本工具只分发代码，不分发、不转售任何市场数据**；数据由使用者自行按各源条款获取。 **使用方式：** 将本文件放入 `~/.claude/skills/global-stock-data/SKILL.md`，Claude Code 会自动识别并在美股/港股相关对话中激活。 ``` 行情层（实时/延时） ├── 新浪财经 → 美股 gb_XXXX 36字段 / 港股 rt_hkXXXXX 25字段 ├── 腾讯财经 → 美股 usXXXX 71字段 / 港股 r_hkXXXXX 78字段 └── 东财 push2 → 美股/港股 secid 实时行情，含中文名/涨跌幅/换手率 K线层（日/周/月/分钟） ├── 新浪 → 美股日K (回溯至1984年) └── Yahoo chart → 美股+港股+日本/台湾/韩国/印度/欧洲等 (v8 API, 零crumb, 全历史日线) [D级] 技术指标层（纯计算，零额外依赖） └── MA/EMA + MACD + RSI + KDJ + 布林带 基于K线OHLCV，纯Python计算 基本面层 ├── 东财 datacenter → 美股/港股三表(资产负债+利润+现金流) + GMAININDICATOR(关键指标) ├── Yahoo crumb → 23个模块(财务数据+关键指标+分析师+机构持仓) └── SEC EDGAR XBRL → 美股503个GAAP指标 (仅美股) 资金面层 └── 东财 push2his → 日级资金流(主力/大单/中单/小单) 美股+港股 期权层（仅美股） └── Yahoo crumb → 期权链(calls+puts, 所有到期日) 仅美股(港股期权不在Yahoo覆盖范围) SEC Filing层（仅美股） ├── EDGAR submissions → 10-K/10-Q/8-K 完整Filing列表 └── EDGAR XBRL → 结构化财务指标(营收/净利/EPS等) 工具层 ├── 东财 search → 股票搜索(中英文, 含市场代码映射) ├── 东财 push2 → 全市场股票列表(涨跌幅/成交量排名, 美股5925只+港股18000+只) ├── Yahoo search → 新闻资讯(按股票代码) └── SEC CIK mapping → ticker↔CIK 映射 (仅美股) ━━━ 以下为 V2.0 新增（官方源优先）━━━ 期权层·CBOE 官方（仅美股）⭐ └── CBOE cdn → 全链 + IV + delta/gamma/vega/theta/rho + 0DTE + 异动flow [C级·需授权] 做空层（仅美股）⭐ └── FINRA Reg SHO → 全市场每日空头成交量(实测12,112只) + 个股时序 + 排行 [B级] 申报事件流（仅美股）⭐ ├── EDGAR 每日索引 → Form4内部人/8-K/13F机构持仓/144，当日全量 [S级] └── EDGAR 全文检索 → 2001至今所有申报正文，按关键词+表单+日期 [S级] 全市场横截面（仅美股）⭐ └── EDGAR frames → 任意XBRL标签一次拿全市场(实测1,842~5,309家)=免费screener [S级] 宏观 / 日历 ⭐ ├── Treasury → 美债收益率曲线(1M~30Y, 每日) [S级] ├── CFTC → COT 持仓报告 [S级] └── Nasdaq → 财报日历(含盘前盘后+EPS预期) [D级] ━━━ 以下为 V2.1 新增 ━━━ 全球利率 / 汇率 / 央行 ⭐ ├── BIS → 38家央行政策利率(一次取全) [S级] ├── ECB → 欧元参考汇率 + ECB三大利率 + 欧元区收益率曲线 [S级] ├── 纽约联储 → SOFR / EFFR / OBFR / TGCR / BGCR [S级·须附声明] ├── 美联储 → H.10 美元对23种货币 + H.6 M1/M2 [S级] └── 财政部 → 国债拍卖结果与日程 + 联邦债务 + 国债平均利率 [S级] ━━━ 以下为 V2.2 新增 ━━━ 波动率（仅美股）⭐ └── CBOE 指数文件 → VIX 1990起日线 + VIX9D/3M/6M/1Y 期限结构 + VVIX/SKEW/OVX/GVZ [C级·需授权] 做空余额（仅美股）⭐ └── FINRA 每月两期 → 全美未平仓空头(实测22,595只) + 回补天数 + 排行 [B级] 内部人交易 / 机构持仓（仅美股）⭐ ├── SEC Form 4 → 逐笔买卖(价格/股数/交易后持股/申报是否勾10b5-1) + 买卖汇总 [S级] └── SEC 13F → 机构季度持仓明细(按市值排序 + 占比) [S级] 台股 ⭐ └── 证交所 + 柜买中心 OpenAPI → 全市场最新行情/本益比/月营收/融资融券/除权息 [S级·注明来源] 能源 ⭐ └── EIA → 原油/天然气每周库存 [S级] + WTI(1986起)/布伦特/Henry Hub 现货日价 [B级·转载 Refinitiv] ``` --- ## 端点路由速查（按需定位，不必通读全文） | 我想要… | 去哪层 | 主力源 | 合规级 | |---|---|---|---| | 实时/延时报价 | Layer 1 | 新浪 / 腾讯 / 东财 | C | | K 线（日/周/月；日本/台湾/韩国/印度/欧洲等换代码后缀） | Layer 2 | 新浪 / Yahoo | C·D | | 技术指标 MA/MACD/RSI/KDJ/布林 | Layer 3 | 本地计算 | — | | 财报三表 / 关键指标 / 分析师 / 机构持仓 | Layer 4 | 东财 / Yahoo / EDGAR | C·D·S | | 日级资金流 | Layer 5 | 东财 | C | | **期权链 + 希腊字母 + IV + 0DTE + 异动flow** | **Layer 6.1** | **CBOE 官方** ⭐ | C | | 期权链（无希腊字母，后备） | Layer 6.2 | Yahoo | D | | 10-K/10-Q/8-K 列表、XBRL 财务 | Layer 7 | SEC EDGAR | **S** | | 搜索 / 新闻 / CIK 映射 / 全市场列表 | Layer 8 | 东财 / Yahoo / SEC | C·D·S | | **全市场每日空头成交量、个股空头占比** | **Layer 9.1** | **FINRA Reg SHO** ⭐ | B | | **当日申报流：Form 4 内部人 / 8-K / 13F** | **Layer 10.1** | **EDGAR 每日索引** ⭐ | **S** | | **申报全文检索（2001 至今正文）** | **Layer 10.2** | **EDGAR FTS** ⭐ | **S** | | **全市场基本面横截面（免费 screener）** | **Layer 11** | **EDGAR frames** ⭐ | **S** | | 美债收益率曲线 / CFTC COT / 财报日历 | Layer 12 | Treasury / CFTC / Nasdaq | S·D | | **全球央行政策利率** | **Layer 13.1** | **BIS** ⭐ | **S** | | **欧元汇率 / ECB 利率 / 欧元区收益率曲线** | **Layer 13.2** | **欧洲央行** ⭐ | **S** | | **SOFR / EFFR 等美元参考利率** | **Layer 13.3** | **纽约联储** ⭐ | **S** | | **美元对 23 种货币汇率 / M1·M2** | **Layer 13.4** | **美联储** ⭐ | **S** | | **国债拍卖结果与日程 / 联邦债务** | **Layer 13.5** | **财政部 FiscalData** ⭐ | **S** | | **VIX 历史 / 期限结构 / VVIX / SKEW** | **Layer 6.3** | **CBOE 官方** ⭐ | C | | **做空余额（未平仓空头）/ 回补天数** | **Layer 9.2** | **FINRA** ⭐ | B | | **内部人逐笔买卖（Form 4）** | **Layer 10.3** | **SEC EDGAR** ⭐ | **S** | | **机构 13F 持仓明细** | **Layer 10.4** | **SEC EDGAR** ⭐ | **S** | | **台股最新行情 / 本益比 / 月营收 / 融资融券** | **Layer 14** | **证交所 / 柜买中心** ⭐ | **S** | | **原油 / 天然气每周库存** | **Layer 15** | **EIA** ⭐ | **S** | | **原油 / 天然气现货日价** | **Layer 15** | **EIA（转载 Refinitiv）** ⭐ | B | ⭐ = V2.0 / V2.1 / V2.2 新增，且为 yfinance 与多数开源方案不具备的能力。 --- ## 数据源合规分级（取用前必读 — 各级均引条款原文） > 下表结论来自 **逐家实读各源条款原文**（2026-07-24；V2.1 于 2026-10-11 复核 Yahoo / Nasdaq， > 并新读 BIS / ECB / 美联储理事会 / 纽约联储 4 家新增官方源；V2.2 于 2026-10-12 新读台湾证交所 / 柜买中心 > 使用条款、台湾《政府资料开放授权条款》与 EIA），除标明「本工具的判断」处外都不是推断。引号内为原文。 > **各源差异极大，"官方"不等于"可自由使用"。** ### S 级 — 可自由使用（含商用与再分发；部分要求注明来源） | 源 | 依据（原文） | |---|---| | **SEC EDGAR** | 官网明示：*"Anyone can access and download this information **for free**"*、*"We **allow scripted access** to sec.gov content"*。**硬性要求**：`Current max request rate: 10 requests/second`，且必须声明 User-Agent（格式 `Company Name AdminContact@domain.com`），否则触发 *"Undeclared Automated Tool"* / Access Denied | | **US Treasury / CFTC** | 美国联邦政府作品不受版权保护（17 U.S.C. §105）。FiscalData 接口文档：*"Our API is **open**, meaning that it does not require a user account or registration for a token."* ⚠️ 收益率曲线页与 CFTC 的条款正文**未逐条核验**，按政府数据惯例归此级 | | **美联储理事会** | *"Unless otherwise indicated, information on Board's website is in the **public domain** and may be copied and distributed without permission. Please **cite to the Board** as the source of the information."* | | **纽约联储** | *"The New York Fed grants you a non-exclusive license… to use, copy, and distribute Content for your **personal or business purposes**. You may: Access the Content, manually or **through an automated process** or device…"* ⚠️ 对外展示或分发参考利率（SOFR / EFFR 等）时**必须附上**这段声明（方括号为原文所有，按原文脚注由使用者填写）：*"The [NAME OF DATA or CONTENT] is subject to the Terms of Use posted at newyorkfed.org. The New York Fed is not responsible for publication of the [DATA NAME] by [NAME OF PUBLISHER], does not [sanction] or [endorse] any particular republication, and has no liability for your use."* | | **BIS 国际清算银行** | *"The use of the statistics is **unrestricted**, provided that: if the statistics are reproduced, the BIS must be **cited** in your publication or product as the source of the statistics…"* | | **欧洲央行 ECB** | *"All publicly available ESCB statistics may be **reused free of charge** on the condition that the source is quoted (e.g. "Source: ECB statistics.") and that the statistics (including metadata) are **not modified**."* | | **美国能源信息署 EIA**（库存等 EIA 自己的数据） | *"U.S. government publications are in the **public domain** and are not subject to copyright protection."* 转载时应注明来源与发布日期，如 *"Source: U.S. Energy Information Administration (Oct 2008)."* ⚠️ EIA 网站上转载的第三方数据不在此列，见 B 级的 EIA 现货价格 | | **台湾证交所 / 柜买中心 OpenAPI** | **授权**：本工具用到的 13 个数据集都登记在台湾「政府资料开放平台」，授权方式为《政府资料开放授权条款-第1版》：*「授權使用者不限目的、時間及地域、非專屬、不可撤回、免授權金進行利用」*，但须按条款的「显名声明」**注明来源**，否则视为未取得授权。两家网站条款的知识产权一节写明，经授权给政府资料开放平台的资料 *「不在此限」*，同时要求转载 *「清楚註明資料來源，並確保資料完整性，不得任意增刪」*。**程序下载**：网站条款禁止 *「非依（交易所）同意之方式」* 用自动程序下载；两家的 OpenAPI 说明页都写 *「歡迎各位介接使用」*，证交所的还直接链接上述授权条款——官方开放的程序接口即为其同意的方式（本工具的理解）。⚠️ 柜买中心的 OpenAPI 页没有链接授权条款，平台上登记的多是同一份数据的网页下载地址，归 S 级是**本工具的判断**。两家网页上逐股查历史的接口不在此列，本工具不用 | ### B 级 — 数据文件系主动公开，但站点条款含限制 | 源 | 依据（原文） | |---|---| | **FINRA** | Reg SHO 每日文件与做空余额（short interest）双周文件都是 FINRA 主动发布供下载的数据文件；但其 Terms of Use 同时禁止 *"use any process to monitor or copy the FINRA Website **in bulk**, or use any **data mining, scraping or harvesting tools (including robots)**"*，且站点声明 *"FINRA Data provides **non-commercial use** of data"*。→ **下载已发布的数据文件属常规用法；批量爬站点页面不属于。商用前请自行向 FINRA 确认。** | | **EIA 现货价格**（WTI / 布伦特 / Henry Hub） | EIA 数据说明页写明这些现货价的来源是 *"Refinitiv, an LSEG business"*；EIA 版权页 "Protected materials" 一节：第三方授权给 EIA 的材料，*"Transmission or reproduction of protected items beyond that allowed by fair use… requires the written permission of the copyright owners"*。→ **页面公开、个人研究可用；商用或再分发前请自行确认**（归 B 级是本工具的判断） | ### C 级 — 使用需事先授权，或条款未核实 | 源 | 依据（原文） | |---|---| | **CBOE**（期权链 6.1 + 波动率指数 6.3） | Use of Content 政策：使用任何 Cboe Content 须 *"receive **approval in advance** from Cboe"*，并须 *"**execution of a license agreement**"*；政策**不区分**商用/非商用、不区分实时/延时。→ **本工具的 CBOE 期权层仅供个人研究；商业用途或再分发前，须先向 Cboe 申请授权。** | | 东财 / 新浪 / 腾讯 | 站点前端接口，未见针对接口的公开授权条款。仅供个人研究，勿用于商业产品或再分发 | ### D 级 — 条款禁止未经许可的自动抓取（V2.1 复核后新增此级） | 源 | 依据（原文） | 本工具里用到它的地方 | |---|---|---| | **Yahoo Finance** | 条款禁止 *"access or collect data, or attempt to access or collect data, from our Services using **any automated means**, devices, programs, algorithms or methodologies, including but not limited to robots, spiders, scrapers… **for any purpose without our express, prior permission**."* | 美股 K 线备源、**港股 K 线（唯一来源）**、其他市场 K 线、英文关键指标、分析师、机构持仓、期权后备、新闻 | | **Nasdaq** | 条款（Last Updated: May 11, 2026）禁止 *"access or use the Service, or **any process, whether automated or manual**, to capture data or content from the Service… for any reason"*，并禁止未经书面许可把内容用于 *"any other form of data analysis software… including, but not limited to, scraping, data mining"*；授权范围 *"solely for your **personal, non-commercial use**"* | Layer 12 财报日历 `earnings_calendar()` | > **为什么 D 级保留代码，而 HKEX 直接排除？** 坦白说，两者条款性质相同。区别只在于有没有替代： > Yahoo 是本工具港股 K 线、美港以外市场 K 线的唯一来源，Nasdaq 是财报日历唯一免 key 的来源； > HKEX CCASS 则是可有可无的增量。所以 D 级代码保留、条款原文照贴—— > **仅供个人学习研究，风险自负，不得商用或再分发；用不用由你按条款自行判断。** ### ⛔ 已排除的源 | 源 | 原因 | |---|---| | **HKEX（CCASS 港股席位持股）** | 其 Terms of Use 明文禁止 *"any '**robot**', '**bot**', '**spider**', '**scraper**' or other automated device... to access, obtain, copy, monitor or republish any portion of the Website"*，禁止 *"text or data mining or web scraping"*，且适用于 *"**whether or not for gain**"*（不论是否营利）。→ **本工具不提供 CCASS 抓取代码。** 需要港股席位持股/南向资金数据者，请通过 HKEX 授权渠道或其网页人工查询 | ### 给使用者的三条硬规则 1. **商业用途**：只依赖 **S 级**（SEC EDGAR / Treasury / CFTC / 美联储 / 纽约联储 / BIS / ECB / EIA 库存 / 台湾证交所 / 柜买中心），并按各源要求注明来源。B 级需自行确认，C 级须先取得授权，D 级不得商用。 2. **再分发**：本工具**只分发代码，不分发任何市场数据**。你也不应把 B/C/D 级源取得的数据对外分发。 3. **限速**：所有官方源请求已内置节流（见「官方源统一出口」）。**不要绕过它**——SEC 的 10 req/s 是官方硬上限。 --- ## When to Activate - 用户要查**美股/港股**行情（价格/涨跌幅/成交量） - 用户要拉 K 线（日线/周线/月线/分钟线） - 用户要看**财报**（资产负债表/利润表/现金流量表） - 用户要看**关键财务指标**（PE/PB/ROE/利润率/目标价） - 用户要看**分析师预期**（EPS预测/评级/目标价区间） - 用户要看**机构持仓**（前十大机构/持股比例） - 用户要看**资金流向**（主力/大单/中单/小单净流入） - 用户要查**期权链**（calls/puts/到期日/Greeks） - 用户要查 **SEC Filing**（10-K/10-Q/8-K/年报/季报） - 用户要做**美股财报量化分析**（从 XBRL 拉多年营收/净利/EPS 趋势） - 用户要**搜索股票**（中英文均可） - 用户要看**美股/港股新闻** - 用户要看**全市场涨跌幅排名**（当日涨幅/跌幅最大的股票） - 用户要做**全市场筛选**（遍历美股/港股列表做初筛） - 用户要看**关键财务指标概览**（营收/净利/EPS/ROE/ROA/资产负债率 中文版） - 用户要看**技术指标**（MACD/RSI/KDJ/布林带/均线） - 用户要判断**金叉死叉/超买超卖/变盘信号** - 用户要查**日本/台湾/韩国/印度/欧洲/澳洲/加拿大等市场**的 K 线（Yahoo 换代码后缀） - 用户要看**全球央行政策利率**、美联储/欧央行利率、SOFR/EFFR - 用户要看**汇率**（欧元或美元对各国货币）、欧元区国债收益率、美国国债拍卖、联邦债务、M1/M2 - 用户要看 **VIX 恐慌指数**历史、波动率期限结构（正常 / 倒挂）、VVIX / SKEW - 用户要看**做空余额**、空头回补天数、轧空候选 - 用户要看**内部人买卖**（高管 / 董事增减持明细）或**机构 13F 持仓**（如伯克希尔持仓） - 用户要查**台股**最新行情、本益比 / 殖利率 / 股价净值比、月营收、融资融券、除权息（官方可商用数据） - 用户要看**原油 / 天然气**现货价格或 EIA 每周库存 - 关键词：美股、港股、AAPL、苹果、腾讯、00700、TSLA、特斯拉、BABA、阿里巴巴、行情、K线、财报、PE、PB、ROE、分析师、目标价、期权、call、put、SEC、10-K、年报、季报、资金流、主力、机构持仓、新闻、涨幅排名、全市场、筛选、关键指标、MACD、RSI、KDJ、布林带、均线、金叉、死叉、超买、超卖、技术分析、日股、台股、韩股、印度股、欧股、央行、政策利率、加息、降息、SOFR、EFFR、汇率、欧元、日元、收益率曲线、国债拍卖、美债、联邦债务、M2、VIX、恐慌指数、波动率、期限结构、做空余额、空头回补、轧空、内部人、高管减持、Form 4、13F、巴菲特持仓、台积电、台股本益比、月营收、原油、WTI、布伦特、天然气、EIA 库存 --- ## Prerequisites ```bash pip install requests # Windows 另装 tzdata，Yahoo K 线才能按交易所时区算日期（Linux / macOS 自带） pip install tzdata ``` | 依赖 | 版本要求 | 用途 | |------|---------|------| | requests | any | 所有 HTTP API 直连 | > **极简依赖：** 仅需 requests，所有数据源均为直连 HTTP API，零第三方数据封装。 --- ## 市场代码规则 ### 东财 secid 前缀（push2/push2his 用） | 前缀 | 市场 | 示例 | |------|------|------| | 105 | 美股 NASDAQ | `105.AAPL`, `105.TSLA` | | 106 | 美股 NYSE | `106.BABA`, `106.JD` |