Skip to content
Back to search

a-stock-data

SkillWorks with Claude CodeGitHub

当任务需要写代码实际获取A股及相关市场数据时使用——行情/K线/逐笔(腾讯日周月前后复权+分钟线+当日逐笔、通达信官网全市场盘后包、百度)、研报(东财+新浪+同花顺+iwencai)、信号(热点/北向/龙虎榜/解禁/行业/板块资金流)、资金面(融资融券/大宗/股东户数/分红/资金流/ETF份额)、新闻(财联社/东财/华尔街见闻/新闻联播)、财务三表/F10/估值历史/ST名单、公告(巨潮)、打板(涨停池/连板/炸板率/监控池/异动)、ETF期权、舆情互动(互动易/上证e互动/热榜)、筹码分布、复权因子、申万行业变迁、宏观与利率(社融/PMI/中债收益率曲线/回购定盘利率/LPR/全球宏观日历)、指数成分/权重/估值/交易日历、期货与大宗商品(五家期货交易所日行情/商品与股指期权/持仓排名/期货日K含大商所/实时期货/A50/上海金)、事件驱动(业绩预告/机构调研/增减持/回购/股权质押/新股申购)、可转债等真实数据。十五层·87端点(含5备胎)·34个来源·内嵌全部可运行代码,自包含零外部文件;优先用腾讯/交易所官方等不封IP源,东财接口已内置限流防封,主源被封可查「备用源速查」降级。仅在需要调用数据接口取数时使用:A股概念解释、投资观点讨论、策略问答等无需取数的话题不要加载本skill。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/simonlin1212-a-stock-data/badge.svg)](/listings/simonlin1212-a-stock-data)

HTML

