tdx-tq-sdk

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

用途 该工具面向需要通过命令行访问通达信数据的量化场景，可获取行情、股票基础信息、板块、财务数据，并调用通达信指标公式与选股公式。

前置条件

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

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

主要能力与命令组

1. market - 行情数据

• market get：获取 K 线数据。参数包括 -s/--stocks（股票代码列表，逗号分隔，必填）、-p/--period（周期，可选 tick/1m/5m/1d/1w/1mon，默认 1d）、-c/--count（获取数量，默认 60）、-d/--dividend（复权类型，可选 none/front/back，默认 front）、-o/--output（输出文件路径）、--json。
• market snapshot：获取实时行情快照。参数包括 -s/--stock（股票代码，必填）、--json。
• market divid：获取除权除息数据。参数包括 -s/--stock（必填）、--start（开始时间 YYYYMMDD）、--end（结束时间 YYYYMMDD）、--json。

1. stock - 股票信息

• stock info：获取股票基础信息。参数包括 -s/--stock（必填）、--json。
• stock more：获取股票更多信息。参数包括 -s/--stock（必填）、-f/--fields（指定字段，逗号分隔）、--json。

1. sector - 板块数据

• sector list：获取板块列表。参数包括 -t/--type（板块类型，0=行业/1=概念/2=风格，默认 0）、--json。
• sector stocks：获取板块成分股。参数包括 -s/--sector（板块名称，必填）、--json。

1. financial - 财务数据

• financial get：获取专业财务数据。参数包括 -s/--stocks（股票代码列表，逗号分隔，必填）、-f/--fields（字段列表，逗号分隔，必填，如 FN1(EPS),FN4(BPS),FN6(ROE)）、--start（开始时间 YYYYMMDD）、--end（结束时间 YYYYMMDD）、--json。常用字段：FN1 每股收益(EPS)、FN4 每股净资产(BPS)、FN6 净资产收益率(ROE)、FN230 营业收入、FN232 净利润。

1. formula - 公式调用

• formula zb：调用指标公式。参数包括 -n/--name（指标公式名称，必填）、-a/--args（公式参数，逗号分隔）、-s/--stock（股票代码）、--json。
• formula xg：调用选股公式。参数包括 -n/--name（选股公式名称，必填）、-a/--args（公式参数，逗号分隔）、-s/--stocks（股票列表，逗号分隔）、--json。

1. config - 配置管理

• config show：显示当前配置。
• config set：设置配置，如 --tdx-path D:\new_tdx64。

1. status - 查看状态

• status [--json]。

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

输出格式 所有命令都支持 --json 选项，输出 JSON 格式数据。例如：cli-anything-tdx-tq stock info -s 600487.SH --json，输出包含 Code、Name、Industry、Area 等字段。

使用方式示例

• 获取单只股票数据：cli-anything-tdx-tq market get -s 600487.SH -c 100 --json > data.json
• 获取板块成分股：cli-anything-tdx-tq sector stocks -s 半导体 --json > semiconductor.json
• 批量获取财务数据：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 .）。

其他信息（如收费、价格、平台支持范围等）暂未提供。