a-stock-data

📦 项目主页：https://github.com/simonlin1212/a-stock-data — 更新、反馈、支持作者

作者：Simon 林 · X @linsizhen · 邮箱：simonlin0423@gmail.com

A股全栈数据工具包 V3.7.1

十一层数据架构，54 个端点实测可用（51 主端点 + 3 官方备胎，2026-08 验证），覆盖主板/中小板/科创板/ST。每类数据在「备用源速查」列有独立备胎，主源被封时可降级。

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)

端点路由速查（按需定位，不必通读全文）

只需一类数据时，按下表定位章节（§）局部读取。除 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()	行业板块涨跌排名	东财
3.8	board_fund_flow(board_type, period)	板块资金流向（行业/概念/地域 × 今日/5日/10日，主力+四档）	东财
3.9	daily_dragon_tiger(date)	全市场龙虎榜+净买额排名	东财
4.1	margin_trading(code)	融资融券明细	东财
4.2	block_trade(code)	大宗交易+营业部	东财
4.3	holder_num_change(code)	股东户数变化	东财
4.4	dividend_history(code)	分红送转历史	东财
4.5	stock_fund_flow_120d(code)	个股资金流（120日，日级）	东财
4.6	chip_distribution(df)	筹码分布（获利比例/平均成本/90-70成本区间/筹码峰）	本地计算
5.1	eastmoney_stock_news(code)	个股新闻	东财
5.2	cls_telegraph()	财联社电报（7×24，本地签名零key）	财联社
5.3	eastmoney_global_news()	全球资讯（7×24）	东财
6.1	client.finance(symbol)	季报快照 37 字段	通达信
6.2	client.F10(symbol, name)	公司资料 9 大类文本	通达信
6.3	eastmoney_stock_info(code)	行业/股本/市值/上市日期	东财
6.4	sina_financial_report(code, type)	财报三表	新浪
6.5	baostock_valuation_history(code, s, e)	估值历史 PE/PB/PS/PCF + 换手率 + 停牌 + ST（不支持北交所）	baostock
6.6	baostock_stock_basic(code)	上市日 / 退市日 / 状态	baostock
6.7	sw_industry_history() / sw_industry_as_of(df, code, d)	申万行业变迁史（消除前视偏差，仅代码无中文名）	申万
7.1	cninfo_announcements(code)	公告检索+PDF 下载	巨潮
7.2	client.F10(symbol, name='最新提示')	最新公告摘要	通达信
8.1	em_zt_pool / em_zb_pool / em_dt_pool / em_yzt_pool	涨停/炸板/跌停/昨涨停四池	东财
8.2	ths_limit_up_pool(date)	涨停原因题材+封板成功率+板型	同花顺
8.3	limit_up_sentiment(date)	炸板率/连板高度/连板梯队	东财(四池组合)
8.4	em_stock_monitor()	重点监控池（风险警示名单+生效时间窗）	东财
8.5	em_price_anomaly() / em_price_anomaly_count()	日内异动明细 / 按标的聚合异动统计（严重异常波动）	东财
9.1	sina_option_codes / sina_option_tquote / sina_option_greeks	ETF期权合约清单 / T型报价 / 希腊字母+IV	新浪
10.1	cninfo_irm(code)	互动易问答（提问+公司回复）	巨潮
10.2	ths_hot_list() / em_hot_rank() / em_hot_concept(code)	热榜/人气榜/概念命中	同花顺+东财
11.1	pboc_social_financing(year)	社会融资规模增量（月度12列）	人民银行
11.2	nbs_pmi()	制造业/非制造业/综合 PMI + 大中小型企业	国家统计局
备用源速查	dragon_tiger_backup / fund_flow_backup / announcements_backup	龙虎榜/资金流/公告官方备胎（主源被封时降级）	交易所官方+新浪+东财(沪市公告)
估值公式	forward_pe / pe_digestion / calc_peg / full_valuation(code)	前向PE / PE消化时间 / PEG / 单票估值全景	本地计算

数据源优先级 & 东财防封（重要，先读）

优先级原则：能用通达信/腾讯，就别用东财

优先级	数据源	协议	封 IP 风险	覆盖
1（首选）	mootdx（通达信）	TCP 7709 二进制	不封 IP	K线、五档盘口、逐笔成交、财务快照、F10
2	腾讯财经	HTTP GBK	不封 IP	实时价、PE/PB/市值/换手率/涨跌停、指数、ETF
3	新浪 / 巨潮 / 同花顺	HTTP	低	财报三表、公告、一致预期/热点
4（仅独有数据才用）	东财 eastmoney	HTTP	有风控，会封 IP	见下

