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

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

作者：Simon 林 · X @linsizhen · 邮箱：[email protected]

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

十五层数据架构，87 个能力端点（82 主端点 + 5 备胎）、34 个来源。V3.10 新增的 2 个入口于 2026-09-22 实测，V3.9 新增的 25 个入口于 2026-09-20 实测；旧端点的验证日期见各章节。覆盖主板/创业板/科创板/ST，北交所覆盖依端点而异；已有备胎的数据可按「备用源速查」降级。

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

V3.10.1（成交量单位与对账口径更正 · 逐笔提速与盘后核对，2026-10-07 · #57）： 入口数、来源数不变，返回的数据不变。

• §1.2 tencent_kline() 的 volume：科创板（688 / 689）是股，其余是手；此前文档全写成「手」，按此换算科创板会大 100 倍。 备用源速查里「成交额 = 量(手) × 100 × 均价」同样更正。
• §1.2 补成交量对账口径：科创板以外日线是整手、最近一个交易日的分钟量也是整手（下一个交易日才回填成精确股数）； 1 分钟线 09:30 那根只有集合竞价、13:01 开盘价是上午收盘价；深市整分时刻的成交腾讯与 Baostock 分在相邻两根；无成交分钟：第一笔成交以前沪深都没有行，之后深市会缺行。
• §1.4 tencent_ticks() 改走复用连接、自动重试的 V39_RETRY_SESSION：一次约 70 秒 → 约 25 秒；连接失败、等响应超时、 429 / 5xx 自动重试，不再一次抖动就整次失败（读响应体中途卡住不重试）。 新增 frame.attrs["complete"]，15:31 以后用快照的盘后成交额核对盘后定价各笔（此前末尾缺笔完全看不出；低价 ETF 一两手的小额缺笔仍看不出）。
• §13.7 futures_kline() 同样自动重试，单次超时收短到 (5, 20) 秒；补上中金所主力连续只从 2017-01-17 起。

V3.10.0（逐笔替代 / 期货日 K / 行情层重排，2026-09-22）： 85→87 个能力入口（82 主 + 5 备胎），来源数不变（34）。

• §1.4 腾讯逐笔 tencent_ticks()：替代 #52 后返回空的 mootdx transaction()。最近一个交易日的全部分笔（沪深个股 + ETF）， 收盘后与行情快照的当日成交额核对，连续竞价段缺笔直接报错；只有当日、不含北交所。
• §13.7 新浪期货日 K futures_kline()：单个合约或主力连续的逐日 K 线，六家交易所含大商所（此前大商所只有实时价）； 实测价格与交易所官方逐日一致。
• 行情层重排：能用的在前，mootdx 行情命令移到 §1.7 留档。新旧编号对照见 Layer 1 开头；下面历史版本说明里写的仍是旧编号。
• 期货修正：上期能源在各类数据首日前抛 ValueError（此前报成「格式可能已变」的 RuntimeError），期权首日更正为 2021-06-21； 上期所日行情实测最早 2002-01-07、中金所 2010-04-16，文档原写 2015 年。

V3.9.0（期货大宗 / 事件驱动 / 可转债 / 利率 + 四个 issue，2026-09-20）： 新增 §13 期货与大宗商品、§14 事件驱动、 §15 可转债三层，并在原有各层补齐 K 线、研报、ETF 份额、新闻、ST 名单、沪市问答、利率曲线等入口。 12→15 层，60→85 个能力入口（80 主 + 5 备胎），22→34 个来源（新增通达信官网盘后包、华尔街见闻、央视网、上证e互动、 中债、中国货币网、上期所、上期能源、郑商所、中金所、广期所、上金所）；无新增安装依赖，保留 Python 3.9。

• #52 mootdx 行情命令失效：通达信公开服务器的 K 线 / 盘口 / 逐笔返回 0 行，财务与 F10 正常。tdx_client(check='finance') 让财务 / F10 按财务命令验活；K 线改走 §1.5 腾讯 / §1.6 通达信盘后包，tdx_client() 失败时的报错直接指路。
• #49 商品期货 / 期权：§13 接入五家期货交易所官方日行情与商品 / 股指期权、四家（广期所除外）的会员持仓排名，另有新浪实时期货（含大商所）、 A50 期指与上海金交所现货。大商所官网有反爬，日行情未接入。
• #53 研报来源：新增 §2.4 新浪研报列表，作为东财之外的第二来源（只有列表，无评级与目标价）。
• #55 聚宽代码：norm_ticker() / get_prefix() 认 .XSHG / .XSHE，新增 to_joinquant()；FAQ 说明回测能力边界。