QMT Python API
快速开始
概述
欢迎使用迅投数据服务!本数据字典为您在使用过程中提供相关指导,您可以通过搜索相关数据,找到对应的描述、用法、参数、返回、示例。
如果您是 QMT 基础行情用户,遇到相关问题的时候,请查阅VIP 行情用户优势对比,找到对应问题描述,如没有对应内容,可联系客服反馈。
如果您想成为 VIP 行情用户,请查阅VIP 行情用户-购买流程,进行购买。
如果您已经是 VIP 行情用户,请查阅VIP 行情用户-使用流程,学习使用。
其他问题,欢迎您联系客服反馈。
VIP 行情用户优势对比
通用功能对比
| 数据类型 | 券商版权限 | 基础版权限 | 投研版权限 |
|---|---|---|---|
| 仿真交易权限 | 不支持 | 支持所有品种:股票、期货、期权 | 支持所有品种:股票、期货、期权 |
| Python交易权限 | 支持 | 支持 | 支持 |
| 图表交易权限 | 不支持 | 不支持 | 支持 |
| 直连期货交易 | 不支持 | 不支持 | 支持 |
| 高级 VBA、Python 函数 | 不支持 | 不支持 | 支持 |
| 专属微信组工程师指导 | 不支持 | 不支持 | 支持 |
| VIP行情权限 | |||
| 行情数量 | 100 个限制 | 100 个限制 | 300个限制 |
| 盘口档位 | 最高 1 档 | 仅最新价 | 最高 5 档 |
| 品种 | 只支持股票 | 只支持股票 | 支持所有品种:股票、期货 |
| 下载数据-历史范围 | 5m-1年 1m-1年 tick-1个月 | 5m-1年 1m-1年 tick-1个月 | 5m-3年 1m-3年 tick-1年 |
| 下载数据-流速 | 限制 | 限制 | 无限制 |
| 期权 | 不支持 | 不支持 | 需购买开通权限 |
| 因子数据 | 不支持 | 不支持 | 需购买开通权限 |
| 北向、资金流、沪港通数据 | 不支持 | 不支持 | 支持 |
| 行业、商品指数行情数据 | 不支持 | 不支持 | 支持 |
| 现货、仓单、席位数据 | 不支持 | 不支持 | 支持 |
| 可转债数据 | 不支持 | 不支持 | 支持 |
| ETF申赎清单数据 | 不支持 | 不支持 | 需购买开通权限 |
行情站点对比
普通行情使用的行情站点与VIP行情也有区别,更换VIP行情站点,能够带来更好的行情体验,添加方式如下: 
VIP行情站点
| 地点 | 网址 | 端口 |
|---|---|---|
| VIP迅投绍兴电信 | vipsxmd1.thinktrader.net | 55310 |
| VIP迅投绍兴电信 | vipsxmd2.thinktrader.net | 55310 |
| VIP迅投郑州联通 | ltzzmd2.thinktrader.net | 55300 |
| VIP迅投郑州联通 | ltzzmd1.thinktrader.net | 55300 |
| VIP迅投郑州电信 | dxzzmd1.thinktrader.net | 55300 |
| VIP迅投郑州电信 | dxzzmd2.thinktrader.net | 55300 |
| 地点 | IP地址 | 端口 |
|---|---|---|
| VIP迅投绍兴电信 | 115.231.218.73 | 55310 |
| VIP迅投绍兴电信 | 115.231.218.79 | 55310 |
| VIP迅投郑州联通 | 42.228.16.211 | 55300 |
| VIP迅投郑州联通 | 42.228.16.210 | 55300 |
| VIP迅投郑州电信 | 36.99.48.20 | 55300 |
| VIP迅投郑州电信 | 36.99.48.21 | 55300 |
普通行情站点
| 地点 | 网址 | 端口 |
|---|---|---|
| 迅投浦东电信 | shmd1.thinktrader.net | 55300 |
| 迅投浦东电信 | shmd2.thinktrader.net | 55300 |
| 迅投东莞电信 | szmd1.thinktrader.net | 55300 |
| 迅投东莞电信 | szmd2.thinktrader.net | 55300 |
| 地点 | IP地址 | 端口 |
|---|---|---|
| 迅投浦东电信 | 43.242.96.162 | 55300 |
| 迅投浦东电信 | 43.242.96.164 | 55300 |
| 迅投东莞电信 | 218.16.123.121 | 55300 |
| 迅投东莞电信 | 218.16.123.122 | 55300 |
如何成为 VIP 行情用户
购买流程

步骤一:注册登录
在迅投研官网使用手机号注册你的投研账号。
提示
记录好你的密码,后续会很重要
步骤二:购买权限

登录你的投研账号,访问投研服务页面,选择行情用户 VIP,并支付。

支付方式支持微信支付、支付宝以及对公转账,其中对公转账信息如下:
- 公司名:
成都睿智融科科技有限公司 - 账户号:
4402235009000153959 - 开户行:
中国工商银行成都高新城南支行
步骤三:查看权限
支付成功后,你就可以在个人中心看到您的服务已经开启相应时长的使用权限
使用流程
1.如何在券商 QMT 中使用