<a href="/listings/simonlin1212-a-stock-data"><img src="/api/listings/simonlin1212-a-stock-data/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 4,843 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: a-stock-data
  3. description: 当任务需要写代码实际获取A股及相关市场数据时使用——行情/K线/逐笔(腾讯日周月前后复权+分钟线+当日逐笔、通达信官网全市场盘后包、百度)、研报(东财+新浪+同花顺+iwencai)、信号(热点/北向/龙虎榜/解禁/行业/板块资金流)、资金面(融资融券/大宗/股东户数/分红/资金流/ETF份额)、新闻(财联社/东财/华尔街见闻/新闻联播)、财务三表/F10/估值历史/ST名单、公告(巨潮)、打板(涨停池/连板/炸板率/监控池/异动)、ETF期权、舆情互动(互动易/上证e互动/热榜)、筹码分布、复权因子、申万行业变迁、宏观与利率(社融/PMI/中债收益率曲线/回购定盘利率/LPR/全球宏观日历)、指数成分/权重/估值/交易日历、期货与大宗商品(五家期货交易所日行情/商品与股指期权/持仓排名/期货日K含大商所/实时期货/A50/上海金)、事件驱动(业绩预告/机构调研/增减持/回购/股权质押/新股申购)、可转债等真实数据。十五层·87端点(含5备胎)·34个来源·内嵌全部可运行代码,自包含零外部文件;优先用腾讯/交易所官方等不封IP源,东财接口已内置限流防封,主源被封可查「备用源速查」降级。仅在需要调用数据接口取数时使用:A股概念解释、投资观点讨论、策略问答等无需取数的话题不要加载本skill。
  4. origin: custom
  5. version: 3.10.4
  6. ---
  7. > 📦 项目主页:https://github.com/simonlin1212/a-stock-data — 更新、反馈、支持作者
  8. >
  9. > 作者:Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱:simonlin0423@gmail.com
  10. # A股全栈数据工具包 V3.10.4
  11. 十五层数据架构,87 个能力端点(82 主端点 + 5 备胎)、34 个来源。V3.10 新增的 2 个入口于 2026-09-22 实测,V3.9 新增的 25 个入口于 2026-09-20 实测;旧端点的验证日期见各章节。覆盖主板/创业板/科创板/ST,北交所覆盖依端点而异;已有备胎的数据可按「备用源速查」降级。
  12. > **V3.10.4(基金复权修复,2026-11-04 · #64):** 入口数、来源数不变,个股的返回值不变。§1.6 `sina_adjust_factor()` / `apply_adjust()`:
  13. > 基金(ETF / LOF)原来只读新浪的 `f`(基金恒为 1),复权等于没做;现在补读 `s`(累计份额折算比例)和 `u`(累计每份分红),
  14. > 前复权 `raw / s - u`、后复权 `(raw + u) * s`,因子多出 `split` / `dividend`,结果多出 `adj_split` / `adj_dividend`。
  15. > **V3.10.3(上证e互动时间列修复,2026-10-23):** 入口数、来源数不变,返回的数据也不变。§10.3 `sse_e_interaction()`:
  16. > 站点 1 天内的回复时间写成「昨天 18:22」,原来只认绝对时间,遇到就整页抛 `RuntimeError`;现在相对 / 绝对写法都换算成
  17. > `YYYY-MM-DD HH:MM`(相对时间按北京时间),认不出仍然报错。
  18. > **V3.10.2(PE 消化年数修正,2026-10-11 · #58):** 入口数、来源数不变。`full_valuation()` 的 `digest_years`:
  19. > 前向 PE 高于 30x 而下一年预测缺失或盈利不增长、或当年 EPS 缺失 / 不为正时,原来返回 `0`(像是已经消化完),现在返回 `None`;其余情况不变。
  20. > **V3.10.1(成交量单位与对账口径更正 · 逐笔提速与盘后核对,2026-10-07 · #57):** 入口数、来源数不变,返回的数据不变。
  21. > - §1.2 `tencent_kline()` 的 `volume`:**科创板(688 / 689)是股**,其余是手;此前文档全写成「手」,按此换算科创板会大 100 倍。
  22. > 备用源速查里「成交额 = 量(手) × 100 × 均价」同样更正。
  23. > - §1.2 补成交量对账口径:科创板以外日线是整手、最近一个交易日的分钟量也是整手(下一个交易日才回填成精确股数);
  24. > 1 分钟线 09:30 那根只有集合竞价、13:01 开盘价是上午收盘价;深市整分时刻的成交腾讯与 Baostock 分在相邻两根;无成交分钟:第一笔成交以前沪深都没有行,之后深市会缺行。
  25. > - §1.4 `tencent_ticks()` 改走复用连接、自动重试的 `V39_RETRY_SESSION`:一次约 70 秒 → 约 25 秒;连接失败、等响应超时、
  26. > 429 / 5xx 自动重试,不再一次抖动就整次失败(读响应体中途卡住不重试)。
  27. > 新增 `frame.attrs["complete"]`,15:31 以后用快照的盘后成交额核对盘后定价各笔(此前末尾缺笔完全看不出;低价 ETF 一两手的小额缺笔仍看不出)。
  28. > - §13.7 `futures_kline()` 同样自动重试,单次超时收短到 (5, 20) 秒;补上中金所主力连续只从 2017-01-17 起。
  29. > **V3.10.0(逐笔替代 / 期货日 K / 行情层重排,2026-09-22):** 85→87 个能力入口(82 主 + 5 备胎),来源数不变(34)。
  30. > - **§1.4 腾讯逐笔 `tencent_ticks()`**:替代 #52 后返回空的 mootdx `transaction()`。最近一个交易日的全部分笔(沪深个股 + ETF),
  31. > 收盘后与行情快照的当日成交额核对,连续竞价段缺笔直接报错;只有当日、不含北交所。
  32. > - **§13.7 新浪期货日 K `futures_kline()`**:单个合约或主力连续的逐日 K 线,六家交易所含大商所(此前大商所只有实时价);
  33. > 实测价格与交易所官方逐日一致。
  34. > - **行情层重排**:能用的在前,mootdx 行情命令移到 §1.7 留档。新旧编号对照见 Layer 1 开头;下面历史版本说明里写的仍是旧编号。
  35. > - **期货修正**:上期能源在各类数据首日前抛 `ValueError`(此前报成「格式可能已变」的 `RuntimeError`),期权首日更正为 2021-06-21;
  36. > 上期所日行情实测最早 2002-01-07、中金所 2010-04-16,文档原写 2015 年。
  37. > **V3.9.0(期货大宗 / 事件驱动 / 可转债 / 利率 + 四个 issue,2026-09-20):** 新增 §13 期货与大宗商品、§14 事件驱动、
  38. > §15 可转债三层,并在原有各层补齐 K 线、研报、ETF 份额、新闻、ST 名单、沪市问答、利率曲线等入口。
  39. > 12→15 层,60→85 个能力入口(80 主 + 5 备胎),22→34 个来源(新增通达信官网盘后包、华尔街见闻、央视网、上证e互动、
  40. > 中债、中国货币网、上期所、上期能源、郑商所、中金所、广期所、上金所);无新增安装依赖,保留 Python 3.9。
  41. > - **#52 mootdx 行情命令失效**:通达信公开服务器的 K 线 / 盘口 / 逐笔返回 0 行,财务与 F10 正常。`tdx_client(check='finance')`
  42. > 让财务 / F10 按财务命令验活;K 线改走 §1.5 腾讯 / §1.6 通达信盘后包,`tdx_client()` 失败时的报错直接指路。
  43. > - **#49 商品期货 / 期权**:§13 接入五家期货交易所官方日行情与商品 / 股指期权、四家(广期所除外)的会员持仓排名,另有新浪实时期货(含大商所)、
  44. > A50 期指与上海金交所现货。大商所官网有反爬,日行情未接入。
  45. > - **#53 研报来源**:新增 §2.4 新浪研报列表,作为东财之外的第二来源(只有列表,无评级与目标价)。
  46. > - **#55 聚宽代码**:`norm_ticker()` / `get_prefix()` 认 `.XSHG` / `.XSHE`,新增 `to_joinquant()`;FAQ 说明回测能力边界。
  47. > - 新端点统一返回带 `source` / `source_url` / `fetched_at` 的 DataFrame,「确实没有」与「接口坏了」分开报错。
  48. > 25 个新入口于 2026-09-20 用本文件原文代码实测,见 [本次数据源整合记录](docs/source-integration-v3.9.0.md)。
  49. > **V3.8.0(官方指数与交易基础数据,2026-09-05):** 新增 §12 指数与交易日历层,
  50. > 中证/国证成分与权重、中证 PE/股息率、深交所整月日历,以及沪深官方两融、北交所行情两个备胎。
  51. > 11→12 层,54→60 个能力入口,19→22 个来源(新增中证、国证、北交所);无新增安装依赖,保留 Python 3.9。
  52. > 国证当前文件是月末快照;历史调样、集合竞价、需 Key 的同花顺增强 API 暂不算已支持。
  53. > 实测记录、候选取舍和边界见 [本次数据源整合记录](docs/source-integration-v3.8.0.md)。
  54. > **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` 段尚未启用,故**不改变任何现有标的的判定结果**,修的是一致性与前向兼容。
  55. >
  56. > **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()` 再传**的总原则不变。
  57. >
  58. > **V3.7.0(宏观层 + 筹码分布 + 复权因子 + 估值历史,2026-08-19):**新增 **1 个数据层、7 个端点、4 个数据源**(baostock / 申万 / 人民银行 / 国家统计局,全部零注册零 key)。全部端点于 2026-08-19 实跑验证。
  59. >
  60. > - **§4.6 筹码分布 CYQ** — 补上本层名实不符的窟窿:Layer 4 叫「资金面 / **筹码**层」但 §4.1~§4.5 全是资金面数据,一直没有真正的筹码分布。**东财没有公开 CYQ 接口**(实测 `push2`/`push2his` 的 `cyq/get` 均 404),本端点用 OHLC + 换手率**本地推演**,零新增数据源。输出获利比例 / 平均成本 / 90-70 成本区间与集中度 / 筹码峰。⚠️ 初始筹码**播种为首日全部流通盘**——从全零起步会把窗口前的存量持仓一笔勾销(两个 1% 换手日会被算成 50/50,真实应约 99%/1%)。
  61. > - **§6.5 估值历史** — §1.2 腾讯只有**当日**估值快照,本端点给**日频历史序列**(实测茅台 2016-01-04 起 2581 行),并一次补齐此前完全缺失的四项:**换手率**(筹码分布的必需输入)、**停牌状态**、**ST 标记**(实测 000004 有 276 天 isST=1)、历史 PE/PB/PS/PCF。⚠️ **baostock 不支持北交所**,服务端报 `10004011`,本实现在**登录前**就拦掉抛 `ValueError`。
  62. > - **§1.4 复权因子** — §1.1 通达信 `bars()` 是**不复权**数据,跨除权日直接比价必错。新浪 qfq/hfq 因子序列一次 HTTP 约 1.8KB。⚠️ 响应末尾挂着 `/* base64 */` 注释块,**不能用 `$` 锚定正则**,须用 `raw_decode`。
  63. > - **§6.6 上市/退市日** — 唯一能拿到**退市日期**的零鉴权源,配合 §1.2 `is_stale` 可在筛选阶段剔除僵尸标的。
  64. > - **§6.7 申万行业变迁史** — §3.7 东财只有**当前**行业归属,用它做历史研究是**前视偏差**。本端点给每只股票的行业变迁(实测 12,893 行 / 5,905 只 / 38 个一级行业;有标的历史变更过 10 次)。⚠️ 申万官方只发代码不发中文名。
  65. > - **§11.1/§11.2 宏观层(新)** — 人民银行社融(月度 12 列)+ 国家统计局 PMI。⚠️ 社融链路是三级跳,未发布月份**整行丢弃**而非返回 NaN(否则调用方会把 12 行当 12 个月真数据);PMI 正文是全角括号**内带空格**,空白必须**整个删掉**才匹配得到。
  66. > **V3.6.1(龙虎榜空窗口崩溃修复,2026-08-09 · #45):**`dragon_tiger_board()` 在回看窗口内无上榜记录时抛 `UnboundLocalError`——而大市值 / 低换手率标的(如贵州茅台)常态无上榜,等于**调用即崩**,调用方还无法区分「无数据」与「接口异常」。已修,空窗口返回语义一致的空结构。
  67. >
  68. > **V3.6.0(静默失败修复 + 重点监控池/日内异动,2026-07-31 · #15):**
  69. > - **🔴 北交所老号段(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 而非返回空**。
  70. > - **🔴 §2.1/§2.2 研报层 ticker 未归一化(静默空)**:`eastmoney_reports("SH600519")` / `"600519.SH"` 一律返回 **0 篇**(reportapi 只认纯 6 位),而文档「Ticker 格式归一化」明文承诺全接口支持带前缀写法——**承诺与实现不符,且失败方式是静默空**,调用方会误读成「该标的无研报覆盖」。新增 `norm_ticker()` 实现(解析失败抛 ValueError,绝不返回空串),`eastmoney_reports()` / `ths_eps_forecast()` 接入。
  71. > - **§8.4 `em_stock_monitor()` 东财重点监控池新增(#15)**:交易所风险警示 / 重点监控名单 + 生效时间窗,零鉴权静态 JSON。
  72. > - **§8.5 `em_price_anomaly()` / `em_price_anomaly_count()` 日内异动池新增(#15)**:交易所「严重异常波动」口径的异动明细与按标的聚合统计,含 12 条异动规则码全解释。⚠️ 必须带 `team=h5` 等固定参数,缺失返回 `unknow team`——已做 `result!=0` 冒泡而非静默返回空。
  73. > - **§2.1 行业研报去硬编码日期**:`begin` 默认由固定的 `2024-01-01` 改为「相对今天往前两年」,避免时间窗越用越旧。
  74. > - 端点 44 → 47。实测 24/24 通过(含前缀格式 4/4、老号段拦截、新端点真数据、异动接口拒绝冒泡)。
  75. >
  76. > **V3.5.0(板块资金流向,2026-07-23 · #37):**
  77. > - **§3.8 `board_fund_flow()` 板块资金流向新增**:补上此前缺失的**板块级资金流**——行业/概念/地域三类板块 × 今日/5日/10日三周期,主力净流入额/净占比 + 超大/大/中/小单四档明细 + 领涨股。与 §3.7 板块排名**同源同接口**(东财 push2 `clist`),此前只请求了价格/涨跌家数字段,本版补请求 `f62/f184/f66...` 资金流字段即覆盖。走 `em_get` 限流防封。端点 43 → 44。
  78. > - 实测(2026-07-23):行业今日 100 个板块主力净额降序(电力设备 64.66亿 = 超大 43.55亿 + 大 21.11亿)、概念 5 日、地域 10 日均真实返回;参数校验拒绝非法 board_type/period。
  79. >
  80. > **V3.4.1(前缀路由 + mootdx 验活修复,2026-07-23):**
  81. > - **§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 平安银行)歧义。
  82. > - **§1.1 `tdx_client()` 真实取数验活(#43)**:`_probe()` 仅做 TCP 握手,握手成功 ≠ 能取数——坏服务器可握手通过却回 2 字节空 body,导致**静默返回空 DataFrame 或连接崩溃**且走不到 fallback。新增 `_validate()`:每个候选 server 必须真实拉一根 K 线成功才采用,并对 `factory()` 连接异常做 try/except 跳过,全部失败才抛明确错误。
  83. > - **备用源速查 K线行新增腾讯 m5 分钟 K 线(#43)**:同花顺 K 线备胎只有 30/60 分,mootdx 一挂就无 5 分钟源。补腾讯 `ifzq.gtimg.cn` 分钟 K(m1/m5/m15/m30/m60,零鉴权不封 IP)。⚠️ 第 7 字段是**换手率基点**不是成交额(差 3 个数量级),成交额需自算。
  84. >
  85. > **V3.4.0(接口质量 + 备用源韧性,2026-07-11):**
  86. > - **§5.2 财联社快讯复活**:旧 nodeapi 2026-05 下线后,改走官方 `v1/roll/get_roll_list` + 本地签名(`sign=md5(sha1(排序query))`,零 key),V3.2 移除的全市场电报能力恢复,与东财 7×24 互为独立备份。实测 errno=0。
  87. > - **新增「备用源速查 & 降级策略」章节**:十层主源→独立备胎速查表(不同域名/不同风控面)+ 3 个实测备胎函数——`dragon_tiger_backup()`(沪深交易所官方龙虎榜,含营业部席位)、`fund_flow_backup()`(新浪日度资金流)、`announcements_backup()`(深市深交所官方/沪市东财公告+PDF)。端点 40 → 43,数据源 13 → 15(新增沪深交易所官方)。
  88. > - **§3.6 解禁字段修复**:东财 `RPT_LIFT_STAGE` 改列名致 `type`/`shares` 恒空 → 改 `FREE_SHARES_TYPE`/`FREE_SHARES`,并新增 `able_shares`(实际可流通股数,更贴近真实抛压)。
  89. > - **§3.7 行业排名排序修复**:clist 请求补 `fid=f3`,`top`/`bottom` 现按涨跌幅真实排序(此前缺排序字段,切片结果非涨幅序)。
  90. > - **§3.2 深股通标注**:北向盘中披露收紧后 sgt 分钟序列不可靠(hgt 可用),权威北向用 HKEX 官方日统计(见备用源速查)。
  91. > - **体验**:顶部新增「端点路由速查」总表(§→函数→用途→源,可按需局部读取);FAQ 新增东财被封对策 / 财联社复活 / mootdx 库烂尾说明。
  92. >
  93. > **V3.2.3(行业研报新增):**
  94. > - **§2.1 东财行业研报 `eastmoney_industry_reports()`**:研报层补上行业研报端点(此前只有个股研报)。与个股研报**同端点** `reportapi.eastmoney.com/report/list`,仅 `qType=1`;`industry_code="*"` 拉全行业、传东财行业码(如 `1238`=IT服务Ⅱ)精确过滤,PDF 复用 `download_pdf()`,走 `em_get` 限流。端点数 27 → 28。
  95. > - 实测(2026-06-20):全行业 `hits=47928`、按行业码 `1238` 过滤 `hits=1863`,首篇 PDF `H3_{infoCode}_1.pdf` 下载成功(2.5MB,`%PDF` 头);行业码表端点(`bxpa` 等)404 不存在,用 `"*"` 拉取后从结果反查行业码。
  96. > **V3.2.2(失效接口替换 + 隐藏 Bug 修复):**
  97. > - **§3.3 概念板块归属(#18)**:百度 PAE `getrelatedblock` 失效(`ResultCode 10003` + 空数组)→ 改用东财 `slist`(`spt=3`)`eastmoney_concept_blocks()`,一次请求拿全个股所属板块(行业/概念/地域 + BK码 + 涨跌幅 + 龙头股),零鉴权走 `em_get` 限流。
  98. > - **§7.1 巨潮公告 orgId(#19)**:硬编码 `gssx0{code}` 致大量 601xxx 股票 `totalAnnouncement=0` → 新增 `_cninfo_orgid()` 动态查官方映射表 `szse_stock.json`(6198 只股,模块级缓存),硬编码降为 fallback。
  99. > - **综合示例修复**:示例仍调用 v3.1 已删的 `baidu_fund_flow_history` → 改 `eastmoney_fund_flow_minute`。
  100. > - **§4.5/§5.1 风控说明**:部分大陆住宅 IP 被东财间歇风控(`HTTP 000`/空)非代码 Bug,加重试/换网络提示。
  101. > - 新代码原样 exec smoke test 实测:板块归属 茅台27/五粮液28/绿的谐波21;公告 平安601318/工行601398 原失效股恢复。
  102. >
  103. > **V3.2.1(Bug 修复):** 修复两个内嵌函数的解析逻辑(预先存在,非 V3.2 引入)——
  104. > - **§5.1 东财个股新闻**:东财实际返回里 `result.cmsArticleWebOld` 直接就是文章列表,旧写法对 list 调 `.get("list")` 触发 AttributeError / 返回空 → 改为遍历 `cmsArticleWebOld` 列表本身。
  105. > - **§6.4 新浪财报三表**:新浪实际结构是 `result.data.report_list`(按报告期为键的 dict,每期 `data` 才是行项列表),旧写法取 `result.data.{lrb}` 永久返回空 → 改为遍历 `report_list` 期次、从每期 `data` 按 `item_title` 提取。
  106. > - 两函数均用茅台 600519 公开 API(零 key)实测返回非空、字段正确。
  107. >
  108. > **V3.2(防封 + 失效修复):**
  109. > - **数据源优先级 + 东财防封**:明确「通达信(mootdx)/腾讯不封IP 优先用,东财仅用于其独有数据」原则;新增统一节流入口 `em_get()`,所有东财接口内置串行限流(间隔≥1s+随机抖动)+ 会话复用,AI 抄代码即自带防封。详见「数据源优先级 & 东财防封」章节。
  110. > - **财联社快讯下线(#14)**:`cls.cn` 旧 API 全面 404,标注弃用并改用东财全球资讯。
  111. >
  112. > **V3.1 修复:** 替换 4 个失效接口(百度 PAE 资金流→东财 push2、大宗交易 RPT 报表名更新、机构席位改用 BUY/SELL 明细筛选)+ 修复东财全球资讯 req_trace 参数 + 修复巨潮公告 orgId 格式。
  113. >
  114. > **V3.0 Breaking Change**:彻底移除 akshare 依赖,所有数据源改为直连 HTTP API(仅 mootdx 保留 TCP)。
  115. > ⚠️ V3.7 起 §6.5/§6.6 另需第三方客户端 `baostock`(TCP),因此「零第三方封装依赖」现仅适用于其余端点。
  116. **使用方式:** 将本文件放入 `~/.claude/skills/a-stock-data/SKILL.md`,Claude Code 会自动识别并在 A 股相关对话中激活。
  117. ```
  118. 行情层(实时,不封IP)
  119. ├── 腾讯财经 API → PE/PB/市值/换手率/涨跌停/指数/ETF (HTTP)
  120. ├── 腾讯 K 线 → 沪深日/周/月前后复权 + 1~60 分钟,三入口轮换 (V3.9 新增)
  121. ├── 通达信盘后包 → 某交易日沪深北全市场日线含成交额 (tdx.com.cn HTTP,V3.9 新增)
  122. ├── 腾讯逐笔 → 最近一个交易日的分笔成交明细,沪深个股 + ETF (HTTP,V3.10 新增)
  123. ├── 百度股市通 → K线带MA5/10/20 (V3.0 新增,HTTP)
  124. ├── 新浪复权因子 → qfq/hfq 因子序列 + 套用到不复权K线 (V3.7 新增)
  125. └── mootdx → K线 + 五档盘口 + 逐笔成交 (TCP 7709;⚠️ 2026-09 起行情命令返回空,#52,留档)
  126. 研报层
  127. ├── 东财 reportapi → 个股研报 + 行业研报 + PDF下载 + 评级 + 三年EPS
  128. ├── 同花顺 THS → 一致预期EPS (直连 basic.10jqka.com.cn)
  129. ├── iwencai → NL语义搜索研报 (唯一能力,需X-Claw)
  130. └── 新浪研报列表 → 标题/机构/研究员/日期,研报第二来源 (V3.9 新增)
  131. 信号层
  132. ├── 同花顺热点 → 当日强势股 + 题材归因 reason tags (零鉴权 73ms)
  133. ├── 同花顺北向 → hgt/sgt 分钟资金流向 + 本地自缓存历史
  134. ├── 东财 slist → 个股所属板块/概念归属 (V3.2.2 替换百度PAE)
  135. ├── 东财 push2 → 个股资金流向 分钟级 (V3.1 替换百度PAE)
  136. ├── 龙虎榜席位 → 上榜记录 + 买卖席位 TOP5 + 机构动向 (datacenter-web)
  137. ├── 全市场龙虎榜 → 每日全市场上榜股票 + 净买额排名 (datacenter-web)
  138. ├── 限售解禁日历 → 历史解禁 + 未来90天待解禁 (datacenter-web)
  139. ├── 行业板块排名 → 东财行业涨跌/上涨下跌家数 (V3.0 替换同花顺)
  140. └── 板块资金流向 → 行业/概念/地域 × 今日/5日/10日 主力+超大/大/中/小四档 (push2, V3.5)
  141. 资金面 / 筹码层
  142. ├── 融资融券明细 → 日级融资余额/买入/偿还 + 融券 (datacenter-web)
  143. ├── 大宗交易 → 成交价/量 + 买卖方营业部 (datacenter-web)
  144. ├── 股东户数变化 → 季度股东户数 + 环比变化 (datacenter-web)
  145. ├── 分红送转 → 历史每股派息/送股/转增 (datacenter-web)
  146. ├── 个股资金流120日 → 主力/大单/中单/小单 日级净流入 (push2his)
  147. ├── 筹码分布 CYQ → 获利比例/平均成本/90-70成本区间/筹码峰 (本地计算,V3.7 新增)
  148. └── ETF 份额 → 上交所按日归档 / 深交所当前快照,万份 (V3.9 新增)
  149. 新闻层
  150. ├── 东财个股新闻 → 个股相关新闻 (search-api-web JSONP)
  151. ├── 财联社快讯 → 全市场实时电报 (v1 API+本地签名零key,✅V3.4 复活)
  152. ├── 东财全球资讯 → 7×24 财经快讯 (np-weblist,与财联社互备)
  153. ├── 华尔街见闻 → 7×24 快讯,按频道 + 翻页游标 (V3.9 新增)
  154. └── 新闻联播 → 当日条目标题 + 文字稿 (央视网,V3.9 新增)
  155. 基础数据层
  156. ├── mootdx finance → 季报快照 (37字段, EPS/ROE/净利)
  157. ├── mootdx F10 → 最新提示 (公告/报道/大宗/两融/风险提示摘要;2026-09 起只剩这一类)
  158. ├── 东财个股信息 → 行业/总股本/流通股/市值/上市日期 (push2)
  159. ├── 新浪财报三表 → 资产负债表/利润表/现金流量表 (quotes.sina.cn)
  160. ├── baostock 估值历史 → 日频 PE/PB/PS/PCF + 换手率 + 停牌 + ST (不支持北交所,V3.7 新增)
  161. ├── baostock 标的信息 → 上市日/退市日/状态 (V3.7 新增)
  162. ├── 申万行业分类 → 行业归属变迁史,消除前视偏差 (仅代码无中文名,V3.7 新增)
  163. └── ST 名单 → 沪深京 ST / *ST 当日快照 (东财,baostock 兜底,V3.9 新增)
  164. 公告层
  165. ├── 巨潮 cninfo → 公告全文检索+下载 (cninfo.com.cn)
  166. └── mootdx F10 → 最新公告摘要
  167. 打板层 (V3.3 新增)
  168. ├── 东财涨停池 → 连板数/几天几板/封板资金/炸板次数/行业 (push2ex)
  169. ├── 东财炸板池 → 涨停后开板 + 振幅/涨速 (push2ex)
  170. ├── 东财跌停池 → 封单资金/连续跌停/开板次数 (push2ex)
  171. ├── 东财昨涨停池 → 昨涨停今表现,算晋级率/赚钱效应 (push2ex)
  172. └── 同花顺涨停揭秘 → 涨停原因题材/封板成功率/板型 (10jqka)
  173. ETF期权层 (V3.3 新增)
  174. ├── 合约清单 → 50ETF/300ETF/科创50/500ETF 各月认购认沽 (新浪)
  175. ├── T型报价 → 买卖五档/持仓量/行权价/最新价 (新浪)
  176. └── 希腊字母+IV → Delta/Gamma/Theta/Vega/隐含波动率 (新浪)
  177. 舆情互动层 (V3.3 新增)
  178. ├── 互动易问答 → 投资者提问+公司回复 (巨潮,深市)
  179. ├── 上证e互动 → 沪市投资者提问+公司回复 (上交所运营的独立平台,V3.9 新增)
  180. ├── 同花顺热榜 → 人气值/概念标签/排名变化 (10jqka)
  181. ├── 东财人气榜 → 排名+排名变化+名称价格 (emappdata)
  182. └── 东财概念命中 → 个股被归到哪些概念在炒+热度 (emappdata)
  183. 宏观与利率层 (V3.7 新增,V3.9 扩展)
  184. ├── 人民银行社融 → 社会融资规模增量 月度12列 (pbc.gov.cn,三级跳取 xls 附件)
  185. ├── 国家统计局PMI → 制造业/非制造业/综合 + 大中小型企业分档 (stats.gov.cn)
  186. ├── 中债收益率曲线 → 国债 / 商业银行 AAA / 中短票 AAA,3月~30年 (V3.9 新增)
  187. ├── 回购定盘利率 → FR001/007/014 + FDR (中国货币网,V3.9 新增)
  188. ├── LPR → 1 年 / 5 年全历史 (东财,V3.9 新增)
  189. └── 全球宏观日历 → 公布值/预期/前值 + 重要事件 (华尔街见闻,V3.9 新增)
  190. 指数与交易日历层 (V3.8 新增)
  191. ├── 中证指数 → 当前成分 / 月末权重 / 近期 PE 与股息率
  192. ├── 国证指数 → 最近公布的成分与权重(月末快照)
  193. └── 深交所日历 → 官方整月交易标志(完整性校验)
  194. 期货与大宗商品层 (V3.9 新增,#49)
  195. ├── 期货日行情 → 上期所/上期能源/郑商所/中金所/广期所 官方收盘数据
  196. ├── 期权日行情 → 商品期权 + 股指期权,Delta / 隐含波动率(中金所不公布这两项)
  197. ├── 持仓排名 → 会员成交量 / 持买 / 持卖前 20 名
  198. ├── 实时期货 → 新浪实时价(含大商所品种)
  199. ├── 期货日 K → 新浪单合约 / 主力连续逐日 K 线(含大商所,V3.10 新增)
  200. ├── A50 期指 → 富时中国 A50 连续合约报价
  201. └── 上海金现货 → 上金所 Au99.99 / Au(T+D) / Ag(T+D) 日线
  202. 事件驱动层 (V3.9 新增)
  203. ├── 业绩预告 · 机构调研 · 股东增减持 · 股票回购
  204. └── 股权质押(中国结算周度) · 新股申购日历 (均为东财 datacenter)
  205. 可转债层 (V3.9 新增)
  206. └── 可转债全表 → 条款 + 转股价 / 债价 / 转股价值 / 溢价率 (东财)
  207. 官方备胎扩展 (V3.8 新增)
  208. ├── 上交所/深交所 → 两融明细(分交易所调用,金额元、余量股/份)
  209. └── 北交所 → 当前行情与五档快照(必须核对交易日)
  210. ```
  211. ## 端点路由速查(按需定位,不必通读全文)
  212. 只需一类数据时,按下表定位章节(§)局部读取。除 iwencai 需 API Key 外全部零 key。
  213. | § | 函数 | 拿什么 | 源 |
  214. |---|------|--------|----|
  215. | 前置 | `norm_ticker(code)` | 任意写法→纯6位(`SH600519`/`600519.SH`/`600519.XSHG` 皆可;解析失败抛错不返空) | 本地 |
  216. | 前置 | `to_joinquant(code)` | 转聚宽代码 `600519.XSHG` / `000001.XSHE`(北交所不转换) | 本地 |
  217. | 1.1 | `tencent_quote(codes)` | 实时价/PE/PB/市值/换手/涨跌停/指数/ETF(带 `is_stale` 僵尸报价标志) | 腾讯 |
  218. | 1.2 | `tencent_kline(code, period, adjust, start, end, count)` | 日/周/月前后复权 + 1~60 分钟 K 线(沪深,不含北交所) | 腾讯 |
  219. | 1.3 | `tdx_daily_package(date)` | 某交易日沪深北全部证券日线(含成交额) | 通达信官网 |
  220. | 1.4 | `tencent_ticks(code)` | 最近一个交易日的分笔成交(价/手/元/主动买卖;沪深个股+ETF,不含北交所) | 腾讯 |
  221. | 1.5 | `baidu_kline_with_ma(code)` | 日K线带 MA5/10/20 | 百度 |
  222. | 1.6 | `sina_adjust_factor(code, kind)` / `apply_adjust(bars, factors)` | 复权因子 qfq/hfq + 套用到不复权K线 | 新浪 |
  223. | 1.7 | `tdx_client()` → `.bars()` / `.quotes()` / `.transaction()` | K线(多周期,不复权) / 五档盘口 / 逐笔成交(⚠️ 2026-09 起返回空,#52,留档) | 通达信 |
  224. | 2.1 | `eastmoney_reports(code)` / `download_pdf(rec)` | 个股研报+评级+三年EPS / 研报PDF | 东财 |
  225. | 2.1 | `eastmoney_industry_reports(industry_code)` | 行业研报 | 东财 |
  226. | 2.2 | `ths_eps_forecast(code)` | 机构一致预期 EPS | 同花顺 |
  227. | 2.3 | `iwencai_search(query)` / `iwencai_query(query)` | NL 语义搜研报/选股(需 Key) | iwencai |
  228. | 2.4 | `sina_research_reports(code=None, page=1)` | 研报列表:标题/类型/机构/研究员(无评级) | 新浪 |
  229. | 3.1 | `ths_hot_reason()` | 当日强势股+题材归因 | 同花顺 |
  230. | 3.2 | `hsgt_realtime()` | 北向分钟流向(hgt 可用 / sgt 仅参考) | 同花顺 |
  231. | 3.3 | `eastmoney_concept_blocks(code)` | 个股所属板块/概念归属 | 东财 |
  232. | 3.4 | `eastmoney_fund_flow_minute(code)` | 个股资金流(分钟级) | 东财 |
  233. | 3.5 | `dragon_tiger_board(code, date)` | 个股龙虎榜+买卖席位 TOP5 | 东财 |
  234. | 3.6 | `lockup_expiry(code, date)` | 解禁历史+未来90天待解禁 | 东财 |
  235. | 3.7 | `industry_comparison()` | 行业板块涨跌排名 | 东财 |
  236. | 3.8 | `board_fund_flow(board_type, period)` | 板块资金流向(行业/概念/地域 × 今日/5日/10日,主力+四档) | 东财 |
  237. | 3.9 | `daily_dragon_tiger(date)` | 全市场龙虎榜+净买额排名 | 东财 |
  238. | 4.1 | `margin_trading(code)` | 融资融券明细 | 东财 |
  239. | 4.2 | `block_trade(code)` | 大宗交易+营业部 | 东财 |
  240. | 4.3 | `holder_num_change(code)` | 股东户数变化 | 东财 |
  241. | 4.4 | `dividend_history(code)` | 分红送转历史 | 东财 |
  242. | 4.5 | `stock_fund_flow_120d(code)` | 个股资金流(120日,日级) | 东财 |
  243. | 4.6 | `chip_distribution(df)` | 筹码分布(获利比例/平均成本/90-70成本区间/筹码峰) | 本地计算 |
  244. | 4.7 | `etf_shares(date, exchange)` | ETF 份额(万份):上交所历史日期 / 深交所当前快照 | 上交所/深交所 |
  245. | 5.1 | `eastmoney_stock_news(code)` | 个股新闻 | 东财 |
  246. | 5.2 | `cls_telegraph()` | 财联社电报(7×24,本地签名零key) | 财联社 |
  247. | 5.3 | `eastmoney_global_news()` | 全球资讯(7×24) | 东财 |
  248. | 5.4 | `wallstreetcn_lives(channel, limit, cursor)` | 7×24 快讯(按频道,可翻页) | 华尔街见闻 |
  249. | 5.5 | `cctv_news(date, with_content=True)` | 新闻联播条目 + 文字稿(政策信号研究用) | 央视网 |
  250. | 6.1 | `tdx_client(check='finance').finance(symbol)` | 季报快照 37 字段 | 通达信 |
  251. | 6.2 | `tdx_client(check='finance').F10(symbol, name)` | F10 文本(2026-09 起服务端只剩「最新提示」一类) | 通达信 |
  252. | 6.3 | `eastmoney_stock_info(code)` | 行业/股本/市值/上市日期 | 东财 |
  253. | 6.4 | `sina_financial_report(code, type)` | 财报三表 | 新浪 |
  254. | 6.5 | `baostock_valuation_history(code, s, e)` | 估值历史 PE/PB/PS/PCF + 换手率 + 停牌 + ST(**不支持北交所**) | baostock |
  255. | 6.6 | `baostock_stock_basic(code)` | 上市日 / **退市日** / 状态 | baostock |
  256. | 6.7 | `sw_industry_history()` / `sw_industry_as_of(df, code, d)` | 申万行业**变迁史**(消除前视偏差,仅代码无中文名) | 申万 |
  257. | 6.8 | `st_stock_list()` | 沪深京 ST / *ST 当日名单 | 东财(baostock 兜底) |
  258. | 7.1 | `cninfo_announcements(code)` | 公告检索+PDF 下载 | 巨潮 |
  259. | 7.2 | `tdx_client(check='finance').F10(symbol, name='最新提示')` | 最新公告摘要 | 通达信 |
  260. | 8.1 | `em_zt_pool` / `em_zb_pool` / `em_dt_pool` / `em_yzt_pool` | 涨停/炸板/跌停/昨涨停四池 | 东财 |
  261. | 8.2 | `ths_limit_up_pool(date)` | 涨停原因题材+封板成功率+板型 | 同花顺 |
  262. | 8.3 | `limit_up_sentiment(date)` | 炸板率/连板高度/连板梯队 | 东财(四池组合) |
  263. | 8.4 | `em_stock_monitor()` | 重点监控池(风险警示名单+生效时间窗) | 东财 |
  264. | 8.5 | `em_price_anomaly()` / `em_price_anomaly_count()` | 日内异动明细 / 按标的聚合异动统计(严重异常波动) | 东财 |
  265. | 9.1 | `sina_option_codes` / `sina_option_tquote` / `sina_option_greeks` | ETF期权合约清单 / T型报价 / 希腊字母+IV | 新浪 |
  266. | 10.1 | `cninfo_irm(code)` | 互动易问答(提问+公司回复,深市) | 巨潮 |
  267. | 10.2 | `ths_hot_list()` / `em_hot_rank()` / `em_hot_concept(code)` | 热榜/人气榜/概念命中 | 同花顺+东财 |
  268. | 10.3 | `sse_e_interaction(code=None, kind='answered')` | 上证e互动问答(沪市) | 上证e互动(上交所运营) |
  269. | 11.1 | `pboc_social_financing(year)` | 社会融资规模增量(月度12列) | 人民银行 |
  270. | 11.2 | `nbs_pmi()` | 制造业/非制造业/综合 PMI + 大中小型企业 | 国家统计局 |
  271. | 11.3 | `chinabond_yield_curve(start, end, curve)` | 国债 / 银行 AAA / 中短票 AAA 收益率曲线 3月~30年 | 中债 |
  272. | 11.4 | `repo_fixing_rates(kind)` | 回购定盘利率 FR / FDR 001·007·014 | 中国货币网 |
  273. | 11.5 | `lpr_history()` | LPR 1 年 / 5 年全历史 | 东财 |
  274. | 11.6 | `macro_calendar(start, end, country, min_importance)` | 全球宏观日历(公布值/预期/前值) | 华尔街见闻 |
  275. | 12.1 | `index_constituents(index_code, provider)` | 最近公布的沪深北指数成分;csi/cni 显式选源 | 中证/国证 |
  276. | 12.2 | `index_weights(index_code, provider)` | 最近公布的指数权重(百分数),保留真实日期 | 中证/国证 |
  277. | 12.3 | `index_valuation(index_code)` | 两种口径 PE、股息率;不含 PB | 中证 |
  278. | 12.4 | `trading_calendar(year, month)` | 官方整月交易日历 | 深交所 |
  279. | 13.1 | `futures_daily(date, exchange)` | 期货日行情(SHFE/INE/CZCE/CFFEX/GFEX) | 五家期货交易所 |
  280. | 13.2 | `options_daily(date, exchange)` | 商品期权 / 股指期权日行情 + Delta / IV(中金所不公布这两项) | 五家期货交易所 |
  281. | 13.3 | `futures_position_rank(date, exchange, symbol)` | 会员成交 / 持买 / 持卖前 20 名 | 上期所/能源/郑商所/中金所 |
  282. | 13.4 | `futures_realtime(symbols)` | 实时期货(含大商所品种) | 新浪 |
  283. | 13.5 | `a50_futures()` | 富时中国 A50 期指 | 新浪 |
  284. | 13.6 | `sge_spot(instrument)` | 上海金交所现货日线(黄金/白银/铂金) | 上金所 |
  285. | 13.7 | `futures_kline(symbol, start, end)` | 期货日 K:单个合约 / 主力连续的逐日序列(含大商所) | 新浪 |
  286. | 14.1 | `earnings_forecast(code, report_date, limit)` | 业绩预告 | 东财 |
  287. | 14.2 | `institution_survey(code, start, end, detail, limit)` | 机构调研(汇总 / 逐机构) | 东财 |
  288. | 14.3 | `holder_trades(code, direction, start, end, limit)` | 股东增减持 | 东财 |
  289. | 14.4 | `share_buyback(code, progress, limit)` | 股票回购方案与进度 | 东财 |
  290. | 14.5 | `equity_pledge(code, date, limit)` | 股权质押比例(中国结算周度,仅沪深) | 东财 |
  291. | 14.6 | `ipo_calendar(limit)` | 新股申购日历 | 东财 |
  292. | 15.1 | `convertible_bonds(include_delisted=False)` | 可转债条款 + 转股价值 / 溢价率 | 东财 |
  293. | 官方备胎扩展 | `margin_trading_backup(date, exchange, code=None)` | 单所两融明细(先执行 §12 helper) | 上交所/深交所 |
  294. | 官方备胎扩展 | `bse_quote_backup(date, code=None)` | 北交所全板/单票当前快照(先执行 §12 helper) | 北交所 |
  295. | 备用源速查 | `dragon_tiger_backup` / `fund_flow_backup` / `announcements_backup` | 龙虎榜/资金流/公告官方备胎(主源被封时降级) | 交易所官方+新浪+东财(沪市公告) |
  296. | 估值公式 | `forward_pe` / `pe_digestion` / `calc_peg` / `full_valuation(code)` | 前向PE / PE消化时间 / PEG / 单票估值全景 | 本地计算 |
  297. ## 数据源优先级 & 东财防封(重要,先读)
  298. ### 优先级原则:能用腾讯 / 交易所官方,就别用东财
  299. | 优先级 | 数据源 | 协议 | 封 IP 风险 | 覆盖 |
  300. |--------|--------|------|-----------|------|
  301. | **1(首选)** | **腾讯财经** | HTTP | **不封 IP**(K 线单入口约 600 次后限流,§1.2 三入口轮换) | 实时价、PE/PB/市值/换手率/涨跌停、指数、ETF、日周月/分钟 K 线、当日逐笔 |
  302. | **2** | **交易所 / 官方机构** | HTTP | 极低(避免高频) | 通达信盘后包、沪深北交易所、五家期货交易所、上金所、中债、货币网、中证/国证 |
  303. | **3** | 新浪 / 巨潮 / 同花顺 / 华尔街见闻 | HTTP | 低 | 财报三表、复权因子、公告、一致预期/热点、研报列表、快讯 |
  304. | **4** | **mootdx(通达信)** | TCP 7709 二进制 | 不封 IP | 财务快照、F10 正常;**K 线 / 盘口 / 逐笔 2026-09 起返回空(#52)** |
  305. | **5(仅独有数据才用)** | **东财 eastmoney** | HTTP | **有风控,会封 IP** | 见下 |
  306. **凡是行情 / K线 / 实时价 / 市值 / 财务三表能从腾讯、交易所官方或新浪拿到的,一律走它们**——实测不封 IP,可放心使用(仍应控制频率)。
  307. ### 东财只用于它「独有、别处拿不到」的数据
  308. 下列能力默认走东财(须限流);已有交易所备胎的龙虎榜、两融可按文末速查表切换,不应视为东财独占:
  309. > 龙虎榜席位 · 全市场龙虎榜 · 限售解禁日历 · 融资融券 · 大宗交易 · 股东户数 · 分红送转 · 个股资金流向(分钟/日级)· 行业板块排名 · 研报列表/PDF · 个股新闻 · 全球资讯 · ST 名单 · LPR · 事件驱动(业绩预告/机构调研/增减持/回购/质押/新股)· 可转债
  310. ### 东财风控阈值(社区实测,2026-05)
  311. | 行为 | 触发封禁的阈值 | 风险 |
  312. |------|---------------|------|
  313. | 每秒请求数 | > 5 次/秒 | 高 |
  314. | 单 IP 并发连接 | ≥ 10 | 高 |
  315. | 1 分钟请求总数 | ≥ 200 次 | 中高 |
  316. | 5 分钟请求总数 | ≥ 300 次 | 触发封禁 |
  317. | User-Agent | 空 UA / 无浏览器特征 | 中 |
  318. 被封表现:连续请求后 `403` / `429` / 连接超时 / 返回空数据。临时封禁通常几分钟到几小时。
  319. ### ⚠️ 实测封禁案例(2026-06-30,一手数据,感谢 [@luodada99](https://github.com/luodada99) issue #36)
  320. 上表是社区口径;下面这条是**真实踩到 IP 级封禁**的完整记录,比阈值表更有参考价值:
  321. - **触发方式**:选股脚本 10 线程并发、**完全不走 `em_get()` 限流**,1 小时内发出 45000+ 请求(三个版本的脚本同时跑全市场 5208 只)
  322. - **后果**:`push2` / `push2his` **全系列** `RemoteDisconnected`,**IP 级封禁持续 20+ 小时**——不是"几分钟到几小时"那种临时限速
  323. - **关键观察一**:`datacenter-web.eastmoney.com` **不受影响**——东财不同子域走不同 WAF,`push2` 被封不代表整个东财都不能用
  324. - **关键观察二**:**腾讯 K 线(`web.ifzq.gtimg.cn`)连续 5000+ 次后会返回空**,但这是**限流不是封 IP**,降速或换新浪即可恢复
  325. - **降级实测**:东财被封时,第一只股票花 10.9s 完成"检测被封 + 降级",之后每只 0.4s 走腾讯,数据准确
  326. **这个案例正是「限流是铁律」的实证**:`em_get()` 的默认间隔(1s + 抖动、串行)下,1 小时最多约 3000 次请求,与踩坑者的 45000 次差一个数量级。
  327. **被封后的降级路径**(各层备胎详见「备用源速查」章节):
  328. | 被封端点 | 替代方案 | 差异 |
  329. |---|---|---|
  330. | `push2/clist/get`(股票列表) | `datacenter-web` + 腾讯行情批量 | 行业字段来自 datacenter 的 `BOARD_NAME` |
  331. | `push2his/kline/get`(K线) | 腾讯 `fqkline/get`(前复权)→ 新浪 `getKLineData`(不复权) | 腾讯有前复权,新浪没有;量的单位新浪是股,腾讯科创板是股、其余是手(见 §1.2) |
  332. | `push2/stock/get`(个股) | 腾讯 `qt.gtimg.cn` | 腾讯无行业/概念字段 |
  333. ### 防封铁律(调用东财时必须遵守)
  334. 1. **串行,不并发**——绝不对东财开多线程/协程并发请求
  335. 2. **每次间隔 ≥ 1 秒 + 随机抖动**(QPS ≤ 2),批量筛选时调大到 1.5~2 秒
  336. 3. **复用 HTTP 会话**(Keep-Alive),不要每次新建连接
  337. 4. **带正常 UA + Referer**(本 SKILL 各端点已配好)
  338. 5. **批量场景每只股票之间 sleep**——AI 跑批量循环(如筛选 100 只股逐个拉龙虎榜/资金流)是被封的头号元凶
  339. ### 已内置限流:所有东财请求走 `em_get()`
  340. 本 SKILL 提供统一的节流入口 `em_get()`(定义见下方「东财数据中心统一查询(共用 helper)」),它自动做到:串行限流(最小间隔 `EM_MIN_INTERVAL=1.0s` + 随机抖动)+ 复用 `EM_SESSION`(Keep-Alive)+ 默认 UA。**所有 `eastmoney.com` 端点的代码块都已改用 `em_get` 而非裸 `requests.get`**,AI 直接抄代码即自带防封。批量任务把 `EM_MIN_INTERVAL` 调大即可进一步降速。
  341. > 注:`em_get` / `EM_SESSION` / `EM_MIN_INTERVAL` 是所有东财代码块共用的前置定义,使用任一东财端点前需先执行「共用 helper」代码块。
  342. ---
  343. ## When to Activate
  344. - 用户需要**指数成分、指数权重、指数 PE / 股息率、官方交易日历、沪深官方两融或北交所行情备份**(V3.8)。
  345. - 用户要看**商品期货 / 期权 / 持仓排名 / A50 / 黄金现货**,或**业绩预告 / 机构调研 / 增减持 / 回购 / 股权质押 / 新股申购 / 可转债**,
  346. 或**国债收益率曲线 / 回购利率 / LPR / 全球宏观日历**、**ETF 份额**、**ST 名单**、**新闻联播**、**沪市互动问答**、**全市场当日日线**(V3.9)。
  347. - 用户要把代码转成**聚宽格式**(`600519.XSHG`)或问**能否回测**(V3.9,见 FAQ)。
  348. - 用户要查 A 股个股估值(一致预期 / PE / PEG / PE消化)
  349. - 用户要拉实时行情(价格 / 五档盘口 / K线 / 涨跌停价)
  350. - 用户要搜研报(按主题 / 按标的 / 按行业 / 下载PDF)
  351. - 用户要看**当日强势股 / 题材归因 / 概念热点**
  352. - 用户要看**北向资金动向**(沪股通/深股通分钟流向)
  353. - 用户要看**概念板块归属**(行业/概念/地域)
  354. - 用户要看**个股资金流向**(主力/散户/超大单/大单分钟级)
  355. - 用户要看**龙虎榜席位**(营业部 + 机构买卖)
  356. - 用户要看**全市场龙虎榜**(当日所有上榜股票 + 净买额排名)
  357. - 用户要看**限售解禁日历**(历史解禁 + 未来待解禁)
  358. - 用户要做**行业横向对比**(涨跌排名 / 资金流入 / 领涨股)
  359. - 用户要看**融资融券 / 两融数据**(融资余额 + 融券余额)
  360. - 用户要看**大宗交易**(成交价/量 + 买卖方营业部)
  361. - 用户要看**股东户数变化**(筹码集中度)
  362. - 用户要看**分红送转历史**(每股派息 + 送股 + 转增)
  363. - 用户要看**指数/ETF行情**(上证指数 / 沪深300 / 创业板指 / ETF)
  364. - 用户要看**涨停 / 打板情绪**(涨停池 / 连板梯队 / 炸板率 / 跌停 / 涨停原因题材)
  365. - 用户要看**ETF 期权**(T型报价 / 希腊字母 Delta·Gamma·Theta·Vega / 隐含波动率 IV)
  366. - 用户要看**投资者互动问答**(公司如何回应某传闻/利好 · 互动易)
  367. - 用户要看**市场热度 / 人气榜**(同花顺热榜 / 东财人气榜 / 个股概念命中)
  368. - 用户要看新闻资讯(个股新闻 / 财联社快讯 / 全球资讯)
  369. - 用户要查公告(巨潮公告全文)
  370. - 用户要做产业链调研 / 批量横向对比
  371. - 关键词:估值、一致预期、机构预测、市盈率、PEG、市值、研报、产业链、行业研究、K线、盘口、公告、新闻、**强势股、题材、热点、概念归因、北向资金、沪股通、深股通、概念板块、资金流向、主力、龙虎榜、席位、营业部、全市场龙虎榜、净买入、解禁、限售、行业对比、行业轮动、融资融券、两融、大宗交易、股东户数、筹码集中、分红、派息、送股、指数、ETF、涨停、打板、连板、炸板、跌停、涨停原因、封板、晋级率、ETF期权、希腊字母、隐含波动率、互动易、投资者关系、热榜、人气榜、市场热度、期货、商品期权、股指期权、持仓排名、A50、黄金、上海金、业绩预告、机构调研、增减持、回购、股权质押、新股申购、打新、可转债、转股溢价率、国债收益率、收益率曲线、回购利率、FR007、LPR、宏观日历、ETF份额、ST、新闻联播、上证e互动、聚宽、回测**
  372. ---
  373. ## Prerequisites
  374. ```bash
  375. pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl
  376. ```
  377. | 依赖 | 版本要求 | 用途 |
  378. |------|---------|------|
  379. | mootdx | >= 0.10 | TCP 财务快照+F10(非 HTTP 依赖之一;K 线/盘口/逐笔 2026-09 起返回空,#52);0.11.x 用 `tdx_client()` 规避 BESTIP bug,见下节 |
  380. | requests | any | 所有HTTP API直连 |
  381. | pandas | any | 数据处理+HTML表格解析 |
  382. | stockstats | any | 技术指标计算(RSI/MACD/BOLL等) |
  383. | numpy | any | §4.6 筹码分布的网格计算 |
  384. | baostock | >= 0.8 | §6.5/§6.6 估值历史·换手率·停牌·ST·退市日,§6.8 ST 名单兜底(TCP,免注册免 key;**不支持北交所**) |
  385. | xlrd | >= 2.0 | 读 `.xls`(§6.7 申万行业分类、§12 中证) |
  386. | openpyxl | any | 读 `.xlsx`(§11.1 社融、§12 国证、深交所两融) |
  387. > **架构:** 除 mootdx 与 baostock(均为 TCP 客户端库)外,所有数据源均为直连 HTTP API,不经第三方数据封装。每个 HTTP 端点的底层 URL/参数完全暴露,方便调试和定制。
  388. ### iwencai API Key(仅语义搜索需要)
  389. ```bash
  390. # 环境变量方式
  391. export IWENCAI_API_KEY="your_key_here"
  392. export IWENCAI_BASE_URL="https://openapi.iwencai.com"
  393. # 申请地址: https://www.iwencai.com/skillhub
  394. # 注册后安装 SkillHub CLI,再安装 report-search 技能即可获得 Key
  395. ```
  396. 其他数据源(腾讯 / 东财 / 同花顺 / 百度股市通 / 新浪 / 巨潮 / 财联社 / mootdx / baostock / 申万 / 人民银行 / 国家统计局 / 沪深北交易所 / 中证 / 国证 / 通达信官网 / 华尔街见闻 / 央视网 / 中债 / 中国货币网 / 五家期货交易所 / 上金所)全部免费,无需 key。
  397. ### mootdx 客户端(必读,规避 0.11.x BESTIP 空串 bug)
  398. > **已知 bug(mootdx 0.11.x):** 全新安装后 `Quotes.factory(market='std')` 裸调用可能抛 `ValueError: not enough values to unpack (expected 2, got 0)`。
  399. > 根因:`~/.mootdx/config.json` 的 `BESTIP.HQ` 初始是空字符串 `""`(不是缺失键),mootdx 用 `dict.get(key, default)` 取不到 default,拆包失败。**老用户(config 曾填充过 IP)不会触发,所以容易漏测。**
  400. > **不要靠锁版本解决:** 锁 `mootdx==0.10.12` 在部分环境(如干净的 Python 3.9)下 `import mootdx` 会因 numpy/pandas 二进制不兼容直接崩。正确做法是用下面的 `tdx_client()`——显式传 server 绕过 BESTIP,对 0.10 / 0.11 都适用。
  401. **统一用以下 helper 创建客户端(所有 mootdx 调用都走它):**
  402. ```python
  403. import socket
  404. from mootdx.quotes import Quotes
  405. # 实测可用的备选服务器(按延迟排序,2026-06 验证)
  406. _TDX_SERVERS = [
  407. ('119.97.185.59', 7709), ('124.70.133.119', 7709), ('116.205.183.150', 7709),
  408. ('123.60.73.44', 7709), ('116.205.163.254', 7709), ('121.36.225.169', 7709),
  409. ('123.60.70.228', 7709), ('124.71.9.153', 7709), ('110.41.147.114', 7709),
  410. ('124.71.187.122', 7709),
  411. ]
  412. def _probe(ip, port, timeout=2.0):
  413. """TCP 握手探测(快速粗筛)。注意:握手成功 ≠ 能取数,必须再经 _validate 验活。"""
  414. try:
  415. with socket.create_connection((ip, port), timeout=timeout):
  416. return True
  417. except Exception:
  418. return False
  419. def _validate(client, market: str = 'std', check: str = 'bars') -> bool:
  420. """真实取数验活:坏服务器可 TCP 握手通过却回 2 字节空 body → 静默空表。用一次真实请求兜底。
  421. check='bars' :用 K 线请求验活(§1.7 行情类调用);
  422. check='finance':财务快照、F10 类别表里的「最新提示」及其正文都要取到才算活(§6.1 财务 / §6.2、§7.2 F10 调用),
  423. 只验财务会选中「财务正常、F10 为空」的服务器,F10 随后静默给空文本;
  424. 只看类别表非空,又会放过只回别的类别或畸形对象的服务器。
  425. 两者要分开:2026-09 起通达信公开服务器的行情类命令(bars / quotes / transaction)普遍返回空表,
  426. 而 finance / F10「最新提示」/ 除权除息仍正常(#52)。财务类调用若仍用 K 线验活,会被误判成「全部不可达」。
  427. 验活样本 '000001' 是 A 股代码,只对 market='std' 有意义。其它市场(如扩展行情 'ext')
  428. 用它必然取不到数,会把所有正常服务器都判死、误报「全部不可达」,故非 std 时跳过验活。
  429. """
  430. if market != 'std':
  431. return True
  432. try:
  433. if check == 'finance':
  434. cats = client.F10C(symbol='000001')
  435. if not any(isinstance(c, dict) and c.get('name') == '最新提示' for c in cats):
  436. return False
  437. text = client.F10(symbol='000001', name='最新提示')
  438. if not isinstance(text, str) or not text.strip():
  439. return False
  440. df = client.finance(symbol='000001')
  441. else:
  442. df = client.bars(symbol='000001', frequency=9, offset=1)
  443. return df is not None and not df.empty
  444. except Exception:
  445. return False
  446. def tdx_client(market='std', check='bars'):
  447. """
  448. 创建 mootdx 客户端,规避 0.11.x BESTIP.HQ 空串 bug + 坏服务器静默空表(#43)。
  449. check: 'bars'(默认,K 线 / 盘口 / 逐笔)或 'finance'(财务快照 / F10),决定用哪类请求验活(#52)。
  450. 每个候选都必须「真实取数验活」通过才采用(_probe TCP 握手是假阳性来源):
  451. 1) 顺序探测 _TDX_SERVERS,对 probe 通过者再 _validate 真实取数,取第一个验活成功的;
  452. 2) 全部失败 → 回退 mootdx 自带 bestip 测速选优(同样验活);
  453. 3) 再回退裸 factory(老用户 config 已有可用 BESTIP 时成立);
  454. 4) 仍失败 → 抛 RuntimeError,明确报错而非静默返回空表 / 崩溃。
  455. """
  456. if check not in ('bars', 'finance'):
  457. raise ValueError("check 只能是 'bars' 或 'finance'")
  458. for ip, port in _TDX_SERVERS:
  459. if not _probe(ip, port):
  460. continue
  461. try:
  462. c = Quotes.factory(market=market, server=(ip, port))
  463. if _validate(c, market, check):
  464. return c
  465. except Exception:
  466. continue # 握手过但取数崩 → 跳过下一台
  467. for kwargs in ({'bestip': True}, {}): # fallback: bestip 测速 / 裸 factory
  468. try:
  469. c = Quotes.factory(market=market, **kwargs)
  470. if _validate(c, market, check):
  471. return c
  472. except Exception:
  473. continue
  474. hint = ("海外网络通常全部超时(TCP 7709),请走国内代理或更新 _TDX_SERVERS 列表。")
  475. if check == 'bars':
  476. hint += ("若国内网络也如此:2026-09 起通达信公开服务器的 K 线 / 盘口 / 逐笔命令普遍返回空(#52),"
  477. "K 线改用 §1.2 tencent_kline()(日周月 + 1~60 分钟)或 §1.3 tdx_daily_package()"
  478. "(全市场当日日线含成交额),逐笔改用 §1.4 tencent_ticks()(当日);"
  479. "财务与 F10 用 tdx_client(check='finance') 仍可取。")
  480. raise RuntimeError("所有 mootdx 服务器均无法取到数据(TCP 可达但返回空 / 被 reset)。" + hint)
  481. # 用法:client = tdx_client() # K 线 / 盘口 / 逐笔(#52:目前普遍取不到,见 §1.7 警告)
  482. # client = tdx_client(check='finance') # 财务快照 / F10(正常)
  483. ```
  484. > **海外 IP 用户:** mootdx 走通达信 TCP 7709,海外环境通常全部超时。`tdx_client()` 会快速失败给出明确报错,而非死等。
  485. >
  486. > **⚠️ 行情命令失效(#52,2026-09-20 实测):** 内置 10 台服务器逐台测试,TCP 均可达,`finance` / `xdxr` 正常、
  487. > `F10` 只剩「最新提示」一类(见 §6.2),但 `bars` / `quotes` / `transaction` 全部返回 0 行。财务与 F10 调用请传 `check='finance'`;
  488. > K 线改走 §1.2 腾讯 / §1.3 通达信盘后包,实时价与五档走 §1.1 腾讯,当日逐笔走 §1.4 腾讯。
  489. ### 市场前缀规则(全局通用)
  490. ```python
  491. # 沪市指数白名单:与深市 000xxx 个股同段,需白名单区分(沪深300/上证50/中证500/科创50/中证1000/上证180)
  492. SH_INDEX = {"000300", "000905", "000016", "000688", "000852", "000010"}
  493. def get_prefix(code: str) -> str:
  494. """6位代码 → 市场前缀(sh/sz/bj)。支持显式前缀/后缀(sh000016 / 000016.SH)透传以解决歧义。"""
  495. c = code.lower().strip()
  496. if c.endswith((".sh", ".sz", ".bj")): # 后缀写法与前缀等价:000016.SH ≡ sh000016。
  497. return c[-2:] # 不认后缀会让 000016.SH 落到默认深市 → 静默查成深康佳A
  498. if c.endswith((".xshg", ".xshe")): # 聚宽写法(#55):.XSHG=上交所 / .XSHE=深交所,000001.XSHG=上证指数
  499. return "sh" if c.endswith(".xshg") else "sz"
  500. if c.startswith(("sh", "sz", "bj")): # 显式前缀透传(如 sh000001=上证指数 vs sz000001=平安银行)
  501. return c[:2]
  502. if c.startswith("92"): # 北交所 2024-10 起的新股号段,必须先于下面的 9x 判断
  503. return "bj"
  504. if c.startswith(("5", "6", "9")): # 5x=沪 ETF/LOF,6/9=沪个股(900xxx=沪 B 股)
  505. return "sh"
  506. if c.startswith(("4", "8")): # 4x/8x=北交所【老号段,多数已迁 920,见下方警告】
  507. return "bj"
  508. if c in SH_INDEX: # 沪深300/上证50 等沪指数(000xxx)
  509. return "sh"
  510. return "sz" # 深市个股/ETF(00/30/15x/16x/159 等),深指数 399xxx 亦走 sz
  511. ```
  512. > **歧义说明:** `000001` 默认按个股→`sz000001`(平安银行);要上证指数请显式传 `sh000001`。`000016` 默认按沪指数→上证50;要深康佳A 请传 `sz000016`。
  513. > ### ⚠️ 北交所老号段(43/83/87)已基本作废 — 会拿到僵尸数据且不报错
  514. >
  515. > **2026-07-31 实测:** 东财北交所在市 342 只中 **336 只已是 `920xxx` 号段**,仅剩 3 只老码且全部停牌。存量公司代码已整体迁移(如 锦波生物 `832982`→`920982`、贝特瑞 `835185`→`920185`)。
  516. >
  517. > **危险在于老码不会报错,而是返回看似正常的脏数据:**
  518. >
  519. > | 接口 | 传老码 `832982` | 传新码 `920982` |
  520. > |------|----------------|----------------|
  521. > | 腾讯行情 | 返回 **112.60、成交量 0**(定格在迁移日) | 131.74,正常成交 ✅ |
  522. > | 腾讯行情(贝特瑞) | `835185` → 45.91、成交量 0 | `920185` → 21.05 ✅ |
  523. > | 东财研报 | **0 篇**(静默空) | 79 篇 ✅ |
  524. >
  525. > 老码行情价与真实价可差 17%~100%+,直接拿去算估值会得出完全错误的结论。
  526. >
  527. > **判定僵尸报价:** `成交量 == 0 且 最新价 == 昨收` → 极可能是已迁移的废码(真停牌股同样满足,两者都不该用于估值)。`tencent_quote()` 已内置该检测并置 `is_stale` 标志,见 §1.1。
  528. >
  529. > **拿新码:** 用 `push2` 北交所全量清单 `fs=m:0+t:81+s:2048` 按名称反查现行代码。
  530. ### Ticker 格式归一化
  531. `norm_ticker()` 把下列写法统一成纯 6 位数字:
  532. > ⚠️ **不是所有端点都自动归一化**(V3.6.0 前这里写的是「所有接口统一支持」,与实现不符,已改正)。
  533. > - **已内置归一化**:§2.1 `eastmoney_reports()`、§2.2 `ths_eps_forecast()`。
  534. > - **只认纯 6 位或显式 `sh`/`sz`/`bj` 前缀**(其余端点):`tencent_quote()` 等走 `get_prefix()` 路由的函数
  535. > 支持 `600519` 和 `sh600519`,但**不认后缀式** `600519.SH`——实测会拼成 `sh600519.SH` 并返回空载荷(静默失败)。
  536. > - **结论**:拿到用户输入的代码,**先过一遍 `norm_ticker()` 再传给任何端点**,最省事也最安全。
  537. > 例外:输入本身带市场信息且落在 000 歧义段(`000001.SH` / `000001.XSHG` = 上证指数)时,`norm_ticker()` 会丢掉市场,
  538. > 应改用 `get_prefix(c) + norm_ticker(c)` 得到 `sh000001` 再传。聚宽代码互转见下方 `to_joinquant()`(#55)。
  539. | 输入 | 归一化结果 |
  540. |------|-----------|
  541. | `688017` | `688017` |
  542. | `SH688017` / `sh688017` | `688017` |
  543. | `688017.SH` / `688017.sh` | `688017` |
  544. | `SZ000001` | `000001` |
  545. | `BJ920982` | `920982` |
  546. | `600519.XSHG` / `000001.XSHE`(聚宽写法,#55) | `600519` / `000001` |
  547. ```python
  548. import re
  549. # 整串锚定匹配,只认下表列出的写法;市场标识前缀、后缀**二选一,不能同时出现**。
  550. # ⚠️ 两个坑都会造成「静默拿到另一只股票的数据」,比报错危险得多:
  551. # ① 别用 re.search(r"\d{6}") 从任意串里"捞"6 位:"6005190"/"foo600519bar" 会被截成 600519。
  552. # ② 别让前后缀同时可选:`SH000001.SZ` 这种自相矛盾的写法会被照单全收,
  553. # 而 000001 恰是歧义码(sh000001=上证指数 / sz000001=平安银行),静默丢掉市场信息=选错标的。
  554. # 捕获组:1=前缀市场 2=前缀式代码 | 3=后缀式代码 4=后缀市场
  555. # 市场标识要**同时**从前缀和后缀取——只认 startswith("sh") 会漏掉 `000001.SH` 这种后缀写法。
  556. _TICKER_RE = re.compile(
  557. r"^(?:(sh|sz|bj)(\d{6})|(\d{6})(?:\.(sh|sz|bj|xshg|xshe))?)$", re.IGNORECASE)
  558. _JQ_SUFFIX = {"xshg": "sh", "xshe": "sz"} # 聚宽后缀 → 市场(#55);聚宽未公开北交所后缀,不猜
  559. def _natural_market(digits: str) -> str:
  560. """6 位码的自然归属市场。仅用于校验显式前缀是否自相矛盾。
  561. 注意 000xxx 是沪指数/深个股共用的歧义段,由调用处单独处理,不走这里。"""
  562. if digits.startswith(("4", "8", "92")):
  563. return "bj" # 北交所:与 get_prefix() 同一套号段规则(92x 现行 / 4x·8x 老号段,#51)
  564. if digits[0] in ("5", "6", "9"):
  565. return "sh" # 5x 沪 ETF/LOF,6xx 沪个股,9xx 沪 B 股
  566. return "sz" # 00x/30x/15x/16x/39x 等
  567. def norm_ticker(code: str, stock_only: bool = False) -> str:
  568. """任意受支持写法 → 纯 6 位数字代码。
  569. 支持 600519 / SH600519 / sh600519 / 600519.SH / BJ920982 等。
  570. stock_only=True:个股专用接口(研报、一致预期等)传这个,会拒绝显式指数写法。
  571. ⚠️ 不匹配时**抛 ValueError,绝不静默返回空串或猜一个代码**——
  572. 否则调用方会把「代码格式写错」误读成「这只票没有数据」,
  573. 或者更糟:拿到另一只股票的数据还以为是对的。
  574. """
  575. raw = str(code).strip()
  576. m = _TICKER_RE.match(raw)
  577. if not m:
  578. raise ValueError(
  579. f"无法把 {code!r} 解析为 6 位股票代码;"
  580. f"支持格式:600519 / SH600519 / sh600519 / 600519.SH / 600519.XSHG(聚宽)"
  581. f"(前缀与后缀二选一,不能同时写)"
  582. )
  583. digits = m.group(2) or m.group(3)
  584. market = (m.group(1) or m.group(4) or "").lower() # 前缀式与后缀式都要认
  585. market = _JQ_SUFFIX.get(market, market) # 600519.XSHG ≡ 600519.SH
  586. # 归一化会丢掉市场标识,若标识与号段矛盾就会静默落到另一只票上,必须在这里拦。
  587. if market:
  588. if digits.startswith("000"):
  589. # 000xxx 是**沪市指数 / 深市个股共用**的歧义段,显式标识在这里是「消歧」不是「矛盾」:
  590. # sh000001=上证指数 vs sz000001=平安银行;sh000016=上证50 vs sz000016=深康佳A。
  591. if market == "bj":
  592. raise ValueError(f"{code!r} 市场标识与号段矛盾:000xxx 不属北交所。")
  593. # 沪市个股只有 600/601/603/605/688/689(B 股 900),**不存在 000xxx 沪市个股**,
  594. # 所以「显式 sh + 000 段」必然是指数。实测不拦的话:sh000001→平安银行研报 100 篇、
  595. # sh000016→深康佳A、sh000039→中集集团 84 篇,全是别人的数据。
  596. if stock_only and market == "sh":
  597. raise ValueError(
  598. f"{code!r} 指向沪市指数而非个股(沪市无 000xxx 个股),本接口只服务个股。"
  599. f"要查同号段的深市个股请显式传 sz{digits}。"
  600. )
  601. else:
  602. nat = _natural_market(digits)
  603. if market != nat:
  604. raise ValueError(
  605. f"{code!r} 的市场标识与号段矛盾:{digits} 属 {nat} 市,而不是 {market} 市。"
  606. f"(改用 {nat}{digits} 或去掉市场标识)"
  607. )
  608. return digits
  609. # 用法
  610. norm_ticker("SH600519") # '600519'
  611. norm_ticker("600519.SH") # '600519'
  612. norm_ticker("bj920982") # '920982'
  613. norm_ticker("6005190") # ValueError(7 位,不会被截成 600519)
  614. norm_ticker("茅台") # ValueError
  615. norm_ticker("SH000001.SZ") # ValueError(前后缀矛盾,不猜市场)
  616. norm_ticker("SH000001", stock_only=True) # ValueError(上证指数,不是平安银行)
  617. norm_ticker("000001.SH", stock_only=True) # ValueError(后缀写法同样拦下)
  618. norm_ticker("SZ600519") # ValueError(600519 是沪市,标识矛盾)
  619. norm_ticker("sz000016") # '000016'(深康佳A,000 段的显式消歧,合法)
  620. norm_ticker("600519.XSHG") # '600519'(聚宽写法,#55)
  621. norm_ticker("600519.XSHE") # ValueError(600519 是沪市,聚宽后缀同样校验)
  622. def em_market_code(code: str) -> int:
  623. """东财 secid 的市场号:**沪=1,深/北=0**(V3.7.0 新增 · #46)。
  624. ⚠️ 绝不要用 `code.startswith("6")` 判市场 —— 那会把**沪市 ETF(51x)**、
  625. **科创板 ETF(588x)**、**沪 B 股(900x)** 全部错判成深市,接口返回 `data: null`。
  626. 2026-08-19 实测:510300 / 588000 / 600519 / 688112 / 900901 → m=1;
  627. 300750 / 159915 / 920982 / 832982 → m=0(北交所与深市共用 m=0)。
  628. """
  629. return 1 if get_prefix(code) == "sh" else 0
  630. def em_secid(code: str) -> str:
  631. """东财 push2/push2his 的 secid,如 `1.600519` / `0.300750`。"""
  632. return f"{em_market_code(code)}.{norm_ticker(code)}"
  633. def to_joinquant(code: str) -> str:
  634. """任意受支持写法 → 聚宽代码,如 `600519.XSHG` / `000001.XSHE`(#55)。
  635. 000 段歧义码按 get_prefix() 的规则走:`to_joinquant("sh000001")` → `000001.XSHG`(上证指数),
  636. `to_joinquant("000001")` → `000001.XSHE`(平安银行)。反方向(聚宽 → 本 Skill)用
  637. `get_prefix(c) + norm_ticker(c)` 得到 `sh000001` 这类显式前缀写法,再传给各端点。
  638. 北交所:聚宽公开文档与 jqdatasdk 源码(2026-09-20 查)只有 .XSHG / .XSHE,没查到北交所后缀,抛 ValueError 不猜。
  639. """
  640. digits, market = norm_ticker(code), get_prefix(code)
  641. if market == "bj":
  642. raise ValueError(f"{code!r} 是北交所证券;聚宽公开文档未给出北交所后缀,不做转换")
  643. return f"{digits}.{'XSHG' if market == 'sh' else 'XSHE'}"
  644. ```
  645. ### 东财数据中心统一查询(共用 helper)
  646. 龙虎榜/解禁/融资融券/大宗交易/股东户数/分红 共用同一 base URL:
  647. ```python
  648. import time
  649. import random
  650. import requests
  651. UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
  652. DATACENTER_URL = "https://datacenter-web.eastmoney.com/api/data/v1/get"
  653. # ── 东财防封:全局节流 + 会话复用 ────────────────────────────────────
  654. # 东财系 HTTP 接口(push2 / datacenter / reportapi / search / np-weblist)有风控:
  655. # 每秒 >5 次 / 单 IP 并发 ≥10 / 1 分钟 ≥200 次 → 临时封 IP。
  656. # 所有 eastmoney.com 请求一律走 em_get():串行限流(最小间隔 + 随机抖动)+ 复用
  657. # Keep-Alive 会话,批量调用时自动降速,避免被封。详见「数据源优先级 & 东财防封」章节。
  658. EM_SESSION = requests.Session()
  659. EM_SESSION.headers.update({"User-Agent": UA})
  660. # 连接级自动重试:瞬态连接错误 / 429 / 5xx 指数退避重试(住宅IP偶发风控更稳)。
  661. # 注意:403 不重试(东财风控信号,重试无益反而加重;按下方 EM_MIN_INTERVAL 降频应对)。
  662. try:
  663. from requests.adapters import HTTPAdapter
  664. from urllib3.util.retry import Retry
  665. _em_adapter = HTTPAdapter(max_retries=Retry(
  666. total=3, connect=3, backoff_factor=0.6,
  667. status_forcelist=[429, 500, 502, 503, 504], allowed_methods=["GET"]))
  668. EM_SESSION.mount("https://", _em_adapter)
  669. EM_SESSION.mount("http://", _em_adapter)
  670. except Exception:
  671. pass # 老版本 urllib3 缺 allowed_methods 等参数时降级为无重试,不影响主流程
  672. from typing import Optional # 3.9 兼容:不能写 `dict | None`(那是 3.10+ 语法)
  673. EM_MIN_INTERVAL = 1.0 # 两次东财请求最小间隔(秒);批量筛选建议调大到 1.5~2
  674. _em_last_call = [0.0] # 模块级上次请求时间戳
  675. def em_get(url: str, params: Optional[dict] = None, headers: Optional[dict] = None,
  676. timeout: int = 15, **kwargs):
  677. """东财统一请求入口:自动节流 + 复用 session + 默认 UA。
  678. 所有 eastmoney.com 接口都应通过它请求,避免高频被封 IP。"""
  679. wait = EM_MIN_INTERVAL - (time.time() - _em_last_call[0])
  680. if wait > 0:
  681. time.sleep(wait + random.uniform(0.1, 0.5))
  682. try:
  683. return EM_SESSION.get(url, params=params, headers=headers, timeout=timeout, **kwargs)
  684. finally:
  685. _em_last_call[0] = time.time()
  686. def eastmoney_datacenter(report_name: str, columns: str = "ALL",
  687. filter_str: str = "", page_size: int = 50,
  688. sort_columns: str = "", sort_types: str = "-1") -> list[dict]:
  689. """东财数据中心统一查询 — 龙虎榜/解禁/融资融券/大宗交易/股东户数/分红 共用(已内置限流)"""
  690. params = {
  691. "reportName": report_name, "columns": columns,
  692. "filter": filter_str, "pageNumber": "1", "pageSize": str(page_size),
  693. "sortColumns": sort_columns, "sortTypes": sort_types,
  694. "source": "WEB", "client": "WEB",
  695. }
  696. r = em_get(DATACENTER_URL, params=params, timeout=15)
  697. d = r.json()
  698. if d.get("result") and d["result"].get("data"):
  699. return d["result"]["data"]
  700. return []
  701. ```
  702. ### V3.9.0 共用 helper(§1.2 腾讯 K 线起的所有 V3.9.0 / V3.10.0 新端点都依赖它)
  703. 先执行上面的 `get_prefix` / `norm_ticker` / 东财 `em_get` 代码块,再执行本块。V3.9.0 新端点统一返回 DataFrame,
  704. 末尾附 `source` / `source_url` / `fetched_at` 三列。**「确实没有数据」与「接口坏了」分开处理**:前者返回空表或抛
  705. `ValueError`(非交易日、日期太早),后者抛 `RuntimeError`(结构改变、重复行、全市场 0 行),不把错误页当空结果。
  706. 东财请求一律经 `em_get()` 限流;`_em_datacenter_strict()` 与旧 `eastmoney_datacenter()` 的区别是会翻页、并把错误码抛出来。
  707. <!-- v39-helpers:start -->
  708. ```python
  709. import functools
  710. import math
  711. import re
  712. from datetime import date as _date_cls, datetime, timezone
  713. import pandas as pd
  714. import requests
  715. V39_UA = ("Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 "
  716. "(KHTML, like Gecko) Chrome/126.0 Safari/537.36")
  717. # 一次要翻几十页(§1.4 腾讯逐笔)或偶尔握手卡住(§13.7 新浪期货日 K)的请求走这个会话:复用连接,
  718. # 连接失败、握手或等响应头超时、429 / 5xx 指数退避重试(写法同 EM_SESSION);读响应体中途超时不重试,
  719. # 也不按服务端给的 Retry-After 等待。
  720. V39_RETRY_SESSION = requests.Session()
  721. try:
  722. from requests.adapters import HTTPAdapter
  723. from urllib3.util.retry import Retry
  724. _v39_retry_adapter = HTTPAdapter(max_retries=Retry(
  725. total=3, connect=3, backoff_factor=0.6, respect_retry_after_header=False,
  726. status_forcelist=[429, 500, 502, 503, 504], allowed_methods=["GET"]))
  727. V39_RETRY_SESSION.mount("https://", _v39_retry_adapter)
  728. V39_RETRY_SESSION.mount("http://", _v39_retry_adapter)
  729. except Exception:
  730. # 老版本 urllib3(< 1.26)缺 allowed_methods:不重试,也不复用连接(复用的连接被服务端断开时没有重试兜底),同 v3.10.0
  731. V39_RETRY_SESSION = None
  732. def _v39_http(url, params=None, data=None, headers=None, method="GET", timeout=(10, 40),
  733. allow_status=(), allow_redirects=True, session=None):
  734. """非东财的 HTTP 请求:带浏览器 UA。网络错误、非 2xx 一律抛 RuntimeError(不把错误页当数据);
  735. allow_status 里的状态码(源用 404 表示「当天没发布」时)原样返回,由调用方判断。
  736. session:传 V39_RETRY_SESSION 复用连接并自动重试(哪些情况重试见它的定义);不传每次新建连接、不重试。"""
  737. merged = {"User-Agent": V39_UA}
  738. merged.update(headers or {})
  739. try:
  740. response = (session or requests).request(method, url, params=params, data=data, headers=merged,
  741. timeout=timeout, allow_redirects=allow_redirects)
  742. if response.status_code not in allow_status:
  743. response.raise_for_status()
  744. except requests.RequestException as exc:
  745. raise RuntimeError(f"请求 {url} 失败: {type(exc).__name__}: {exc}") from exc
  746. return response
  747. def _v39_json(response):
  748. """解析 JSON;不是 JSON 抛 RuntimeError。json 的解析错误是 ValueError 的子类,
  749. 不转换会被调用方当成「确实没有数据」。"""
  750. try:
  751. return response.json()
  752. except ValueError as exc:
  753. raise RuntimeError(f"{getattr(response, 'url', '')} 返回的不是 JSON,可能是错误页") from exc
  754. def _v39_date(value):
  755. """'2026-09-18' / '20260918' / date 对象 → '2026-09-18';其他写法抛 ValueError。"""
  756. if isinstance(value, datetime):
  757. return value.date().isoformat()
  758. if isinstance(value, _date_cls):
  759. return value.isoformat()
  760. text = str(value).strip()
  761. fmt = "%Y%m%d" if re.fullmatch(r"[0-9]{8}", text) else "%Y-%m-%d"
  762. return datetime.strptime(text, fmt).date().isoformat()
  763. def _v39_src_date(value):
  764. """来源返回的日期 → 'YYYY-MM-DD';认不出抛 RuntimeError(源格式变了,不是参数写错)。"""
  765. try:
  766. return _v39_date(value)
  767. except ValueError as exc:
  768. raise RuntimeError(f"来源返回了无法识别的日期 {value!r}") from exc
  769. def _v39_num(value):
  770. """'1,234.50' → 1234.5;空串 / '-' / '--' / None → None;其他非数字抛 RuntimeError
  771. (来源给了认不出的值是「源的格式变了」,不能和参数错误的 ValueError 混在一起)。
  772. JSON 布尔值同样抛错:float(True)=1.0 会把格式错误静默写成价格 / 成交量。"""
  773. if value is None:
  774. return None
  775. if isinstance(value, bool):
  776. raise RuntimeError(f"来源在数值字段给了布尔值 {value!r}")
  777. if isinstance(value, (int, float)):
  778. if isinstance(value, float) and not math.isfinite(value):
  779. return None
  780. return float(value)
  781. text = str(value).replace(",", "").strip()
  782. if text in ("", "-", "--", "None", "null"):
  783. return None
  784. try:
  785. number = float(text)
  786. except ValueError as exc:
  787. raise RuntimeError(f"来源返回了无法识别的数值 {value!r}") from exc
  788. return number if math.isfinite(number) else None
  789. def _v39_rows(value, what):
  790. """来源里可能整段缺失的行列表:字段没有(None)按空处理,其余必须是对象列表。
  791. 写成 `value or []` 会把 {} / '' / 0 这类结构改变也当成空表,静默丢掉整段数据。"""
  792. if value is None:
  793. return []
  794. if not isinstance(value, list) or not all(isinstance(row, dict) for row in value):
  795. raise RuntimeError(f"{what} 应为对象列表,实际是 {type(value).__name__}: {str(value)[:120]}")
  796. return value
  797. def _v39_labels(value, what):
  798. """来源的标签数组(频道名之类):None 按空处理,其余必须是字符串列表。
  799. 直接 `value or []` 再 join,来源把数组改成字符串时会被拆成单字('ab' → 'a,b')。"""
  800. if value is None:
  801. return []
  802. if not isinstance(value, list) or not all(isinstance(x, str) for x in value):
  803. raise RuntimeError(f"{what} 应为字符串列表,实际是 {type(value).__name__}: {str(value)[:120]}")
  804. return value
  805. def _v39_req_num(value, what):
  806. """必填数值(价格、成交量):在 _v39_num 之上,空值 / NaN / inf 也抛 RuntimeError,不能当缺失放过。"""
  807. number = _v39_num(value)
  808. if number is None:
  809. raise RuntimeError(f"来源的 {what} 为空或不是有限数值: {value!r}")
  810. return number
  811. def _v39_contract(func):
  812. """统一异常契约:来源行缺字段时 row["X"] 会漏出 KeyError,调用方按「参数错 / 没数据」处理就会
  813. 把「来源格式变了」当成正常情况。这里把它转成带函数名和字段名的 RuntimeError。
  814. (函数内所有按用户参数取字典的地方都先校验过参数,不会走到这里。)"""
  815. @functools.wraps(func)
  816. def wrapper(*args, **kwargs):
  817. try:
  818. return func(*args, **kwargs)
  819. except KeyError as exc:
  820. raise RuntimeError(f"{func.__name__}: 来源数据缺少字段 {exc},格式可能已变") from exc
  821. return wrapper
  822. def _v39_count(value, what):
  823. """来源自报的页数 / 条数 → 非负 int。只认 int 或纯数字串;bool 抛错(int(True)=1 会让
  824. 「只返回 1 条」通过完整性核对),其他写法也抛 RuntimeError。"""
  825. text = str(value).strip() if isinstance(value, (int, str)) and not isinstance(value, bool) else ""
  826. if not re.fullmatch(r"[0-9]+", text):
  827. raise RuntimeError(f"{what} 不是非负整数: {value!r}")
  828. return int(text)
  829. def _v39_frame(rows, source, url, columns=None):
  830. """统一出表:附 source / source_url / fetched_at。rows 为空时返回带列名的空表,
  831. 是否允许为空由调用方判断(「确实没有」与「接口坏了」要分开处理)。"""
  832. frame = pd.DataFrame(rows, columns=columns)
  833. frame["source"] = source
  834. frame["source_url"] = url
  835. frame["fetched_at"] = datetime.now(timezone.utc).isoformat()
  836. return frame
  837. def _em_datacenter_strict(report_name, filter_str="", sort_columns="", sort_types="",
  838. page_size=500, max_rows=5000, columns="ALL", extra=None):
  839. """东财 datacenter 严格版:code=0 取数据;第 1 页就 9201(返回数据为空) → [];其他错误码直接抛。
  840. 与旧 eastmoney_datacenter() 的区别:后者把任何失败都变成 [],调用方分不清
  841. 「这只票确实没有」和「参数写错/被风控」。sortTypes 个数必须与 sortColumns 一致,
  842. 否则东财返回 9501「排序字段和顺序数量不一致」。
  843. 翻页中途失败(第 2 页起 9201、空页、非末页不满页、缺 pages / count、总页数或总条数变了、
  844. 最终条数与 count 不符)抛 RuntimeError,不把部分结果当完整结果返回。
  845. payload / result 不是对象、data 不是由对象组成的列表,同样抛 RuntimeError。
  846. 只有「第 1 页、pages=1、data 为空」才算确实没有数据。
  847. max_rows 只在来源自报总数 count > max_rows 时提前截断;count 不超过上限的,一律走完分页并核对总数。
  848. """
  849. n_cols = len([c for c in sort_columns.split(",") if c]) if sort_columns else 0
  850. n_types = len([t for t in sort_types.split(",") if t]) if sort_types else 0
  851. if n_cols != n_types:
  852. raise ValueError(f"sortColumns({n_cols}) 与 sortTypes({n_types}) 个数不一致")
  853. rows, page, first = [], 1, None
  854. while True:
  855. params = {"reportName": report_name, "columns": columns, "filter": filter_str,
  856. "pageNumber": str(page), "pageSize": str(page_size),
  857. "sortColumns": sort_columns, "sortTypes": sort_types,
  858. "source": "WEB", "client": "WEB"}
  859. params.update(extra or {})
  860. try:
  861. response = em_get(DATACENTER_URL, params=params, timeout=20)
  862. response.raise_for_status()
  863. except requests.RequestException as exc:
  864. raise RuntimeError(f"东财 {report_name} 请求失败: {type(exc).__name__}: {exc}") from exc
  865. payload = _v39_json(response)
  866. if not isinstance(payload, dict):
  867. raise RuntimeError(f"东财 {report_name} 返回的不是 JSON 对象: {str(payload)[:100]}")
  868. if payload.get("code") == 9201:
  869. if page == 1:
  870. return []
  871. raise RuntimeError(f"东财 {report_name} 第 {page} 页返回「数据为空」,"
  872. f"前面已取 {len(rows)} 条,结果不完整")
  873. if payload.get("code") != 0 or not payload.get("result"):
  874. raise RuntimeError(f"东财 {report_name} 返回错误: "
  875. f"{payload.get('code')} {payload.get('message')}")
  876. result = payload["result"]
  877. if not isinstance(result, dict):
  878. raise RuntimeError(f"东财 {report_name} 的 result 不是对象: {str(result)[:100]}")
  879. pages, count, data = result.get("pages"), result.get("count"), result.get("data")
  880. if data is None:
  881. data = []
  882. if not isinstance(data, list) or not all(isinstance(r, dict) for r in data):
  883. raise RuntimeError(f"东财 {report_name} 第 {page} 页的 data 不是由对象组成的列表,格式可能已变")
  884. if (any(isinstance(v, bool) or not isinstance(v, int) for v in (pages, count))
  885. or pages < 1 or count < 0):
  886. raise RuntimeError(f"东财 {report_name} 缺少分页信息(pages={pages!r}, count={count!r})")
  887. if first is None:
  888. first = (pages, count)
  889. elif (pages, count) != first:
  890. raise RuntimeError(f"东财 {report_name} 翻页时总页数 / 总条数从 {first} 变成 {(pages, count)},"
  891. "结果可能错位,请重试")
  892. if not data and (page > 1 or pages > 1):
  893. raise RuntimeError(f"东财 {report_name} 第 {page}/{pages} 页是空的,结果不完整")
  894. if page < pages and len(data) != int(page_size):
  895. raise RuntimeError(f"东财 {report_name} 第 {page}/{pages} 页只有 {len(data)} 条"
  896. f"(非末页应为 {page_size} 条),结果不完整")
  897. rows.extend(data)
  898. # 只有来源自报的总数确实超过上限才提前截断;否则(count <= max_rows 却已拿到更多行)
  899. # 必须走完分页并核对总数,不然「data 比 count 还多」这种格式异常会被当成正常截断放过
  900. if len(rows) >= max_rows and count > max_rows:
  901. return rows[:max_rows]
  902. if page >= pages:
  903. if len(rows) != count:
  904. raise RuntimeError(f"东财 {report_name} 翻页后 {len(rows)} 条,与总数 {count} 不符")
  905. return rows
  906. page += 1
  907. def _em_day(value):
  908. """东财日期串 '2026-09-18 00:00:00' → '2026-09-18';空值 → None;认不出的写法抛 RuntimeError
  909. (只截前 10 个字符会把 '2026/09/18' 原样放行,再拿去和日期串比较就会比错)。"""
  910. return _v39_src_date(str(value)[:10]) if value else None
  911. ```
  912. <!-- v39-helpers:end -->
  913. ---
  914. ## Layer 1: 行情层(实时,不封IP)
  915. > **V3.10.0 起本层重排:能用的在前,2026-09 起失效的 mootdx 行情命令移到最后(§1.7,留档)。**
  916. > 旧编号 → 新编号:1.2→1.1 腾讯实时、1.5→1.2 腾讯 K 线、1.6→1.3 通达信盘后包、1.3→1.5 百度、1.4→1.6 新浪复权因子、1.1→1.7 mootdx;
  917. > §1.4 腾讯逐笔为新增。CHANGELOG 与文件开头的历史版本说明里写的仍是旧编号。
  918. ### 1.1 腾讯财经 API — PE/PB/市值/换手率/涨跌停/指数/ETF
  919. HTTP GET,GBK 编码,`~` 分隔 88 个字段,不封IP。
  920. ```python
  921. import urllib.request
  922. def tencent_quote(codes: list[str]) -> dict[str, dict]:
  923. """
  924. 批量拉取腾讯财经实时行情。
  925. codes: ["688017", "300476", "002463"]
  926. 也支持指数: ["000001", "000300", "399006"]
  927. 也支持ETF: ["510050", "510300"]
  928. 返回: {code: {name, price, pe_ttm, pb, mcap, ...}}
  929. """
  930. # 前缀路由:与全局 get_prefix() 一致。5x 沪ETF / 000300 等沪指数不能落到 sz(会返回空或错票)。
  931. SH_INDEX = {"000300", "000905", "000016", "000688", "000852", "000010"} # 沪指数白名单
  932. prefixed = []
  933. key_of = {} # 带前缀的查询键 → 调用方原始写法,保证结果键与入参一一对应
  934. for c in codes:
  935. low = c.lower()
  936. if low.startswith(("sh", "sz", "bj")): # 显式前缀透传,解决 000001 等歧义
  937. p = low
  938. elif c.startswith("92"): # 北交所 920 号段须先于 9x 判断
  939. p = f"bj{c}"
  940. elif c in SH_INDEX or c.startswith(("5", "6", "9")):
  941. p = f"sh{c}"
  942. elif c.startswith(("4", "8")):
  943. p = f"bj{c}"
  944. else:
  945. p = f"sz{c}"
  946. prefixed.append(p)
  947. key_of[p] = c # 显式前缀入参原样返回,裸代码返回裸代码
  948. url = "https://qt.gtimg.cn/q=" + ",".join(prefixed)
  949. req = urllib.request.Request(url)
  950. req.add_header("User-Agent", "Mozilla/5.0")
  951. resp = urllib.request.urlopen(req, timeout=10)
  952. data = resp.read().decode("gbk")
  953. result = {}
  954. for line in data.strip().split(";"):
  955. if not line.strip() or "=" not in line or '"' not in line:
  956. continue
  957. key = line.split("=")[0].split("_")[-1]
  958. vals = line.split('"')[1].split("~")
  959. if len(vals) < 53:
  960. continue
  961. # 用入参原样做键:批量里同时传 sh000001 与 sz000001 时,若都退回裸 6 位码
  962. # 会撞成同一个键、后者静默覆盖前者,显式前缀这个特性就白做了。
  963. code = key_of.get(key, key[2:])
  964. result[code] = {
  965. "name": vals[1],
  966. "price": float(vals[3]) if vals[3] else 0,
  967. "last_close": float(vals[4]) if vals[4] else 0,
  968. "open": float(vals[5]) if vals[5] else 0,
  969. "change_amt": float(vals[31]) if vals[31] else 0,
  970. "change_pct": float(vals[32]) if vals[32] else 0,
  971. "high": float(vals[33]) if vals[33] else 0,
  972. "low": float(vals[34]) if vals[34] else 0,
  973. "amount_wan": float(vals[37]) if vals[37] else 0,
  974. "turnover_pct": float(vals[38]) if vals[38] else 0,
  975. "pe_ttm": float(vals[39]) if vals[39] else 0,
  976. "amplitude_pct":float(vals[43]) if vals[43] else 0,
  977. # ⚠️ 44=流通市值、45=总市值(曾标反)。总股本≠流通股本时差数倍,见上方踩坑提醒二
  978. "float_mcap_yi":float(vals[44]) if vals[44] else 0,
  979. "mcap_yi": float(vals[45]) if vals[45] else 0,
  980. "pb": float(vals[46]) if vals[46] else 0,
  981. "limit_up": float(vals[47]) if vals[47] else 0,
  982. "limit_down": float(vals[48]) if vals[48] else 0,
  983. "vol_ratio": float(vals[49]) if vals[49] else 0,
  984. "pe_static": float(vals[52]) if vals[52] else 0,
  985. }
  986. # 僵尸报价检测:腾讯对「已迁移的北交所老码 / 长期停牌股」照样返回 HTTP 200 +
  987. # 一份定格在最后交易日的报价(成交量 0、最新价==昨收),不报任何错。
  988. # 直接拿去算估值会得出完全错误的结论(实测 bj832982 报 112.60,真实新码 920982 为 131.74)。
  989. q = result[code]
  990. q["is_stale"] = (q["amount_wan"] == 0 and q["price"] == q["last_close"] and q["price"] > 0)
  991. if q["is_stale"] and key[2:4] in ("43", "83", "87"):
  992. q["stale_reason"] = "北交所老号段,多数已迁至 920xxx,请按名称反查现行代码"
  993. elif q["is_stale"]:
  994. q["stale_reason"] = "成交量为 0(停牌 / 未开盘 / 废码),报价非当日真实成交"
  995. return result
  996. # 用法: 个股
  997. quotes = tencent_quote(["688017", "300476", "002463"])
  998. for code, q in quotes.items():
  999. print(f"{q['name']}({code}): {q['price']}元 PE={q['pe_ttm']} PB={q['pb']} 市值={q['mcap_yi']}亿")
  1000. # 用法: 指数 — sh000001=上证指数, sh000300=沪深300, sz399006=创业板指
  1001. index_quotes = tencent_quote(["000001", "000300", "399006"])
  1002. # 用法: ETF — sh510050=上证50ETF, sh510300=沪深300ETF
  1003. etf_quotes = tencent_quote(["510050", "510300"])
  1004. ```
  1005. #### 腾讯财经字段索引速查(实测校准 2026-05-03)
  1006. | 索引 | 含义 | 示例 |
  1007. |------|------|------|
  1008. | 1 | 名称 | 绿的谐波 |
  1009. | 3 | 当前价 | 224.12 |
  1010. | 4 | 昨收 | 215.01 |
  1011. | 5 | 今开 | 214.10 |
  1012. | 9-18 | 买一~买五(价+量) | |
  1013. | 19-28 | 卖一~卖五(价+量) | |
  1014. | 31 | 涨跌额 | 9.11 |
  1015. | 32 | 涨跌幅% | 4.24 |
  1016. | 33 | 最高 | 229.62 |
  1017. | 34 | 最低 | 214.10 |
  1018. | 37 | 成交额(万) | 187040 |
  1019. | 38 | 换手率% | 4.55 |
  1020. | **39** | **PE(TTM)** | 300.45 |
  1021. | **43** | **振幅%(不是PB!)** | 7.22 |
  1022. | **44** | **流通市值(亿)** | 410.88 |
  1023. | **45** | **总市值(亿)** | 410.88 |
  1024. | **46** | **PB(市净率)** | 11.51 |
  1025. | **47** | **涨停价** | 258.01 |
  1026. | **48** | **跌停价** | 172.01 |
  1027. | 49 | 量比 | 1.20 |
  1028. | **52** | **PE(静)** | 314.76 |
  1029. > **踩坑提醒一:** 网上很多教程把索引 43 写成 PB,实测是振幅%。PB 在索引 46。
  1030. >
  1031. > **踩坑提醒二(2026-07-26 修正):** **44 是流通市值、45 才是总市值**,此前本表标反了。
  1032. > 多数股票两者相等,所以看不出来;但**总股本 ≠ 流通股本的票(科创板/次新股/有限售股)会差出数倍**。
  1033. > 实测中船特气(688146):`f[44]=356.15亿`(流通股本 1.45亿股)、`f[45]=1300.61亿`(总股本 5.29亿股),**差 3.65 倍**。
  1034. > 用市值做筛选时取错会把大市值公司误判成小盘股。可用 `f[45] ÷ 现价` 反推总股本核对(与东财 `f84` 一致)。
  1035. > 参考:东财 push2 的 `f116`=总市值 / `f117`=流通市值 方向与腾讯相反,实测确认无误,勿混用。
  1036. ### 1.2 腾讯 K 线 — 日/周/月前后复权 + 1~60 分钟(V3.9.0 新增 · #52)
  1037. §1.7 mootdx K 线失效(#52)后的主力 K 线源。三个入口是同一后端、限流各自独立:某入口返回空或异常时冷却 120 秒、换下一个,
  1038. 三个都不可用才抛错(#52 实测单入口约 600 次后返回空 JSON)。**只支持沪深**:腾讯对北交所只返回最新 1 根日线、
  1039. 区间和分钟线都是空的(2026-09-20 实测 920021 / 920982 / 920185),函数遇北交所代码直接抛 `ValueError`,北交所日线用 §1.3。
  1040. | 参数 | 说明 |
  1041. |---|---|
  1042. | `period` | `day` / `week` / `month`:默认前复权,可 `adjust='hfq'` 或 `adjust=''`(不复权);`m1` / `m5` / `m15` / `m30` / `m60`:只有不复权、只能取最近 ≤320 根 |
  1043. | `start` / `end` | 仅日周月可用,自动按段翻页(单段 <640 根);不给 `start` 时取最近 `count` 根(≤640) |
  1044. | 返回列 | `code` / `adjust`(仅日周月)/ `date` / `open` / `high` / `low` / `close` / `volume`;分钟线另有 `turnover_rate_pct`,日期列名为 `datetime` |
  1045. | `volume` 单位 | **科创板(688 / 689)是股**,其余是手:沪深主板、创业板、B 股、ETF(含科创板 ETF 588)、LOF、REITs 1 手 = 100 股 / 份,可转债 1 手 = 10 张,指数也是手;日周月线、分钟线、复权与否都是这个规则 |
  1046. > ⚠️ **腾讯前复权是等差口径**(逐次减去每股分红):茅台 2020-01-02 原始价 1130.00、腾讯 qfq 870.741,差额正是此后累计分红;
  1047. > 高分红老股早年会被减成负数(茅台 2015 年约 -117.6)。本函数遇到 ≤0 价格直接抛错。**个股长区间回测请取 `adjust=''`,
  1048. > 再用 §1.6 的比例因子复权;基金(ETF/LOF)长区间请用 §1.6 的 `hfq`(基金为等差+折算口径)**。本接口**没有成交额**,需要成交额用 §1.3。
  1049. > ⚠️ **成交量按股对账前先看这几条**(#57,2026-10-05 对照通达信盘后包与 Baostock 实测):
  1050. > - **整手取整**:科创板以外,日线的量是当日总股数取整到手——2020-03-11 起基本是四舍五入(实测差 −52~+50 股),更早是舍去零头(差 −99~0 股),
  1051. > 日线不会回填,周 / 月线是日线相加。分钟线**最近一个交易日**也是逐根整手,要到下一个交易日才回填成精确股数(会出现 34967.59 这样的小数手),
  1052. > 回填后当日各根合计与盘后包逐股一致;确切的回填时点没测出来。科创板的分钟量当天就是精确股数。
  1053. > ⇒ **最近一个交易日的分钟量别拿来按股精确对账**。本函数 m1 最多 320 根(约 1.3 天),要拿整天已回填的数据用 m5 / m60(320 根约 6 / 80 个交易日)。
  1054. > - **1 分钟线**每天 241 根:09:30 那根只有开盘集合竞价(竞价没成交就没有这根),m5 及以上把竞价并进第一根。
  1055. > 13:01 那根的开盘价是上午收盘价、不是午后第一笔,用 m1 自己合成 5 分钟线时 13:05 的开盘价会和腾讯原生 m5 / Baostock 对不上。
  1056. > - **深市分钟边界**:整分那一刻(hh:mm:00)的成交,腾讯算进下一根(m1、原生 m5 都是;11:30:00 那一刻例外,留在 11:30 那根),Baostock 算进上一根,所以深市逐根量价对不上
  1057. > (改按开始时刻分桶也拼不回来)、全天合计一致;沪市已回填的日子腾讯原生 m5 与 Baostock 5 分钟逐根一致。
  1058. > - **没有成交的分钟**:当天第一笔成交以前沪深都没有行(集合竞价没成交时连 09:30 那根也没有;09-30 抽 54 只沪深 B 股,第一笔晚于 09:30 的 43 只都从第一笔那分钟才有行)。
  1059. > 第一笔以后,沪市没有成交的分钟给一根量为 0、四个价基本都等于上一根收盘的行,不缺行;深市大多也这样,但会整根缺失
  1060. > (09-30 抽 51 只低成交深市股,25 只共缺 64 分钟,抽查的缺失分钟逐笔里都没有成交)。按分钟格点对齐时要自己处理缺行。
  1061. <!-- v39-tencent-kline:start -->
  1062. ```python
  1063. import time
  1064. from datetime import date, datetime, timedelta
  1065. # 三个入口是同一后端,但限流各自独立(#52 实测单域名约 600 次后返回空 JSON)。
  1066. TENCENT_KLINE_HOSTS = ["https://web.ifzq.gtimg.cn",
  1067. "https://proxy.finance.qq.com/ifzqgtimg",
  1068. "https://ifzq.gtimg.cn"]
  1069. _TENCENT_HOST_COOLDOWN = 120 # 某入口失败后暂停使用的秒数
  1070. _tencent_host_down_until = {}
  1071. _TENCENT_MINUTES = ("m1", "m5", "m15", "m30", "m60")
  1072. _TENCENT_SPAN_DAYS = {"day": 700, "week": 3650, "month": 18250} # 每段 < 640 根
  1073. def _tencent_kline_call(path, param):
  1074. """按顺序尝试三个入口;空响应或异常视为该入口被限流,冷却后换下一个。返回 (data, 实际成功的入口)。"""
  1075. errors = []
  1076. for host in TENCENT_KLINE_HOSTS:
  1077. if _tencent_host_down_until.get(host, 0) > time.time():
  1078. continue
  1079. try:
  1080. response = _v39_http(host + path, params={"param": param},
  1081. headers={"Referer": "https://gu.qq.com/"}, timeout=(8, 20))
  1082. payload = _v39_json(response) if response.text.strip() else {}
  1083. except RuntimeError as exc:
  1084. errors.append(f"{host}: {type(exc.__cause__ or exc).__name__}")
  1085. _tencent_host_down_until[host] = time.time() + _TENCENT_HOST_COOLDOWN
  1086. continue
  1087. if not isinstance(payload, dict): # 顶层变成数组 / 字符串:当作这个入口坏了,换下一个
  1088. errors.append(f"{host}: 顶层是 {type(payload).__name__},不是对象")
  1089. _tencent_host_down_until[host] = time.time() + _TENCENT_HOST_COOLDOWN
  1090. continue
  1091. if payload.get("msg") == "param error":
  1092. raise ValueError(f"腾讯 K 线参数错误(区间过长或代码不存在): {param}")
  1093. if isinstance(payload.get("data"), dict) and payload["data"]:
  1094. return payload["data"], host
  1095. errors.append(f"{host}: 空响应")
  1096. _tencent_host_down_until[host] = time.time() + _TENCENT_HOST_COOLDOWN
  1097. raise RuntimeError("腾讯 K 线三个入口均不可用(可能被限流,稍后重试): " + "; ".join(errors))
  1098. @_v39_contract
  1099. def tencent_kline(code, period="day", adjust=None, start=None, end=None, count=320):
  1100. """腾讯 K 线 — 日/周/月(默认前复权)与 1/5/15/30/60 分钟(不复权)。
  1101. period: day / week / month / m1 / m5 / m15 / m30 / m60
  1102. adjust: None=日周月默认 qfq、分钟默认不复权;可显式传 'qfq' / 'hfq' / ''(不复权)
  1103. start/end: 仅日周月可用,'YYYY-MM-DD';给了 start 会自动按段分页(单次最多 640 根)
  1104. count: 不给 start 时取最近 count 根;日周月 ≤ 640,分钟 ≤ 320
  1105. 成交量单位:科创板(688/689)是股,其余是手;科创板以外,最近一个交易日的分钟量是整手、下一个交易日才回填成精确股数(见 §1.2 说明)。
  1106. 本接口**没有成交额**,需要成交额用 §1.3 通达信盘后包。
  1107. 不支持北交所:腾讯对北交所只返回最新 1 根日线,区间与分钟线为空(2026-09-20 实测),直接抛 ValueError。
  1108. """
  1109. period = str(period).lower()
  1110. if get_prefix(code) == "bj":
  1111. raise ValueError("腾讯 K 线不支持北交所(只返回最新 1 根日线、分钟线为空);"
  1112. "北交所日线请用 §1.3 tdx_daily_package(date) 按交易日取")
  1113. symbol = get_prefix(code) + norm_ticker(code)
  1114. if period in _TENCENT_MINUTES:
  1115. if adjust not in (None, ""):
  1116. raise ValueError("分钟线只有不复权数据,adjust 请留空")
  1117. if start or end:
  1118. raise ValueError("分钟线只能取最近 count 根,不支持 start/end")
  1119. if not 1 <= int(count) <= 320:
  1120. raise ValueError("分钟线 count 范围 1–320")
  1121. data, host = _tencent_kline_call("/appstock/app/kline/mkline", f"{symbol},{period},,{int(count)}")
  1122. node = data.get(symbol)
  1123. if not isinstance(node, dict) or not isinstance(node.get(period), list):
  1124. raise RuntimeError(f"腾讯分钟线 {symbol} 的返回里没有 {period} 列表,格式可能已变")
  1125. rows, seen = [], set()
  1126. try:
  1127. for item in node[period]:
  1128. stamp = datetime.strptime(item[0], "%Y%m%d%H%M")
  1129. if stamp in seen:
  1130. raise RuntimeError(f"腾讯分钟线 {symbol} 同一时刻 {stamp} 出现两次,结果不可信")
  1131. seen.add(stamp)
  1132. rows.append({"datetime": stamp.strftime("%Y-%m-%d %H:%M"),
  1133. "open": _v39_req_num(item[1], "open"), "high": _v39_req_num(item[3], "high"),
  1134. "low": _v39_req_num(item[4], "low"), "close": _v39_req_num(item[2], "close"),
  1135. "volume": _v39_req_num(item[5], "volume"),
  1136. # 第 8 个字段是换手率「基点」,÷100 才是百分数;它不是成交额。
  1137. "turnover_rate_pct": _v39_num(item[7]) / 100 if len(item) > 7
  1138. and _v39_num(item[7]) is not None else None})
  1139. except (ValueError, TypeError, IndexError, KeyError) as exc: # 源格式变了(行变短 / 变成对象),不是参数错
  1140. raise RuntimeError(f"腾讯分钟线 {symbol} 行格式改变: {exc}") from exc
  1141. if not rows:
  1142. raise RuntimeError(f"腾讯分钟线 {symbol} {period} 返回 0 根")
  1143. frame = _v39_frame(rows, "tencent", host + "/appstock/app/kline/mkline")
  1144. frame.insert(0, "code", symbol)
  1145. return frame
  1146. if period not in _TENCENT_SPAN_DAYS:
  1147. raise ValueError("period 只能是 day/week/month 或 m1/m5/m15/m30/m60")
  1148. adjust = "qfq" if adjust is None else adjust
  1149. if adjust not in ("qfq", "hfq", ""):
  1150. raise ValueError("adjust 只能是 'qfq' / 'hfq' / ''")
  1151. if start:
  1152. first = datetime.strptime(_v39_date(start), "%Y-%m-%d").date()
  1153. last = datetime.strptime(_v39_date(end), "%Y-%m-%d").date() if end else date.today()
  1154. if first > last:
  1155. raise ValueError("start 不能晚于 end")
  1156. windows, cursor = [], first
  1157. while cursor <= last:
  1158. stop = min(cursor + timedelta(days=_TENCENT_SPAN_DAYS[period] - 1), last)
  1159. windows.append((cursor.isoformat(), stop.isoformat(), 640))
  1160. cursor = stop + timedelta(days=1)
  1161. else:
  1162. if end:
  1163. raise ValueError("只给 end 时请同时给 start")
  1164. if not 1 <= int(count) <= 640:
  1165. raise ValueError("日周月 count 范围 1–640")
  1166. windows = [("", "", int(count))]
  1167. by_date, used_hosts = {}, []
  1168. for s, e, n in windows:
  1169. data, host = _tencent_kline_call("/appstock/app/fqkline/get",
  1170. f"{symbol},{period},{s},{e},{n},{adjust}")
  1171. if host not in used_hosts:
  1172. used_hosts.append(host)
  1173. node = data.get(symbol)
  1174. # 有除权的标的返回 qfqday / hfqweek…;从未除权的标的(以及指数)只返回 day/week/month,
  1175. # 此时复权价与原始价相同。只认其中一个 key 会静默丢掉另一类标的(#52 补充)。
  1176. # 复权 key 在就只用它:它为空而 day 有数据时,拿 day 顶上就是把原始价标成复权价,直接抛错。
  1177. # 空列表是正常的(上市前、长期停牌的区间,实测 688981 在 2019 年返回 day=[]);
  1178. # 连这两个 key 都没有说明返回格式变了,不能把这一段当成 0 根跳过。
  1179. key = adjust + period
  1180. if not isinstance(node, dict) or not isinstance(node.get(key, node.get(period)), list):
  1181. raise RuntimeError(f"腾讯 K 线 {symbol} {s or '最近'}~{e or ''} 的返回里没有 {key} / {period},"
  1182. "格式可能已变")
  1183. items = node.get(key, node.get(period))
  1184. if key != period and key in node and not items and node.get(period):
  1185. raise RuntimeError(f"腾讯 K 线 {symbol} {s}~{e} 的 {key} 为空、{period} 却有数据,"
  1186. "不能拿原始价冒充复权价")
  1187. try:
  1188. for item in items:
  1189. day = _v39_src_date(item[0])
  1190. # 每段只接受段内日期(实测腾讯按 K 线日期过滤,周 / 月线也不越界);
  1191. # 越界说明拿到的是别的请求或缓存页,只按总区间过滤会把缺掉的几段静默吞掉
  1192. if s and not s <= day <= e:
  1193. raise RuntimeError(f"腾讯 K 线 {symbol} 请求 {s}~{e} 却返回了 {day},结果不可信")
  1194. if day in by_date: # 各段互不重叠,同一天出现两次只能是源数据有问题
  1195. raise RuntimeError(f"腾讯 K 线 {symbol} 日期 {day} 出现两次,结果不可信")
  1196. # 必填数值走 _v39_req_num:float() 会把 true 读成 1.0、把 'nan' 放进结果
  1197. by_date[day] = {"date": day, "open": _v39_req_num(item[1], "open"),
  1198. "high": _v39_req_num(item[3], "high"), "low": _v39_req_num(item[4], "low"),
  1199. "close": _v39_req_num(item[2], "close"), "volume": _v39_req_num(item[5], "volume")}
  1200. except (ValueError, TypeError, IndexError, KeyError) as exc: # 源格式变了(行变短 / 变成对象),不是参数错
  1201. raise RuntimeError(f"腾讯 K 线 {symbol} 行格式改变: {exc}") from exc
  1202. rows = [by_date[k] for k in sorted(by_date)]
  1203. if start:
  1204. rows = [r for r in rows if windows[0][0] <= r["date"] <= windows[-1][1]]
  1205. if not rows:
  1206. raise RuntimeError(f"腾讯 K 线 {symbol} {period} 在所给区间内 0 根(未上市/停牌区间/代码有误)")
  1207. # 腾讯 qfq 是「逐次减去每股分红」的等差口径(茅台 2020-01-02:原始 1130.00,qfq 870.741,
  1208. # 差额 259.259 正是此后累计分红),高分红股的早年价格会被减成负数(茅台 2015 年 -117.6)。
  1209. # 负价不能拿去算收益率,直接拒绝;个股长区间请用 adjust='' 再按 §1.6 比例口径复权;基金长区间请用 §1.6 的 hfq。
  1210. if any(min(r["open"], r["high"], r["low"], r["close"]) <= 0 for r in rows):
  1211. raise RuntimeError(f"腾讯 {adjust or '原始'} 价格出现 ≤0(等差复权口径的副作用);"
  1212. "个股请改用 adjust='' 取不复权价,再用 §1.6 sina_adjust_factor + apply_adjust 比例复权;基金长区间请用 hfq")
  1213. # 分段请求可能落在不同入口,source_url 列出实际用到的全部入口
  1214. frame = _v39_frame(rows, "tencent", " | ".join(h + "/appstock/app/fqkline/get" for h in used_hosts))
  1215. frame.insert(0, "code", symbol)
  1216. frame.insert(1, "adjust", adjust or "none")
  1217. return frame
  1218. ```
  1219. <!-- v39-tencent-kline:end -->
  1220. ```python
  1221. day = tencent_kline("600519", start="2025-01-01") # 前复权日线,自动分段
  1222. raw = tencent_kline("600519", adjust="", count=250) # 不复权 → 可交给 §1.6 apply_adjust
  1223. m5 = tencent_kline("300750", period="m5", count=96) # 最近 96 根 5 分钟线
  1224. idx = tencent_kline("sh000001", period="week", count=100) # 指数(上证指数要写 sh 前缀)
  1225. ```
  1226. ### 1.3 通达信官网盘后包 — 某交易日全市场日线含成交额(V3.9.0 新增 · #52)
  1227. 通达信官网每天发布的增量数据包(HTTP 下载约 2.7MB),一次拿到**沪深北全部证券**当日的昨收、开高低收、成交量(股)、
  1228. 成交额(元)。它走 HTTP,和 §1.7 失效的 TCP 行情命令是两条路。适合收盘后全市场截面筛选、每日落库。
  1229. 二进制布局参考 [jing2uo/tdx2db](https://github.com/jing2uo/tdx2db)(MIT),已与腾讯收盘价对拍。
  1230. 非交易日、或当天包还没发布(通常收盘后数小时)抛 `ValueError`,不返回空表。
  1231. <!-- v39-tdx-package:start -->
  1232. ```python
  1233. import io
  1234. import math
  1235. import re
  1236. import struct
  1237. import zipfile
  1238. import zlib
  1239. TDX_PACKAGE_URL = "https://www.tdx.com.cn/products/data/data/g4day/{ymd}.zip"
  1240. # 盘后包从这一天起带北交所文件(2026-09-20 二分实测:20220505 无、20220506 有)
  1241. TDX_BJ_FIRST_DAY = "20220506"
  1242. # 每个市场有收盘价的最少行数。2026-09-20 实测 2021-08-16 ~ 2026-09-18 共 11 个包的最小值:
  1243. # 沪 16202、深 3641(2022 年以前深市大部分代码当日无价)、京 87(2022-05-06),下限取明显低于最小值的整数
  1244. TDX_MIN_PRICED = {"sh": 10000, "sz": 3000, "bj": 50}
  1245. def _tdx_parse_package(content, ymd):
  1246. """解析通达信每日增量包:每个市场一对 .cod(代码表,150 字节/条)+ .md1(行情块,512 字节/块)。
  1247. 布局参考 jing2uo/tdx2db(MIT)的 tdx/merge.go,已用 600519/000001/920000 与腾讯收盘价对拍。"""
  1248. archive = zipfile.ZipFile(io.BytesIO(content))
  1249. names = set(archive.namelist())
  1250. rows = []
  1251. for market in ("sh", "sz", "bj"):
  1252. cod_name, md1_name = f"{market}{ymd[2:]}.cod", f"{market}{ymd[2:]}.md1"
  1253. if (market == "bj" and ymd < TDX_BJ_FIRST_DAY
  1254. and cod_name not in names and md1_name not in names):
  1255. continue # 这天之前的包还没有北交所文件;之后缺文件按格式改变报错
  1256. if cod_name not in names or md1_name not in names:
  1257. raise RuntimeError(f"通达信盘后包缺少 {cod_name}/{md1_name},格式可能已变")
  1258. cod, md1 = archive.read(cod_name), archive.read(md1_name)
  1259. if len(cod) % 150 or len(md1) % 512:
  1260. raise RuntimeError(f"{market} 代码表或行情块长度不是整块,文件可能被截断")
  1261. if len(cod) // 150 != len(md1) // 512:
  1262. raise RuntimeError(f"{market} 代码表 {len(cod) // 150} 条、行情块 {len(md1) // 512} 块,对不上")
  1263. before, codes, seqs = len(rows), set(), set()
  1264. for offset in range(0, len(cod), 150):
  1265. record = cod[offset:offset + 150]
  1266. # 11 个真实包(2021-08 ~ 2026-09)的代码全是 6 位 ASCII 数字;用 replace 解码会把坏字节变成 '\ufffd00000' 放行
  1267. code = record[0:6].rstrip(b"\x00 ").decode("ascii", "replace")
  1268. seq = struct.unpack("<H", record[32:34])[0]
  1269. if not re.fullmatch(r"[0-9]{6}", code):
  1270. raise RuntimeError(f"通达信盘后包 {market} 代码表出现非 6 位数字代码 {code!r},格式可能已变")
  1271. if code in codes or seq in seqs:
  1272. raise RuntimeError(f"通达信盘后包 {market} 代码表有重复的代码 / 行情块序号({code!r}, seq={seq})")
  1273. codes.add(code)
  1274. seqs.add(seq)
  1275. block = md1[seq * 512:(seq + 1) * 512]
  1276. if len(block) != 512:
  1277. raise RuntimeError(f"{market}{code} 行情块越界(seq={seq})")
  1278. prev_close = struct.unpack("<d", block[4:12])[0]
  1279. open_, high, low, close = struct.unpack("<4d", block[12:44])
  1280. amount = struct.unpack("<d", block[72:80])[0]
  1281. # NaN 能绕过 close <= 0 被当成有价记录计入下限;11 个真实包里没有一个非有限值
  1282. if not all(math.isfinite(v) for v in (prev_close, open_, high, low, close, amount)):
  1283. raise RuntimeError(f"通达信盘后包 {market}{code} 行情块出现非有限数值,文件可能已损坏")
  1284. if close <= 0:
  1285. continue # 880/881 等通达信自编板块指数当日无价,整块为 0,不是证券
  1286. volume = struct.unpack("<Q", block[56:64])[0]
  1287. raw_name = record[40:72].split(b"\x00")[0]
  1288. try: # replace 会把坏字节变成「�」当成正常名称返回(11 个真实包实测零替换字符)
  1289. name = raw_name.decode("gbk").strip()
  1290. except UnicodeDecodeError as exc:
  1291. raise RuntimeError(f"通达信盘后包 {market}{code} 的名称不是 GBK,文件可能已损坏") from exc
  1292. if not name:
  1293. raise RuntimeError(f"通达信盘后包 {market}{code} 有价格却没有名称,文件可能已损坏")
  1294. rows.append({"date": f"{ymd[:4]}-{ymd[4:6]}-{ymd[6:]}", "market": market,
  1295. "code": code,
  1296. "name": name,
  1297. "prev_close": round(prev_close, 4), "open": round(open_, 4),
  1298. "high": round(high, 4), "low": round(low, 4),
  1299. "close": round(close, 4), "volume": volume,
  1300. "amount": round(amount, 2)})
  1301. # 逐市场核对下限:只检查总行数会让沪深撑过门槛、北交所静默缺失
  1302. if len(rows) - before < TDX_MIN_PRICED[market]:
  1303. raise RuntimeError(f"通达信盘后包 {market} 市场只有 {len(rows) - before} 条有价记录"
  1304. f"(实测下限 {TDX_MIN_PRICED[market]}),文件可能残缺或格式已变")
  1305. return rows
  1306. @_v39_contract
  1307. def tdx_daily_package(date):
  1308. """通达信官网每日盘后包 — 某一交易日沪深北全部证券的日线(含成交额)。
  1309. 走 HTTP 下载(约 2.7MB),与 #52 失效的 TCP 行情命令是两条路。
  1310. 个股 volume 单位是「股」、amount 单位是「元」;指数等特殊代码的 volume 为通达信原值。
  1311. 非交易日或当日包尚未发布时官网返回 404,本函数抛 ValueError,不返回空表。
  1312. 历史包实测 2022-01-04、2023-01-03 可取,2021-01-04 已 404,未逐日验证;
  1313. 2022-05-06 之前的包没有北交所文件,只返回沪深,之后缺北交所文件会报错。
  1314. 某个市场有价记录少于 TDX_MIN_PRICED 的实测下限、代码不是 6 位数字或重复、行情块序号重复、
  1315. 代码表与行情块条数对不上、价格 / 成交额不是有限数,
  1316. 都按文件残缺抛 RuntimeError,不把部分市场当全市场返回。
  1317. """
  1318. ymd = _v39_date(date).replace("-", "")
  1319. url = TDX_PACKAGE_URL.format(ymd=ymd)
  1320. response = _v39_http(url, timeout=(10, 90), allow_status=(404,))
  1321. if response.status_code == 404:
  1322. raise ValueError(f"{date} 没有通达信盘后包:非交易日、当日包尚未发布(通常收盘后数小时),或早于官网保留范围(实测 2021-01-04 已没有)")
  1323. if not response.content.startswith(b"PK"):
  1324. raise RuntimeError("通达信盘后包不是 zip 文件,可能是错误页")
  1325. try:
  1326. rows = _tdx_parse_package(response.content, ymd)
  1327. except (zipfile.BadZipFile, zlib.error, EOFError) as exc: # 以 PK 开头但压缩包坏了 / 下载被截断
  1328. raise RuntimeError(f"通达信盘后包 {url} 无法解压: {type(exc).__name__}: {exc}") from exc
  1329. return _v39_frame(rows, "tdx", url)
  1330. ```
  1331. <!-- v39-tdx-package:end -->
  1332. ```python
  1333. snap = tdx_daily_package("2026-09-18")
  1334. print(len(snap), snap[snap.code == "600519"][["close", "volume", "amount"]])
  1335. ```
  1336. ### 1.4 腾讯逐笔成交 — 当日分笔明细(V3.10.0 新增 · 替代 §1.7 mootdx `transaction`)
  1337. §1.7 mootdx `transaction()` 2026-09 起返回空(#52)后的逐笔来源:腾讯行情页「成交明细」接口,一页 70 笔,逐页翻到空页为止,
  1338. 全天 60–70 页、约 20–30 秒(复用连接;连接失败、等响应超时、429 / 5xx 自动重试)。先执行 Prerequisites 的 V3.9.0 共用 helper。
  1339. - **只有最近一个交易日**,没有历史;覆盖沪深个股(含创业板、科创板)与 ETF。北交所、指数没有,直接抛 `ValueError`。
  1340. - 是约 3 秒一笔的**分笔**(同一时刻撮合的多笔合并成一笔),不是交易所 Level-2 逐笔委托 / 逐笔成交。
  1341. 09:25 那一笔就是开盘集合竞价的撮合结果。
  1342. - `volume` 单位「手」(科创板也是手,和 §1.2 K 线不同:科创板按股成交、这里每笔取整成手,全天累加与真实股数有误差,成交越清淡越大:09-30 实测 688981 +0.013%、688001 −0.052%,成交清淡的 688184 +0.20%、688459 −0.16%)、`amount` 单位元;`side`:B = 主动买、S = 主动卖、M = 中性(集合竞价、盘后定价多为 M)。
  1343. - 收盘后 15:05–15:30 的盘后定价(固定价格)成交也在结果里(`time` 晚于 15:00:59 的行);实测沪深主板、创业板、科创板、ETF 都有,
  1344. 不计入腾讯行情的当日成交额。
  1345. - **完整性核对:** 收盘后调用时,连续竞价段(≤ 15:00:59)的成交额合计要与腾讯行情快照的当日成交额相符,差超过 0.1% + 1000 元抛 `RuntimeError`
  1346. (2026-09-22 实测 000001 / 600519 / 300750 / 688981 / 159915 / 000002 / 603286 相差 0–285 元)。
  1347. 盘中调用拿到的是截至取数时刻的逐笔,成交额还在变,不做这项核对,也不保证完整(翻页途中遇到空页就当作结束)。
  1348. - 腾讯偶尔缓存了盘后某一页的旧版本,会缺几笔盘后成交(实测 300750 缺 6 笔、159915 缺 7 笔,都在 15:14 以后)。
  1349. 连续竞价段缺号直接抛 `RuntimeError`,稍后重试;盘后段中间缺的序号记在 `frame.attrs["missing_seq"]`,末尾缺的从序号上看不出来。
  1350. - **`frame.attrs["complete"]`**:15:31 以后调用(看取数前那次快照的时刻),再用快照的盘后成交额(下标 58 的字段,万元)核对 15:00:59 以后的各笔,
  1351. 差不超过「笔数 + 1」元算对上(每笔金额取整到元)。
  1352. `True` = 序号连续,连续竞价段和盘后定价的金额都对上;`False` = 盘后定价有缺笔(中间缺号,或末尾缺的金额超出容差),稍后重试;
  1353. `None` = 没有缺号,但还在盘中、不到 15:31,或快照没有这个字段,没法核对。
  1354. 末尾缺的笔金额小时看不出来:低价 ETF 一笔 1–2 手只有几十元,落在容差里仍是 `True`(09-30 的 512170 盘后 46 笔、容差 47 元,缺一笔 1 手 35 元判不出)。
  1355. 2026-10-05 实测 10 只(沪深主板、创业板、科创板、ETF)09-30 的盘后各笔合计与该字段差 0–3 元。
  1356. - 开盘前(9:25 撮合前)调用可能拿不到上一交易日的逐笔。
  1357. <!-- v310-tencent-ticks:start -->
  1358. ```python
  1359. import re
  1360. import time
  1361. TENCENT_TICK_URL = "https://stock.gtimg.cn/data/index.php"
  1362. TENCENT_QT_URL = "https://qt.gtimg.cn/q="
  1363. _TICK_MAX_PAGES = 300 # 一页 70 笔;2026-09-22 实测最活跃的票全天约 4800 笔 / 69 页
  1364. _TICK_SESSION_END = "15:00:59" # 连续竞价 + 收盘集合竞价到此为止(科创板收盘那笔在 15:00:02),之后是盘后定价
  1365. def _tencent_qt_snapshot(symbol):
  1366. """腾讯行情快照 → (交易日 'YYYY-MM-DD', 时刻 'HHMMSS', 当日成交额 元, 盘后定价成交额 元)。代码不存在抛 ValueError。
  1367. 盘后定价成交额是下标 58 的字段(万元、4 位小数);字段没有或认不出时为 None,只是不做盘后核对。"""
  1368. response = _v39_http(TENCENT_QT_URL + symbol, timeout=(5, 15), session=V39_RETRY_SESSION)
  1369. text = response.content.decode("gbk", "replace")
  1370. if "v_pv_none_match" in text:
  1371. raise ValueError(f"腾讯没有 {symbol} 这个代码")
  1372. match = re.search(rf'v_{symbol}="([^"]*)"', text)
  1373. if not match:
  1374. raise RuntimeError(f"腾讯行情快照 {symbol} 的返回里没有 v_{symbol} 变量,格式可能已变")
  1375. fields = match.group(1).split("~")
  1376. if len(fields) < 36 or not re.fullmatch(r"[0-9]{14}", fields[30]):
  1377. raise RuntimeError(f"腾讯行情快照 {symbol} 字段数 {len(fields)} 或时间字段不对,格式可能已变")
  1378. parts = fields[35].split("/") # 「最新价/成交量/成交额(元)」;科创板的成交量是股、其余是手,所以只用成交额
  1379. if len(parts) != 3:
  1380. raise RuntimeError(f"腾讯行情快照 {symbol} 的价/量/额字段是 {fields[35]!r},格式可能已变")
  1381. after_hours = fields[58] if len(fields) > 58 else ""
  1382. after_hours = round(float(after_hours) * 1e4, 2) if re.fullmatch(r"\d+(\.\d+)?", after_hours) else None
  1383. return _v39_src_date(fields[30][:8]), fields[30][8:], _v39_req_num(parts[2], "成交额"), after_hours
  1384. def _tencent_tick_page(symbol, page):
  1385. """第 page 页逐笔(0 起)→ 记录列表;翻过最后一页时腾讯返回空内容,返回 None。"""
  1386. response = _v39_http(TENCENT_TICK_URL, params={"appn": "detail", "action": "data", "c": symbol, "p": page},
  1387. timeout=(5, 15), session=V39_RETRY_SESSION)
  1388. text = response.content.decode("gbk", "replace").strip()
  1389. if not text:
  1390. return None
  1391. match = re.fullmatch(rf'v_detail_data_{symbol}=\[(\d+),"([^"]*)"\];?', text)
  1392. if not match or int(match.group(1)) != page:
  1393. raise RuntimeError(f"腾讯逐笔 {symbol} 第 {page} 页不是预期格式: {text[:80]!r}")
  1394. if not match.group(2):
  1395. return None
  1396. records = []
  1397. try:
  1398. for item in match.group(2).split("|"):
  1399. seq, clock, price, change, volume, amount, side = item.split("/")
  1400. if not re.fullmatch(r"\d\d:\d\d:\d\d", clock) or side not in ("B", "S", "M"):
  1401. raise ValueError(item)
  1402. records.append({"seq": int(seq), "time": clock, "price": _v39_req_num(price, "price"),
  1403. "change": _v39_req_num(change, "change"), "volume": _v39_req_num(volume, "volume"),
  1404. "amount": _v39_req_num(amount, "amount"), "side": side})
  1405. except ValueError as exc: # 字段数不对 / 序号不是整数 / 方向认不出:源格式变了,不是参数错
  1406. raise RuntimeError(f"腾讯逐笔 {symbol} 第 {page} 页记录格式改变: {exc}") from exc
  1407. return records
  1408. @_v39_contract
  1409. def tencent_ticks(code):
  1410. """腾讯逐笔成交(分笔)— 最近一个交易日的全部成交明细,沪深个股与 ETF。
  1411. 一行一笔:date / code / time / seq(腾讯序号)/ price / change(较上一笔)/ volume(手)/ amount(元)/
  1412. side(B 主动买 · S 主动卖 · M 中性)。约 3 秒一笔的分笔,不是 Level-2 逐笔。
  1413. 北交所、指数、代码不存在、当日没有成交抛 ValueError。收盘后调用会用行情快照的当日成交额核对连续竞价段,
  1414. 对不上抛 RuntimeError;盘后定价段腾讯偶尔缺几笔:中间缺的序号在 frame.attrs["missing_seq"],
  1415. 15:31 以后再用快照的盘后成交额核对,结果在 frame.attrs["complete"](True 对上 / False 有缺 / None 没法核对;
  1416. 低价 ETF 一两手的小额缺笔可能看不出)。
  1417. """
  1418. prefix, ticker = get_prefix(code), norm_ticker(code)
  1419. if prefix == "bj":
  1420. raise ValueError("腾讯逐笔不支持北交所(返回空);北交所日线见 §1.3 tdx_daily_package")
  1421. if (prefix, ticker[:3]) in (("sh", "000"), ("sz", "399")):
  1422. raise ValueError(f"{prefix}{ticker} 是指数,没有逐笔成交")
  1423. symbol = prefix + ticker
  1424. day, clock, amount_before, after_hours_before = _tencent_qt_snapshot(symbol)
  1425. if amount_before == 0:
  1426. raise ValueError(f"{symbol} 在 {day} 没有成交(停牌、尚未开盘或集合竞价未撮合)")
  1427. rows, missing = [], []
  1428. for page in range(_TICK_MAX_PAGES):
  1429. records = _tencent_tick_page(symbol, page)
  1430. if records is None:
  1431. break
  1432. for r in records:
  1433. expected = rows[-1]["seq"] + 1 if rows else 0
  1434. if r["seq"] < expected or (rows and r["time"] < rows[-1]["time"]):
  1435. raise RuntimeError(f"腾讯逐笔 {symbol} 序号或时间倒退(第 {page} 页 {r['seq']} {r['time']}),结果不可信")
  1436. if r["seq"] > expected:
  1437. if r["time"] <= _TICK_SESSION_END:
  1438. raise RuntimeError(f"腾讯逐笔 {symbol} 缺序号 {expected}–{r['seq'] - 1}({r['time']} 之前,第 {page} 页),"
  1439. "腾讯该页缓存不完整,稍后重试")
  1440. missing.extend(range(expected, r["seq"]))
  1441. rows.append(r)
  1442. time.sleep(0.1)
  1443. else:
  1444. raise RuntimeError(f"腾讯逐笔 {symbol} 翻到第 {_TICK_MAX_PAGES} 页仍未结束,格式可能已变")
  1445. if not rows:
  1446. if clock < "092500":
  1447. raise ValueError(f"{symbol} 集合竞价尚未撮合({clock}),还没有逐笔")
  1448. raise RuntimeError(f"{symbol} 在 {day} 成交 {amount_before:.0f} 元,腾讯逐笔却为空:"
  1449. "开盘前腾讯可能已清空上一交易日的明细,否则是接口变了")
  1450. day_after, clock_after, amount_after, after_hours_after = _tencent_qt_snapshot(symbol)
  1451. if day_after != day:
  1452. raise RuntimeError(f"取数期间交易日从 {day} 变成 {day_after},请重试")
  1453. session = sum(r["amount"] for r in rows if r["time"] <= _TICK_SESSION_END)
  1454. # 两次快照成交额相同说明取数期间没有新成交(收盘后 / 午休 / 停牌),此时连续竞价段逐笔合计应与当日成交额相符
  1455. if amount_after == amount_before and abs(session - amount_before) > amount_before * 0.001 + 1000:
  1456. raise RuntimeError(f"腾讯逐笔 {symbol} 连续竞价段成交额 {session:.0f} 元,与行情快照 {amount_before:.0f} 元对不上,"
  1457. "逐笔可能不全")
  1458. # 盘后定价 15:30 结束(深市最后一笔可能正好在 15:30:00)。取数前的快照已在 15:31 以后、两次快照一致时,
  1459. # 15:00:59 以后各笔成交额合计应等于快照的盘后成交额(每笔取整到元,差不超过笔数 + 1 元);
  1460. # 中间缺号、末尾缺笔都会对不上,但末尾缺的金额小于容差(低价 ETF 一两手)时看不出。盘中 / 15:31 前没法核对,记 None。
  1461. after_hours = [r["amount"] for r in rows if r["time"] > _TICK_SESSION_END]
  1462. complete = None
  1463. if missing:
  1464. complete = False
  1465. elif (amount_after == amount_before and after_hours_before is not None
  1466. and after_hours_after == after_hours_before and clock >= "153100"):
  1467. complete = abs(sum(after_hours) - after_hours_before) <= len(after_hours) + 1
  1468. frame = _v39_frame(rows, "tencent", f"{TENCENT_TICK_URL}?appn=detail&action=data&c={symbol}",
  1469. ["time", "seq", "price", "change", "volume", "amount", "side"])
  1470. frame.insert(0, "date", day)
  1471. frame.insert(1, "code", symbol)
  1472. frame.attrs["missing_seq"] = missing
  1473. frame.attrs["complete"] = complete
  1474. return frame
  1475. ```
  1476. <!-- v310-tencent-ticks:end -->
  1477. ```python
  1478. ticks = tencent_ticks("000001") # 平安银行最近一个交易日全部分笔
  1479. ticks.attrs["complete"] # 15:31 以后:True 对上 / False 盘后有缺笔;盘中为 None
  1480. auction = ticks[ticks.time < "09:30:00"] # 开盘集合竞价撮合那一笔(科创板在 09:25:0x)
  1481. buy = ticks.loc[ticks.side == "B", "amount"].sum() # 主动买入额
  1482. etf = tencent_ticks("510300") # ETF 同样可用
  1483. ```
  1484. ### 1.5 百度股市通 K线 — 带MA5/MA10/MA20(V3.0 新增)
  1485. **核心价值:** 返回时自带均线数据,无需本地计算。
  1486. ```python
  1487. import requests
  1488. def baidu_kline_with_ma(code: str, start_time: str = "") -> dict:
  1489. """百度股市通K线 — 独有能力: 返回时自带 ma5/ma10/ma20 均价"""
  1490. url = "https://finance.pae.baidu.com/selfselect/getstockquotation"
  1491. params = {
  1492. "all": "1", "isIndex": "false", "isBk": "false", "isBlock": "false",
  1493. "isFutures": "false", "isStock": "true", "newFormat": "1",
  1494. "group": "quotation_kline_ab", "finClientType": "pc",
  1495. "code": code, "start_time": start_time, "ktype": "1",
  1496. }
  1497. headers = {
  1498. "User-Agent": "Mozilla/5.0",
  1499. "Accept": "application/vnd.finance-web.v1+json",
  1500. "Origin": "https://gushitong.baidu.com",
  1501. "Referer": "https://gushitong.baidu.com/",
  1502. }
  1503. r = requests.get(url, params=params, headers=headers, timeout=10)
  1504. d = r.json()
  1505. result = d.get("Result", {})
  1506. md = result.get("newMarketData", {})
  1507. keys = md.get("keys", []) # includes: ma5avgprice, ma10avgprice, ma20avgprice
  1508. rows = md.get("marketData", "").split(";")
  1509. return {"keys": keys, "rows": rows}
  1510. # 用法
  1511. data = baidu_kline_with_ma("600519")
  1512. print("字段:", data["keys"][:10])
  1513. print("最近5根K线:", data["rows"][-5:])
  1514. # keys 包含: time, open, close, high, low, volume, amount, ma5avgprice, ma10avgprice, ma20avgprice 等
  1515. ```
  1516. ### 1.6 新浪复权因子 — qfq / hfq(V3.7.0 新增)
  1517. **核心价值:** §1.7 `tdx_client().bars()`、§1.2 `tencent_kline(adjust='')`、§1.3 `tdx_daily_package()` 返回的是**不复权**数据,跨除权日直接比价必然出错。
  1518. 本端点给出复权因子序列,一次 HTTP、约 1.8KB、零鉴权。
  1519. 个股使用 `f` 比例因子。基金(ETF/LOF)使用 `s`(累计份额折算比例)和 `u`(累计每份分红)的等差+折算口径:
  1520. qfq 为 `raw / s - u`,hfq 为 `(raw + u) * s`;本次基金样例在 0.001 容差内与腾讯复权收盘价一致。
  1521. ```python
  1522. import json
  1523. import re
  1524. import requests
  1525. def sina_adjust_factor(code: str, kind: str = "qfq") -> list:
  1526. """新浪复权因子序列 — kind='qfq'(前复权) | 'hfq'(后复权),按日期倒序(最新在前)
  1527. 个股返回 date/factor;基金(ETF/LOF)另含 split/dividend,对应 s/u 等差+折算口径。
  1528. """
  1529. if kind not in ("qfq", "hfq"):
  1530. raise ValueError(f"kind 只能是 'qfq' 或 'hfq',收到 {kind!r}")
  1531. # 数字位用 norm_ticker() 剥掉前后缀(否则 "sz000016" 会拼成 "szsz000016" ——
  1532. # zfill(6) 对 8 字符输入不做任何事)。
  1533. raw = str(code).strip()
  1534. digits = norm_ticker(raw)
  1535. # 市场:**显式写法优先**——前缀或 `.SH` 后缀直接采信(V3.7.1 起 get_prefix() 也认后缀,
  1536. # 本地显式匹配保留,语义不变)。都没写显式市场时,才用 get_prefix() 按号段推断
  1537. # (它已处理 92 必须先于 9x)。
  1538. m = re.match(r"^(sh|sz|bj)", raw, re.I) or re.search(r"\.(sh|sz|bj|xshg|xshe)$", raw, re.I)
  1539. prefix = {"xshg": "sh", "xshe": "sz"}.get(m.group(1).lower(), m.group(1).lower()) if m else get_prefix(digits)
  1540. symbol = f"{prefix}{digits}"
  1541. url = f"https://finance.sina.com.cn/realstock/company/{symbol}/{kind}.js"
  1542. r = requests.get(url, headers={"User-Agent": "Mozilla/5.0",
  1543. "Referer": "https://finance.sina.com.cn/"}, timeout=10)
  1544. r.raise_for_status()
  1545. # 🔴 响应形如 `var sh600519qfq={...}` 且**末尾挂着 /* base64 */ 注释块**,
  1546. # 不能用 $ 锚定正则。从第一个 { 起用 raw_decode,让解析器自己在 JSON 结束处停下。
  1547. text = r.text
  1548. brace = text.find("{")
  1549. if brace < 0:
  1550. raise RuntimeError(f"新浪复权因子响应无 JSON({symbol}/{kind}): {text[:120]}")
  1551. try:
  1552. data, _ = json.JSONDecoder().raw_decode(text[brace:])
  1553. except json.JSONDecodeError as e:
  1554. raise RuntimeError(f"新浪复权因子 JSON 解析失败({symbol}/{kind}): {e}") from e
  1555. rows = []
  1556. for it in data.get("data", []):
  1557. row = {"date": it["d"], "factor": float(it["f"])}
  1558. if "s" in it or "u" in it:
  1559. try:
  1560. row.update(split=float(it["s"]), dividend=float(it["u"]))
  1561. except (KeyError, TypeError, ValueError) as e:
  1562. raise RuntimeError(f"新浪基金复权因子 s/u 格式异常({symbol}/{kind}): {e}") from e
  1563. rows.append(row)
  1564. return rows
  1565. def apply_adjust(bars, factors: list, kind: str = "qfq",
  1566. price_keys=("open", "high", "low", "close")):
  1567. """把复权因子套到不复权 K 线上。
  1568. `bars` 接受两种形态:
  1569. - **§1.7 `tdx_client().bars()` 的 DataFrame**(日期列名是 `datetime`)或 §1.2 `tencent_kline(adjust='')` 的 DataFrame(`date` 列)→ 返回 DataFrame
  1570. - list[dict](需含 `date` 键)→ 返回 list[dict]
  1571. 🔴 **qfq 与 hfq 的运算方向相反,必须传对 kind**:
  1572. - `qfq`(前复权)因子是**除数**:`前复权价 = 不复权价 ÷ factor`
  1573. - `hfq`(后复权)因子是**乘数**:`后复权价 = 不复权价 × factor`
  1574. 传错方向不会报错,只会把历史价格放大/缩小几倍(见下方实测对照表)。
  1575. 基金(ETF/LOF)每行带 split/dividend,走 s/u 等差+折算口径:
  1576. - qfq:`v / split - dividend`;hfq:`(v + dividend) * split`
  1577. 输出保留 4 位小数,另记 adj_split/adj_dividend;基金 qfq 舍入后非正价抛错,长区间改用 hfq。
  1578. 因子表是「生效日 → 因子」的阶梯,每根 K 线取**不晚于它**的最近一个因子。
  1579. """
  1580. if kind not in ("qfq", "hfq"):
  1581. raise ValueError(f"kind 只能是 'qfq' 或 'hfq',收到 {kind!r}")
  1582. # 🔴 因子为空时绝不能「原样返回」—— 那会把不复权价当成复权价交出去,
  1583. # 调用方拿到的数字看着正常却是错的(新浪对不支持的标的就返回空 data)。
  1584. if not factors:
  1585. raise ValueError(
  1586. "复权因子列表为空,无法复权。请先确认 sina_adjust_factor() 是否取到数据"
  1587. "(新浪对不支持的标的会返回空 data),不要用未复权价继续计算。"
  1588. )
  1589. fund_mode = all("split" in f and "dividend" in f for f in factors)
  1590. if not fund_mode and any("split" in f or "dividend" in f for f in factors):
  1591. raise RuntimeError("复权因子表口径混杂:基金每行必须同时含 split/dividend")
  1592. if fund_mode:
  1593. for f in factors:
  1594. if f["split"] <= 0 or f["factor"] != 1:
  1595. raise RuntimeError("基金复权因子异常:split 必须 >0,factor 必须为 1")
  1596. is_df = hasattr(bars, "columns") and hasattr(bars, "to_dict")
  1597. if is_df:
  1598. # mootdx bars() 的日期列叫 datetime,且可能带时分秒,统一截成 YYYY-MM-DD
  1599. date_col = next((c for c in ("date", "datetime") if c in bars.columns), None)
  1600. if date_col is None:
  1601. raise ValueError(f"DataFrame 需含 date 或 datetime 列,实际列={list(bars.columns)}")
  1602. rows = bars.to_dict("records")
  1603. for r in rows:
  1604. r["date"] = str(r[date_col])[:10]
  1605. else:
  1606. rows = [dict(b) for b in bars]
  1607. for r in rows:
  1608. if "date" not in r:
  1609. raise ValueError(f"每根 K 线需含 'date' 键,实际键={sorted(r)}")
  1610. r["date"] = str(r["date"])[:10]
  1611. fac = sorted(factors, key=lambda x: x["date"])
  1612. out, i, cur = [], 0, None
  1613. for bar in sorted(rows, key=lambda b: b["date"]):
  1614. while i < len(fac) and fac[i]["date"] <= bar["date"]:
  1615. cur = fac[i] if fund_mode else fac[i]["factor"]
  1616. i += 1
  1617. # 🔴 早于最早因子日的 K 线不能原样放行 —— 那会让一份结果里混着「已复权」和
  1618. # 「未复权」两种价格且无从分辨。新浪的因子表通常带 1900-01-01 哨兵
  1619. # (实测 600519/000001/300750/688981/000004/601398 六只均是),
  1620. # 真出现未覆盖行,说明因子表异常,必须显式失败。
  1621. if cur is None:
  1622. raise RuntimeError(
  1623. f"K 线日期 {bar['date']} 早于因子序列最早日 {fac[0]['date']},"
  1624. "无法复权;不返回未复权价以免与已复权行混淆。"
  1625. )
  1626. factor = cur["factor"] if fund_mode else cur
  1627. if factor == 0:
  1628. raise RuntimeError(f"复权因子为 0({bar['date']}),无法换算")
  1629. nb = dict(bar)
  1630. for k in price_keys:
  1631. if k in nb and nb[k] is not None:
  1632. v = float(nb[k])
  1633. if fund_mode:
  1634. v = v / cur["split"] - cur["dividend"] if kind == "qfq" else (v + cur["dividend"]) * cur["split"]
  1635. nb[k] = round(v, 4)
  1636. if kind == "qfq" and nb[k] <= 0:
  1637. raise RuntimeError(f"基金前复权价格 ≤0({bar['date']}/{k}),长区间请改用 hfq")
  1638. else:
  1639. nb[k] = round(v / factor if kind == "qfq" else v * factor, 4)
  1640. nb["adj_factor"] = factor
  1641. if fund_mode:
  1642. nb.update(adj_split=cur["split"], adj_dividend=cur["dividend"])
  1643. out.append(nb)
  1644. if is_df:
  1645. import pandas as pd
  1646. res = pd.DataFrame(out)
  1647. # mootdx 的 bars() 带 DatetimeIndex,重建 DataFrame 会退化成 RangeIndex,
  1648. # 下游按时间切片 / resample / 时间对齐 join 都会失效。按排序后的顺序还原索引。
  1649. if getattr(bars, "index", None) is not None and not isinstance(
  1650. bars.index, pd.RangeIndex
  1651. ):
  1652. order = sorted(range(len(bars)), key=lambda n: str(bars.iloc[n][date_col])[:10])
  1653. res.index = bars.index[order]
  1654. res.index.name = bars.index.name
  1655. return res
  1656. return out
  1657. # 用法
  1658. qfq = sina_adjust_factor("600519", "qfq")
  1659. hfq = sina_adjust_factor("600519", "hfq")
  1660. print(len(qfq), "条 | 最新", qfq[0], "| 最早", qfq[-1])
  1661. # 实测 2026-08-19:33 条
  1662. # qfq 最新 {'date': '2026-06-26', 'factor': 1.0} ← 前复权以最新为基准
  1663. # hfq 最早 {'date': '1900-01-01', 'factor': 1.0} ← 后复权以最早为基准
  1664. bars = [{"date": "2015-01-05", "close": 202.52}] # 茅台当日不复权收盘价
  1665. print(apply_adjust(bars, qfq, kind="qfq")) # → 143.46(前复权,除法)
  1666. print(apply_adjust(bars, hfq, kind="hfq")) # → 1274.28(后复权,乘法)
  1667. ```
  1668. **方向实测对照(2026-08-19,以 baostock `adjustflag` 为基准交叉验证)**
  1669. | 日期 | 不复权 | baostock 前复权 | `raw × qfq` | `raw ÷ qfq` |
  1670. |------|--------|----------------|-------------|-------------|
  1671. | 2015-01-05 | 202.52 | **143.46** | 285.90 ❌ | **143.46** ✅ |
  1672. | 2026-08-14 | 1341.99 | 1341.99 | 1341.99 ✅ | 1341.99 ✅ |
  1673. > `qfq` 因子恒 ≥ 1 且越往历史越大,**乘上去会把历史价格放大**,必须做除法。
  1674. > 基金(ETF/LOF)请使用上面的 s/u 公式;本段比例因子及下方 baostock 基准对照适用于个股。
  1675. > 2026 那行两种算法都对,是因为最新日因子恰为 1.0 —— **只用最近日期做验证会漏掉这个 bug**。
  1676. >
  1677. > ⚠️ **hfq 的基准与 baostock 不同**:新浪 `raw × hfq` 与 baostock 后复权价差一个**恒定倍数**
  1678. > (实测 1.1582,2015 与 2026 两点一致)。后复权序列整体缩放不影响收益率与形态,
  1679. > 但**不要把新浪后复权价与其它源的后复权价直接比数值**。
  1680. > ⚠️ **北交所无复权因子**:实测 `bj920982` 返回 **404**(新浪未提供北交所的 qfq/hfq 文件),
  1681. > 本函数会抛 `HTTPError`。北交所标的请改用 §1.3 通达信盘后包的不复权日线,并自行按分红送转推导。
  1682. >
  1683. > **自检口径(实测 2026-08-19 校准):**
  1684. > - `qfq` 序列**最新**一条因子恒为 `1.0`;`hfq` 序列**最早**一条恒为 `1.0`。
  1685. > - 同一日期上 **`qfq(d) × hfq(d)` 恒等于一个常数**(该标的全期总复权系数,茅台实测 `8.882513`)。
  1686. > ⚠️ 两者**不是倒数**(乘积不为 1),比值 `hfq/qfq` 也**不恒定**(茅台 33 个日期有 32 种取值)——
  1687. > 两个基准不同的归一化序列,只有乘积守恒。
  1688. > 不满足以上任一条,说明响应被截断或标的代码写错。
  1689. > **基金分支自检(fixtures 采集于 2026-11-03,离线核对):**
  1690. > 4 组样例均满足 qfq 最新一行 `split=1、dividend=0`,hfq 最早一行(1900 哨兵)也为 `split=1、dividend=0`。
  1691. > 同日 `qfq.dividend + hfq.dividend` 在各样例全期恒定(依次为 `5.3905、0、0.4062、0`);
  1692. > `qfq.split × hfq.split` 也在浮点容差内恒定(依次为 `1、5、约 0.4245239277782239、1`,最大极差约 `4e-17`)。
  1693. > 上述顺序为债券 ETF 示例、份额折算示例、分红及折算示例、无分红示例;这是 fixtures 上的结论,非所有标的的保证。
  1694. > - 基金 `f` 全为 `1` 是正常状态,必须继续读取 `s/u`;已知有分红或折算的基金 **`f` 全为 `1` 且没有 `s/u`** 才是可疑状态。
  1695. > 只有 1900 哨兵且 `s=1、u=0` 的无事件基金可正常原价换算。自检异常时应核对响应完整性和标的代码。
  1696. ### 1.7 mootdx — K线 + 五档盘口 + 逐笔成交(⚠️ 2026-09 起行情命令失效,留档)
  1697. TCP 二进制协议,连通达信服务器(7709),无需注册,不封IP。
  1698. > **⚠️ 2026-09 起本节普遍取不到数(#52):** 通达信公开服务器 TCP 仍可达,但 `bars` / `quotes` / `transaction`
  1699. > 返回 0 行(2026-09-20 逐台实测内置 10 台,全部如此);`tdx_client()` 会在约 1 分钟测速后抛出带指引的 RuntimeError。
  1700. > 替代:**K 线 → §1.2 `tencent_kline()`**(沪深日周月前/后复权 + 1~60 分钟)或 **§1.3 `tdx_daily_package()`**(沪深北全市场某日含成交额,北交所日线只能走这里);
  1701. > **实时价 / 五档 → §1.1 腾讯**;**逐笔 → §1.4 `tencent_ticks()`**(只有当日)。财务与 F10(§6.1 / §6.2 / §7.2)不受影响。以下代码保留,服务器恢复后可照常使用。
  1702. ```python
  1703. from mootdx.quotes import Quotes
  1704. client = tdx_client() # 见 Prerequisites 的 tdx_client() helper(规避 0.11.x BESTIP bug;等价 Quotes.factory(market='std'))
  1705. # === K线数据 ===
  1706. # ⚠️ 参数名是 frequency(不是 category!传 category 会被 **kwargs 静默吞掉,
  1707. # 永远退化成默认 frequency=9 日线,拿不到分钟数据)。
  1708. # mootdx 0.11.7 实测频率值表:
  1709. # 0=5分钟 1=15分钟 2=30分钟 3=60分钟(1小时) 4=日线 5=周线 6=月线
  1710. # 8=1分钟 9=日线(默认) 10=季线 11=年线 (7=1分钟除权口径,少用)
  1711. klines = client.bars(symbol='688017', frequency=9, offset=10) # 日线
  1712. min1 = client.bars(symbol='688017', frequency=8, offset=240) # 1分钟(一个交易日≈240根)
  1713. min5 = client.bars(symbol='688017', frequency=0, offset=48) # 5分钟
  1714. # 返回: open, close, high, low, vol, amount, datetime
  1715. # ⚠️ 复权:bars 返回【不复权】原始价(通达信原始数据,无 adjust 参数)。
  1716. # 跨除权除息日做估值/回测前需自行复权,或改用带前复权的日K数据源(腾讯财经)。
  1717. # === 实时报价 ===
  1718. quotes = client.quotes(symbol=['688017', '300476'])
  1719. # 返回 46 个字段:
  1720. # price(现价), open, high, low, last_close(昨收)
  1721. # bid1~bid5, ask1~ask5, bid_vol1~bid_vol5, ask_vol1~ask_vol5
  1722. # vol(成交量), amount(成交额), servertime
  1723. # === 逐笔成交(非交易时间返回空)===
  1724. trades = client.transaction(symbol='688017', date='20260502')
  1725. # 返回: time, price, vol, num, buyorsell(0买/1卖/2中性)
  1726. ```
  1727. **mootdx 不提供 PE / PB / 市值 / 换手率 / 涨跌停价** — 这些走腾讯财经。
  1728. ---
  1729. ## Layer 2: 研报层
  1730. ### 2.1 东财研报 API — 研报列表 + PDF下载(主力)
  1731. A级接口(公开JSON API),reportapi.eastmoney.com,免费无key。
  1732. ```python
  1733. import requests
  1734. import re
  1735. import time
  1736. from datetime import date, timedelta # 注意用 date/timedelta,不要 import datetime 模块:
  1737. # 本 SKILL 多处有 `from datetime import datetime`,会把模块名遮蔽掉
  1738. from pathlib import Path
  1739. from typing import Optional # 3.9 兼容:不能写 `str | None`(那是 3.10+ 语法)
  1740. REPORT_API = "https://reportapi.eastmoney.com/report/list"
  1741. PDF_TPL = "https://pdf.dfcfw.com/pdf/H3_{info_code}_1.pdf"
  1742. UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
  1743. def eastmoney_reports(code: str, max_pages: int = 5) -> list[dict]:
  1744. """拉取指定股票的研报列表。
  1745. code 支持 600519 / SH600519 / 600519.SH 等写法(内部归一化为纯 6 位)。
  1746. ⚠️ reportapi 只认纯 6 位数字:传 "SH600519" 会返回 hits=0,
  1747. 看起来像「这只票没研报」,实际是格式没归一化——务必先过 norm_ticker()。
  1748. 返回 [] 仅表示东财确无该标的研报覆盖(格式错误已在上游抛 ValueError)。
  1749. """
  1750. code = norm_ticker(code, stock_only=True) # 格式错/显式指数码直接抛错,不静默返回 []
  1751. all_records = []
  1752. for page in range(1, max_pages + 1):
  1753. params = {
  1754. "industryCode": "*", "pageSize": "100", "industry": "*",
  1755. "rating": "*", "ratingChange": "*",
  1756. "beginTime": "2000-01-01", "endTime": "2030-01-01",
  1757. "pageNo": str(page), "fields": "", "qType": "0",

Lines 2,001–4,843 are not shown. The link to the file on GitHub has every line.

README.md · README · 629 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center"><b>简体中文</b> | <a href="README_en.md">English</a></p>
  2. <h1 align="center">a-stock-data</h1>
  3. <p align="center">
  4. <b>A 股全栈数据工具包 — 15 层架构 · 87 个端点 · 34 个数据源 · 零鉴权(iwencai 除外)</b>
  5. </p>
  6. <p align="center">
  7. 行情 K 线 · 研报 · 市场信号 · 资金面 / 筹码 · 新闻 · 基础财务 · 公告 · 打板 · ETF 期权 · 舆情互动 ·
  8. 宏观与利率 · 指数与交易日历 · 期货与大宗商品 · 事件驱动 · 可转债
  9. </p>
  10. <p align="center">
  11. <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License"></a>
  12. <img src="https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white" alt="Python">
  13. <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>
  14. <br>
  15. <img src="https://img.shields.io/badge/layers-15-2ea44f.svg" alt="Layers">
  16. <img src="https://img.shields.io/badge/endpoints-87-2ea44f.svg" alt="Endpoints">
  17. <img src="https://img.shields.io/badge/sources-34-2ea44f.svg" alt="Sources">
  18. <img src="https://img.shields.io/badge/auth-zero-success.svg" alt="Zero Auth">
  19. </p>
  20. ---
  21. <p align="center">
  22. <a href="#数据覆盖15-类">数据覆盖</a> ·
  23. <a href="#架构">架构</a> ·
  24. <a href="#快速开始">快速开始</a> ·
  25. <a href="#87-个端点能力清单">端点清单</a> ·
  26. <a href="#使用示例">使用示例</a> ·
  27. <a href="#faq">FAQ</a> ·
  28. <a href="./CHANGELOG.md">更新日志</a>
  29. </p>
  30. 一个自包含的 Skill 文件,把分散在 34 个数据源里的 A 股及相关市场原始数据整合成 AI 编程助手直接能用的工具集。你不用再背腾讯 K 线的分段参数、通达信盘后包的二进制格式、东财的 PDF Referer 头、iwencai 的 X-Claw 鉴权——全部封装好了。主源被封还有「备用源速查」可降级。
  31. > 兼容 [Claude Code](https://github.com/anthropics/claude-code) · [Codex](https://github.com/openai/codex) · [OpenClaw](https://github.com/openclaw/openclaw) · [WorkBuddy](https://www.workbuddy.cn/) · [Muse](https://muse.ai/) · [Grok Bot](https://x.ai/bot)
  32. >
  33. > Skill 文件本质是结构化 Markdown + 内嵌 Python,任何支持上下文注入的 AI 编程助手都能用。
  34. > **V3.10.4(2026-11-04 · #64 基金复权):** §1.6 新浪复权因子用于基金(ETF / LOF)时原来只读 `f`(基金恒为 1),复权等于没做。现在补读份额折算比例 `s` 和累计每份分红 `u`:前复权 `raw / s - u`,后复权 `(raw + u) * s`。个股的返回值、入口数、来源数都不变。
  35. >
  36. > **V3.10.3(2026-10-23 · 上证e互动时间列):** §10.3 `sse_e_interaction()` 的回复时间是相对写法(`昨天 18:22`),原来只认绝对时间,遇到就整页抛错。现在相对/绝对时间都换算成 `YYYY-MM-DD HH:MM`(按北京时间),认不出仍然报错。入口数、来源数、返回的数据都不变。
  37. >
  38. > **V3.10.2(2026-10-11 · #58):** 修正 `full_valuation()` 的 PE 消化年数:前向 PE 高于 30x 而预测盈利不增长(或下一年预测缺失)时,原来返回 0 年,像是已经消化完;现在返回 `None`,表示无法估算。当年 EPS 缺失或不为正时同样返回 `None`。入口数、来源数不变。
  39. >
  40. > **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 同样自动重试。入口数、来源数、返回的数据都不变。
  41. >
  42. > **V3.10.0(2026-09-22):** 通达信公开服务器的 K 线 / 盘口 / 逐笔命令失效(#52)后,行情层把可用来源排到前面(腾讯 → 腾讯 K 线 → 通达信盘后包 → 腾讯逐笔),mootdx 移到最后留档;新增 §1.4 `tencent_ticks()` 腾讯当日逐笔成交(替代 mootdx 逐笔)和 §13.7 `futures_kline()` 新浪期货日 K(主力连续 + 具体合约,**补上大商所**)。Layer 1 重新编号,旧编号对照见 CHANGELOG。
  43. >
  44. > **V3.9.0(2026-09-20):** 新增期货与大宗商品、事件驱动、可转债三层,并在原有各层补上腾讯 K 线、通达信官网盘后包、新浪研报、ETF 份额、利率曲线等入口,共 25 个;通达信公开服务器的 K 线命令失效(#52)已改走 HTTP。详见 [CHANGELOG](./CHANGELOG.md)。
  45. ---
  46. ## 数据覆盖(15 类)
  47. <table>
  48. <thead>
  49. <tr><th nowrap>#</th><th nowrap>类别</th><th>包含数据</th><th>主要来源</th></tr>
  50. </thead>
  51. <tbody>
  52. <tr><td nowrap>1</td><td nowrap>行情 / K 线</td><td>实时价、PE/PB/市值/换手率、日周月前后复权与 1~60 分钟 K 线、某交易日全市场日线(含成交额)、复权因子、指数 / ETF</td><td>腾讯、通达信官网、百度、新浪</td></tr>
  53. <tr><td nowrap>2</td><td nowrap>研报</td><td>个股 / 行业研报与 PDF、评级、三年 EPS 预测、一致预期、自然语言检索、研报列表</td><td>东财、新浪、同花顺、iwencai</td></tr>
  54. <tr><td nowrap>3</td><td nowrap>市场信号</td><td>强势股与题材归因、北向资金、板块归属、资金流向、龙虎榜、限售解禁、行业排名、板块资金流</td><td>同花顺、东财</td></tr>
  55. <tr><td nowrap>4</td><td nowrap>资金面 / 筹码</td><td>融资融券、大宗交易、股东户数、分红送转、120 日资金流、筹码分布、ETF 份额</td><td>东财、上交所、深交所、本地计算</td></tr>
  56. <tr><td nowrap>5</td><td nowrap>新闻</td><td>个股新闻、财联社电报、7×24 快讯、新闻联播文字稿</td><td>东财、财联社、华尔街见闻、央视网</td></tr>
  57. <tr><td nowrap>6</td><td nowrap>基础财务</td><td>季报快照、F10、财报三表、估值历史、上市退市日、申万行业变迁、ST 名单</td><td>通达信(mootdx)、新浪、baostock、申万、东财</td></tr>
  58. <tr><td nowrap>7</td><td nowrap>公告</td><td>沪深北全量公告</td><td>巨潮</td></tr>
  59. <tr><td nowrap>8</td><td nowrap>打板</td><td>涨停 / 炸板 / 跌停 / 昨涨停池、涨停原因、重点监控池、日内异动</td><td>东财、同花顺</td></tr>
  60. <tr><td nowrap>9</td><td nowrap>ETF 期权</td><td>T 型报价、希腊字母、隐含波动率</td><td>新浪</td></tr>
  61. <tr><td nowrap>10</td><td nowrap>舆情互动</td><td>互动易(深市)、上证e互动(沪市)、同花顺热榜、东财人气榜、概念命中</td><td>巨潮、上证e互动、同花顺、东财</td></tr>
  62. <tr><td nowrap>11</td><td nowrap>宏观与利率</td><td>社融、PMI、国债与信用债收益率曲线、回购定盘利率、LPR、全球宏观日历</td><td>人民银行、国家统计局、中债、中国货币网、东财、华尔街见闻</td></tr>
  63. <tr><td nowrap>12</td><td nowrap>指数与交易日历</td><td>中证 / 国证成分与权重、中证 PE 与股息率、深交所交易日历</td><td>中证指数、国证指数、深交所</td></tr>
  64. <tr><td nowrap>13</td><td nowrap>期货与大宗商品</td><td>期货日行情、商品与股指期权、会员持仓排名、实时期货、A50 期指、上海金现货</td><td>上期所、上期能源、郑商所、中金所、广期所、新浪、上金所</td></tr>
  65. <tr><td nowrap>14</td><td nowrap>事件驱动</td><td>业绩预告、机构调研、股东增减持、股票回购、股权质押、新股申购日历</td><td>东财</td></tr>
  66. <tr><td nowrap>15</td><td nowrap>可转债</td><td>条款、转股价、转股价值、溢价率、上市 / 摘牌状态</td><td>东财</td></tr>
  67. </tbody>
  68. </table>
  69. 另有 5 个备胎:官方龙虎榜、新浪资金流、公告、沪深官方两融、北交所当前行情,主源被封时降级用。
  70. ---
  71. ## 架构
  72. ```
  73. A 股全栈数据 · 十五层架构 · V3.10.4
  74. │ (优先级:腾讯 / 交易所官方优先,不封 IP;mootdx 行情命令 2026-09 起失效,只用于财务与 F10;
  75. │ 东财只用于独有数据,已内置限流防封)
  76. ├── 行情层 腾讯 + 通达信官网 + 百度 + 新浪 实时价 / PE / PB / 市值 + 指数 / ETF + K线(带MA5/10/20)
  77. │ + 复权因子 qfq/hfq ★V3.7
  78. │ + 日周月前后复权与 1~60 分钟 K 线 + 全市场当日日线(含成交额) ★V3.9
  79. │ + 当日逐笔成交(沪深个股 + ETF) ★V3.10
  80. ├── 研报层 东财 reportapi + 同花顺 + iwencai + 新浪 个股研报 / 行业研报 / PDF下载 / 一致预期 / NL搜索
  81. │ + 新浪研报列表(第二来源) ★V3.9
  82. ├── 信号层 同花顺 + 东财 强势股 + 题材归因 + 北向资金 + 板块归属
  83. │ + 资金流向(push2) + 龙虎榜 + 全市场龙虎榜 + 解禁 + 行业对比 + 板块资金流
  84. ├── 资金面 东财 datacenter + push2 融资融券 + 大宗交易 + 股东户数 + 分红送转 + 资金流(分钟+120日)
  85. │ /筹码 本地计算 + 上交所 + 深交所 筹码分布 CYQ ★V3.7 + ETF 份额 ★V3.9
  86. ├── 新闻层 东财 + 财联社 + 华尔街见闻 + 央视网 个股新闻 / 财联社电报 / 全球资讯 / 7×24 快讯 / 新闻联播 ★V3.9
  87. ├── 基础数据 mootdx + 东财 + 新浪 季报37字段 / F10最新提示 / 财报三表
  88. │ + baostock + 申万 估值历史(PE/PB/PS+换手率+停牌+ST) / 上市退市日 / 申万行业变迁史 ★V3.7
  89. │ + ST 名单 ★V3.9
  90. ├── 公告层 巨潮 cninfo + mootdx 沪深北全量公告
  91. ├── 打板层 东财 push2ex + 同花顺 涨停池 / 炸板 / 跌停 / 昨涨停 / 涨停原因题材 / 连板梯队
  92. │ + 重点监控池 + 日内异动池 ★V3.6
  93. ├── 期权层 新浪 hq.sinajs ETF期权 T型报价 / 希腊字母 / 隐含波动率 IV ★V3.3
  94. ├── 舆情互动 巨潮互动易 + 上证e互动 + 同花顺 + 东财 互动易(深市) / 上证e互动(沪市) ★V3.9 / 热榜 / 人气榜 / 概念命中
  95. ├── 宏观利率 人民银行 + 统计局 + 中债 + 货币网 + 东财 + 华尔街见闻
  96. │ 社融 / PMI / 收益率曲线 / 回购定盘利率 / LPR / 全球宏观日历 ★V3.9 扩展
  97. ├── 指数日历 中证指数 + 国证指数 + 深交所 指数成分 / 权重 / PE与股息率 / 官方交易日历
  98. ├── 期货大宗 上期所 + 上期能源 + 郑商所 + 中金所 + 广期所 + 新浪 + 上金所
  99. │ 期货日行情 / 商品与股指期权 / 持仓排名 / 实时期货 / A50 / 上海金 ★V3.9
  100. │ + 期货日 K(主力连续 + 具体合约,含大商所) ★V3.10
  101. ├── 事件驱动 东财 datacenter 业绩预告 / 机构调研 / 增减持 / 回购 / 股权质押 / 新股申购 ★V3.9
  102. └── 可转债 东财 datacenter 条款 / 转股价值 / 溢价率 / 上市摘牌状态 ★V3.9
  103. ```
  104. > 十五层之外另附**备用源速查 & 降级策略**:龙虎榜/资金流/公告备胎,以及沪深官方两融、北交所当前行情与五档备胎。使用范围和真实数据日期见 SKILL.md 对应章节。
  105. ---
  106. ## 快速开始
  107. **3 步,2 分钟。**
  108. ```bash
  109. # 1. 创建 skill 目录
  110. mkdir -p ~/.claude/skills/a-stock-data
  111. # 2. 把 SKILL.md 放进去
  112. curl -o ~/.claude/skills/a-stock-data/SKILL.md \
  113. https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/SKILL.md
  114. # 3. 安装依赖(V3.0 不再需要 akshare;V3.9 没有新增依赖)
  115. pip install mootdx requests pandas stockstats numpy baostock xlrd openpyxl
  116. ```
  117. 启动 Claude Code,说一句「帮我看看 688017 的估值」,自动激活。
  118. > **Codex / OpenClaw 用户:** 把 SKILL.md 的内容贴入你的系统 prompt 或项目上下文文件即可,内嵌的 Python 代码可直接执行。
  119. ---
  120. ## 87 个端点能力清单
  121. 共 82 个主入口、5 个备胎。沿用能力入口计数:同一函数的中证/国证或沪深路由不重复计数,辅助函数与仅列入候选的项目不计入。
  122. > **计数口径:** 下方清单共 88 行,按能力入口计 87 个——「东财 行业研报」与「东财 reportapi」为**同一端点**(仅 `qType` 参数不同)、「同花顺北向(历史)」为本地自缓存(非独立端点),两行不计入;「东财日内异动池」一行含 `list` / `count` **两个端点**,多计 1 个。88 − 1 − 1 + 1 = 87。代码转换辅助函数 `to_joinquant()` 不计入。
  123. ### 行情层(实时,不封 IP)
  124. <table>
  125. <thead>
  126. <tr><th nowrap>端点</th><th>数据</th></tr>
  127. </thead>
  128. <tbody>
  129. <tr><td nowrap>腾讯财经</td><td>PE(TTM) / PB / 总市值 / 流通市值 / 换手率 / 涨跌停价 / 指数 / ETF</td></tr>
  130. <tr><td nowrap><strong>腾讯 K 线</strong></td><td>沪深日/周/月前后复权 + 1/5/15/30/60 分钟,三个入口轮换;不含北交所(V3.9 新增)</td></tr>
  131. <tr><td nowrap><strong>通达信盘后包</strong></td><td>某交易日沪深北全市场日线含成交额,单个 zip 约 2~3 MB;实测 2022-01-04、2023-01-03 可取,2021-01-04 已没有,未逐日验证;2022-05-06 之前的包没有北交所(V3.9 新增)</td></tr>
  132. <tr><td nowrap><strong>腾讯逐笔成交</strong></td><td>最近一个交易日全部分笔(约 3 秒一笔):时间 / 价格 / 量 / 额 / 买卖方向,沪深个股 + ETF,不含北交所;收盘后自动用当日成交额核对完整性(V3.10 新增,替代 mootdx 逐笔)</td></tr>
  133. <tr><td nowrap><strong>百度K线</strong></td><td>日K线 + MA5/MA10/MA20 均价直接返回(V3.0 新增)</td></tr>
  134. <tr><td nowrap><strong>新浪复权因子</strong></td><td>qfq / hfq 因子序列 + 套用到不复权 K 线(V3.7 新增)</td></tr>
  135. <tr><td nowrap>mootdx 行情(留档)</td><td>K线(多周期) + 五档盘口 + 逐笔成交 + 实时报价 46 字段(⚠️ 2026-09 起通达信公开服务器返回空,见 FAQ #52;K 线改用腾讯 K 线 / 盘后包,逐笔改用腾讯逐笔)</td></tr>
  136. </tbody>
  137. </table>
  138. ### 研报层
  139. | 端点 | 数据 |
  140. |------|------|
  141. | 东财 reportapi | 个股研报列表 + 评级 + 三年 EPS 预测 |
  142. | 东财 行业研报 | 行业研报列表(qType=1,同端点)+ 行业名/行业码 + 评级(V3.2.3 新增) |
  143. | 东财 PDF 下载 | 完整研报 PDF(个股/行业通用,已处理 Referer 鉴权) |
  144. | 同花顺一致预期 | 机构一致预期 EPS(直连 basic.10jqka.com.cn) |
  145. | iwencai NL 搜索 | 自然语言跨主题研报检索 |
  146. | **新浪研报列表** | 标题 / 类型 / 机构 / 研究员 / 日期,东财之外的第二来源;无评级与目标价(V3.9 新增,#53) |
  147. ### 信号层
  148. <table>
  149. <thead>
  150. <tr><th nowrap>端点</th><th>数据</th></tr>
  151. </thead>
  152. <tbody>
  153. <tr><td nowrap>同花顺热点</td><td>当日强势股 + 题材归因 reason tags(编辑部人工标注)</td></tr>
  154. <tr><td nowrap>同花顺北向(实时)</td><td>沪股通分钟级流向(深股通近期上游披露收紧仅供参考,权威北向见 HKEX 备胎)</td></tr>
  155. <tr><td nowrap>同花顺北向(历史)</td><td>本地自缓存日级历史</td></tr>
  156. <tr><td nowrap>东财板块归属</td><td>个股所属全部板块(行业/概念/地域混合)+ BK码 + 当日涨跌幅 + 龙头股(V3.2.2 替换百度 PAE,一次请求拿全)</td></tr>
  157. <tr><td nowrap><strong>东财资金流向</strong></td><td>主力 / 大单 / 中单 / 小单 / 超大单分钟级净流入(V3.1 替换百度 PAE)</td></tr>
  158. <tr><td nowrap>龙虎榜席位</td><td>上榜记录 + 买卖席位 TOP5 + 机构动向</td></tr>
  159. <tr><td nowrap>全市场龙虎榜</td><td>每日全市场上榜股票 + 净买额排名 + 上榜原因</td></tr>
  160. <tr><td nowrap>限售解禁日历</td><td>历史解禁 + 未来 90 天待解禁预警</td></tr>
  161. <tr><td nowrap><strong>行业板块排名</strong></td><td>东财行业涨跌/上涨下跌家数(V3.0 替换同花顺,零鉴权)</td></tr>
  162. <tr><td nowrap><strong>板块资金流向</strong></td><td>行业/概念/地域 × 今日/5日/10日 主力净流入额/净占比 + 超大/大/中/小单四档 + 领涨股(V3.5 新增,与行业排名同源)</td></tr>
  163. </tbody>
  164. </table>
  165. ### 资金面 / 筹码层(V3.0 新增)
  166. | 端点 | 数据 |
  167. |------|------|
  168. | **融资融券明细** | 日级融资余额/买入/偿还 + 融券余额/卖出/偿还 |
  169. | **大宗交易** | 成交价/量 + 买卖方营业部 + 溢价率 |
  170. | **股东户数变化** | 季度股东数 + 环比变化 + 户均持股(筹码集中度) |
  171. | **分红送转历史** | 每股派息/送股/转增 + 进度状态 |
  172. | **个股资金流120日** | 主力/大单/中单/小单日级净流入 |
  173. | **筹码分布 CYQ** | 获利比例 / 平均成本 / 90-70 成本区间与集中度 / 筹码峰(本地计算,V3.7 新增) |
  174. | **ETF 份额** | 上交所按日归档(实测 2022-01-04 仍有数据)/ 深交所当前快照,单位万份(V3.9 新增) |
  175. ### 新闻层
  176. | 端点 | 数据 |
  177. |------|------|
  178. | 个股新闻 | 东财个股新闻流(直连 search-api-web) |
  179. | 财联社电报 | 全市场实时快讯(v1 API + 本地签名零 key,✅V3.4.0 复活,与全球资讯互备) |
  180. | 全球资讯 | 东财全球财经资讯(直连 np-weblist,7×24) |
  181. | **华尔街见闻快讯** | 按频道取 7×24 快讯,带翻页游标(V3.9 新增) |
  182. | **新闻联播** | 当日条目标题 + 文字稿(央视网,当晚约 20:00 后更新;V3.9 新增) |
  183. ### 基础数据 + 公告
  184. <table>
  185. <thead>
  186. <tr><th nowrap>端点</th><th>数据</th></tr>
  187. </thead>
  188. <tbody>
  189. <tr><td nowrap>季报快照</td><td>37 字段(EPS / ROE / 净利润 / 主营收入...)</td></tr>
  190. <tr><td nowrap>F10 文本</td><td>「最新提示」(公告 / 报道 / 大宗 / 两融 / 风险提示摘要);2026-09 起服务端只剩这一类</td></tr>
  191. <tr><td nowrap>东财个股信息</td><td>行业/总股本/流通股/市值/上市日期(直连 push2)</td></tr>
  192. <tr><td nowrap>新浪财报三表</td><td>资产负债表/利润表/现金流量表(直连 quotes.sina.cn)</td></tr>
  193. <tr><td nowrap>巨潮公告</td><td>沪深北交所全量公告</td></tr>
  194. <tr><td nowrap><strong>估值历史</strong></td><td>日频 PE/PB/PS/PCF + 换手率 + 停牌 + ST(可回溯至 2016;<strong>不支持北交所</strong>,V3.7 新增)</td></tr>
  195. <tr><td nowrap><strong>上市/退市日</strong></td><td>ipoDate / outDate / 状态(唯一零鉴权退市日源,V3.7 新增)</td></tr>
  196. <tr><td nowrap><strong>申万行业变迁史</strong></td><td>每只股票历次行业调整(消除前视偏差;仅代码无中文名,V3.7 新增)</td></tr>
  197. <tr><td nowrap><strong>ST 名单</strong></td><td>沪深京 ST / *ST 当日名单 + 现价;东财不可达时退 baostock(只有沪深、无价格,V3.9 新增)</td></tr>
  198. </tbody>
  199. </table>
  200. ### 打板层(V3.3 新增)
  201. | 端点 | 数据 |
  202. |------|------|
  203. | 东财涨停池 | 连板数 / 几天几板 / 封板资金 / 炸板次数 / 首末封板时间 / 所属行业 |
  204. | 东财炸板池 | 曾涨停后开板 + 振幅 / 涨速 |
  205. | 东财跌停池 | 封单资金 / 连续跌停天数 / 开板次数 / 板上成交额 |
  206. | 东财昨日涨停池 | 昨涨停今表现(自算晋级率 / 赚钱效应) |
  207. | 同花顺涨停揭秘 | 涨停原因题材 / 封板成功率 / 一字·换手·T字板 / 封单额 |
  208. | 东财重点监控池 | 交易所风险警示 / 重点监控名单 + 生效时间窗(V3.6 新增)|
  209. | 东财日内异动池 | 严重异常波动明细 + 按标的聚合异动统计 + 12 条异动规则解释(V3.6 新增)|
  210. ### ETF 期权层(V3.3 新增)
  211. | 端点 | 数据 |
  212. |------|------|
  213. | 期权合约清单 | 50ETF / 300ETF / 科创50ETF / 500ETF 各月份认购认沽合约 |
  214. | T型报价 | 买卖五档 / 持仓量 / 行权价 / 最新价 / 成交量额 |
  215. | 希腊字母 + IV | Delta / Gamma / Theta / Vega / 隐含波动率 / 理论价值(交易所预算,免本地算 BSM) |
  216. ### 舆情互动层(V3.3 新增)
  217. <table>
  218. <thead>
  219. <tr><th nowrap>端点</th><th>数据</th></tr>
  220. </thead>
  221. <tbody>
  222. <tr><td nowrap>互动易问答</td><td>投资者提问 + 公司官方回复(巨潮,覆盖深市;AI 问答独家信源:公司如何回应某传闻/利好)</td></tr>
  223. <tr><td nowrap><strong>上证e互动</strong></td><td>沪市投资者提问 + 公司回复,补上互动易不覆盖的沪市(V3.9 新增)</td></tr>
  224. <tr><td nowrap>同花顺热榜</td><td>人气值 / 概念标签 / 排名变化</td></tr>
  225. <tr><td nowrap>东财人气榜</td><td>排名 + 排名变化 + 名称价格</td></tr>
  226. <tr><td nowrap>东财个股概念命中</td><td>这只票当下被市场归到哪些概念在炒 + 热度值</td></tr>
  227. </tbody>
  228. </table>
  229. ### 宏观与利率层(V3.7 新增,V3.9 扩展)
  230. <table>
  231. <thead>
  232. <tr><th nowrap>端点</th><th>数据</th></tr>
  233. </thead>
  234. <tbody>
  235. <tr><td nowrap><strong>人民银行社融</strong></td><td>社会融资规模增量月度 12 列(人民币贷款/委托/信托/未贴现汇票/企业债/政府债/股票融资/ABS/核销)</td></tr>
  236. <tr><td nowrap><strong>国家统计局 PMI</strong></td><td>制造业 / 非制造业商务活动 / 综合产出 + 大中小型企业分档</td></tr>
  237. <tr><td nowrap><strong>中债收益率曲线</strong></td><td>国债 / 商业银行 AAA / 中短期票据 AAA,3 个月~30 年关键期限(V3.9 新增)</td></tr>
  238. <tr><td nowrap><strong>回购定盘利率</strong></td><td>FR001 / FR007 / FR014 与 FDR 同期限(中国货币网,FR 约近 3 年、FDR 约近 1 年;V3.9 新增)</td></tr>
  239. <tr><td nowrap><strong>LPR</strong></td><td>1 年 / 5 年全历史(含 2013~2019 旧机制逐日报价,V3.9 新增)</td></tr>
  240. <tr><td nowrap><strong>全球宏观日历</strong></td><td>公布值 / 预期 / 前值 / 修正值 / 重要性(华尔街见闻,V3.9 新增)</td></tr>
  241. </tbody>
  242. </table>
  243. ### 指数与交易日历
  244. | 端点 | 数据 |
  245. |------|------|
  246. | 指数成分 | 中证最近成分、国证最近公布的月末成分;保留源侧日期,不提供历史时点回填 |
  247. | 指数权重 | 中证/国证最近公布权重;单位为百分数,不假定与成分同日 |
  248. | 指数估值 | 中证两种股本口径的 PE 和股息率;近期文件,不含 PB、不承诺全历史 |
  249. | 官方交易日历 | 深交所完整自然月交易标志,缺日/未发布/未知标志抛错 |
  250. ### 期货与大宗商品层(V3.9 新增,#49)
  251. <table>
  252. <thead>
  253. <tr><th nowrap>端点</th><th>数据</th></tr>
  254. </thead>
  255. <tbody>
  256. <tr><td nowrap><strong>期货日行情</strong></td><td>上期所 / 上期能源 / 郑商所 / 中金所 / 广期所官方收盘数据:开高低收、结算价、成交量、持仓量及变化、成交额</td></tr>
  257. <tr><td nowrap><strong>期权日行情</strong></td><td>商品期权 + 股指期权:行权价、结算价、成交持仓、Delta、隐含波动率(上期所 / 上期能源按系列,郑商所 / 广期所按合约;中金所不公布 Delta 和隐含波动率)</td></tr>
  258. <tr><td nowrap><strong>会员持仓排名</strong></td><td>成交量 / 持买单 / 持卖单前 20 名会员及增减(上期所、上期能源、郑商所、中金所)</td></tr>
  259. <tr><td nowrap><strong>实时期货</strong></td><td>新浪实时价、买卖一档,覆盖六家期货交易所(大商所品种走这里);涨跌停价只有中金所品种有</td></tr>
  260. <tr><td nowrap><strong>期货日 K</strong></td><td>新浪逐日 K 线,主力连续(<code>RB0</code> / <code>M0</code>,最早到 2005 年)或具体合约(约 2022 年起到期的),六家交易所全覆盖、含大商所;价格与官方日行情一致,结算价不全(V3.10 新增)</td></tr>
  261. <tr><td nowrap><strong>A50 期指</strong></td><td>富时中国 A50 连续合约报价</td></tr>
  262. <tr><td nowrap><strong>上海金现货</strong></td><td>上金所 Au99.99 / Au(T+D) / Ag(T+D) / Pt99.95 等日线</td></tr>
  263. </tbody>
  264. </table>
  265. > 大商所官网有 JS 反爬(纯 HTTP 返回 412),官方日行情未接入;大商所品种的历史日 K 用「期货日 K」,实时价用「实时期货」。
  266. ### 事件驱动层(V3.9 新增)
  267. | 端点 | 数据 |
  268. |------|------|
  269. | **业绩预告** | 预告类型、预计金额与变动幅度区间、上年同期、变动原因 |
  270. | **机构调研** | 调研汇总(接待机构数、方式、地点)或逐机构明细 |
  271. | **股东增减持** | 股东、方向、变动股数与比例、变动后持股、均价、渠道 |
  272. | **股票回购** | 方案价格上限、股数与金额区间、已回购股数与金额、进度 |
  273. | **股权质押** | 中国结算周度质押比例、质押股数与市值、笔数(只覆盖沪深) |
  274. | **新股申购日历** | 申购 / 中签 / 缴款 / 上市日期、发行价与市盈率、中签率、首日表现 |
  275. ### 可转债层(V3.9 新增)
  276. | 端点 | 数据 |
  277. |------|------|
  278. | **可转债** | 正股、评级、发行规模、转股价、转股价值、溢价率、上市 / 到期 / 摘牌日与状态 |
  279. ### 备用源(主源被封时降级)
  280. | 端点 | 数据 |
  281. |------|------|
  282. | 官方龙虎榜备胎 | 上交所 + 深交所官方接口,零鉴权权威一手,含营业部席位(东财被封时用) |
  283. | 资金流备胎 | 新浪日度四档单净额(超大/大/中/小单 + 净流入) |
  284. | 公告备胎 | 深市走深交所官方、沪市走东财,均带 PDF 直链(巨潮被封时用) |
  285. | 官方两融备胎 | 上交所/深交所分开查询,金额元、余量股/份;上交所缺融券余额金额时保留为空 |
  286. | 北交所行情备胎 | 全板或单票 OHLC/成交量额/五档快照,强制核对交易日;不提供历史回填,盘中延迟未标定 |
  287. > 另附**十五层主源 → 独立备胎速查表**(交易所官方 / 同花顺 F10 / HKEX / 巨潮 webapi / 金十等,全部不同风控面)与「已死透别用」名单,见 SKILL.md「备用源速查 & 降级策略」章节。V3.9 起 K 线主源改为腾讯,当日全市场日线可用通达信盘后包,研报列表可用新浪。
  288. ### 鉴权要求
  289. 除 iwencai 外,其余已接入数据源无需用户注册或 API Key;V3.8 的中证、国证和北交所,以及 V3.9 新增的 12 个来源(通达信官网、华尔街见闻、央视网、上证e互动、中债、中国货币网、五家期货交易所、上金所)也不需要用户凭据(北交所使用官网匿名 Cookie)。仅 iwencai 语义搜索需要 API Key([申请地址](https://www.iwencai.com/skillhub))。候选增强源不计入上述能力。
  290. ---
  291. ## 使用示例
  292. 跟你的 AI 助手说这些话就能激活:
  293. | 场景 | 说什么 |
  294. |------|--------|
  295. | 个股估值 | 「帮我估一下 688017,给我 PE / PEG / 消化时间」 |
  296. | 题材归因 | 「今天哪些股票走强,主要是什么题材」 |
  297. | 研报检索 | 「人形机器人产业链最近的研报,特别是丝杠和减速器」 |
  298. | 北向资金 | 「今天北向资金流入流出怎么样」 |
  299. | 概念板块 | 「688017 属于哪些概念板块」 |
  300. | 资金流向 | 「000858 今天主力资金流入还是流出」 |
  301. | 龙虎榜 | 「002475 最近上过龙虎榜吗,哪些营业部在买」 |
  302. | 全市场龙虎榜 | 「今天龙虎榜哪些票净买入最多」 |
  303. | 解禁预警 | 「这只股票未来 3 个月有没有限售解禁」 |
  304. | 行业轮动 | 「今天哪些行业涨幅最大」 |
  305. | **板块资金流** | 「今天主力资金在流入哪些行业/概念板块,近 5 日趋势呢」 |
  306. | 融资融券 | 「600519 最近的融资余额变化趋势」 |
  307. | 大宗交易 | 「这只票最近有没有大宗交易,溢价还是折价」 |
  308. | 股东户数 | 「000858 股东户数在增加还是减少,筹码集中吗」 |
  309. | 分红送转 | 「茅台历年分红派息多少」 |
  310. | **ETF 行情** | 「510050 上证50ETF 现在什么价、今天涨跌多少」 |
  311. | **涨停打板** | 「今天涨停多少家、最高几连板、炸板率多少」 |
  312. | **涨停归因** | 「今天涨停的票都是什么题材,哪些是几天几板」 |
  313. | **重点监控池** | 「现在哪些标的被交易所列入重点监控,监控到什么时候」 |
  314. | **日内异动** | 「今天有哪些严重异常波动的票,触发的是哪条异动规则」 |
  315. | **异动 × 监控交叉** | 「今天异动的票里,有没有已经在重点监控名单上的」 |
  316. | **ETF 期权** | 「50ETF 平值期权的隐含波动率和 Delta 是多少」 |
  317. | **互动易** | 「比亚迪最近投资者都在问什么,公司怎么回应的」 |
  318. | **市场热度** | 「今天哪些票最热门,被归到什么概念在炒」 |
  319. | 新闻公告 | 「拉一下 300476 最近的新闻和公告」 |
  320. | **市场快讯** | 「用财联社电报看看现在市场上有什么大新闻」 |
  321. | 批量对比 | 「帮我对比这 5 只半导体股的估值」 |
  322. | **筹码分布** | 「600519 现在获利盘多少,平均成本在哪,筹码峰压力位在哪」 |
  323. | **估值历史** | 「茅台现在的 PE 在过去十年是什么分位,顺便看下换手率」 |
  324. | **ST / 停牌** | 「000004 历史上哪段时间是 ST,有没有停过牌」 |
  325. | **行业变迁** | 「000001 在 2016 年属于哪个申万行业,跟现在一样吗」 |
  326. | **宏观环境** | 「最新社融和 PMI 什么水平,现在流动性是宽还是紧」 |
  327. | 指数成分 | 「沪深300最近的成分有哪些,文件日期是什么」 |
  328. | 指数权重 | 「创业板指最近公布的权重是多少,注意保留真实日期」 |
  329. | 指数估值 | 「中证沪深300近期 PE 和股息率,两种口径分别列出」 |
  330. | 交易日历 | 「2026 年 9 月哪些日期开市,按深交所官方日历」 |
  331. | 两融备胎 | 「东财不可用,分别取沪深交易所 2026-09-03 的两融明细」 |
  332. | 北交所备胎 | 「从北交所官方取 920021 当前快照,核对交易日」 |
  333. | **前复权 K 线** | 「600519 从 2025 年到现在的前复权日线,再给我 300750 最近 96 根 5 分钟线」 |
  334. | **全市场日线** | 「2026-09-18 沪深北全市场的收盘价和成交额,按成交额排前 20」 |
  335. | **研报第二来源** | 「东财连不上,用新浪看看 600519 最近有哪些研报」 |
  336. | **ETF 份额** | 「510300 这半年份额是在增加还是减少」 |
  337. | **7×24 快讯** | 「华尔街见闻 A 股频道最近 50 条快讯」 |
  338. | **新闻联播** | 「今晚新闻联播提到了哪些行业」 |
  339. | **ST 名单** | 「现在一共有多少只 ST 和 *ST,北交所有几只」 |
  340. | **沪市问答** | 「浦发银行最近在上证e互动回复了什么」 |
  341. | **利率曲线** | 「今年以来 10 年期国债收益率怎么走的,和 AAA 中短票的利差多少」 |
  342. | **资金面利率** | 「FR007 最近一个月的走势,LPR 上次调整是哪天」 |
  343. | **宏观日历** | 「下周有哪些重要宏观数据要公布;上周公布的数据和预期差多少」 |
  344. | **期货日行情** | 「上期所昨天螺纹钢和铜各合约的结算价和持仓」 |
  345. | **商品期权** | 「上期所铜期权昨天各合约的 Delta 和隐含波动率」 |
  346. | **期货持仓排名** | 「IF2610 前 20 名会员的多空持仓变化」 |
  347. | **大宗商品** | 「豆粕主力现在什么价,A50 期指和上海金呢」 |
  348. | **业绩预告** | 「三季报业绩预告里预增幅度最大的是哪些」 |
  349. | **机构调研** | 「688062 最近被哪些机构调研过」 |
  350. | **增减持 / 回购** | 「这个月有哪些股东在减持,哪些公司正在实施回购」 |
  351. | **股权质押** | 「质押比例最高的公司有哪些」 |
  352. | **新股申购** | 「这周有哪些新股可以申购,发行市盈率多少」 |
  353. | **可转债** | 「现在溢价率最低的可转债有哪些」 |
  354. | **聚宽代码** | 「把这批代码转成聚宽格式」 |
  355. ### 内置 4 套调研流程
  356. | 流程 | 做什么 | 耗时 |
  357. |------|--------|------|
  358. | 单票估值 | 实时价 → 一致预期 EPS → 前向 PE / PEG / PE 消化年数 | 30 秒 |
  359. | 批量对比 | 多只股票横向估值排列 | 1 分钟 |
  360. | 主题研报 | iwencai 多关键词 NL 搜索 + 东财 PDF 交叉补充 | 2 分钟 |
  361. | 新标的调研 | 机构覆盖 → 估值 → 概念板块 → 资金流向 → 龙虎榜 → 解禁 → 两融 | 1 分钟 |
  362. ---
  363. ## 数据源优先级(V3.9 重排,按封 IP 风险)
  364. > **原则:能用腾讯 / 交易所官方,就别用东财。** 行情 / K 线 / 实时价 / 市值 / 财务三表能从腾讯、交易所官方或新浪拿到的,一律走它们。mootdx 行情命令 2026-09 起失效(#52),只用于财务快照与 F10。东财只用于它独有、别处拿不到的数据,且全部走 `em_get()` 内置限流。
  365. <table>
  366. <thead>
  367. <tr><th nowrap>优先级</th><th>数据源</th><th nowrap>协议</th><th nowrap>封 IP 风险</th><th>用途</th></tr>
  368. </thead>
  369. <tbody>
  370. <tr><td nowrap><strong>1(首选)</strong></td><td>腾讯财经</td><td nowrap>HTTP</td><td><strong>不封 IP</strong>(K 线单入口约 600 次后限流,已三入口轮换)</td><td>实时价 / PE / PB / 市值 / 换手率 / 涨跌停 / 指数 / ETF / 日周月与分钟 K 线</td></tr>
  371. <tr><td nowrap><strong>2</strong></td><td>交易所 / 官方机构</td><td nowrap>HTTP</td><td nowrap>极低(避免高频)</td><td>通达信盘后包、沪深北交易所、五家期货交易所、上金所、中债、中国货币网、中证 / 国证、人民银行、国家统计局</td></tr>
  372. <tr><td nowrap><strong>3</strong></td><td>新浪 / 巨潮 / 同花顺 / 百度 / 财联社 / 华尔街见闻 / 央视网 / 申万</td><td nowrap>HTTP</td><td nowrap>低</td><td>财报三表、复权因子、研报列表、实时期货、公告、一致预期、热点与北向、带均线 K 线、快讯、新闻联播、行业变迁</td></tr>
  373. <tr><td nowrap><strong>4</strong></td><td>mootdx(通达信)</td><td nowrap>TCP 7709</td><td nowrap>不封 IP</td><td>财务快照、F10「最新提示」正常;<strong>K 线 / 盘口 / 逐笔 2026-09 起返回空(#52)</strong>,逐笔改用腾讯 §1.4</td></tr>
  374. <tr><td nowrap><strong>4</strong></td><td>baostock</td><td nowrap>TCP</td><td nowrap>低(免注册)</td><td>估值历史 PE/PB/PS/PCF + 换手率 + 停牌 + ST + 上市退市日(<strong>不支持北交所</strong>)</td></tr>
  375. <tr><td nowrap>需 Key</td><td>iwencai</td><td nowrap>OpenAPI</td><td nowrap>低</td><td>NL 语义搜索研报(唯一需要 Key 的来源)</td></tr>
  376. <tr><td nowrap><strong>末位(仅独有数据)</strong></td><td><strong>东财</strong> datacenter / push2 / reportapi / search / np-weblist</td><td nowrap>HTTP</td><td nowrap><strong>中 — 有风控会封 IP</strong></td><td>龙虎榜 / 解禁 / 两融 / 大宗 / 股东户数 / 分红 / 资金流 / 研报 PDF / 个股新闻 / 全球资讯 / ST 名单 / LPR / 事件驱动 / 可转债(已统一走 <code>em_get()</code> 限流)</td></tr>
  377. </tbody>
  378. </table>
  379. <details>
  380. <summary><b>34 个来源一览</b></summary>
  381. | # | 来源 | 主要用途 |
  382. |---|------|------|
  383. | 1 | 腾讯财经 | 实时估值、指数 / ETF、日周月与分钟 K 线 |
  384. | 2 | mootdx(通达信 TCP) | 财务快照、F10(行情命令已失效,#52) |
  385. | 3 | 东财 datacenter | 龙虎榜、解禁、两融、大宗、股东户数、分红、事件驱动、可转债、LPR |
  386. | 4 | 东财 push2 / push2his | 行业板块、资金流、个股信息、ST 名单 |
  387. | 5 | iwencai | 自然语言研报检索(需 Key) |
  388. | 6 | 东财 reportapi / PDF | 研报列表、评级、PDF |
  389. | 7 | 同花顺热点 | 强势股与题材归因、涨停揭秘、热榜 |
  390. | 8 | 同花顺 hsgtApi | 北向资金 |
  391. | 9 | 百度股市通 | 带均线 K 线 |
  392. | 10 | 新浪财经 | 财报三表、复权因子、ETF 期权、研报列表、实时期货、A50 |
  393. | 11 | 同花顺 basic | 一致预期 EPS |
  394. | 12 | 财联社 | 电报快讯 |
  395. | 13 | 巨潮 cninfo | 公告、互动易 |
  396. | 14 | 上交所官方 | 龙虎榜、五档、两融、ETF 份额 |
  397. | 15 | 深交所官方 | 龙虎榜、公告、五档、两融、交易日历、ETF 份额 |
  398. | 16 | baostock | 估值历史、上市退市日、ST 名单兜底 |
  399. | 17 | 申万研究 | 行业分类变迁史 |
  400. | 18 | 人民银行 | 社融 |
  401. | 19 | 国家统计局 | PMI |
  402. | 20 | 中证指数 | 成分、权重、PE 与股息率 |
  403. | 21 | 国证指数 | 成分、权重 |
  404. | 22 | 北交所官方 | 当前行情与五档 |
  405. | 23 | 通达信官网盘后包 | 某交易日沪深北全市场日线(含成交额) |
  406. | 24 | 华尔街见闻 | 7×24 快讯、全球宏观日历 |
  407. | 25 | 央视网 | 新闻联播条目与文字稿 |
  408. | 26 | 上证e互动 | 沪市投资者问答 |
  409. | 27 | 中债 | 国债与信用债收益率曲线 |
  410. | 28 | 中国货币网 | 回购定盘利率 FR / FDR |
  411. | 29 | 上期所 | 期货 / 期权日行情、持仓排名 |
  412. | 30 | 上期能源 | 原油 / 国际铜等期货期权、持仓排名 |
  413. | 31 | 郑商所 | 期货 / 期权日行情、持仓排名 |
  414. | 32 | 中金所 | 股指 / 国债期货、股指期权、持仓排名 |
  415. | 33 | 广期所 | 工业硅 / 碳酸锂等期货期权日行情 |
  416. | 34 | 上金所 | 黄金 / 白银 / 铂金现货日线 |
  417. </details>
  418. > **架构原则:** 除 mootdx 与 baostock(均为 TCP 客户端库)外,全部直连 HTTP API,不经第三方数据封装。**东财系接口有访问频率风控,所有调用统一经 `em_get()` 串行限流防封;批量任务请调大 `EM_MIN_INTERVAL`。**
  419. >
  420. > **降级原则:** 主源被封/失效时,查 SKILL.md「备用源速查 & 降级策略」。部分核心数据有**不同域名、不同风控面**的独立备胎;并非所有能力都有备份,取数后仍须检查日期与完整性。
  421. ---
  422. ## FAQ
  423. **Q: 指数权重为什么不是今天?能拿来回测吗?**
  424. 官方成分与权重可能按不同日期发布,国证这条接口返回月末快照;`date` 保存源文件日期。当前成分不能代替历史时点成分。本版未接入历史调样,也不把缺失的指数 PB 补为零。
  425. **Q: 两融和北交所备胎怎么用?**
  426. 先执行 SKILL.md 的 Layer 12 完整代码块,再执行「官方两融与北交所行情备胎」代码块。两融按 `SH` / `SZ` 分开取,北交所必须传期望交易日;日期不符、分页不全、源未发布均报错。
  427. **Q: mootdx 取不到 K 线 / `tdx_client()` 报「所有 mootdx 服务器均无法取到数据」?(#52)**
  428. 2026-09-20 逐台实测内置 10 台服务器,TCP 都能连上,财务、除权除息正常,F10 只剩「最新提示」一类,但 K 线、五档盘口、逐笔成交都返回 0 行。这是服务器端的变化,换 mootdx 版本解决不了。替代方案:
  429. > - 沪深日 / 周 / 月 K 线(前后复权)和 1~60 分钟 K 线 → §1.2 `tencent_kline()`
  430. > - 某交易日沪深北全市场日线(含成交额;北交所日线只能走这里)→ §1.3 `tdx_daily_package()`
  431. > - 实时价与五档 → §1.1 腾讯,或「备用源速查」里的交易所官方五档
  432. > - 当日逐笔成交 → §1.4 `tencent_ticks()`(只有最近一个交易日,不含北交所)
  433. > - 财务快照 / F10「最新提示」→ `tdx_client(check='finance')`,照常可用;F10 其余 8 类(公司概况、股东研究等)已不返回,替代见 SKILL.md §6.2
  434. >
  435. > `tdx_client()` 在 K 线模式下要先测速,全部失败大约需要 1 分钟才报错。
  436. **Q: easy_tdx(PR #54)、同花顺官方 API 等新项目加入了吗?**
  437. 没有。easy_tdx 是同一通达信协议的另一个客户端库,不是新的数据源,#52 已改走 HTTP 解决,所以 PR #54 不合并;本项目只接可直接取数的来源。同花顺金融 API 需要用户 Key,不接;集合竞价需先处理 Python 3.10+ 兼容性。候选状态见 [v3.8.0](docs/source-integration-v3.8.0.md) 与 [v3.9.0](docs/source-integration-v3.9.0.md) 整合记录。V3.9 不新增安装依赖。
  438. **Q: 能直接回测吗?能接聚宽吗?(#55)**
  439. 本 skill 只负责取数,**不带回测引擎**。回测要把数据交给自己的框架或聚宽。
  440. > - 代码格式:`norm_ticker()` / `get_prefix()` 认聚宽写法 `600519.XSHG` / `000001.XSHE`;`to_joinquant()` 把任意写法转成聚宽代码。聚宽公开文档没有北交所后缀,北交所代码会直接报错,不做转换。
  441. > - 复权:聚宽 `get_price` 默认前复权(`fq='pre'`)。对拍时用 §1.2 `tencent_kline(adjust='qfq')`,或用 §1.6 复权因子自己换算。
  442. > - 防未来函数:历史估值用 §6.5,历史行业归属用 §6.7,历史指数成分要注意 §12 只给当前快照。
  443. **Q: 研报只能从东财拿吗?(#53)**
  444. 不是。§2.4 `sina_research_reports()` 是第二来源,可按个股或全市场翻页,东财被封时也能用。它只有标题、类型、机构、研究员和日期,没有评级和目标价;评级与目标价仍用东财研报或同花顺一致预期。
  445. **Q: 有商品期货和期权吗?大商所呢?(#49)**
  446. 有,见期货与大宗商品层。上期所、上期能源、郑商所、中金所、广期所的官方期货日行情和期权日行情都有,会员持仓排名覆盖前四家(广期所未接);另有新浪实时期货、A50 期指和上金所现货。**大商所官网有反爬,官方日行情没接**;大商所品种(豆粕、铁矿石等)的历史日 K 用 V3.10 的 `futures_kline('M0')`(新浪,主力连续或具体合约),实时价用新浪实时期货。
  447. **Q: 沪市公司的互动易问答为什么是空的?**
  448. 巨潮互动易只覆盖深市公司,沪市公司实测返回 0 条。沪市请用 §10.3 `sse_e_interaction()`(上证e互动)。部分公司近一个月确实没有回复,返回空表属正常。
  449. **Q: 查北交所股票拿不到研报 / 行情价格明显不对?**
  450. 北交所老号段(`43x`/`83x`/`87x`)已基本作废。2026-07-31 实测:在市 342 只中 **336 只已迁至 `920xxx`**(锦波生物 `832982`→`920982`、贝特瑞 `835185`→`920185`)。老码最坑的地方是**不报错**——东财研报静默返回 0 篇(看着像"这票没研报"),腾讯行情返回定格在迁移日的**僵尸报价**(成交量 0,与真实价差 17%~100%+)。V3.6.0 起:`tencent_quote()` 返回 `is_stale` / `stale_reason` 标志,`eastmoney_reports()` 遇老码直接抛 `ValueError` 而不是返回空。**拿新码**:用 push2 北交所全量清单 `fs=m:0+t:81+s:2048` 按名称反查。V3.9 新入口的北交所边界:腾讯 K 线不支持北交所(直接报错),北交所日线用 §1.3 通达信盘后包;新浪研报会自动加 `bj` 前缀;股权质押统计不含北交所,传北交所代码直接报错。
  451. **Q: 传 `SH600519` / `600519.SH` 查不到数据?**
  452. V3.6.0 前研报层确实如此(reportapi 只认纯 6 位数字,带前缀静默返回 0 篇)。现已新增 `norm_ticker()` 并在研报层接入,四种写法结果一致;解析不出 6 位数字时**抛 ValueError 而非返回空**,避免把"代码写错"误读成"这票没数据"。
  453. **Q: SKILL.md 这么大,agent 每次加载很费 token?**
  454. 单文件自包含是本项目的**有意产品决策**——拷一个文件就能用、离线可携、便于分发,这个形态会长期保持,不做目录化拆分(相关讨论见 #21 / #22 / #29)。两个降耗建议:① v3.3.1 起 description 已收窄触发范围,无需取数的 A 股话题不会再误加载整个文件;② token 敏感的用户可以不把它装成自动触发 skill,改为放进项目目录、需要取数时让 agent 按需读取——文件按十五层组织、章节标题清晰,v3.4.0 起顶部还有「端点路由速查」总表(§→函数→用途→源),agent 按表定位后只读对应层,通常只花几 K token。
  455. **Q: 东财接口 403 / 连接重置,是被封了怎么办?**
  456. 东财系接口(datacenter/push2/push2ex/reportapi/search/np-weblist)共用同一套风控,IP 被封会成片失联。三步:① 停止请求等 30-60 分钟(IP 级临时封通常自动解除),或换网络(手机热点)立刻恢复;② 长批任务确认全部走 `em_get()` 并调大 `EM_MIN_INTERVAL`;③ 数据不能等 → 用 SKILL.md「备用源速查 & 降级策略」的独立备胎(交易所官方/新浪/同花顺,不同风控面)。
  457. **Q: 财联社快讯不是 V3.2 标注下线了吗?**
  458. 已复活(V3.4.0)。2026-05 死的是旧 `nodeapi` 系接口;官方新版 `v1/roll/get_roll_list` 一直可用,只是强制 `sign` 校验——sign 纯本地可算(`md5(sha1(按 key 字典序拼接的 query 串))`),零 key。与东财 7×24 全球资讯互为独立备份。
  459. **Q: mootdx 库听说停更了,还能用吗?**
  460. 库确实烂尾(最后 commit 2024-07,BESTIP bug 无官方修复)。内置的 `tdx_client()` 已绕开 BESTIP bug;目前只用它取财务与 F10,K 线见上面 #52 那条。
  461. **Q: `pip install mootdx` 把 httpx 降到 0.25.2,和 MCP(要 httpx≥0.27.1)冲突?(#30)**
  462. mootdx 上游锁了 `httpx<0.26`,与 MCP 等工具的 `httpx≥0.27` 硬冲突,skill 层改不动它的依赖声明。但**可以绕过**——关键点:**mootdx 取行情走的是 TCP 二进制协议(通达信 7709 端口),运行时根本不经过 httpx**,`httpx<0.26` 只是它声明的一个用不到的保守上限。两个务实解法:
  463. > 1. **`--no-deps` 升 httpx(推荐)**:装完 mootdx 后 `pip install --no-deps "httpx>=0.27.1"`,既满足 MCP,mootdx 也照常工作。pip 会留一条 incompatible 警告,但不影响运行(实测 mootdx 0.11.7 在 httpx 0.28.1 下取数正常)。
  464. > 2. **独立 venv 隔离**:把跑 mootdx 的部分和跑 MCP 的主环境分到不同 venv,彻底互不干扰。
  465. **Q: mootdx 和腾讯有什么区别?**
  466. 以前互补:mootdx 管价格 / 盘口 / K 线,腾讯管估值(PE / PB / 市值 / 换手率 / 涨跌停价)。#52 之后价格与 K 线都走腾讯,mootdx 只剩财务快照和 F10。两者都不封 IP。
  467. **Q: 在海外服务器跑,mootdx 超时?**
  468. mootdx 走 TCP 直连通达信行情服务器,需国内 IP 才稳定;#52 之后它只用于财务与 F10,K 线已改走腾讯与通达信盘后包(HTTP)。海外环境建议走代理或切换到 yfinance。
  469. **Q: 腾讯 API 字段 43 是 PB 吗?**
  470. 不是。43 = 振幅%,46 = PB。网上大量教程写错了,这里是实测校准结果。
  471. **Q: V3.0 为什么移除 akshare?**
  472. akshare 本质是对东财/同花顺/新浪等公开 API 的封装,中间层增加了故障点(版本兼容 bug、pandas 3.0 ArrowInvalid 等)。V3.0 直连底层 HTTP API,零中间依赖,更稳定可控。
  473. **Q: 行业板块为什么从同花顺换成东财?**
  474. 同花顺 `stock_board_industry_summary_ths` 接口 2026 年初加了反爬 401。东财 push2 行业板块(`m:90+t:2`)是完美替代,零鉴权且字段更丰富。
  475. **Q: iwencai 返回 401?**
  476. 检查:(1) API Key 有效性 (2) 是否携带了 X-Claw-* Headers。SkillHub 2.0 后强制要求。
  477. **Q: 同花顺热点 reason 字段为空?**
  478. 盘后数据还没更新,15:30 之后再调。个别 ST 股没有人工标注,`dropna` 过滤即可。
  479. **Q: 百度股市通 ResultCode 不稳定?**
  480. 已知坑——有时返回 int `0`,有时返回 string `"0"`。代码里用 `str()` 统一比较即可。
  481. **Q: 东财资金流/个股新闻偶尔返回空或 HTTP 000?(#18)**
  482. 部分**大陆住宅宽带 IP** 会被东财 push2/search-api 连接级间歇风控(表现 `HTTP 000` 连接被拒、或新闻只返回 `passportWeb` 无文章)。**这不是代码问题**——同一代码在其他网络/时段实测正常。对策:隔几分钟重试、换网络环境(手机热点)、调大 `EM_MIN_INTERVAL` 降频。日级资金流也可用腾讯 K 线或通达信盘后包的量价数据务实替代。
  483. **Q: 北向资金历史只有几天?**
  484. V2.1 改为本地自缓存。每次调用自动积累,越跑越丰富。首次运行只有当天数据。
  485. **Q: 不用 Claude Code,能用吗?**
  486. 能。SKILL.md 本质是 Markdown + 内嵌 Python 代码。Codex、OpenClaw 或任何 AI 编程助手都能读取。你也可以直接把 Python 代码段复制出来在自己的脚本里跑。
  487. ---
  488. ## 验证
  489. `python3 -m unittest discover -s tests -v` 直接从 SKILL.md 抽取发布代码,测试日期、字段、代码归属、单位、分页与错误传播,不访问网络(V3.10.4 共 208 条离线测试,另有 4 条联网测试默认跳过)。
  490. 真实网络测试需显式开启,日期须是源已发布数据的交易日:
  491. ```bash
  492. # V3.10 的逐笔、期货日 K,以及 §1.2 K 线成交量单位核对(会下载一次通达信盘后包)
  493. ASTOCK_LIVE_V310=1 python3 -m unittest tests.test_v310_sources -v
  494. # V3.9 新增的 25 个入口(31 次真实调用)
  495. ASTOCK_LIVE_V39=2026-09-18 python3 -m unittest tests.test_v39_sources -v
  496. # V3.8 的官方两融与北交所备胎
  497. ASTOCK_LIVE_TRADE_DATE=2026-09-04 ASTOCK_LIVE_MARGIN_DATE=2026-09-03 python3 -m unittest tests.test_official_data -v
  498. ```
  499. 逐个入口的实测行数与数据边界见 [v3.9.0 整合记录](docs/source-integration-v3.9.0.md);V3.8 的记录见 [v3.8.0](docs/source-integration-v3.8.0.md)。
  500. ## 更新日志
  501. 见 [CHANGELOG.md](./CHANGELOG.md)。
  502. ---
  503. ## 免责声明
  504. 本项目仅提供数据获取工具,不构成任何投资建议。股市有风险,投资需谨慎。
  505. ---
  506. ## License
  507. [Apache License 2.0](./LICENSE) — 自由使用,注明出处即可。
  508. **作者:** Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱:[simonlin0423@gmail.com](mailto:simonlin0423@gmail.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.