这个项目能做什么
global-stock-data 将美股和港股市场数据访问打包进单个 SKILL.md 文件,其中包含 Markdown 指令和嵌入式 Python。它面向 Claude Code、Codex 和 OpenClaw 等 AI 编程助手设计,但其中的 Python 也可复制到普通脚本中使用。该项目要求 Python 3.9+ 和 requests 库;无需单独的 API 密钥。Yahoo cookie/crumb 处理已自动化,而 SEC EDGAR 要求声明带有真实联系信息的 User-Agent。
该工具包分为 13 层。市场数据端点提供来自新浪、腾讯和东方财富的美股/港股行情,根据来源不同包含 25–78 个字段。K 线支持包括日线、周线、月线和分钟级间隔,新浪/Yahoo 的美股标的历史数据据称可追溯至 1984 年。技术指标——MA、EMA、MACD、RSI、KDJ 和布林带——在本地计算,无需额外依赖。
基本面数据包括东方财富报表和关键指标、Yahoo quoteSummary 模块(涵盖财务、分析师和机构持仓),以及包含 503 个 GAAP 指标的 SEC XBRL 数据。东方财富还用于每日主力、大单、中单和小单资金流。实用函数涵盖股票搜索、美股/港股市场列表、标的新闻以及标的到 CIK 的映射。
2.0 版本强调官方来源优先的数据。CBOE 期权支持提供完整期权链、隐含波动率、delta、gamma、vega、theta、rho、0DTE 过滤,以及基于成交量/未平仓量的异常资金流检测;Yahoo 可作为不带希腊值的备用链。FINRA Reg SHO 提供全市场每日做空量、按标的序列和比率排名。SEC EDGAR 功能包括当日每日索引访问 Form 4、8-K、13F 和 144 等表格、可追溯至 2001 年的全文搜索、文件列表和结构化 XBRL 财务数据。EDGAR frames 被用作任意 XBRL 标签的全市场筛选器。宏观和日历端点涵盖美国国债收益率曲线、CFTC 持仓报告和 Nasdaq 财报日历。
一个显著特点是来源合规标注。S 级涵盖 SEC EDGAR、美国财政部和 CFTC 来源,据称适合在其规则范围内商业使用和再分发。FINRA 为 B 级,README 建议在商业使用前进行核实。CBOE、Nasdaq、Yahoo、东方财富、新浪和腾讯为 C 级,因为其条款要求批准、将使用限制为个人/研究目的,或未经核实。该项目声明其分发的是代码而非市场数据,建议商业使用仅依赖 S 级来源,并且由于 HKEX 的限制而未包含其爬虫。
请求使用直接 HTTP 和内置的线程安全速率限制器,SEC 流量被限制在 EDGAR 规定上限以下。该仓库采用 Apache-2.0 许可证,并包含免责声明:它是数据访问工具,而非投资建议。
评论
0 人表达喜爱 · 满10人后显示 Deer Point
登录后参与讨论。