By name: tdx-tq-sdk description: 通达信 TQ SDK CLI - 通达信量化接口命令行工具 version: 1.0.0
TDX TQ SDK CLI Skill
通达信量化接口命令行工具，基于 TQ 策略模式，提供完整的股票数据获取和分析功能。
前置条件
- 通达信客户端：必须已启动并登录
- 通达信安装：默认路径
D:\new_tdx64 - 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
注意事项
- 前置条件：必须先启动并登录通达信客户端
- 股票代码格式：6 位数字 + 市场后缀，如
600487.SH - 时间格式：YYYYMMDD，如
20240101 - 数据周期：tick, 1m, 5m, 1d, 1w, 1mon 等
- 复权类型：none(不复权), front(前复权), back(后复权)
故障排除
初始化失败
确保通达信客户端已启动并登录，检查路径配置：
cli-anything-tdx-tq config show
模块未找到
重新安装：
cd D:/TDX-SKILL/tdx-tq-sdk/cli_agent
pip install -e .