a-stock-data

简体中文 | English

a-stock-data

A 股全栈数据工具包 — 15 层架构 · 87 个端点 · 34 个数据源 · 零鉴权（iwencai 除外）

行情 K 线 · 研报 · 市场信号 · 资金面 / 筹码 · 新闻 · 基础财务 · 公告 · 打板 · ETF 期权 · 舆情互动 · 宏观与利率 · 指数与交易日历 · 期货与大宗商品 · 事件驱动 · 可转债

数据覆盖 · 架构 · 快速开始 · 端点清单 · 使用示例 · FAQ · 更新日志

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

兼容 Claude Code · Codex · OpenClaw · WorkBuddy · Muse · Grok Bot

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

V3.10.2（2026-10-11 · #58）： 修正 full_valuation() 的 PE 消化年数：前向 PE 高于 30x 而预测盈利不增长（或下一年预测缺失）时，原来返回 0 年，像是已经消化完；现在返回 None，表示无法估算。当年 EPS 缺失或不为正时同样返回 None。入口数、来源数不变。

V3.10.1（2026-10-07 · #57）： 更正 §1.2 腾讯 K 线的成交量单位：科创板（688 / 689）是股，其余是手。此前文档全写成手，照旧文档换算科创板会大 100 倍。同时补上和通达信盘后包、Baostock 按股对账的口径。§1.4 逐笔改走复用连接、自动重试的会话（一次约 70 秒 → 约 25 秒），新增 frame.attrs["complete"]，15:31 以后核对盘后定价段有没有缺笔；§13.7 期货日 K 同样自动重试。入口数、来源数、返回的数据都不变。

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打板涨停 / 炸板 / 跌停 / 昨涨停池、涨停原因、重点监控池、日内异动东财、同花顺 9ETF 期权T 型报价、希腊字母、隐含波动率新浪 10舆情互动互动易（深市）、上证e互动（沪市）、同花顺热榜、东财人气榜、概念命中巨潮、上证e互动、同花顺、东财 11宏观与利率社融、PMI、国债与信用债收益率曲线、回购定盘利率、LPR、全球宏观日历人民银行、国家统计局、中债、中国货币网、东财、华尔街见闻 12指数与交易日历中证 / 国证成分与权重、中证 PE 与股息率、深交所交易日历中证指数、国证指数、深交所 13期货与大宗商品期货日行情、商品与股指期权、会员持仓排名、实时期货、A50 期指、上海金现货上期所、上期能源、郑商所、中金所、广期所、新浪、上金所 14事件驱动业绩预告、机构调研、股东增减持、股票回购、股权质押、新股申购日历东财 15可转债条款、转股价、转股价值、溢价率、上市 / 摘牌状态东财

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

架构

A 股全栈数据 · 十五层架构 · V3.10.2
│  （优先级：腾讯 / 交易所官方优先，不封 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 线 / 盘后包，逐笔改用腾讯逐笔）

研报层

信号层

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

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