凡是行情 / K线 / 实时价 / 市值 / 财务三表能从 mootdx 或腾讯拿到的，一律走它们——TCP 协议和腾讯接口实测不封 IP，可放心高频调用。

东财只用于它「独有、别处拿不到」的数据

下列数据只有东财有，通达信/腾讯/新浪都没有，必须用东财（但要限流）：

龙虎榜席位 · 全市场龙虎榜 · 限售解禁日历 · 融资融券 · 大宗交易 · 股东户数 · 分红送转 · 个股资金流向（分钟/日级）· 行业板块排名 · 研报列表/PDF · 个股新闻 · 全球资讯

东财风控阈值（社区实测，2026-05）

行为	触发封禁的阈值	风险
每秒请求数	> 5 次/秒	高
单 IP 并发连接	≥ 10	高
1 分钟请求总数	≥ 200 次	中高
5 分钟请求总数	≥ 300 次	触发封禁
User-Agent	空 UA / 无浏览器特征	中

被封表现：连续请求后 403 / 429 / 连接超时 / 返回空数据。临时封禁通常几分钟到几小时。

⚠️ 实测封禁案例（2026-06-30，一手数据，感谢 @luodada99 issue #36）

上表是社区口径；下面这条是真实踩到 IP 级封禁的完整记录，比阈值表更有参考价值：

• 触发方式：选股脚本 10 线程并发、完全不走 em_get() 限流，1 小时内发出 45000+ 请求（三个版本的脚本同时跑全市场 5208 只）
• 后果：push2 / push2his 全系列 RemoteDisconnected，IP 级封禁持续 20+ 小时——不是"几分钟到几小时"那种临时限速
• 关键观察一：datacenter-web.eastmoney.com 不受影响——东财不同子域走不同 WAF，push2 被封不代表整个东财都不能用
• 关键观察二：腾讯 K 线（web.ifzq.gtimg.cn）连续 5000+ 次后会返回空，但这是限流不是封 IP，降速或换新浪即可恢复
• 降级实测：东财被封时，第一只股票花 10.9s 完成"检测被封 + 降级"，之后每只 0.4s 走腾讯，数据准确

这个案例正是「限流是铁律」的实证：em_get() 的默认间隔（1s + 抖动、串行）下，1 小时最多约 3000 次请求，与踩坑者的 45000 次差一个数量级。

被封后的降级路径（各层备胎详见「备用源速查」章节）：

被封端点	替代方案	差异
push2/clist/get（股票列表）	datacenter-web + 腾讯行情批量	行业字段来自 datacenter 的 BOARD_NAME
push2his/kline/get（K线）	腾讯 fqkline/get（前复权）→ 新浪 getKLineData（不复权）	腾讯有前复权，新浪没有
push2/stock/get（个股）	腾讯 qt.gtimg.cn	腾讯无行业/概念字段

防封铁律（调用东财时必须遵守）

1. 串行，不并发——绝不对东财开多线程/协程并发请求
2. 每次间隔 ≥ 1 秒 + 随机抖动（QPS ≤ 2），批量筛选时调大到 1.5~2 秒
3. 复用 HTTP 会话（Keep-Alive），不要每次新建连接
4. 带正常 UA + Referer（本 SKILL 各端点已配好）
5. 批量场景每只股票之间 sleep——AI 跑批量循环（如筛选 100 只股逐个拉龙虎榜/资金流）是被封的头号元凶

已内置限流：所有东财请求走 em_get()

本 SKILL 提供统一的节流入口 em_get()（定义见下方「东财数据中心统一查询（共用 helper）」），它自动做到：串行限流（最小间隔 EM_MIN_INTERVAL=1.0s + 随机抖动）+ 复用 EM_SESSION（Keep-Alive）+ 默认 UA。所有 eastmoney.com 端点的代码块都已改用 em_get 而非裸 requests.get，AI 直接抄代码即自带防封。批量任务把 EM_MIN_INTERVAL 调大即可进一步降速。

注：em_get / EM_SESSION / EM_MIN_INTERVAL 是所有东财代码块共用的前置定义，使用任一东财端点前需先执行「共用 helper」代码块。

---

When to Activate

