Home

easy-tdx Wiki

通达信 TCP 行情协议的 Python 客户端库。一个包搞定 A 股、港股、美股、期货行情数据。

它能做什么

• 实时行情：批量报价、分时图、逐笔成交
• 历史数据：K 线（日/周/月/分钟，支持前复权/后复权）
• 板块分析：行业/概念板块列表、成分股、资金流向
• 技术指标：32 个内置指标（MACD、KDJ、RSI、BOLL 等），支持自定义参数
• 缠论分析：笔、中枢、线段、买卖点、背驰，CLI 和 Python API 双通道
• 扩展市场：港股主板/创业板、美股、国内期货
• 离线读取：直接从本地通达信安装目录解析数据文件，不需要网络
• 回测引擎：内置向量回测，15 个自带策略，多因子组合回测，资金曲线可视化
• 策略选股：用策略扫描全市场买入信号，回测排名一步到位
• CLI 工具：easy-tdx 命令行，默认输出 JSON，方便接入 AI Agent

30 秒上手

pip install easy-tdx
easy-tdx ping
easy-tdx kline SH 600519 --count 10 --table
easy-tdx quote "SZ 000001,SH 600519" --table

Python 里这样用：

from easy_tdx import MacClient, Market

with MacClient.from_best_host() as c:
    df = c.get_stock_kline(Market.SH, "600519", count=10)
    print(df)

文档目录

页面	内容
安装与快速开始	安装方式、环境要求、第一个请求
CLI-使用指南	所有命令行命令的用法和示例
Python-API-参考	所有客户端类和方法的详细说明
技术指标	32 个指标的用法、参数、输出列
缠论分析	缠论技术分析：笔/中枢/线段/买卖点/背驰
回测引擎	单策略/批量对比/多因子组合/自定义策略编写
策略选股扫描	全市场信号扫描 + 回测排名两步走
扩展市场	港股、美股、期货行情接入
离线数据读取	离线数据读取 + 写入同步
协议与架构	通达信 TCP 协议细节、代码结构
常见问题	常见报错和解决方案

相关链接

• GitHub 仓库
• PyPI
• 问题反馈