tdx-quant-dev

Original：🇨🇳 Chinese

Translated

Auxiliary development skill for Tongda Xin quantitative platform (TdxQuant). Use this skill when users mention "Tongda Xin", "TDX", "TdxQuant", "quantitative trading" or ask about the usage of the `tqcenter` module. It can help with environment setup, API calling, market data acquisition and trading strategy implementation.

2installs

Sourcewzcxbg/develop-agent-skills

Added on2026-03-31

NPX Install

npx skill4agent add wzcxbg/develop-agent-skills tdx-quant-dev

SKILL.md Content (Chinese)

View Translation Comparison →

TdxQuant Development Skill

This skill is used to assist in developing quantitative trading strategies on the Tongda Xin quantitative platform (TdxQuant).

Core Concepts

TdxQuant integrates Python into the Tongda Xin financial terminal. It allows Python scripts to access real-time and historical market data and execute trading strategies. The core module is

tqcenter

.

Environment Configuration

1. Python Path Setting

To use the

tqcenter

module, you must ensure that the Python environment can locate the module. This module is usually located in the

PYPlugins/user

directory under the Tongda Xin installation directory (e.g.

C:/new_tdx64/PYPlugins/user

).

You usually need to add this path to

sys.path

before importing:

python

import sys
sys.path.append('C:/new_tdx64/PYPlugins/user') 
from tqcenter import tq

if __name__ == '__main__':
    #所有策略连接通达信客户端都必须调用此函数进行初始化
    tq.initialize(__file__)

    #获取平安银行日线前复权收盘数据
    df = tq.get_market_data(
        field_list = ['Close'],
        stock_list = ["000001.SZ"],
        start_time = '20251219',
        end_time = '20251225',
        dividend_type='front',
        period='1d',
    )
    print(df)

2. Market Data Download (Important)

Note: The reason why the Python interface can obtain market data is that Tongda Xin has downloaded the market data in advance. Calling the Python interface does not actually send any network requests, but directly reads from the locally downloaded market data files. If the data obtained is not the latest, it may be caused by not downloading the latest market data.

Market data includes two items, which need to be manually downloaded and overwritten to the Tongda Xin installation directory (take

C:/new_tdx64

as an example):

Daily Market Data
- Download Link:
```
https://data.tdx.com.cn/vipdoc/hsjday.zip
```
- Update Frequency: Updated about 1 hour after the market closes every day.
- Operation: Unzip after downloading, overwrite to the
```
C:/new_tdx64/vipdoc
```
  directory.
Financial Data
- Download Link:
```
https://data.tdx.com.cn/vipdoc/tdxfin.zip
```
- Update Frequency: Low update frequency, no need to download every day.
- Operation: Unzip after downloading, overwrite to the
```
C:/new_tdx64/vipdoc/cw
```
  directory.

API Documentation and Detailed Guide

This skill contains a series of detailed sub-documents covering all aspects of TdxQuant development. When answering specific user questions, please read the following relevant documents first:

Basic Getting Started

TdxQuant 简介: Platform introduction, operating environment requirements and core operating logic.
常见问题: Common errors (such as DLL errors, path problems) and solutions.
常量枚举: Constant definitions for parameters such as market type, dividend adjustment type, K-line period, etc.

Core Function APIs

通用函数: Initialization, data subscription, message/alert sending, file download, etc.
行情类信息: Get real-time market quotes, historical K-lines, tick data, etc.
财务类数据: Get financial data, ex-rights and ex-dividend information, etc.
债券和期货数据: Acquisition of convertible bond and futures related data.

Sector and Stock Selection

分类和板块成份股: Obtain system classification, industry sectors and their constituent stocks.
自选股和自定义板块: Manage user-defined sectors and self-selected stocks.

Advanced Features

调用通达信公式: Call Tongda Xin indicator formulas for calculation in Python.
回测及模拟交易: Strategy backtesting process and simulated trading instructions.

Examples

场景化示例: Code implementation examples for common strategy scenarios.

Common Troubleshooting

ModuleNotFoundError: Make sure the path of
```
PYPlugins/user
```
is correct and has been added to
```
sys.path
```
.
DLL Error: If you see
```
FileNotFoundError: Could not find module ... TPythClient.dll
```
, please check whether
```
tdxrpcx64.dll
```
exists in the parent directory (
```
../PYPlugins/
```
) and make sure it is not blocked by anti-virus software. For detailed troubleshooting, please refer to 常见问题.
Empty Data: Make sure
```
count
```
is sufficient for formula calculation (for example, at least 5 data points are required to calculate 5-day moving average).
Process Conflict: If the external script reports that it is already running, please check and stop the existing instance in the TQ strategy manager of Tongda Xin.

Reference Materials

Official Documentation: Tongda Xin Quantitative Platform Help Documentation
Tip: The built-in documentation of this skill was updated on March 1, 2026. As the TdxQuant platform may continue to iterate, if you need to get the latest API changes and feature descriptions, be sure to visit the official documentation link above.