lululu811/cli-anything-tdx-tq-

tdx-tq-sdk

通达信 TQ SDK CLI - 通达信量化接口命令行工具

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/lululu811/cli-anything-tdx-tq- --skill tdx-tq-sdk

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

TDX TQ SDK CLI Skill

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

前置条件

  1. 通达信客户端:必须已启动并登录
  2. 通达信安装:默认路径 D:\new_tdx64
  3. 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

注意事项

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

故障排除

初始化失败

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

bash
cli-anything-tdx-tq config show

模块未找到

重新安装:

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