TDX TQ SDK CLI

通达信量化接口命令行工具 - 基于 TQ 策略模式

安装

前置条件

1. 通达信客户端：已启动并登录
2. 通达信安装路径：默认 D:\new_tdx64，可通过环境变量 TDX_PATH 修改
3. Python 3.8+

安装步骤

# 进入 cli_agent 目录
cd cli_agent

# 安装依赖
pip install -e .

验证安装

# 检查 CLI 是否可用
cli-anything-tdx-tq --version

# 查看帮助
cli-anything-tdx-tq --help

快速开始

1. 查看状态

cli-anything-tdx-tq status

2. 获取行情数据

# 获取日线数据
cli-anything-tdx-tq market get -s 600487.SH,000001.SZ -p 1d -c 60

# 获取实时行情
cli-anything-tdx-tq market snapshot -s 600487.SH

# 获取除权除息数据
cli-anything-tdx-tq market divid -s 600487.SH

3. 获取股票信息

# 获取基础信息
cli-anything-tdx-tq stock info -s 600487.SH

# 获取更多信息
cli-anything-tdx-tq stock more -s 600487.SH

4. 获取板块数据

# 获取行业板块列表
cli-anything-tdx-tq sector list -t 0

# 获取板块成分股
cli-anything-tdx-tq sector stocks -s 半导体

5. 获取财务数据

cli-anything-tdx-tq financial get -s 600487.SH -f FN1,FN4,FN6 --start 20240101 --end 20241231

6. 调用公式

# 调用指标公式
cli-anything-tdx-tq formula zb -n MA -a 5,10,20

# 调用选股公式
cli-anything-tdx-tq formula xg -n KDJ -a 9,3,3

7. 导出 JSON 格式

# 所有命令都支持 --json 输出
cli-anything-tdx-tq stock info -s 600487.SH --json

命令参考

全局命令

命令	说明
init	初始化连接
close	关闭连接
status	查看状态
config	配置管理

market - 行情数据

命令	说明
market get	获取 K 线数据
market snapshot	获取实时行情快照
market divid	获取除权除息数据

stock - 股票信息

命令	说明
stock info	获取股票基础信息
stock more	获取股票更多信息

sector - 板块数据

命令	说明
sector list	获取板块列表
sector stocks	获取板块成分股

financial - 财务数据

命令	说明
financial get	获取专业财务数据

formula - 公式调用

命令	说明
formula zb	调用指标公式
formula xg	调用选股公式

环境变量

变量	说明	默认值
TDX_PATH	通达信安装路径	D:\new_tdx64

输出格式

JSON 模式

所有命令都支持 --json 选项，输出 JSON 格式数据，便于 Agent 消费：

cli-anything-tdx-tq stock info -s 600487.SH --json

表格模式（默认）

默认输出为人类可读的表格格式。

故障排除

错误：初始化失败

确保：

1. 通达信客户端已启动并登录
2. 通达信安装路径正确
3. D:\new_tdx64\PYPlugins\sys\tqcenter.py 存在

错误：模块未找到

运行 pip install -e . 重新安装。

开发

# 开发模式安装
pip install -e .

# 运行测试
pytest tests/

License

MIT