- 登录你的券商 QMT 后,点击行情,进入行情面板
- 找到迅投行情主站(包括北京、上海、东莞等),点击
修改 - 在弹窗中将用户名和密码修改为自己的投研账号密码,点击确认
- 点击
链接,即可在券商 QMT 中使用行情用户 VIP 权限 - 执行以上同样的操作,找到迅投资管行情,点击
修改 - 最后,点击右上角
全推行情,在下拉框中选择五档全推
提示
- 第五步,若不修改迅投资管行情的账号密码,不设置将无法收到五档全推
- 第六步,若不修改全推行情,也无法收到五档全推
操作演示
2.如何使用 Token

- 在你的迅投研官网的个人中心,
迅投投研服务平台 - 用户中心 - 个人设置 - 接口 TOKEN,找到你的接口 TOKEN - 接口 TOKEN 一次生成一个,刷新后前一个 TOKEN 失效(刷新有间隔限制,请勿频繁刷新)
- 接口 TOKEN 具体用法如下:
下载指定 xtquant 包
提示
请提前下载指定 xtquant 包,
Windows:下载链接 或在cmd窗口中运行指令
1
pip install xtquant -i https://pypi.tuna.tsinghua.edu.cn/simple基础用法 - 获取数据
1
# 导入 xtdatacenter 模块2
from xtquant import xtdatacenter as xtdc 3
4
''' 5
设置用于登录行情服务的token,此接口应该先于 init_quote 调用6
7
token可以从投研用户中心获取8
https://xuntou.net/#/userInfo9
''' 10
xtdc.set_token('这里输入token')11
12
''' 13
设置数据存储根目录,此接口应该先于 init_quote 调用 14
datacenter 启动后,会在 data_home_dir 目录下建立若干目录存储数据 15
此接口不是必须调用,如果不设置,会使用默认路径16
''' 17
# xtdc.set_data_home_dir('data') 18
19
'''20
函数用法可通过以下方式查看:21
'''22
# print(help(xtdc.set_data_home_dir)) 23
24
''' 25
初始化行情模块 26
''' 27
xtdc.init()28
29
'''30
初始化需要一定时间,完成后即可按照数据字典的对应引导使用31
'''32
33
# 导入 xtdata34
from xtquant import xtdata 35
36
# 获取交易日期37
tdl = xtdata.get_trading_dates('SH') 38
print(tdl[-10:]) 39
40
# 获取板块列表41
sl = xtdata.get_stock_list_in_sector('沪深A股') 42
print(sl[::100]) 43
44
# 输出平安银行的相关信息 45
data = xtdata.get_instrument_detail("000001.SZ") 46
print(data)47
48
# 其他数据获取的方法请参考数据字典:/docs/dictionary/stock.html 进阶用法 - 数据服务
当您已经实现基础用法,成功获取数据后,随即可能会有新的需求:
如果我有多个策略,在不同进程中运行,都要获取数据,而 Token 只支持单点访问,该怎么办?
我们同样提供数据服务,您可以在一个进程中启动数据服务,其他进程连接该数据服务,实现您想要的效果,具体演示如下:
进程 1
1
### 进程1 启动xtdatacenter监听2
3
from xtquant import xtdatacenter as xtdc4
5
xtdc.set_token('这里输入token')6
7
print('xtdc.init')8
xtdc.init() # 初始化行情模块,加载合约数据,会需要大约十几秒的时间9
print('done')10
11
# 为其他进程的xtdata提供服务时启动server,单进程使用不需要12
print('xtdc.listen')13
listen_addr = xtdc.listen(port = 58610)14
print(f'done, listen_addr:{listen_addr}')15
16
from xtquant import xtdata17
print('running')18
xtdata.run() #循环,维持程序运行19
进程 2
1
from xtquant import xtdata2
'''3
连接数据服务指定的端口4
'''5
xtdata.connect(port=58610)6
7
8
# 以下即可正常执行获取数据的操作9
tdl = xtdata.get_trading_dates('SH')10
print(tdl[-10:])11
12
sl = xtdata.get_stock_list_in_sector('沪深A股')13
print(sl[::100])14
15
# 结合数据字典:/docs/dictionary/stock.html16
17
# 输出平安银行信息的中文名称18
data = xtdata.get_instrument_detail("000001.SZ")19
print(data)20
遇到问题,请参考常见问题Token 使用相关
3.如何在投研端中使用
- 购买投研端的用户默认拥有行情用户 VIP 权限,且已经自动配置好
- 投研端的用户可以在券商 QMT 中使用,具体参考如何在券商 QMT 中使用
- 投研端的用户同样可以在后台找到接口 TOKEN,具体参考如何使用 Token
更新日志
2023.11
2023.11.01
- 更新 快速开始
- 补充可转债数据字段
- 优化部分描述
2023.11.21
- 更新K线全推示例
- 更新界面操作-独立python进程
- 新添加get_trade_detail_data -
POSITION_STATISTICS结构
2023.11.22
- 增加常见pandas问题及处理方案
2023.12
2023.12.07
- 新增历史涨跌停价数据
- 新增历史ST数据下载方式
- 新增获取历史期权合约方法
- 更新财务数据获取方式
- 修正 get_etf_info 示例
2023.12.08
- 优化文档显示内容
2023.12.14
- 新增 TOP10HOLDER/TOP10FLOWHOLDER - 十大股东/十大流通股东
- 新增 SHAREHOLDER - 股东数
2023.12.20
- 修复文档描述错误
2023.12.25
- 增加get_etf_info字段描述
- 优化VIP行情对比
2024.01.05
- 增加回测复权方式说明
- 增加openInt变化状态说明
- 优化文档显示内容