# pytdxdata [](https://github.com/openbot-coder/pytdxdata/actions/workflows/ci.yml) [](https://pypi.org/project/pytdxdata/) [](https://pypi.org/project/pytdxdata/) [](https://github.com/openbot-coder/pytdxdata/blob/main/LICENSE) 通达信(TongDaXin)行情数据客户端:**动态连接池 + 双层 TTL 缓存 + 3 连接并发分页**。 纯 `asyncio` 实现,**零运行时依赖**(只用 stdlib);**A股(沪/深/北) + 港股 + 美股 + 期货 + 期权**,一套接口全市场。 ```bash pip install pytdxdata ``` ```python 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 由调用方按需转换 | ## 从这里开始