a-stock-data

<p align="center"><b>简体中文</b> | <a href="README_en.md">English</a></p> <h1 align="center">a-stock-data</h1> <p align="center"> <b>A 股全栈数据工具包 — 15 层架构 · 87 个端点 · 34 个数据源 · 零鉴权（iwencai 除外）</b> </p> <p align="center"> 行情 K 线 · 研报 · 市场信号 · 资金面 / 筹码 · 新闻 · 基础财务 · 公告 · 打板 · ETF 期权 · 舆情互动 · 宏观与利率 · 指数与交易日历 · 期货与大宗商品 · 事件驱动 · 可转债 </p> <p align="center"> <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License"></a> <img src="https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white" alt="Python"> <a href="https://github.com/simonlin1212/a-stock-data/stargazers"><img src="https://img.shields.io/github/stars/simonlin1212/a-stock-data?style=social" alt="Stars"></a> <br> <img src="https://img.shields.io/badge/layers-15-2ea44f.svg" alt="Layers"> <img src="https://img.shields.io/badge/endpoints-87-2ea44f.svg" alt="Endpoints"> <img src="https://img.shields.io/badge/sources-34-2ea44f.svg" alt="Sources"> <img src="https://img.shields.io/badge/auth-zero-success.svg" alt="Zero Auth"> </p> <p align="center"> <a href="#数据覆盖15-类">数据覆盖</a> · <a href="#架构">架构</a> · <a href="#快速开始">快速开始</a> · <a href="#87-个端点能力清单">端点清单</a> · <a href="#使用示例">使用示例</a> · <a href="#faq">FAQ</a> · <a href="./CHANGELOG.md">更新日志</a> </p>

一个自包含的 Skill 文件，把分散在 34 个数据源里的 A 股及相关市场原始数据整合成 AI 编程助手直接能用的工具集。你不用再背腾讯 K 线的分段参数、通达信盘后包的二进制格式、东财的 PDF Referer 头、iwencai 的 X-Claw 鉴权——全部封装好了。主源被封还有「备用源速查」可降级。

兼容 Claude Code · Codex · OpenClaw

Skill 文件本质是结构化 Markdown + 内嵌 Python，任何支持上下文注入的 AI 编程助手都能用。

V3.10.0（2026-09-22）： 通达信公开服务器的 K 线 / 盘口 / 逐笔命令失效（#52）后，行情层把可用来源排到前面（腾讯 → 腾讯 K 线 → 通达信盘后包 → 腾讯逐笔），mootdx 移到最后留档；新增 §1.4 tencent_ticks() 腾讯当日逐笔成交（替代 mootdx 逐笔）和 §13.7 futures_kline() 新浪期货日 K（主力连续 + 具体合约，补上大商所）。Layer 1 重新编号，旧编号对照见 CHANGELOG。

V3.9.0（2026-09-20）： 新增期货与大宗商品、事件驱动、可转债三层，并在原有各层补上腾讯 K 线、通达信官网盘后包、新浪研报、ETF 份额、利率曲线等入口，共 25 个；通达信公开服务器的 K 线命令失效（#52）已改走 HTTP。详见 CHANGELOG。

---

数据覆盖（15 类）

