pytdxdata

通达信(TongDaXin)行情数据客户端：动态连接池 + 双层 TTL 缓存 + 多连接并发分页，纯 asyncio、零运行时依赖。

A股(沪/深/北) + 港股 + 美股 + 期货 + 期权，一套接口全市场。

📖 完整文档：https://openbot-coder.github.io/pytdxdata/

安装

pip install pytdxdata          # 或 uv add pytdxdata

可选异步加速：

pip install "pytdxdata[uvloop]"

30 秒上手

import asyncio
from pytdxdata import TdxData
from pytdxdata.models import KlinePeriod, Adjust

async def main():
    async with TdxData() as td:                     # 自动建连接池 + 缓存
        # 日K线（count 超过单页大小会自动多连接并发分页）
        bars = await td.get_bars(["sz000001"], KlinePeriod.DAY, count=240)
        # 前复权（自动走 MAC 通道）
        qfq = await td.get_bars(["sz300308"], KlinePeriod.DAY,
                                 count=500, adjust=Adjust.QFQ)
        # 跨市场报价：A股+港股+美股一次拿全
        quotes = await td.get_quotes(["sh600000", "hk00700", "usAAPL"])
        # 逐笔成交（MAC 通道，支持历史日期）
        ticks = await td.get_ticks(["sz000001"], date=20260811)
        print(bars[-1].close, quotes[0].price, len(ticks))

asyncio.run(main())

返回的是标准库 dataclass 组成的 list（库本身不依赖 pandas）。要 DataFrame 一行转：

from dataclasses import asdict
import pandas as pd
df = pd.DataFrame([asdict(b) for b in bars])

特性

文档导航

本 README 只做入口层。深度内容一律在文档站，避免两处维护造成漂移。

给 AI 助手用

仓库根的 SKILL.md 是一份可直接加载的技能：三条必守约定、KlinePeriod 等枚举取值表、 「想做什么 → 用哪个方法」决策表、以及 11 条真实陷阱。AI 编程助手读完就能一次写对，不必翻源码。

# 丢进你所用 AI 助手的 skills 目录即可
curl -o ~/.workbuddy/skills/pytdxdata/SKILL.md --create-dirs \
  https://raw.githubusercontent.com/openbot-coder/pytdxdata/main/SKILL.md

示例

• examples/quickstart.py — 报价 / K线 / 分时 / 板块
• examples/server_files.py — 板块 / 行业 / 财报 下载 + 解析

开发

uv sync                        # 建虚拟环境 + 注册 tdx 命令
uv run pytest tests/           # 182 个测试用例（协议 / 池 / 缓存 / 分页 / 全接口回归 / 文件解析 / CLI / 文档漂移 / 当日测速缓存）
uv sync --group docs           # 文档站依赖（mkdocs-material + mkdocstrings）
uv run mkdocs serve            # 本地预览文档站

已知限制

• 行情来自通达信公开服务器，15 分钟延时；需实时数据请使用券商行情
• 标准通道 K 线 count < 100 部分服务器返回空 → 分页器已强制 min_page=100 规避
• 港股 / 美股期权在通达信协议内无数据
• 服务器可用性随时间变化。当日首次启动会自动在后台测速并缓存（对调用方无感，当天不再重测）； 也可用 python -m pytdxdata.server_probe 离线重生成随包清单。 缓存路径与三个开关见 安装与配置 → 当日自动测速

免责声明

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

License

MIT