{"id":"457b9dbc-d1d8-496e-9ca5-e6db7fb273d2","shortId":"D3Gq7Y","kind":"skill","title":"tdxquant","tagline":"通达信量化数据获取技能。当用户提及 tdxquant、通达信、TdxQuant、tqcenter，并且需要获取A股数据（行情快照、K线、财务、板块、可转债、新股、交易数据等）、查询交易日历、执行通达信公式、订阅行情、交易下单时使用","description":"# 通达信量化数据获取技能\n\n## 任务目标\n- 本 Skill 用于：通过通达信 TdxQuant (tqcenter) 接口获取A股市场数据、执行技术分析和查询交易相关信息\n- 能力包含：行情快照、K线数据、证券基本信息、专业财务数据、股票/板块/市场交易数据、板块与成份股、可转债/ETF/新股信息、交易日历、通达信公式执行、行情订阅、交易下单\n- 触发条件：用户提到 tdxquant、通达信、TdxQuant、tqcenter、获取A股数据、K线查询、财务数据、板块分析等\n\n## 前置准备\n- **tqcenter 模块说明**：tqcenter 位于通达信安装目录的 `PYPlugins\\user\\tqcenter.py`。脚本通过 `_tdx_init.py` 自动检测安装目录并将路径加入 `sys.path`。用户也可以通过设置环境变量 `TDX_ROOT` 指定安装目录。\n- 环境要求：需安装通达信金融终端（支持 TQ 策略功能的专业研究版、量化模拟版或期货通），并预先启动客户端\n- Python 版本：支持 64 位 Python 3.7~3.14，建议 3.13\n- 数据准备：部分数据（如专业财务数据、交易数据）需先在客户端中下载对应数据包\n\n## 核心概念\n- **证券代码格式**：6位数字 + 市场后缀（大小写均可），如 `600519.SH`（上海）、`000001.SZ`（深圳）、`430047.BJ`（北交所）\n- **周期参数**：`1m`/`5m`/`15m`/`30m`/`1h`/`1d`/`1w`/`1mon`/`1q`/`1y`/`tick`\n- **复权类型**：`none` 不复权、`front` 前复权、`back` 后复权\n- **市场类型后缀**：`.SH`上海 `.SZ`深圳 `.BJ`北交所 `.HK`港股 `.US`美股 `.CSI`中证指数 `.CNI`国证指数 `.CFF`中金期货 等\n\n**安装目录结构**：\n\n```\n通达信安装目录\\\n├── TdxW.exe              # 主程序\n├── PYPlugins\\\n│   ├── TPyth.dll         # 通信DLL\n│   ├── TPythClient.dll   # 通信DLL\n│   ├── user\\\n│   │   └── tqcenter.py   # TdxQuant 核心模块\n│   ├── data\\             # 下载数据目录\n│   └── file\\             # 发送文件目录\n```\n\n## 操作步骤\n\n1. 确定数据需求 — 智能体理解用户意图\n2. 调用对应脚本 — 根据数据类型选择脚本\n3. 解析结果 — 智能体分析返回的 JSON 格式数据\n\n### 意图识别映射示例\n\n| 用户提问 | 对应功能模块 | 调用参数 |\n|---|---|---|\n| \"贵州茅台实时股价\" | market_data.py snapshot | --code 600519.sh |\n| \"平安银行K线数据\" | market_data.py kline | --code 000001.sz --period 1d |\n| \"招商银行基本信息\" | market_data.py stock_info | --code 600036.sh |\n| \"招商银行财务指标\" | financial_data.py financial | --code 600036.sh --fields fn193,fn197 |\n| \"半导体板块成分股\" | sector_data.py sector_stocks | --block_name 半导体 |\n| \"今日新股申购\" | etf_bond_data.py ipo_info | --ipo_type 2 --ipo_date 1 |\n| \"市场融资融券数据\" | trading_data.py scjy | --fields sc1,sc25 |\n| \"MACD指标\" | formula.py zb | --name MACD --arg 12,26,9 |\n| \"连涨3天选股\" | formula.py xg | --name UPN --arg 3 |\n\n### 使用示例\n\n- 示例1：获取股票实时行情快照\n  - 场景/输入：用户说\"查看贵州茅台的实时行情\"\n  - 预期产出：返回股票代码、名称、现价、涨跌幅、成交量、五档买卖等信息\n  - 关键要点：调用 `python scripts/market_data.py snapshot --code 600519.sh`\n- 示例2：获取日K线数据\n  - 场景/输入：用户说\"获取平安银行最近100天的日K线数据\"\n  - 预期产出：返回日期、开盘价、最高价、最低价、收盘价、成交量等OHLCV数据\n  - 关键要点：调用 `python scripts/market_data.py kline --code 000001.sz --period 1d --count 100`\n- 示例3：查询专业财务数据\n  - 场景/输入：用户说\"查看招商银行最近的成本费用利润率和营业利润率\"\n  - 预期产出：返回fn193成本费用利润率、fn194营业利润率等财务指标\n  - 关键要点：调用 `python scripts/financial_data.py financial --code 600036.sh --fields fn193,fn194 --start 20240101`\n\n### 脚本调用映射参考\n\n- 行情快照 → `python scripts/market_data.py snapshot --code 600519.sh`\n- K线数据 → `python scripts/market_data.py kline --code 600519.sh --period 1d --count 100`\n- 证券基本信息 → `python scripts/market_data.py stock_info --code 600519.sh`\n- 股票更多信息 → `python scripts/market_data.py more_info --code 600519.sh`\n- 分红配送 → `python scripts/market_data.py divid_factors --code 600519.sh`\n- 股本数据 → `python scripts/market_data.py gb_info --code 600519.sh --dates 20250101,20250601`\n- 专业财务数据 → `python scripts/financial_data.py financial --code 600519.sh --fields fn193,fn194,fn197 --start 20250101`\n- 指定日期财务数据 → `python scripts/financial_data.py financial_by_date --code 600519.sh --fields fn193,fn197 --year 0 --mmdd 0`\n- 单个财务指标 → `python scripts/financial_data.py gp_one_data --code 600519.sh --fields go1,go3,go5`\n- 股票交易数据 → `python scripts/trading_data.py gpjy --code 600519.sh --fields gp1,gp2,gp3 --start 20250101`\n- 板块交易数据 → `python scripts/trading_data.py bkjy --code 880660.sh --fields bk5,bk6,bk9 --start 20250101`\n- 市场交易数据 → `python scripts/trading_data.py scjy --fields sc1,sc2,sc3 --start 20250101`\n- 系统分类成份股 → `python scripts/sector_data.py stock_list --list_type 5`\n- 板块代码列表 → `python scripts/sector_data.py sector_list --with_name`\n- 板块成份股 → `python scripts/sector_data.py sector_stocks --block_code 880081.sh`\n- 股票所属板块 → `python scripts/sector_data.py stock_relation --code 688318.sh`\n- 自定义板块操作 → `python scripts/sector_data.py user_sector --action list`\n- 可转债信息 → `python scripts/etf_bond_data.py kzz_info --code 123039.sz`\n- ETF跟踪指数 → `python scripts/etf_bond_data.py trackzs_etf --zs_code 950162.csi`\n- 新股申购 → `python scripts/etf_bond_data.py ipo_info --ipo_type 2 --ipo_date 1`\n- 交易日列表 → `python scripts/calendar.py --start 20250101 --end 20250601`\n- 通达信公式(指标) → `python scripts/formula.py zb --name MACD --arg 12,26,9 --code 688318.sh --period 1d --count 100`\n- 通达信公式(选股) → `python scripts/formula.py xg --name UPN --arg 3 --code 688318.sh --period 1d --count 100`\n- 批量选股公式 → `python scripts/formula.py mul_xg --name UPN --arg 3 --codes 688318.sh,600519.sh --period 1d --count 20`\n\n## 资源索引\n\n### 数据获取脚本\n\n- [scripts/market_data.py](scripts/market_data.py) (用途与参数：行情快照snapshot、K线kline、基本信息stock_info、更多信息more_info、分红divid_factors、股本gb_info)\n- [scripts/financial_data.py](scripts/financial_data.py) (用途与参数：专业财务financial、指定日期财务financial_by_date、单个指标gp_one_data)\n- [scripts/trading_data.py](scripts/trading_data.py) (用途与参数：股票交易gpjy、板块交易bkjy、市场交易scjy及其by_date变体)\n- [scripts/sector_data.py](scripts/sector_data.py) (用途与参数：系统分类stock_list、板块列表sector_list、板块成份股sector_stocks、股票所属板块stock_relation、自定义板块user_sector)\n- [scripts/etf_bond_data.py](scripts/etf_bond_data.py) (用途与参数：可转债kzz_info、ETF跟踪trackzs_etf、新股申购ipo_info)\n- [scripts/calendar.py](scripts/calendar.py) (用途与参数：获取交易日列表，支持 --start/--end/--count)\n- [scripts/formula.py](scripts/formula.py) (用途与参数：通达信公式执行，支持zb指标/xg选股/exp专家/mul批量)\n- [scripts/trade.py](scripts/trade.py) (用途与参数：交易下单、查询持仓/委托/资产、撤单)\n\n### 扩展参考\n\n- [Python 初始化指引](references/python-init.md) (何时读取：需要写 python 脚本自定义获取更多的数据时)\n- [API 使用示例与故障排除](references/tq_use_case.md) (何时读取：需要查看常见用法时。提供了八种常见数据查询示例)\n- [tqcenter API](references/tq_api.md) (何时读取：需要查看完整API参数、字段说明、初始化配置时，**此为最核心参考文档**)\n- [常量字典](references/dict.md) (何时读取：需要查看市场类型、周期、复权类型等常量映射时)\n- [策略开发与回测指引](references/backtest.md) (何时读取：需要写策略、执行策略回测时)\n\n## 注意事项\n\n- 运行脚本前，必须先启动通达信金融终端（支持TQ策略功能的版本），且 TdxW.exe 进程正在运行\n- 如果安装目录下不存在 `tqcenter.py`，说明当前客户端不支持TQ策略，需升级通达信终端\n- 证券代码必须带市场后缀（如 `.SH`、`.SZ`、`.BJ`），大小写均可，但不可省略\n- 专业财务数据和交易数据需先在客户端中下载对应数据包\n- 部分数据（如交易数据中的融资融券、陆股通等）仅展示特定日期之后的数据\n- K线数据一次最多返回24000条，获取完整分钟线需多次分批获取\n- 通达信公式执行时，公式名称和参数需符合通达信语法规范\n- 后复权数据与获取的数据个数有关，只在返回的数据中进行后复权\n- 使用 `sys.path.insert(0, ...)` 而非 `append()`，确保优先加载通达信安装目录的 tqcenter.py","tags":["tdxquant","finance","quant","skills","lzwme","agent-skills"],"capabilities":["skill","source-lzwme","skill-tdxquant","topic-agent-skills","topic-skills"],"categories":["finance-quant-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/lzwme/finance-quant-skills/tdxquant","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add lzwme/finance-quant-skills","source_repo":"https://github.com/lzwme/finance-quant-skills","install_from":"skills.sh"}},"qualityScore":"0.469","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 39 github stars · SKILL.md body (6,084 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:58:29.116Z","embedding":null,"createdAt":"2026-05-09T01:05:19.050Z","updatedAt":"2026-05-18T18:58:29.116Z","lastSeenAt":"2026-05-18T18:58:29.116Z","tsv":"'/etf':40 '/exp':615 '/mul':617 '/xg':613 '0':379,381,691 '000001.sz':102,185,281 '1':161,218,490 '100':285,323,514,529 '12':231,506 '123039.sz':471 '15m':109 '1d':112,187,283,321,512,527,543 '1h':111 '1m':107 '1mon':114 '1q':115 '1w':113 '1y':116 '2':164,215,487 '20':545 '20240101':306 '20250101':353,366,405,417,427,495 '20250601':354,497 '26':232,507 '3':167,240,523,538 '3.13':88 '3.7':85 '30m':110 '430047.bj':104 '5':435 '5m':108 '600036.sh':193,198,301 '600519.sh':100,180,261,313,319,330,337,344,351,360,374,389,399,541 '64':82 '688318.sh':457,510,525,540 '6位数字':96 '880081.sh':450 '880660.sh':411 '9':233,508 '950162.csi':479 'action':463 'api':635,642 'append':693 'arg':230,239,505,522,537 'back':123 'bj':130,675 'bk5':413 'bk6':414 'bk9':415 'bkji':409 'block':206,448 'cff':140 'cni':138 'code':179,184,192,197,260,280,300,312,318,329,336,343,350,359,373,388,398,410,449,456,470,478,509,524,539 'count':284,322,513,528,544,607 'csi':136 'data':156,387,570 'date':217,352,372,489,567 'date变体':577 'divid':341 'end':496,606 'etf':476,597 'etf_bond_data.py':210 'etf跟踪trackz':596 'etf跟踪指数':472 'factor':342,558 'field':199,222,302,361,375,390,400,412,422 'file':158 'financi':196,299,358,370 'financial_data.py':195 'fn193':200,303,362,376 'fn194':304,363 'fn194营业利润率等财务指标':294 'fn197':201,364,377 'formula.py':226,235 'front':121 'gb':348 'go1':391 'go3':392 'go5':393 'gp':385 'gp1':401 'gp2':402 'gp3':403 'gpji':397 'hk':132 'info':191,212,328,335,349,469,484,554,556,560,595,599 'ipo':211,213,216,483,485,488 'json':170 'kline':183,279,317 'kzz':468 'k线':10 'k线kline':552 'k线数据':32,314 'k线数据一次最多返回24000条':683 'k线查询':53 'list':432,433,440,464,582,584 'macd':229,504 'macd指标':225 'market_data.py':177,182,189 'mmdd':380 'mul':533 'name':207,228,237,442,503,520,535 'none':119 'one':386,569 'period':186,282,320,511,526,542 'pyplugin':61,147 'python':79,84,257,277,297,309,315,325,332,339,346,356,368,383,395,407,419,429,437,444,452,459,466,473,481,492,500,517,531,628,633 'references/backtest.md':656 'references/dict.md':650 'references/python-init.md':630 'references/tq_api.md':643 'references/tq_use_case.md':637 'relat':455,588 'root':70 'sc1':223,423 'sc2':424 'sc25':224 'sc3':425 'scji':221,421 'scripts/calendar.py':493,600,601 'scripts/etf_bond_data.py':467,474,482,591,592 'scripts/financial_data.py':298,357,369,384,561,562 'scripts/formula.py':501,518,532,608,609 'scripts/market_data.py':258,278,310,316,326,333,340,347,548,549 'scripts/sector_data.py':430,438,445,453,460,578,579 'scripts/trade.py':619,620 'scripts/trading_data.py':396,408,420,571,572 'sector':204,439,446,462,590 'sector_data.py':203 'sh':126,673 'skill':23 'skill-tdxquant' 'snapshot':178,259,311 'source-lzwme' 'start':305,365,404,416,426,494,605 'stock':190,205,327,431,447,454,586 'sys.path':67 'sys.path.insert':690 'sz':128,674 'tdx':69 'tdx_init.py':65 'tdxquant':1,4,6,26,48,50,154 'tdxw.exe':145,665 'tick':117 'topic-agent-skills' 'topic-skills' 'tpyth.dll':148 'tpythclient.dll':150 'tq':75 'tqcenter':7,27,51,57,59,641 'tqcenter.py':63,153,668,695 'trackz':475 'trading_data.py':220 'type':214,434,486 'upn':238,521,536 'us':134 'user':62,152,461 'xg':236,519,534 'year':378 'zb':227,502 'zs':477 '~3.14':86 '上海':101,127 '下载数据目录':157 '不复权':120 '专业财务financi':564 '专业财务数据':34,355 '专业财务数据和交易数据需先在客户端中下载对应数据包':678 '专家':616 '且':664 '中证指数':137 '中金期货':141 '主程序':146 '五档买卖等信息':254 '交易下单':45,622 '交易下单时使用':19 '交易数据':92 '交易数据等':15 '交易日列表':491 '交易日历':42 '仅展示特定日期之后的数据':682 '今日新股申购':209 '任务目标':21 '但不可省略':677 '位':83 '位于通达信安装目录的':60 '何时读取':631,638,644,651,657 '使用':689 '使用示例':241 '使用示例与故障排除':636 '公式名称和参数需符合通达信语法规范':686 '关键要点':255,275,295 '分红divid':557 '分红配送':338 '初始化指引':629 '初始化配置时':647 '前复权':122 '前置准备':56 '北交所':105,131 '半导体':208 '半导体板块成分股':202 '单个指标gp':568 '单个财务指标':382 '发送文件目录':159 '只在返回的数据中进行后复权':688 '可转债':13,39 '可转债kzz':594 '可转债信息':465 '名称':250 '后复权':124 '后复权数据与获取的数据个数有关':687 '周期':653 '周期参数':106 '国证指数':139 '场景':244,264,288 '基本信息stock':553 '复权类型':118 '复权类型等常量映射时':654 '大小写均可':98,676 '如':99,672 '如专业财务数据':91 '如交易数据中的融资融券':680 '如果安装目录下不存在':667 '委托':624 '字段说明':646 '安装目录结构':143 '对应功能模块':174 '市场交易scjy及其bi':576 '市场交易数据':37,418 '市场后缀':97 '市场类型后缀':125 '市场融资融券数据':219 '常量字典':649 '平安银行k线数据':181 '并且需要获取a股数据':8 '并预先启动客户端':78 '建议':87 '开盘价':270 '当用户提及':3 '必须先启动通达信金融终端':662 '意图识别映射示例':172 '成交量':253 '成交量等ohlcv数据':274 '执行技术分析和查询交易相关信息':29 '执行策略回测时':659 '执行通达信公式':17 '扩展参考':627 '批量':618 '批量选股公式':530 '招商银行基本信息':188 '招商银行财务指标':194 '指定安装目录':71 '指定日期财务financi':565 '指定日期财务数据':367 '指标':499 '接口获取a股市场数据':28 '提供了八种常见数据查询示例':640 '撤单':626 '操作步骤':160 '支持':74,81,604 '支持tq策略功能的版本':663 '支持zb指标':612 '收盘价':273 '数据准备':89 '数据获取脚本':547 '新股':14 '新股信息':41 '新股申购':480 '新股申购ipo':598 '智能体分析返回的':169 '智能体理解用户意图':163 '更多信息more':555 '最低价':272 '最高价':271 '本':22 '板块':12,36 '板块与成份股':38 '板块交易bkji':575 '板块交易数据':406 '板块代码列表':436 '板块分析等':55 '板块列表sector':583 '板块成份股':443 '板块成份股sector':585 '查看招商银行最近的成本费用利润率和营业利润率':291 '查看贵州茅台的实时行情':247 '查询专业财务数据':287 '查询交易日历':16 '查询持仓':623 '核心概念':94 '核心模块':155 '根据数据类型选择脚本':166 '格式数据':171 '模块说明':58 '此为最核心参考文档':648 '注意事项':660 '涨跌幅':252 '深圳':103,129 '港股':133 '版本':80 '环境要求':72 '现价':251 '用于':24 '用户也可以通过设置环境变量':68 '用户提到':47 '用户提问':173 '用户说':246,266,290 '用途与参数':550,563,573,580,593,602,610,621 '确保优先加载通达信安装目录的':694 '确定数据需求':162 '示例1':242 '示例2':262 '示例3':286 '等':142 '策略功能的专业研究版':76 '策略开发与回测指引':655 '系统分类stock':581 '系统分类成份股':428 '美股':135 '而非':692 '股本gb':559 '股本数据':345 '股票':35 '股票交易gpji':574 '股票交易数据':394 '股票所属板块':451 '股票所属板块stock':587 '股票更多信息':331 '能力包含':30 '脚本自定义获取更多的数据时':634 '脚本调用映射参考':307 '脚本通过':64 '自动检测安装目录并将路径加入':66 '自定义板块user':589 '自定义板块操作':458 '获取a股数据':52 '获取交易日列表':603 '获取完整分钟线需多次分批获取':684 '获取平安银行最近100天的日k线数据':267 '获取日k线数据':263 '获取股票实时行情快照':243 '行情快照':9,31,308 '行情快照snapshot':551 '行情订阅':44 '解析结果':168 '触发条件':46 '订阅行情':18 '证券代码必须带市场后缀':671 '证券代码格式':95 '证券基本信息':33,324 '说明当前客户端不支持tq策略':669 '调用':256,276,296 '调用参数':175 '调用对应脚本':165 '财务':11 '财务数据':54 '贵州茅台实时股价':176 '资产':625 '资源索引':546 '输入':245,265,289 '运行脚本前':661 '返回fn193成本费用利润率':293 '返回日期':269 '返回股票代码':249 '进程正在运行':666 '连涨3天选股':234 '选股':516,614 '通信dll':149,151 '通达信':5,49 '通达信公式':498,515 '通达信公式执行':43,611 '通达信公式执行时':685 '通达信安装目录':144 '通达信量化数据获取技能':2,20 '通过通达信':25 '部分数据':90,679 '量化模拟版或期货通':77 '陆股通等':681 '需先在客户端中下载对应数据包':93 '需升级通达信终端':670 '需安装通达信金融终端':73 '需要写':632 '需要写策略':658 '需要查看完整api参数':645 '需要查看市场类型':652 '需要查看常见用法时':639 '预期产出':248,268,292","prices":[{"id":"2d0f509e-56e9-47d5-88b2-f4767af6d7d4","listingId":"457b9dbc-d1d8-496e-9ca5-e6db7fb273d2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"lzwme","category":"finance-quant-skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:19.050Z"}],"sources":[{"listingId":"457b9dbc-d1d8-496e-9ca5-e6db7fb273d2","source":"github","sourceId":"lzwme/finance-quant-skills/tdxquant","sourceUrl":"https://github.com/lzwme/finance-quant-skills/tree/main/skills/tdxquant","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:19.050Z","lastSeenAt":"2026-05-18T18:58:29.116Z"}],"details":{"listingId":"457b9dbc-d1d8-496e-9ca5-e6db7fb273d2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"lzwme","slug":"tdxquant","github":{"repo":"lzwme/finance-quant-skills","stars":39,"topics":["agent-skills","skills"],"license":null,"html_url":"https://github.com/lzwme/finance-quant-skills","pushed_at":"2026-05-18T07:34:02Z","description":"一个面向金融量化交易领域的 Agent Skills 技能维护仓库，主要聚焦A股量化交易。","skill_md_sha":"5b678c18dbf8cf4fbe460d1b0e776eee1e0b747a","skill_md_path":"skills/tdxquant/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/lzwme/finance-quant-skills/tree/main/skills/tdxquant"},"layout":"multi","source":"github","category":"finance-quant-skills","frontmatter":{"name":"tdxquant","description":"通达信量化数据获取技能。当用户提及 tdxquant、通达信、TdxQuant、tqcenter，并且需要获取A股数据（行情快照、K线、财务、板块、可转债、新股、交易数据等）、查询交易日历、执行通达信公式、订阅行情、交易下单时使用"},"skills_sh_url":"https://skills.sh/lzwme/finance-quant-skills/tdxquant"},"updatedAt":"2026-05-18T18:58:29.116Z"}}