| # | 类别 | 包含数据 | 主要来源 | |---|------|----------|----------| | 1 | 行情 / K 线 | 实时价、PE/PB/市值/换手率、日周月前后复权与 1~60 分钟 K 线、某交易日全市场日线（含成交额）、复权因子、指数 / ETF | 腾讯、通达信官网、百度、新浪 | | 2 | 研报 | 个股 / 行业研报与 PDF、评级、三年 EPS 预测、一致预期、自然语言检索、研报列表 | 东财、新浪、同花顺、iwencai | | 3 | 市场信号 | 强势股与题材归因、北向资金、板块归属、资金流向、龙虎榜、限售解禁、行业排名、板块资金流 | 同花顺、东财 | | 4 | 资金面 / 筹码 | 融资融券、大宗交易、股东户数、分红送转、120 日资金流、筹码分布、ETF 份额 | 东财、上交所、深交所、本地计算 | | 5 | 新闻 | 个股新闻、财联社电报、7×24 快讯、新闻联播文字稿 | 东财、财联社、华尔街见闻、央视网 | | 6 | 基础财务 | 季报快照、F10、财报三表、估值历史、上市退市日、申万行业变迁、ST 名单 | 通达信（mootdx）、新浪、baostock、申万、东财 | | 7 | 公告 | 沪深北全量公告 | 巨潮 | | 8 | 打板 | 涨停 / 炸板 / 跌停 / 昨涨停池、涨停原因、重点监控池、日内异动 | 东财、同花顺 | | 9 | ETF 期权 | T 型报价、希腊字母、隐含波动率 | 新浪 | | 10 | 舆情互动 | 互动易（深市）、上证e互动（沪市）、同花顺热榜、东财人气榜、概念命中 | 巨潮、上证e互动、同花顺、东财 | | 11 | 宏观与利率 | 社融、PMI、国债与信用债收益率曲线、回购定盘利率、LPR、全球宏观日历 | 人民银行、国家统计局、中债、中国货币网、东财、华尔街见闻 | | 12 | 指数与交易日历 | 中证 / 国证成分与权重、中证 PE 与股息率、深交所交易日历 | 中证指数、国证指数、深交所 | | 13 | 期货与大宗商品 | 期货日行情、商品与股指期权、会员持仓排名、实时期货、A50 期指、上海金现货 | 上期所、上期能源、郑商所、中金所、广期所、新浪、上金所 | | 14 | 事件驱动 | 业绩预告、机构调研、股东增减持、股票回购、股权质押、新股申购日历 | 东财 | | 15 | 可转债 | 条款、转股价、转股价值、溢价率、上市 / 摘牌状态 | 东财 |

另有 5 个备胎：官方龙虎榜、新浪资金流、公告、沪深官方两融、北交所当前行情，主源被封时降级用。

---

架构

A 股全栈数据 · 十五层架构 · V3.10.0
│  （优先级：腾讯 / 交易所官方优先，不封 IP；mootdx 行情命令 2026-09 起失效，只用于财务与 F10；
│    东财只用于独有数据，已内置限流防封）
├── 行情层    腾讯 + 通达信官网 + 百度 + 新浪   实时价 / PE / PB / 市值 + 指数 / ETF + K线(带MA5/10/20)
│                                           + 复权因子 qfq/hfq  ★V3.7
│                                           + 日周月前后复权与 1~60 分钟 K 线 + 全市场当日日线(含成交额)  ★V3.9
│                                           + 当日逐笔成交(沪深个股 + ETF)  ★V3.10
├── 研报层    东财 reportapi + 同花顺 + iwencai + 新浪   个股研报 / 行业研报 / PDF下载 / 一致预期 / NL搜索
│                                           + 新浪研报列表(第二来源)  ★V3.9
├── 信号层    同花顺 + 东财                  强势股 + 题材归因 + 北向资金 + 板块归属
│                                           + 资金流向(push2) + 龙虎榜 + 全市场龙虎榜 + 解禁 + 行业对比 + 板块资金流
├── 资金面    东财 datacenter + push2        融资融券 + 大宗交易 + 股东户数 + 分红送转 + 资金流(分钟+120日)
│   /筹码     本地计算 + 上交所 + 深交所     筹码分布 CYQ  ★V3.7 + ETF 份额  ★V3.9
├── 新闻层    东财 + 财联社 + 华尔街见闻 + 央视网   个股新闻 / 财联社电报 / 全球资讯 / 7×24 快讯 / 新闻联播  ★V3.9
├── 基础数据  mootdx + 东财 + 新浪           季报37字段 / F10最新提示 / 财报三表
│           + baostock + 申万                估值历史(PE/PB/PS+换手率+停牌+ST) / 上市退市日 / 申万行业变迁史  ★V3.7
│                                           + ST 名单  ★V3.9
├── 公告层    巨潮 cninfo + mootdx           沪深北全量公告
├── 打板层    东财 push2ex + 同花顺          涨停池 / 炸板 / 跌停 / 昨涨停 / 涨停原因题材 / 连板梯队
│                                           + 重点监控池 + 日内异动池  ★V3.6
├── 期权层    新浪 hq.sinajs                ETF期权 T型报价 / 希腊字母 / 隐含波动率 IV  ★V3.3
├── 舆情互动  巨潮互动易 + 上证e互动 + 同花顺 + 东财   互动易(深市) / 上证e互动(沪市) ★V3.9 / 热榜 / 人气榜 / 概念命中
├── 宏观利率  人民银行 + 统计局 + 中债 + 货币网 + 东财 + 华尔街见闻
│                                           社融 / PMI / 收益率曲线 / 回购定盘利率 / LPR / 全球宏观日历  ★V3.9 扩展
├── 指数日历  中证指数 + 国证指数 + 深交所    指数成分 / 权重 / PE与股息率 / 官方交易日历
├── 期货大宗  上期所 + 上期能源 + 郑商所 + 中金所 + 广期所 + 新浪 + 上金所
│                                           期货日行情 / 商品与股指期权 / 持仓排名 / 实时期货 / A50 / 上海金  ★V3.9
│                                           + 期货日 K（主力连续 + 具体合约，含大商所）  ★V3.10
├── 事件驱动  东财 datacenter                业绩预告 / 机构调研 / 增减持 / 回购 / 股权质押 / 新股申购  ★V3.9
└── 可转债    东财 datacenter                条款 / 转股价值 / 溢价率 / 上市摘牌状态  ★V3.9

