Files
pytdxdata/docs/index.md
T
openbot-coder 1bee6b0fc7 release: v0.5.0(文档站 + README 瘦身 + AI 助手技能)
新增
- 文档站(MkDocs + Material + mkdocstrings),push main 自动构建并部署 GitHub Pages
- SKILL.md:面向 AI 编程助手的技能文件(三条必守约定 / 枚举取值表 / 任务→方法决策表 / 9 条陷阱)
- docs/ai.md:文档站的「AI 助手接入」页
- tests/test_check_docs.py(10 项):漂移检查器自身的自测

变更
- README 361 → 125 行,只保留入口层;CLI 手册 / API 表 / 通道路由 / 架构树 /
  扩展市场 / easy-tdx 对比 / Changelog 全部移交文档站与 CHANGELOG.md
- README 相对链接改为绝对 URL(PyPI 渲染不重写相对链接,原本在 PyPI 页面全 404)
- check_docs.py 扩展为两档:MUST_LIST_ALL(须列全)+ MUST_NOT_BE_STALE(只需无过时引用),
  并把 SKILL.md / README / llms.txt / 教程类页面纳入;白名单放行 config 的模块级函数
- 版本号 0.4.0 → 0.5.0;包元数据 Documentation 指向文档站
- uv.lock 同步

修复
- ExMarket 成员数 52 → 46(实测 IntEnum 成员数),4 处文档同步更正
- docs/ai.md 的 3 处相对链接 + CHANGELOG 的 SKILL.md 链接(会导致 mkdocs --strict 失败)
- README 标注的测试数量 85 → 109(pytest 实际收集用例数)
2026-09-15 14:55:07 +08:00

5.5 KiB
Raw Permalink Blame History

pytdxdata

CI PyPI version Python License

通达信(TongDaXin)行情数据客户端:动态连接池 + 双层 TTL 缓存 + 3 连接并发分页。

纯 asyncio 实现,零运行时依赖(只用 stdlib);A股(沪/深/北) + 港股 + 美股 + 期货 + 期权,一套接口全市场。

pip install pytdxdata
import asyncio
from pytdxdata import TdxData
from pytdxdata.models import KlinePeriod

async def main():
    async with TdxData() as td:                      # 自动探测服务器 + 建池 + 建缓存
        bars = await td.get_kline(1, "600000", KlinePeriod.DAY, count=2400)
        print(bars[-1].datetime, bars[-1].close)

asyncio.run(main())

特性

特性 说明
🧩 动态连接池 启动时对服务器真实 K 线探测选优(剔除握手正常但返回空数据的坏节点);健康分(失败 ×0.5 / 成功 +0.2 / 冷却 120s)+ EWMA 延迟选路;按等待队列与空闲时长动态扩缩容;跨服务器故障转移
🗄️ 双层 TTL 缓存 内存 LRU + 磁盘 SQLite(WAL);TTL 分级:报价 5s / 分钟K线 60s / 日线当天 / 复权K线 1天 / 历史逐笔永久;single-flight 同键并发去重;缓存「已解析记录」,重复请求 0 网络 0 解析
⚡ 并发分页 把大请求拆成显式 start 偏移的页,多连接并行拉取、按序拼接、失败换连接重试
🔀 双通道整合 标准通道(经典行情)+ MAC 通道(逐笔 / 复权 / 1分钟K线),按命令自动选路
📄 服务器文件解析 板块 block_*.dat / 行业 tdxhy.cfg / 历史财报 gpcw*.zip 下载即解析成 dataclass(纯 stdlib),无需自己拆二进制
🚀 批量下载 get_kline_batch / get_minute_batch,多股票自动并发,连接池分配到不同服务器
📦 零重型依赖 返回 list[dataclass],pandas / polars 由调用方按需转换

从这里开始

设计取舍

参照 easy-tdx 重新实现,解决其三大短板(无连接池、串行分页、单连接单锁)。 协议层独立实现——不依赖 easy-tdx 包,仅参照其字节级格式。

维度 easy-tdx pytdxdata
并发分页 ❌ 串行 while 循环 ✅ 3 连接并行
连接池 ❌ 单连接单锁 ✅ 动态池 + 故障转移
缓存 仅证券列表(1天) ✅ 双层 TTL + single-flight
数据正确性 基准 ✅ K线 6 字段 / 报价 7 字段逐字段一致(实测)
2400 根日K耗时 0.31s 0.16s(1.97x)
缓存命中重取 — 0.016s(0 网络)
依赖 pandas 等 零运行时依赖

实测环境:Windows 11 / Python 3.13 / 同一批通达信服务器(2026-08)。

数据来源与限制

  • 行情来自通达信公开行情服务器(无需账号),15 分钟延时;需实时数据请使用券商行情
  • 服务器清单由 python -m pytdxdata.server_probe 探测生成,可用性随时间变化
  • 港股 / 美股 / 期货 / 期权走通达信 EX 通道(端口 7727),部分市场(美股期权、港股期权)协议内无数据

完整清单见 常见问题。

!!! warning "免责声明" 本包仅用于技术研究与教育目的。行情数据来自通达信公开接口,不保证实时性与准确性; 作者不对任何投资决策负责。使用前请遵守通达信服务条款及相关法律法规。

目录