tdx-tq-sdk — lululu811/cli-anything-tdx-tq…

How to use

Copy the installation command and review the source package before installing it in your own agent environment.
Check the source document for required tools, credentials and supported hosts.
Describe your input and desired deliverable; review the output against the source material.

npx skills add https://github.com/lululu811/cli-anything-tdx-tq- --skill tdx-tq-sdk

Before you start

Installation does not include a model subscription, API allowance or permission to access your files.
Repository stars and installation counts describe activity, not an independent quality or security test.

Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

TDX TQ SDK CLI Skill

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

前置条件

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

安装

bash

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

命令组

market - 行情数据

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

market get - 获取 K 线数据

bash

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 格式输出

示例：

bash

# 获取亨通光电 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 - 获取实时行情快照

bash

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

参数：

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

示例：

bash

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

market divid - 获取除权除息数据

bash

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

参数：

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

示例：

bash

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 - 获取股票基础信息

bash

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

参数：

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

示例：

bash

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

stock more - 获取股票更多信息

bash

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

参数：

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

示例：

bash

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 - 获取板块列表

bash

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

参数：

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

示例：

bash

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

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

sector stocks - 获取板块成分股

bash

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

参数：

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

示例：

bash

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

financial - 财务数据

获取专业财务数据。

financial get - 获取专业财务数据

bash

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: 净利润

示例：

bash

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 - 调用指标公式

bash

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

参数：

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

示例：

bash

# 调用 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 - 调用选股公式

bash

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

参数：

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

示例：

bash

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

config - 配置管理

config show - 显示当前配置

bash

cli-anything-tdx-tq config show

config set - 设置配置

bash

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

status - 查看状态

bash

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

全局选项

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

输出格式

JSON 模式

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

bash

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

输出示例：

json

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

使用场景

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

bash

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

场景 2：获取板块成分股

bash

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

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

bash

# 获取多只股票的 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(后复权)

故障排除

初始化失败

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

bash

cli-anything-tdx-tq config show

模块未找到

重新安装：

bash

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