SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场tdxquant

tdxquant

数据与分析

查看项目

更新于 10-15 09:29

技能介绍

用途

tdxquant 是一个通达信量化数据获取技能，用于通过通达信 TdxQuant（tqcenter）接口获取 A 股市场数据、执行技术分析和查询交易相关信息。当用户提及 tdxquant、通达信、TdxQuant、tqcenter，并且需要获取 A 股数据、查询交易日历、执行通达信公式、订阅行情或交易下单时使用。

主要能力

该技能覆盖以下数据与操作能力：

  • 行情快照、K 线数据、证券基本信息、股票更多信息、分红配送、股本数据
  • 专业财务数据、指定日期财务数据、单个财务指标
  • 股票交易数据、板块交易数据、市场交易数据
  • 系统分类成份股、板块代码列表、板块成份股、股票所属板块、自定义板块操作
  • 可转债信息、ETF 跟踪指数、新股申购
  • 交易日历
  • 通达信公式执行（指标、选股、专家、批量选股）
  • 行情订阅
  • 交易下单、查询持仓/委托/资产、撤单

使用方式

前置准备

tqcenter 模块位于通达信安装目录的 PYPlugins\user\tqcenter.py。脚本通过 _tdx_init.py 自动检测安装目录并将路径加入 sys.path，用户也可以通过设置环境变量 TDX_ROOT 指定安装目录。

环境要求：需安装通达信金融终端（支持 TQ 策略功能的专业研究版、量化模拟版或期货通），并预先启动客户端。Python 版本支持 64 位 Python 3.7~3.14，建议 3.13。部分数据（如专业财务数据、交易数据）需先在客户端中下载对应数据包。

核心概念

  • 证券代码格式：6 位数字 + 市场后缀（大小写均可），如 600519.SH（上海）、000001.SZ（深圳）、430047.BJ（北交所）
  • 周期参数：1m/5m/15m/30m/1h/1d/1w/1mon/1q/1y/tick
  • 复权类型：none 不复权、front 前复权、back 后复权
  • 市场类型后缀：.SH 上海、.SZ 深圳、.BJ 北交所、.HK 港股、.US 美股、.CSI 中证指数、.CNI 国证指数、.CFF 中金期货 等

操作步骤

  1. 确定数据需求——智能体理解用户意图
  2. 调用对应脚本——根据数据类型选择脚本
  3. 解析结果——智能体分析返回的 JSON 格式数据

脚本调用映射参考

  • 行情快照 → python scripts/market_data.py snapshot --code 600519.sh
  • K 线数据 → python scripts/market_data.py kline --code 600519.sh --period 1d --count 100
  • 证券基本信息 → python scripts/market_data.py stock_info --code 600519.sh
  • 股票更多信息 → python scripts/market_data.py more_info --code 600519.sh
  • 分红配送 → python scripts/market_data.py divid_factors --code 600519.sh
  • 股本数据 → python scripts/market_data.py gb_info --code 600519.sh --dates 20250101,20250601
  • 专业财务数据 → python scripts/financial_data.py financial --code 600519.sh --fields fn193,fn194,fn197 --start 20250101
  • 指定日期财务数据 → python scripts/financial_data.py financial_by_date --code 600519.sh --fields fn193,fn197 --year 0 --mmdd 0
  • 单个财务指标 → python scripts/financial_data.py gp_one_data --code 600519.sh --fields go1,go3,go5
  • 股票交易数据 → python scripts/trading_data.py gpjy --code 600519.sh --fields gp1,gp2,gp3 --start 20250101
  • 板块交易数据 → python scripts/trading_data.py bkjy --code 880660.sh --fields bk5,bk6,bk9 --start 20250101
  • 市场交易数据 → python scripts/trading_data.py scjy --fields sc1,sc2,sc3 --start 20250101
  • 系统分类成份股 → python scripts/sector_data.py stock_list --list_type 5
  • 板块代码列表 → python scripts/sector_data.py sector_list --with_name
  • 板块成份股 → python scripts/sector_data.py sector_stocks --block_code 880081.sh
  • 股票所属板块 → python scripts/sector_data.py stock_relation --code 688318.sh
  • 自定义板块操作 → python scripts/sector_data.py user_sector --action list
  • 可转债信息 → python scripts/etf_bond_data.py kzz_info --code 123039.sz
  • ETF 跟踪指数 → python scripts/etf_bond_data.py trackzs_etf --zs_code 950162.csi
  • 新股申购 → python scripts/etf_bond_data.py ipo_info --ipo_type 2 --ipo_date 1
  • 交易日列表 → python scripts/calendar.py --start 20250101 --end 20250601
  • 通达信公式（指标）→ python scripts/formula.py zb --name MACD --arg 12,26,9 --code 688318.sh --period 1d --count 100
  • 通达信公式（选股）→ python scripts/formula.py xg --name UPN --arg 3 --code 688318.sh --period 1d --count 100
  • 批量选股公式 → python scripts/formula.py mul_xg --name UPN --arg 3 --codes 688318.sh,600519.sh --period 1d --count 20

使用示例

示例 1：获取股票实时行情快照 场景/输入：用户说“查看贵州茅台的实时行情” 预期产出：返回股票代码、名称、现价、涨跌幅、成交量、五档买卖等信息 关键要点：调用 python scripts/market_data.py snapshot --code 600519.sh

示例 2：获取日 K 线数据 场景/输入：用户说“获取平安银行最近 100 天的日 K 线数据” 预期产出：返回日期、开盘价、最高价、最低价、收盘价、成交量等 OHLCV 数据 关键要点：调用 python scripts/market_data.py kline --code 000001.sz --period 1d --count 100

示例 3：查询专业财务数据 场景/输入：用户说“查看招商银行最近的成本费用利润率和营业利润率” 预期产出：返回 fn193 成本费用利润率、fn194 营业利润率等财务指标 关键要点：调用 python scripts/financial_data.py financial --code 600036.sh --fields fn193,fn194 --start 20240101

适用场景

该技能适用于需要以脚本方式批量获取 A 股行情、财务与交易数据，执行通达信公式进行指标计算或选股，查询板块与成份股关系，获取交易日历，以及进行交易下单与持仓查询的量化研究与自动化场景。

限制与注意事项

  • 运行脚本前，必须先启动通达信金融终端（支持 TQ 策略功能的版本），且 TdxW.exe 进程正在运行
  • 如果安装目录下不存在 tqcenter.py，说明当前客户端不支持 TQ 策略，需升级通达信终端
  • 证券代码必须带市场后缀（如 .SH、.SZ、.BJ），大小写均可，但不可省略
  • 专业财务数据和交易数据需先在客户端中下载对应数据包
  • 部分数据（如交易数据中的融资融券、陆股通等）仅展示特定日期之后的数据
  • K 线数据一次最多返回 24000 条，获取完整分钟线需多次分批获取
  • 通达信公式执行时，公式名称和参数需符合通达信语法规范
  • 后复权数据与获取的数据个数有关，只在返回的数据中进行后复权
  • 使用 sys.path.insert(0, ...) 而非 append()，确保优先加载通达信安装目录的 tqcenter.py

扩展参考

  • Python 初始化指引（何时读取：需要写 python 脚本自定义获取更多的数据时）
  • API 使用示例与故障排除（何时读取：需要查看常见用法时。提供了八种常见数据查询示例）
  • tqcenter API（何时读取：需要查看完整 API 参数、字段说明、初始化配置时，此为最核心参考文档）
  • 常量字典（何时读取：需要查看市场类型、周期、复权类型等常量映射时）
  • 策略开发与回测指引（何时读取：需要写策略、执行策略回测时）