十五层之外另附备用源速查 & 降级策略：龙虎榜/资金流/公告备胎，以及沪深官方两融、北交所当前行情与五档备胎。使用范围和真实数据日期见 SKILL.md 对应章节。

---

快速开始

3 步，2 分钟。

# 1. 创建 skill 目录
mkdir -p ~/.claude/skills/a-stock-data

# 2. 把 SKILL.md 放进去
curl -o ~/.claude/skills/a-stock-data/SKILL.md \
  https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/SKILL.md

# 3. 安装依赖（V3.0 不再需要 akshare；V3.9 没有新增依赖）
pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl

启动 Claude Code，说一句「帮我看看 688017 的估值」，自动激活。

Codex / OpenClaw 用户： 把 SKILL.md 的内容贴入你的系统 prompt 或项目上下文文件即可，内嵌的 Python 代码可直接执行。

---

87 个端点能力清单

共 82 个主入口、5 个备胎。沿用能力入口计数：同一函数的中证/国证或沪深路由不重复计数，辅助函数与仅列入候选的项目不计入。

计数口径： 下方清单共 88 行，按能力入口计 87 个——「东财 行业研报」与「东财 reportapi」为同一端点（仅 qType 参数不同）、「同花顺北向（历史）」为本地自缓存（非独立端点），两行不计入；「东财日内异动池」一行含 list / count 两个端点，多计 1 个。88 − 1 − 1 + 1 = 87。代码转换辅助函数 to_joinquant() 不计入。

行情层（实时，不封 IP）

| 端点 | 数据 | |------|------| | 腾讯财经 | PE(TTM) / PB / 总市值 / 流通市值 / 换手率 / 涨跌停价 / 指数 / ETF | | 腾讯 K 线 | 沪深日/周/月前后复权 + 1/5/15/30/60 分钟，三个入口轮换；不含北交所（V3.9 新增） | | 通达信盘后包 | 某交易日沪深北全市场日线含成交额，单个 zip 约 2~3 MB；实测 2022-01-04、2023-01-03 可取，2021-01-04 已没有，未逐日验证；2022-05-06 之前的包没有北交所（V3.9 新增） | | 腾讯逐笔成交 | 最近一个交易日全部分笔（约 3 秒一笔）：时间 / 价格 / 量 / 额 / 买卖方向，沪深个股 + ETF，不含北交所；收盘后自动用当日成交额核对完整性（V3.10 新增，替代 mootdx 逐笔） | | 百度K线 | 日K线 + MA5/MA10/MA20 均价直接返回（V3.0 新增） | | 新浪复权因子 | qfq / hfq 因子序列 + 套用到不复权 K 线（V3.7 新增） | | mootdx 行情（留档） | K线(多周期) + 五档盘口 + 逐笔成交 + 实时报价 46 字段（⚠️ 2026-09 起通达信公开服务器返回空，见 FAQ #52；K 线改用腾讯 K 线 / 盘后包，逐笔改用腾讯逐笔） |

