通达信官方接口股票数据读取AI量化分析

2025-12-22更新

通达信终于迈出了巨大的一步，从传统的看盘软件，走向了量化投研平台。最新的内测版：

通达信金融终端V7.75内测版:

更新时间：2026-05-07
地址：https://data.tdx.com.cn/test/new_tdx_test20251220.exe

参考文章：

通达信社区

新版说明书：

https://www.tdx.com.cn/products/helpfile/tdxw/index.html

用户红宝书：

https://help.tdx.com.cn/book.html

通达信金融终端

环境准备

在 VSCode 中扩展中加入 python 扩展，Python 装好后，有一些经常使用的库可以安装下：

1
2
3
4
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install backtrader -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install vectorbt -i https://pypi.tuna.tsinghua.edu.cn/simple

当然，Python 量化分析世界还有很多其他的先进包和库，用到了自行安装即可。

Python插件目录

首先下载安装上面的最新测试版。安装完毕之后，在安装目录下面，有一个 PYPlugins 目录：

PYPlugins目录

这个目录就包含了 Python 客户端需要的全部内容，user 目录下面就是全部可使用的 python 文件。

user目录

由于安装了 VS Code，可以用下面的指令看看 TpythClient.dll 的依赖：

查看DLL依赖

这里可以清晰的看出，TpythClient.dll 基本都是依赖于主流的 Windows 开发必备的 DLL 了，不依赖任何 Python 的 dll 了。

数据下载

安装完毕之后，如何进入通达信的 Python 界面？

首先，下载所需要的全部数据：

第一步：盘后数据下载：

盘后数据下载

当然也可以用"数据维护工具"从本地其他文件夹转移过来：

数据维护工具

用 Everything 搜一下文件位置：

搜索文件

Python接口代码示例

D:\ProgramData\tdx_20251220\PYPlugins\user\tdxdata_test.py

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
import numpy as np
import pandas as pd
from tqcenter import tq
import time
import json

"""
 这里是 tq 的简单使用示例
 使用时请确保已经启动通达信客户端并登录
 取消对应注释即可运行对应功能
"""

"""
 参数设置
"""
codes = ["600519.SH"]  # 传入的股票代码格式必须是标准格式：6位数+市场后缀（.SH/.SZ/.JJ等）
startime = "20250620"  # 传入的时间格式必须是：YYYYMMDD 或 YYYYMMDDHHMMSS
endtime = "20250801"
period = '1d'  # K线周期：1d/1w/1m/5m/15m/30m/60m等
dividend_type = 'none'  # 复权类型：none-不复权，front-前复权，back-后复权

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

# 刷新行情缓存 刷新后5分钟内取最新report和k线数据不会触发刷新
refresh_cache = tq.refresh_cache()
print(refresh_cache)

# 缓存历史K线 目前仅支持1m 5m 1d三种类型数据
refresh_kline = tq.refresh_kline(stock_list=['600519.SH'], period='1d')
print(refresh_kline)

# 获取K线数据
df = tq.get_market_data(
    field_list=['Close'],
    stock_list=codes,
    start_time=startime,
    end_time=endtime,
    count=30,
    dividend_type=dividend_type,
    period=period,
    fill_data=True
)
print(df)

# 获取交易日列表
trade_dates = tq.get_trading_dates(market='SH', start_time='20220101', end_time='', count=10)
print(trade_dates)

# 获取股票代码
stock_list = tq.get_stock_list('0')
print(stock_list)

# 断开连接 必须调用
tq.close()

接口功能说明

常用参数说明

股票代码格式：必须是标准格式 6位数+市场后缀（如 600519.SH、000001.SZ）

时间格式：YYYYMMDD 或 YYYYMMDDHHMMSS

K线周期：1d/1w/1m/5m/15m/30m/60m 等

复权类型：

none - 不复权
front - 前复权
back - 后复权

主要函数接口

函数	说明
`tq.initialize()`	初始化连接，所有策略必须调用
`tq.refresh_cache()`	刷新行情缓存
`tq.refresh_kline()`	缓存历史K线
`tq.get_market_data()`	获取K线数据
`tq.get_divid_factors()`	获取分红送配数据
`tq.get_report_data()`	获取报表数据
`tq.get_instrument_detail()`	获取基础财务数据
`tq.get_financial_data()`	获取专业财务数据
`tq.get_stock_list()`	获取股票代码列表
`tq.get_trading_dates()`	获取交易日列表
`tq.subscribe_hq()`	订阅股票更新
`tq.send_warn()`	发送预警信号
`tq.close()`	断开连接（必须调用）

stock_list参数类型

代码	说明
0	自选股
1	持仓股
5	所有A股
6	上证指数成份股
7	上证主板
8	深证主板
9	重点指数
10	所有板块指数
23	沪深300
24	中证500
25	中证1000
31	ETF基金
32	可转债
51	创业板
52	科创板
53	北交所