• 用户要查 A 股个股估值（一致预期 / PE / PEG / PE消化）
• 用户要拉实时行情（价格 / 五档盘口 / K线 / 涨跌停价）
• 用户要搜研报（按主题 / 按标的 / 按行业 / 下载PDF）
• 用户要看当日强势股 / 题材归因 / 概念热点
• 用户要看北向资金动向（沪股通/深股通分钟流向）
• 用户要看概念板块归属（行业/概念/地域）
• 用户要看个股资金流向（主力/散户/超大单/大单分钟级）
• 用户要看龙虎榜席位（营业部 + 机构买卖）
• 用户要看全市场龙虎榜（当日所有上榜股票 + 净买额排名）
• 用户要看限售解禁日历（历史解禁 + 未来待解禁）
• 用户要做行业横向对比（涨跌排名 / 资金流入 / 领涨股）
• 用户要看融资融券 / 两融数据（融资余额 + 融券余额）
• 用户要看大宗交易（成交价/量 + 买卖方营业部）
• 用户要看股东户数变化（筹码集中度）
• 用户要看分红送转历史（每股派息 + 送股 + 转增）
• 用户要看指数/ETF行情（上证指数 / 沪深300 / 创业板指 / ETF）
• 用户要看涨停 / 打板情绪（涨停池 / 连板梯队 / 炸板率 / 跌停 / 涨停原因题材）
• 用户要看ETF 期权（T型报价 / 希腊字母 Delta·Gamma·Theta·Vega / 隐含波动率 IV）
• 用户要看投资者互动问答（公司如何回应某传闻/利好 · 互动易）
• 用户要看市场热度 / 人气榜（同花顺热榜 / 东财人气榜 / 个股概念命中）
• 用户要看新闻资讯（个股新闻 / 财联社快讯 / 全球资讯）
• 用户要查公告（巨潮公告全文）
• 用户要做产业链调研 / 批量横向对比
• 关键词：估值、一致预期、机构预测、市盈率、PEG、市值、研报、产业链、行业研究、K线、盘口、公告、新闻、强势股、题材、热点、概念归因、北向资金、沪股通、深股通、概念板块、资金流向、主力、龙虎榜、席位、营业部、全市场龙虎榜、净买入、解禁、限售、行业对比、行业轮动、融资融券、两融、大宗交易、股东户数、筹码集中、分红、派息、送股、指数、ETF、涨停、打板、连板、炸板、跌停、涨停原因、封板、晋级率、ETF期权、希腊字母、隐含波动率、互动易、投资者关系、热榜、人气榜、市场热度

---

Prerequisites

pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl

依赖	版本要求	用途
mootdx	>= 0.10	TCP行情+财务+F10（非 HTTP 依赖之一）；0.11.x 用 tdx_client() 规避 BESTIP bug，见上节
requests	any	所有HTTP API直连
pandas	any	数据处理+HTML表格解析
stockstats	any	技术指标计算（RSI/MACD/BOLL等）
numpy	any	§4.6 筹码分布的网格计算
baostock	>= 0.8	§6.5/§6.6 估值历史·换手率·停牌·ST·退市日（TCP，免注册免 key；不支持北交所）
xlrd	>= 2.0	读 .xls（§6.7 申万行业分类）
openpyxl	any	读 .xlsx（§11.1 人民银行社融）

架构： 除 mootdx 与 baostock（均为 TCP 客户端库）外，所有数据源均为直连 HTTP API，不经第三方数据封装。每个 HTTP 端点的底层 URL/参数完全暴露，方便调试和定制。

iwencai API Key（仅语义搜索需要）

# 环境变量方式
export IWENCAI_API_KEY="your_key_here"
export IWENCAI_BASE_URL="https://openapi.iwencai.com"

# 申请地址: https://www.iwencai.com/skillhub
# 注册后安装 SkillHub CLI，再安装 report-search 技能即可获得 Key

其他数据源（mootdx / 腾讯 / 东财 / 同花顺 / 百度股市通 / 新浪 / 巨潮 / baostock / 申万 / 人民银行 / 国家统计局）全部免费，无需 key。

mootdx 客户端（必读，规避 0.11.x BESTIP 空串 bug）

已知 bug（mootdx 0.11.x）： 全新安装后 Quotes.factory(market='std') 裸调用可能抛 ValueError: not enough values to unpack (expected 2, got 0)。 根因：~/.mootdx/config.json 的 BESTIP.HQ 初始是空字符串 ""（不是缺失键），mootdx 用 dict.get(key, default) 取不到 default，拆包失败。老用户（config 曾填充过 IP）不会触发，所以容易漏测。 不要靠锁版本解决： 锁 mootdx==0.10.12 在部分环境（如干净的 Python 3.9）下 import mootdx 会因 numpy/pandas 二进制不兼容直接崩。正确做法是用下面的 tdx_client()——显式传 server 绕过 BESTIP，对 0.10 / 0.11 都适用。

