tdx-tq-sdk

name	tdx-tq-sdk
description	通达信 TQ SDK CLI - 通达信量化接口命令行工具
version	1.0.0

TDX TQ SDK CLI Skill

通达信量化接口命令行工具，基于 TQ 策略模式，提供完整的股票数据获取和分析功能。

前置条件

1. 通达信客户端：必须已启动并登录
2. 通达信安装：默认路径 D:\new_tdx64
3. Python 环境：Python 3.8+

安装

cd D:/TDX-SKILL/tdx-tq-sdk/cli_agent
pip install -e .

命令组

market - 行情数据

获取股票 K 线数据、实时行情、除权除息数据等。

market get - 获取 K 线数据

cli-anything-tdx-tq market get -s <股票代码> [选项]

参数：

• -s, --stocks: 股票代码列表，逗号分隔（必填）
• -p, --period: 周期，可选 tick/1m/5m/1d/1w/1mon（默认：1d）
• -c, --count: 获取数量（默认：60）
• -d, --dividend: 复权类型，可选 none/front/back（默认：front）
• -o, --output: 输出文件路径
• --json: 以 JSON 格式输出

示例：

# 获取亨通光电 60 条日线数据
cli-anything-tdx-tq market get -s 600487.SH -c 60

# 获取前复权数据
cli-anything-tdx-tq market get -s 600487.SH -d front

# 获取多只股票数据
cli-anything-tdx-tq market get -s 600487.SH,000001.SZ,600519.SH

# 输出 JSON 格式
cli-anything-tdx-tq market get -s 600487.SH --json

market snapshot - 获取实时行情快照

cli-anything-tdx-tq market snapshot -s <股票代码> [选项]

参数：

• -s, --stock: 股票代码（必填）
• --json: 以 JSON 格式输出

示例：

cli-anything-tdx-tq market snapshot -s 600487.SH
cli-anything-tdx-tq market snapshot -s 600487.SH --json

market divid - 获取除权除息数据

cli-anything-tdx-tq market divid -s <股票代码> [选项]

参数：

• -s, --stock: 股票代码（必填）
• --start: 开始时间 YYYYMMDD
• --end: 结束时间 YYYYMMDD
• --json: 以 JSON 格式输出

示例：

cli-anything-tdx-tq market divid -s 600487.SH
cli-anything-tdx-tq market divid -s 600487.SH --start 20230101 --end 20241231

stock - 股票信息

获取股票基础信息、更多信息等。

stock info - 获取股票基础信息

cli-anything-tdx-tq stock info -s <股票代码> [选项]

参数：

• -s, --stock: 股票代码（必填）
• --json: 以 JSON 格式输出

示例：

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

stock more - 获取股票更多信息

cli-anything-tdx-tq stock more -s <股票代码> [选项]

参数：

• -s, --stock: 股票代码（必填）
• -f, --fields: 指定字段，逗号分隔
• --json: 以 JSON 格式输出

示例：

cli-anything-tdx-tq stock more -s 600487.SH
cli-anything-tdx-tq stock more -s 600487.SH -f HisHigh,HisLow,ZTPrice

sector - 板块数据

获取板块列表、板块成分股等。

sector list - 获取板块列表

cli-anything-tdx-tq sector list [选项]

参数：

• -t, --type: 板块类型，0=行业/1=概念/2=风格（默认：0）
• --json: 以 JSON 格式输出

示例：

# 获取行业板块
cli-anything-tdx-tq sector list

# 获取概念板块
cli-anything-tdx-tq sector list -t 1

sector stocks - 获取板块成分股

cli-anything-tdx-tq sector stocks -s <板块名称> [选项]

参数：

• -s, --sector: 板块名称（必填）
• --json: 以 JSON 格式输出

示例：

cli-anything-tdx-tq sector stocks -s 半导体
cli-anything-tdx-tq sector stocks -s 人工智能 --json

financial - 财务数据

获取专业财务数据。

financial get - 获取专业财务数据

cli-anything-tdx-tq financial get -s <股票列表> -f <字段列表> [选项]

参数：

• -s, --stocks: 股票代码列表，逗号分隔（必填）
• -f, --fields: 字段列表，逗号分隔（必填），如 FN1(EPS),FN4(BPS),FN6(ROE)
• --start: 开始时间 YYYYMMDD
• --end: 结束时间 YYYYMMDD
• --json: 以 JSON 格式输出

常用字段：

• FN1: 每股收益 (EPS)
• FN4: 每股净资产 (BPS)
• FN6: 净资产收益率 (ROE)
• FN230: 营业收入
• FN232: 净利润

示例：

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

formula - 公式调用

调用通达信指标公式、选股公式。

formula zb - 调用指标公式

cli-anything-tdx-tq formula zb -n <公式名> [选项]

参数：

• -n, --name: 指标公式名称（必填）
• -a, --args: 公式参数，逗号分隔
• -s, --stock: 股票代码
• --json: 以 JSON 格式输出

示例：

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

# 调用 KDJ 指标
cli-anything-tdx-tq formula zb -n KDJ -a 9,3,3

formula xg - 调用选股公式

cli-anything-tdx-tq formula xg -n <公式名> [选项]

参数：

• -n, --name: 选股公式名称（必填）
• -a, --args: 公式参数，逗号分隔
• -s, --stocks: 股票列表，逗号分隔
• --json: 以 JSON 格式输出

示例：

cli-anything-tdx-tq formula xg -n KDJ -a 9,3,3

config - 配置管理

config show - 显示当前配置

cli-anything-tdx-tq config show

config set - 设置配置

cli-anything-tdx-tq config set --tdx-path D:\new_tdx64

status - 查看状态

cli-anything-tdx-tq status [--json]

全局选项

选项	说明
--help	显示帮助信息
--version	显示版本号
--tdx-path	通达信安装路径（可通过 TDX_PATH 环境变量设置）

输出格式

JSON 模式

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

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

输出示例：

{
  "Code": "600487.SH",
  "Name": "亨通光电",
  "Industry": "通信设备",
  "Area": "江苏",
  ...
}

使用场景

场景 1：获取单只股票数据

# 获取日线数据
cli-anything-tdx-tq market get -s 600487.SH -c 100 --json > data.json

场景 2：获取板块成分股

# 获取半导体板块所有股票
cli-anything-tdx-tq sector stocks -s 半导体 --json > semiconductor.json

场景 3：批量获取财务数据

# 获取多只股票的 EPS 和 ROE
cli-anything-tdx-tq financial get -s 600487.SH,000001.SZ,600519.SH -f FN1,FN6 --json

注意事项

1. 前置条件：必须先启动并登录通达信客户端
2. 股票代码格式：6 位数字 + 市场后缀，如 600487.SH
3. 时间格式：YYYYMMDD，如 20240101
4. 数据周期：tick, 1m, 5m, 1d, 1w, 1mon 等
5. 复权类型：none(不复权), front(前复权), back(后复权)

故障排除

初始化失败

确保通达信客户端已启动并登录，检查路径配置：

cli-anything-tdx-tq config show

模块未找到

重新安装：

cd D:/TDX-SKILL/tdx-tq-sdk/cli_agent
pip install -e .