研报层

| 端点 | 数据 | |------|------| | 东财 reportapi | 个股研报列表 + 评级 + 三年 EPS 预测 | | 东财 行业研报 | 行业研报列表（qType=1，同端点）+ 行业名/行业码 + 评级（V3.2.3 新增） | | 东财 PDF 下载 | 完整研报 PDF（个股/行业通用，已处理 Referer 鉴权） | | 同花顺一致预期 | 机构一致预期 EPS（直连 basic.10jqka.com.cn） | | iwencai NL 搜索 | 自然语言跨主题研报检索 | | 新浪研报列表 | 标题 / 类型 / 机构 / 研究员 / 日期，东财之外的第二来源；无评级与目标价（V3.9 新增，#53） |

信号层

| 端点 | 数据 | |------|------| | 同花顺热点 | 当日强势股 + 题材归因 reason tags（编辑部人工标注） | | 同花顺北向（实时） | 沪股通分钟级流向（深股通近期上游披露收紧仅供参考，权威北向见 HKEX 备胎） | | 同花顺北向（历史） | 本地自缓存日级历史 | | 东财板块归属 | 个股所属全部板块（行业/概念/地域混合）+ BK码 + 当日涨跌幅 + 龙头股（V3.2.2 替换百度 PAE，一次请求拿全）| | 东财资金流向 | 主力 / 大单 / 中单 / 小单 / 超大单分钟级净流入（V3.1 替换百度 PAE） | | 龙虎榜席位 | 上榜记录 + 买卖席位 TOP5 + 机构动向 | | 全市场龙虎榜 | 每日全市场上榜股票 + 净买额排名 + 上榜原因 | | 限售解禁日历 | 历史解禁 + 未来 90 天待解禁预警 | | 行业板块排名 | 东财行业涨跌/上涨下跌家数（V3.0 替换同花顺，零鉴权） | | 板块资金流向 | 行业/概念/地域 × 今日/5日/10日 主力净流入额/净占比 + 超大/大/中/小单四档 + 领涨股（V3.5 新增，与行业排名同源）|

资金面 / 筹码层（V3.0 新增）

| 端点 | 数据 | |------|------| | 融资融券明细 | 日级融资余额/买入/偿还 + 融券余额/卖出/偿还 | | 大宗交易 | 成交价/量 + 买卖方营业部 + 溢价率 | | 股东户数变化 | 季度股东数 + 环比变化 + 户均持股（筹码集中度） | | 分红送转历史 | 每股派息/送股/转增 + 进度状态 | | 个股资金流120日 | 主力/大单/中单/小单日级净流入 | | 筹码分布 CYQ | 获利比例 / 平均成本 / 90-70 成本区间与集中度 / 筹码峰（本地计算，V3.7 新增） | | ETF 份额 | 上交所按日归档（实测 2022-01-04 仍有数据）/ 深交所当前快照，单位万份（V3.9 新增） |

新闻层

| 端点 | 数据 | |------|------| | 个股新闻 | 东财个股新闻流（直连 search-api-web） | | 财联社电报 | 全市场实时快讯（v1 API + 本地签名零 key，✅V3.4.0 复活，与全球资讯互备） | | 全球资讯 | 东财全球财经资讯（直连 np-weblist，7×24） | | 华尔街见闻快讯 | 按频道取 7×24 快讯，带翻页游标（V3.9 新增） | | 新闻联播 | 当日条目标题 + 文字稿（央视网，当晚约 20:00 后更新；V3.9 新增） |

基础数据 + 公告