统一用以下 helper 创建客户端（所有 mootdx 调用都走它）：

import socket
from mootdx.quotes import Quotes

# 实测可用的备选服务器（按延迟排序，2026-06 验证）
_TDX_SERVERS = [
    ('119.97.185.59', 7709), ('124.70.133.119', 7709), ('116.205.183.150', 7709),
    ('123.60.73.44', 7709),  ('116.205.163.254', 7709), ('121.36.225.169', 7709),
    ('123.60.70.228', 7709), ('124.71.9.153', 7709),    ('110.41.147.114', 7709),
    ('124.71.187.122', 7709),
]

def _probe(ip, port, timeout=2.0):
    """TCP 握手探测（快速粗筛）。注意：握手成功 ≠ 能取数，必须再经 _validate 验活。"""
    try:
        with socket.create_connection((ip, port), timeout=timeout):
            return True
    except Exception:
        return False

def _validate(client, market: str = 'std') -> bool:
    """真实取数验活：坏服务器可 TCP 握手通过却回 2 字节空 body → 静默空表。用一次真实 K 线请求兜底。

    验活样本 '000001' 是 A 股代码，只对 market='std' 有意义。其它市场（如扩展行情 'ext'）
    用它必然取不到数，会把所有正常服务器都判死、误报「全部不可达」，故非 std 时跳过验活。
    """
    if market != 'std':
        return True
    try:
        df = client.bars(symbol='000001', frequency=9, offset=1)
        return df is not None and not df.empty
    except Exception:
        return False

def tdx_client(market='std'):
    """
    创建 mootdx 客户端，规避 0.11.x BESTIP.HQ 空串 bug + 坏服务器静默空表（#43）。
    每个候选都必须「真实取数验活」通过才采用（_probe TCP 握手是假阳性来源）：
      1) 顺序探测 _TDX_SERVERS，对 probe 通过者再 _validate 真实取数，取第一个验活成功的；
      2) 全部失败 → 回退 mootdx 自带 bestip 测速选优（同样验活）；
      3) 再回退裸 factory（老用户 config 已有可用 BESTIP 时成立）；
      4) 仍失败 → 抛 RuntimeError，明确报错而非静默返回空表 / 崩溃。
    """
    for ip, port in _TDX_SERVERS:
        if not _probe(ip, port):
            continue
        try:
            c = Quotes.factory(market=market, server=(ip, port))
            if _validate(c, market):
                return c
        except Exception:
            continue                                        # 握手过但取数崩 → 跳过下一台
    for kwargs in ({'bestip': True}, {}):                   # fallback: bestip 测速 / 裸 factory
        try:
            c = Quotes.factory(market=market, **kwargs)
            if _validate(c, market):
                return c
        except Exception:
            continue
    raise RuntimeError(
        "所有 mootdx 服务器均无法取到数据（TCP 可达但返回空 / 被 reset）。"
        "海外网络通常全部超时（TCP 7709），请走国内代理或更新 _TDX_SERVERS 列表。"
    )

# 用法：client = tdx_client()   # 替代所有 Quotes.factory(market='std')

海外 IP 用户： mootdx 走通达信 TCP 7709，海外环境通常全部超时。tdx_client() 会快速失败给出明确报错，而非死等。

市场前缀规则（全局通用）

# 沪市指数白名单：与深市 000xxx 个股同段，需白名单区分（沪深300/上证50/中证500/科创50/中证1000/上证180）
SH_INDEX = {"000300", "000905", "000016", "000688", "000852", "000010"}

def get_prefix(code: str) -> str:
    """6位代码 → 市场前缀（sh/sz/bj）。支持显式前缀/后缀（sh000016 / 000016.SH）透传以解决歧义。"""
    c = code.lower().strip()
    if c.endswith((".sh", ".sz", ".bj")):    # 后缀写法与前缀等价：000016.SH ≡ sh000016。
        return c[-2:]                        # 不认后缀会让 000016.SH 落到默认深市 → 静默查成深康佳A
    if c.startswith(("sh", "sz", "bj")):     # 显式前缀透传（如 sh000001=上证指数 vs sz000001=平安银行）
        return c[:2]
    if c.startswith("92"):                   # 北交所 2024-10 起的新股号段，必须先于下面的 9x 判断
        return "bj"
    if c.startswith(("5", "6", "9")):        # 5x=沪 ETF/LOF，6/9=沪个股（900xxx=沪 B 股）
        return "sh"
    if c.startswith(("4", "8")):             # 4x/8x=北交所【老号段，多数已迁 920，见下方警告】
        return "bj"
    if c in SH_INDEX:                         # 沪深300/上证50 等沪指数（000xxx）
        return "sh"
    return "sz"                              # 深市个股/ETF（00/30/15x/16x/159 等），深指数 399xxx 亦走 sz

