a-stock-data

name a-stock-data description 当任务需要写代码实际获取A股数据时使用——拉取行情/K线(mootdx+腾讯+百度)、研报(东财+同花顺+iwencai)、信号(热点/北向/龙虎榜/解禁/行业)、资金面(融资融券/大宗/股东户数/分红/资金流)、新闻、财务三表/F10、公告(巨潮)、打板(涨停池/连板/炸板率/重点监控池/日内异动)、ETF期权(T型报价/希腊字母/IV)、舆情互动(互动易/热榜/人气榜)、筹码分布(获利比例/成本区间)、复权因子、估值历史(PE/PB/PS+换手率+ST)、申万行业变迁史、宏观(社融/PMI)等真实数据。十二层数据源·60端点(含5备胎)·指数成分/权重/估值/交易日历/官方两融/北交所行情·内嵌全部可运行代码，自包含零依赖外部文件；优先用通达信(mootdx)/腾讯(不封IP)，东财接口已内置限流防封，主源被封可查「备用源速查」降级。仅在需要调用数据接口取数时使用：A股概念解释、投资观点讨论、策略问答等无需取数的话题不要加载本skill。 origin custom version 3.8.0 📦 项目主页： https://github.com/simonlin1212/a-stock-data — 更新、反馈、支持作者 作者：Simon 林 · X @linsizhen · 邮箱： simonlin0423@gmail.com A股全栈数据工具包 V3.8.0 十二层数据架构，60 个能力端点（55 主端点 + 5 备胎）、22 个来源。V3.8 新增的六个入口于 2026-09-05 实测；旧端点的验证日期见各章节。覆盖主板/创业板/科创板/ST，北交所覆盖依端点而异；已有备胎的数据可按「备用源速查」降级。 V3.8.0（官方指数与交易基础数据，2026-09-05）： 新增 §12 指数与交易日历层， 中证/国证成分与权重、中证 PE/股息率、深交所整月日历，以及沪深官方两融、北交所行情两个备胎。 11→12 层，54→60 个能力入口，19→22 个来源（新增中证、国证、北交所）；无新增安装依赖，保留 Python 3.9。 国证当前文件是月末快照；历史调样、集合竞价、需 Key 的同花顺增强 API 暂不算已支持。 实测记录、候选取舍和边界见 本次数据源整合记录 。 V3.7.2（北交所号段判定对齐，2026-09-02）： _natural_market() （ norm_ticker() 校验显式前缀是否自相矛盾）与 §8.5 _anomaly_market() （异动记录→交易所）此前只枚举 43/83/87 三个前两位与 920 ，而 get_prefix() 用 startswith(("4", "8")) + startswith("92") 覆盖整个北交所号段——同一份文件两套规则（#51）。现统一为 startswith(("4", "8", "92")) 。实测（2026-09-01）北交所在市代码只有 43x/83x/87x/920x 四段、 921 段尚未启用，故 不改变任何现有标的的判定结果 ，修的是一致性与前向兼容。 V3.7.1（后缀路由修复，2026-08-20）： get_prefix() 认显式前缀（ sh000016 ）却不认等价的后缀写法（ 000016.SH ）——而 norm_ticker() 文档明文支持后缀式，且 em_market_code() / em_secid() （V3.7.0 新增）把 未归一化的原串 直接喂给 get_prefix() ： 000016.SH 以 0 开头落到默认深市分支，secid 拼成 0.000016 （深康佳A）而非 1.000016 （上证50 指数）， 静默返回另一只标的的数据 。已在 get_prefix() 开头加后缀识别分支（ .sh/.sz/.bj 与显式前缀等价透传），号段推断与沪指数白名单逻辑不变。⚠️ 走「前缀+原串拼接」的端点（ tencent_quote() 、新浪财报等）仍只认纯 6 位或前缀式——后缀式会把 .SH 拼进请求串， 先过 norm_ticker() 再传 的总原则不变。 **V3.7.0（宏观层 + 筹码分布 + 复权因子 + 估值历史，2026-08-19）：**新增 1 个数据层、7 个端点、4 个数据源 （baostock / 申万 / 人民银行 / 国家统计局，全部零注册零 key）。全部端点于 2026-08-19 实跑验证。 §4.6 筹码分布 CYQ — 补上本层名实不符的窟窿：Layer 4 叫「资金面 / 筹码 层」但 §4.1~§4.5 全是资金面数据，一直没有真正的筹码分布。 东财没有公开 CYQ 接口 （实测 push2 / push2his 的 cyq/get 均 404），本端点用 OHLC + 换手率 本地推演 ，零新增数据源。输出获利比例 / 平均成本 / 90-70 成本区间与集中度 / 筹码峰。⚠️ 初始筹码 播种为首日全部流通盘 ——从全零起步会把窗口前的存量持仓一笔勾销（两个 1% 换手日会被算成 50/50，真实应约 99%/1%）。 §6.5 估值历史 — §1.2 腾讯只有 当日 估值快照，本端点给 日频历史序列 （实测茅台 2016-01-04 起 2581 行），并一次补齐此前完全缺失的四项： 换手率 （筹码分布的必需输入）、 停牌状态 、 ST 标记 （实测 000004 有 276 天 isST=1）、历史 PE/PB/PS/PCF。⚠️ baostock 不支持北交所 ，服务端报 10004011 ，本实现在 登录前 就拦掉抛 ValueError 。 §1.4 复权因子 — §1.1 通达信 bars() 是 不复权 数据，跨除权日直接比价必错。新浪 qfq/hfq 因子序列一次 HTTP 约 1.8KB。⚠️ 响应末尾挂着 /* base64 */ 注释块， 不能用 $ 锚定正则 ，须用 raw_decode 。 §6.6 上市/退市日 — 唯一能拿到 退市日期 的零鉴权源，配合 §1.2 is_stale 可在筛选阶段剔除僵尸标的。 §6.7 申万行业变迁史 — §3.7 东财只有 当前 行业归属，用它做历史研究是 前视偏差 。本端点给每只股票的行业变迁（实测 12,893 行 / 5,905 只 / 38 个一级行业；有标的历史变更过 10 次）。⚠️ 申万官方只发代码不发中文名。 §11.1/§11.2 宏观层（新） — 人民银行社融（月度 12 列）+ 国家统计局 PMI。⚠️ 社融链路是三级跳，未发布月份 整行丢弃 而非返回 NaN（否则调用方会把 12 行当 12 个月真数据）；PMI 正文是全角括号 内带空格 ，空白必须 整个删掉 才匹配得到。 V3.6.1（龙虎榜空窗口崩溃修复，2026-08-09 · #45）： dragon_tiger_board() 在回看窗口内无上榜记录时抛 UnboundLocalError ——而大市值 / 低换手率标的（如贵州茅台）常态无上榜，等于 调用即崩 ，调用方还无法区分「无数据」与「接口异常」。已修，空窗口返回语义一致的空结构。 V3.6.0（静默失败修复 + 重点监控池/日内异动，2026-07-31 · #15）： 🔴 北交所老号段（43/83/87）会返回僵尸数据且不报错 ：实测在市 342 只中 336 只已迁至 920xxx （锦波生物 832982 → 920982 、贝特瑞 835185 → 920185 ），老码在东财研报静默返回 0 篇 、在腾讯行情返回 定格报价 （成交量 0，价差达 17%~100%+）却仍是 HTTP 200。新增全局警告章节； tencent_quote() 增加 is_stale / stale_reason 标志（实测老码 2/2 命中、正常票 4/4 无误报）； eastmoney_reports() 遇老码 抛 ValueError 而非返回空 。 🔴 §2.1/§2.2 研报层 ticker 未归一化（静默空） ： eastmoney_reports("SH600519") / "600519.SH" 一律返回 0 篇 （reportapi 只认纯 6 位），而文档「Ticker 格式归一化」明文承诺全接口支持带前缀写法—— 承诺与实现不符，且失败方式是静默空 ，调用方会误读成「该标的无研报覆盖」。新增 norm_ticker() 实现（解析失败抛 ValueError，绝不返回空串）， eastmoney_reports() / ths_eps_forecast() 接入。 §8.4 em_stock_monitor() 东财重点监控池新增（#15） ：交易所风险警示 / 重点监控名单 + 生效时间窗，零鉴权静态 JSON。 §8.5 em_price_anomaly() / em_price_anomaly_count() 日内异动池新增（#15） ：交易所「严重异常波动」口径的异动明细与按标的聚合统计，含 12 条异动规则码全解释。⚠️ 必须带 team=h5 等固定参数，缺失返回 unknow team ——已做 result!=0 冒泡而非静默返回空。 §2.1 行业研报去硬编码日期 ： begin 默认由固定的 2024-01-01 改为「相对今天往前两年」，避免时间窗越用越旧。 端点 44 → 47。实测 24/24 通过（含前缀格式 4/4、老号段拦截、新端点真数据、异动接口拒绝冒泡）。 V3.5.0（板块资金流向，2026-07-23 · #37）： §3.8 board_fund_flow() 板块资金流向新增 ：补上此前缺失的 板块级资金流 ——行业/概念/地域三类板块 × 今日/5日/10日三周期，主力净流入额/净占比 + 超大/大/中/小单四档明细 + 领涨股。与 §3.7 板块排名 同源同接口 （东财 push2 clist ），此前只请求了价格/涨跌家数字段，本版补请求 f62/f184/f66... 资金流字段即覆盖。走 em_get 限流防封。端点 43 → 44。 实测（2026-07-23）：行业今日 100 个板块主力净额降序（电力设备 64.66亿 = 超大 43.55亿 + 大 21.11亿）、概念 5 日、地域 10 日均真实返回；参数校验拒绝非法 board_type/period。 V3.4.1（前缀路由 + mootdx 验活修复，2026-07-23）： §1.2/§市场前缀规则 前缀路由修复（#40 #41） ： 5 开头沪市 ETF（ 510300 / 588200 等）、沪深指数（ 000300 / 000016 等）此前落到 else → sz ，腾讯接口返回空 或错票 （ 000016 被误判为 sz000016 *ST康佳A，静默返回不相干标的的数据，比返空更危险）。 get_prefix() 与 tencent_quote() 两处同步修复： 5x→sh 、沪指数白名单、支持显式前缀（ sh000001 / sz000001 ）透传解决 000001 （上证指数 vs 平安银行）歧义。 §1.1 tdx_client() 真实取数验活（#43） ： _probe() 仅做 TCP 握手，握手成功 ≠ 能取数——坏服务器可握手通过却回 2 字节空 body，导致 静默返回空 DataFrame 或连接崩溃 且走不到 fallback。新增 _validate() ：每个候选 server 必须真实拉一根 K 线成功才采用，并对 factory() 连接异常做 try/except 跳过，全部失败才抛明确错误。 备用源速查 K线行新增腾讯 m5 分钟 K 线（#43） ：同花顺 K 线备胎只有 30/60 分，mootdx 一挂就无 5 分钟源。补腾讯 ifzq.gtimg.cn 分钟 K（m1/m5/m15/m30/m60，零鉴权不封 IP）。⚠️ 第 7 字段是 换手率基点 不是成交额（差 3 个数量级），成交额需自算。 V3.4.0（接口质量 + 备用源韧性，2026-07-11）： §5.2 财联社快讯复活 ：旧 nodeapi 2026-05 下线后，改走官方 v1/roll/get_roll_list + 本地签名（ sign=md5(sha1(排序query)) ，零 key），V3.2 移除的全市场电报能力恢复，与东财 7×24 互为独立备份。实测 errno=0。 新增「备用源速查 & 降级策略」章节 ：十层主源→独立备胎速查表（不同域名/不同风控面）+ 3 个实测备胎函数—— dragon_tiger_backup() （沪深交易所官方龙虎榜，含营业部席位）、 fund_flow_backup() （新浪日度资金流）、 announcements_backup() （深市深交所官方/沪市东财公告+PDF）。端点 40 → 43，数据源 13 → 15（新增沪深交易所官方）。 §3.6 解禁字段修复 ：东财 RPT_LIFT_STAGE 改列名致 type / shares 恒空 → 改 FREE_SHARES_TYPE / FREE_SHARES ，并新增 able_shares （实际可流通股数，更贴近真实抛压）。 §3.7 行业排名排序修复 ：clist 请求补 fid=f3 ， top / bottom 现按涨跌幅真实排序（此前缺排序字段，切片结果非涨幅序）。 §3.2 深股通标注 ：北向盘中披露收紧后 sgt 分钟序列不可靠（hgt 可用），权威北向用 HKEX 官方日统计（见备用源速查）。 体验 ：顶部新增「端点路由速查」总表（§→函数→用途→源，可按需局部读取）；FAQ 新增东财被封对策 / 财联社复活 / mootdx 库烂尾说明。 V3.2.3（行业研报新增）： §2.1 东财行业研报 eastmoney_industry_reports() ：研报层补上行业研报端点（此前只有个股研报）。与个股研报 同端点 reportapi.eastmoney.com/report/list ，仅 qType=1 ； industry_code="*" 拉全行业、传东财行业码（如 1238 =IT服务Ⅱ）精确过滤，PDF 复用 download_pdf() ，走 em_get 限流。端点数 27 → 28。 实测（2026-06-20）：全行业 hits=47928 、按行业码 1238 过滤 hits=1863 ，首篇 PDF H3_{infoCode}_1.pdf 下载成功（2.5MB， %PDF 头）；行业码表端点（ bxpa 等）404 不存在，用 "*" 拉取后从结果反查行业码。 V3.2.2（失效接口替换 + 隐藏 Bug 修复）： §3.3 概念板块归属（#18） ：百度 PAE getrelatedblock 失效（ ResultCode 10003 + 空数组）→ 改用东财 slist （ spt=3 ） eastmoney_concept_blocks() ，一次请求拿全个股所属板块（行业/概念/地域 + BK码 + 涨跌幅 + 龙头股），零鉴权走 em_get 限流。 §7.1 巨潮公告 orgId（#19） ：硬编码 gssx0{code} 致大量 601xxx 股票 totalAnnouncement=0 → 新增 _cninfo_orgid() 动态查官方映射表 szse_stock.json （6198 只股，模块级缓存），硬编码降为 fallback。 综合示例修复 ：示例仍调用 v3.1 已删的 baidu_fund_flow_history → 改 eastmoney_fund_flow_minute 。 §4.5/§5.1 风控说明 ：部分大陆住宅 IP 被东财间歇风控（ HTTP 000 /空）非代码 Bug，加重试/换网络提示。 新代码原样 exec smoke test 实测：板块归属 茅台27/五粮液28/绿的谐波21；公告 平安601318/工行601398 原失效股恢复。 V3.2.1（Bug 修复）： 修复两个内嵌函数的解析逻辑（预先存在，非 V3.2 引入）—— §5.1 东财个股新闻 ：东财实际返回里 result.cmsArticleWebOld 直接就是文章列表，旧写法对 list 调 .get("list") 触发 AttributeError / 返回空 → 改为遍历 cmsArticleWebOld 列表本身。 §6.4 新浪财报三表 ：新浪实际结构是 result.data.report_list （按报告期为键的 dict，每期 data 才是行项列表），旧写法取 result.data.{lrb} 永久返回空 → 改为遍历 report_list 期次、从每期 data 按 item_title 提取。 两函数均用茅台 600519 公开 API（零 key）实测返回非空、字段正确。 V3.2（防封 + 失效修复）： 数据源优先级 + 东财防封 ：明确「通达信(mootdx)/腾讯不封IP 优先用，东财仅用于其独有数据」原则；新增统一节流入口 em_get() ，所有东财接口内置串行限流（间隔≥1s+随机抖动）+ 会话复用，AI 抄代码即自带防封。详见「数据源优先级 & 东财防封」章节。 财联社快讯下线（#14） ： cls.cn 旧 API 全面 404，标注弃用并改用东财全球资讯。 V3.1 修复： 替换 4 个失效接口（百度 PAE 资金流→东财 push2、大宗交易 RPT 报表名更新、机构席位改用 BUY/SELL 明细筛选）+ 修复东财全球资讯 req_trace 参数 + 修复巨潮公告 orgId 格式。 V3.0 Breaking Change ：彻底移除 akshare 依赖，所有数据源改为直连 HTTP API（仅 mootdx 保留 TCP）。 ⚠️ V3.7 起 §6.5/§6.6 另需第三方客户端 baostock （TCP），因此「零第三方封装依赖」现仅适用于其余端点。 使用方式： 将本文件放入 ~/.claude/skills/a-stock-data/SKILL.md ，Claude Code 会自动识别并在 A 股相关对话中激活。 行情层（实时，不封IP） ├── mootdx → K线 + 五档盘口 + 逐笔成交 (TCP 7709) ├── 腾讯财经 API → PE/PB/市值/换手率/涨跌停/指数/ETF (HTTP) ├── 百度股市通 → K线带MA5/10/20 (V3.0 新增，HTTP) └── 新浪复权因子 → qfq/hfq 因子序列 + 套用到不复权K线 (V3.7 新增) 研报层 ├── 东财 reportapi → 个股研报 + 行业研报 + PDF下载 + 评级 + 三年EPS ├── 同花顺 THS → 一致预期EPS (直连 basic.10jqka.com.cn) └── iwencai → NL语义搜索研报 (唯一能力，需X-Claw) 信号层 ├── 同花顺热点 → 当日强势股 + 题材归因 reason tags (零鉴权 73ms) ├── 同花顺北向 → hgt/sgt 分钟资金流向 + 本地自缓存历史 ├── 东财 slist → 个股所属板块/概念归属 (V3.2.2 替换百度PAE) ├── 东财 push2 → 个股资金流向 分钟级 (V3.1 替换百度PAE) ├── 龙虎榜席位 → 上榜记录 + 买卖席位 TOP5 + 机构动向 (datacenter-web) ├── 全市场龙虎榜 → 每日全市场上榜股票 + 净买额排名 (datacenter-web) ├── 限售解禁日历 → 历史解禁 + 未来90天待解禁 (datacenter-web) ├── 行业板块排名 → 东财行业涨跌/上涨下跌家数 (V3.0 替换同花顺) └── 板块资金流向 → 行业/概念/地域 × 今日/5日/10日 主力+超大/大/中/小四档 (push2, V3.5) 资金面 / 筹码层 ├── 融资融券明细 → 日级融资余额/买入/偿还 + 融券 (datacenter-web) ├── 大宗交易 → 成交价/量 + 买卖方营业部 (datacenter-web) ├── 股东户数变化 → 季度股东户数 + 环比变化 (datacenter-web) ├── 分红送转 → 历史每股派息/送股/转增 (datacenter-web) ├── 个股资金流120日 → 主力/大单/中单/小单 日级净流入 (push2his) └── 筹码分布 CYQ → 获利比例/平均成本/90-70成本区间/筹码峰 (本地计算，V3.7 新增) 新闻层 ├── 东财个股新闻 → 个股相关新闻 (search-api-web JSONP) ├── 财联社快讯 → 全市场实时电报 (v1 API+本地签名零key，✅V3.4 复活) └── 东财全球资讯 → 7×24 财经快讯 (np-weblist，与财联社互备) 基础数据层 ├── mootdx finance → 季报快照 (37字段, EPS/ROE/净利) ├── mootdx F10 → 公司资料 (9大类文本) ├── 东财个股信息 → 行业/总股本/流通股/市值/上市日期 (push2) ├── 新浪财报三表 → 资产负债表/利润表/现金流量表 (quotes.sina.cn) ├── baostock 估值历史 → 日频 PE/PB/PS/PCF + 换手率 + 停牌 + ST (不支持北交所，V3.7 新增) ├── baostock 标的信息 → 上市日/退市日/状态 (V3.7 新增) └── 申万行业分类 → 行业归属变迁史，消除前视偏差 (仅代码无中文名，V3.7 新增) 公告层 ├── 巨潮 cninfo → 公告全文检索+下载 (cninfo.com.cn) └── mootdx F10 → 最新公告摘要 打板层 (V3.3 新增) ├── 东财涨停池 → 连板数/几天几板/封板资金/炸板次数/行业 (push2ex) ├── 东财炸板池 → 涨停后开板 + 振幅/涨速 (push2ex) ├── 东财跌停池 → 封单资金/连续跌停/开板次数 (push2ex) ├── 东财昨涨停池 → 昨涨停今表现，算晋级率/赚钱效应 (push2ex) └── 同花顺涨停揭秘 → 涨停原因题材/封板成功率/板型 (10jqka) ETF期权层 (V3.3 新增) ├── 合约清单 → 50ETF/300ETF/科创50/500ETF 各月认购认沽 (新浪) ├── T型报价 → 买卖五档/持仓量/行权价/最新价 (新浪) └── 希腊字母+IV → Delta/Gamma/Theta/Vega/隐含波动率 (新浪) 舆情互动层 (V3.3 新增) ├── 互动易问答 → 投资者提问+公司回复 (巨潮，AI问答独家) ├── 同花顺热榜 → 人气值/概念标签/排名变化 (10jqka) ├── 东财人气榜 → 排名+排名变化+名称价格 (emappdata) └── 东财概念命中 → 个股被归到哪些概念在炒+热度 (emappdata) 宏观层 (V3.7 新增) ├── 人民银行社融 → 社会融资规模增量 月度12列 (pbc.gov.cn，三级跳取 xls 附件) └── 国家统计局PMI → 制造业/非制造业/综合 + 大中小型企业分档 (stats.gov.cn) 指数与交易日历层 (V3.8 新增) ├── 中证指数 → 当前成分 / 月末权重 / 近期 PE 与股息率 ├── 国证指数 → 最近公布的成分与权重（月末快照） └── 深交所日历 → 官方整月交易标志（完整性校验） 官方备胎扩展 (V3.8 新增) ├── 上交所/深交所 → 两融明细（分交易所调用，金额元、余量股/份） └── 北交所 → 当前行情与五档快照（必须核对交易日） 端点路由速查（按需定位，不必通读全文） 只需一类数据时，按下表定位章节（§）局部读取。除 iwencai 需 API Key 外全部零 key。 § 函数 拿什么 源 前置 norm_ticker(code) 任意写法→纯6位（ SH600519 / 600519.SH 皆可；解析失败抛错不返空） 本地 1.1 tdx_client() → .bars() / .quotes() / .transaction() K线(多周期,不复权) / 五档盘口 / 逐笔成交 通达信 1.2 tencent_quote(codes) 实时价/PE/PB/市值/换手/涨跌停/指数/ETF（带 is_stale 僵尸报价标志） 腾讯 1.3 baidu_kline_with_ma(code) 日K线带 MA5/10/20 百度 1.4 sina_adjust_factor(code, kind) / apply_adjust(bars, factors) 复权因子 qfq/hfq + 套用到不复权K线 新浪 2.1 eastmoney_reports(code) / download_pdf(rec) 个股研报+评级+三年EPS / 研报PDF 东财 2.1 eastmoney_industry_reports(industry_code) 行业研报 东财 2.2 ths_eps_forecast(code) 机构一致预期 EPS 同花顺 2.3 iwencai_search(query) / iwencai_query(query) NL 语义搜研报/选股（需 Key） iwencai 3.1 ths_hot_reason() 当日强势股+题材归因 同花顺 3.2 hsgt_realtime() 北向分钟流向（hgt 可用 / sgt 仅参考） 同花顺 3.3 eastmoney_concept_blocks(code) 个股所属板块/概念归属 东财 3.4 eastmoney_fund_flow_minute(code) 个股资金流（分钟级） 东财 3.5 dragon_tiger_board(code, date) 个股龙虎榜+买卖席位 TOP5 东财 3.6 lockup_expiry(code, date) 解禁历史+未来90天待解禁 东财 3.7 industry_comparison() 行业板块涨跌排名 东财