| 端点 | 数据 | |------|------| | 季报快照 | 37 字段（EPS / ROE / 净利润 / 主营收入...） | | F10 文本 | 「最新提示」（公告 / 报道 / 大宗 / 两融 / 风险提示摘要）；2026-09 起服务端只剩这一类 | | 东财个股信息 | 行业/总股本/流通股/市值/上市日期（直连 push2） | | 新浪财报三表 | 资产负债表/利润表/现金流量表（直连 quotes.sina.cn） | | 巨潮公告 | 沪深北交所全量公告 | | 估值历史 | 日频 PE/PB/PS/PCF + 换手率 + 停牌 + ST（可回溯至 2016；不支持北交所，V3.7 新增） | | 上市/退市日 | ipoDate / outDate / 状态（唯一零鉴权退市日源，V3.7 新增） | | 申万行业变迁史 | 每只股票历次行业调整（消除前视偏差；仅代码无中文名，V3.7 新增） | | ST 名单 | 沪深京 ST / *ST 当日名单 + 现价；东财不可达时退 baostock（只有沪深、无价格，V3.9 新增） |

打板层（V3.3 新增）

| 端点 | 数据 | |------|------| | 东财涨停池 | 连板数 / 几天几板 / 封板资金 / 炸板次数 / 首末封板时间 / 所属行业 | | 东财炸板池 | 曾涨停后开板 + 振幅 / 涨速 | | 东财跌停池 | 封单资金 / 连续跌停天数 / 开板次数 / 板上成交额 | | 东财昨日涨停池 | 昨涨停今表现（自算晋级率 / 赚钱效应） | | 同花顺涨停揭秘 | 涨停原因题材 / 封板成功率 / 一字·换手·T字板 / 封单额 | | 东财重点监控池 | 交易所风险警示 / 重点监控名单 + 生效时间窗（V3.6 新增）| | 东财日内异动池 | 严重异常波动明细 + 按标的聚合异动统计 + 12 条异动规则解释（V3.6 新增）|

ETF 期权层（V3.3 新增）

| 端点 | 数据 | |------|------| | 期权合约清单 | 50ETF / 300ETF / 科创50ETF / 500ETF 各月份认购认沽合约 | | T型报价 | 买卖五档 / 持仓量 / 行权价 / 最新价 / 成交量额 | | 希腊字母 + IV | Delta / Gamma / Theta / Vega / 隐含波动率 / 理论价值（交易所预算，免本地算 BSM） |

舆情互动层（V3.3 新增）

| 端点 | 数据 | |------|------| | 互动易问答 | 投资者提问 + 公司官方回复（巨潮，覆盖深市；AI 问答独家信源：公司如何回应某传闻/利好） | | 上证e互动 | 沪市投资者提问 + 公司回复，补上互动易不覆盖的沪市（V3.9 新增） | | 同花顺热榜 | 人气值 / 概念标签 / 排名变化 | | 东财人气榜 | 排名 + 排名变化 + 名称价格 | | 东财个股概念命中 | 这只票当下被市场归到哪些概念在炒 + 热度值 |

宏观与利率层（V3.7 新增，V3.9 扩展）

| 端点 | 数据 | |------|------| | 人民银行社融 | 社会融资规模增量月度 12 列（人民币贷款/委托/信托/未贴现汇票/企业债/政府债/股票融资/ABS/核销） | | 国家统计局 PMI | 制造业 / 非制造业商务活动 / 综合产出 + 大中小型企业分档 | | 中债收益率曲线 | 国债 / 商业银行 AAA / 中短期票据 AAA，3 个月~30 年关键期限（V3.9 新增） | | 回购定盘利率 | FR001 / FR007 / FR014 与 FDR 同期限（中国货币网，FR 约近 3 年、FDR 约近 1 年；V3.9 新增） | | LPR | 1 年 / 5 年全历史（含 2013~2019 旧机制逐日报价，V3.9 新增） | | 全球宏观日历 | 公布值 / 预期 / 前值 / 修正值 / 重要性（华尔街见闻，V3.9 新增） |