歧义说明： 000001 默认按个股→sz000001（平安银行）；要上证指数请显式传 sh000001。000016 默认按沪指数→上证50；要深康佳A 请传 sz000016。

⚠️ 北交所老号段（43/83/87）已基本作废 — 会拿到僵尸数据且不报错

2026-07-31 实测： 东财北交所在市 342 只中 336 只已是 920xxx 号段，仅剩 3 只老码且全部停牌。存量公司代码已整体迁移（如 锦波生物 832982→920982、贝特瑞 835185→920185）。

危险在于老码不会报错，而是返回看似正常的脏数据：

接口	传老码 832982	传新码 920982
腾讯行情	返回 112.60、成交量 0（定格在迁移日）	131.74，正常成交 ✅
腾讯行情（贝特瑞）	835185 → 45.91、成交量 0	920185 → 21.05 ✅
东财研报	0 篇（静默空）	79 篇 ✅

老码行情价与真实价可差 17%~100%+，直接拿去算估值会得出完全错误的结论。

判定僵尸报价： 成交量 == 0 且 最新价 == 昨收 → 极可能是已迁移的废码（真停牌股同样满足，两者都不该用于估值）。tencent_quote() 已内置该检测并置 is_stale 标志，见 §1.2。

拿新码： 用 push2 北交所全量清单 fs=m:0+t:81+s:2048 按名称反查现行代码。

Ticker 格式归一化

norm_ticker() 把下列写法统一成纯 6 位数字：

⚠️ 不是所有端点都自动归一化（V3.6.0 前这里写的是「所有接口统一支持」，与实现不符，已改正）。

• 已内置归一化：§2.1 eastmoney_reports()、§2.2 ths_eps_forecast()。
• 只认纯 6 位或显式 sh/sz/bj 前缀（其余端点）：tencent_quote() 等走 get_prefix() 路由的函数 支持 600519 和 sh600519，但不认后缀式 600519.SH——实测会拼成 sh600519.SH 并返回空载荷（静默失败）。
• 结论：拿到用户输入的代码，先过一遍 norm_ticker() 再传给任何端点，最省事也最安全。

输入	归一化结果
688017	688017
SH688017 / sh688017	688017
688017.SH / 688017.sh	688017
SZ000001	000001
BJ920982	920982

import re

# 整串锚定匹配，只认下表列出的写法；市场标识前缀、后缀**二选一，不能同时出现**。
# ⚠️ 两个坑都会造成「静默拿到另一只股票的数据」，比报错危险得多：
#   ① 别用 re.search(r"\d{6}") 从任意串里"捞"6 位："6005190"/"foo600519bar" 会被截成 600519。
#   ② 别让前后缀同时可选：`SH000001.SZ` 这种自相矛盾的写法会被照单全收，
#      而 000001 恰是歧义码（sh000001=上证指数 / sz000001=平安银行），静默丢掉市场信息＝选错标的。
# 捕获组：1=前缀市场 2=前缀式代码 | 3=后缀式代码 4=后缀市场
# 市场标识要**同时**从前缀和后缀取——只认 startswith("sh") 会漏掉 `000001.SH` 这种后缀写法。
_TICKER_RE = re.compile(
    r"^(?:(sh|sz|bj)(\d{6})|(\d{6})(?:\.(sh|sz|bj))?)$", re.IGNORECASE)

def _natural_market(digits: str) -> str:
    """6 位码的自然归属市场。仅用于校验显式前缀是否自相矛盾。
    注意 000xxx 是沪指数/深个股共用的歧义段，由调用处单独处理，不走这里。"""
    if digits.startswith("92") or digits[:2] in ("43", "83", "87"):
        return "bj"                      # 北交所（920 现行 / 43·83·87 老号段）
    if digits[0] in ("5", "6", "9"):
        return "sh"                      # 5x 沪 ETF/LOF，6xx 沪个股，9xx 沪 B 股
    return "sz"                          # 00x/30x/15x/16x/39x 等