指数与交易日历

| 端点 | 数据 | |------|------| | 指数成分 | 中证最近成分、国证最近公布的月末成分；保留源侧日期，不提供历史时点回填 | | 指数权重 | 中证/国证最近公布权重；单位为百分数，不假定与成分同日 | | 指数估值 | 中证两种股本口径的 PE 和股息率；近期文件，不含 PB、不承诺全历史 | | 官方交易日历 | 深交所完整自然月交易标志，缺日/未发布/未知标志抛错 |

期货与大宗商品层（V3.9 新增，#49）

| 端点 | 数据 | |------|------| | 期货日行情 | 上期所 / 上期能源 / 郑商所 / 中金所 / 广期所官方收盘数据：开高低收、结算价、成交量、持仓量及变化、成交额 | | 期权日行情 | 商品期权 + 股指期权：行权价、结算价、成交持仓、Delta、隐含波动率（上期所 / 上期能源按系列，郑商所 / 广期所按合约；中金所不公布 Delta 和隐含波动率） | | 会员持仓排名 | 成交量 / 持买单 / 持卖单前 20 名会员及增减（上期所、上期能源、郑商所、中金所） | | 实时期货 | 新浪实时价、买卖一档，覆盖六家期货交易所（大商所品种走这里）；涨跌停价只有中金所品种有 | | 期货日 K | 新浪逐日 K 线，主力连续（RB0 / M0，最早到 2005 年）或具体合约（约 2022 年起到期的），六家交易所全覆盖、含大商所；价格与官方日行情一致，结算价不全（V3.10 新增） | | A50 期指 | 富时中国 A50 连续合约报价 | | 上海金现货 | 上金所 Au99.99 / Au(T+D) / Ag(T+D) / Pt99.95 等日线 |

大商所官网有 JS 反爬（纯 HTTP 返回 412），官方日行情未接入；大商所品种的历史日 K 用「期货日 K」，实时价用「实时期货」。

事件驱动层（V3.9 新增）

| 端点 | 数据 | |------|------| | 业绩预告 | 预告类型、预计金额与变动幅度区间、上年同期、变动原因 | | 机构调研 | 调研汇总（接待机构数、方式、地点）或逐机构明细 | | 股东增减持 | 股东、方向、变动股数与比例、变动后持股、均价、渠道 | | 股票回购 | 方案价格上限、股数与金额区间、已回购股数与金额、进度 | | 股权质押 | 中国结算周度质押比例、质押股数与市值、笔数（只覆盖沪深） | | 新股申购日历 | 申购 / 中签 / 缴款 / 上市日期、发行价与市盈率、中签率、首日表现 |

可转债层（V3.9 新增）

| 端点 | 数据 | |------|------| | 可转债 | 正股、评级、发行规模、转股价、转股价值、溢价率、上市 / 到期 / 摘牌日与状态 |

备用源（主源被封时降级）

| 端点 | 数据 | |------|------| | 官方龙虎榜备胎 | 上交所 + 深交所官方接口，零鉴权权威一手，含营业部席位（东财被封时用） | | 资金流备胎 | 新浪日度四档单净额（超大/大/中/小单 + 净流入） | | 公告备胎 | 深市走深交所官方、沪市走东财，均带 PDF 直链（巨潮被封时用） | | 官方两融备胎 | 上交所/深交所分开查询，金额元、余量股/份；上交所缺融券余额金额时保留为空 | | 北交所行情备胎 | 全板或单票 OHLC/成交量额/五档快照，强制核对交易日；不提供历史回填，盘中延迟未标定 |

另附十五层主源 → 独立备胎速查表（交易所官方 / 同花顺 F10 / HKEX / 巨潮 webapi / 金十等，全部不同风控面）与「已死透别用」名单，见 SKILL.md「备用源速查 & 降级策略」章节。V3.9 起 K 线主源改为腾讯，当日全市场日线可用通达信盘后包，研报列表可用新浪。

鉴权要求

除 iwencai 外，其余已接入数据源无需用户注册或 API Key；V3.8 的中证