XtQuant (迅投量化) 技能文档 XtQuant 是基于迅投 MiniQMT 的完善 Python 策略运行框架，提供量化交易所需的行情和交易 API 接口。 何时使用此技能 在以下场景中应该使用此技能： 量化交易开发 开发 A 股量化交易策略 实现自动化交易系统 构建回测框架 编写交易信号生成逻辑 行情数据处理 获取历史 K 线数据（日线、分钟线等） 订阅实时行情推送 下载财务数据和板块信息 处理分笔成交数据 交易执行 程序化下单（限价单、市价单等） 批量撤单操作 查询账户资产、持仓、委托 接收交易回报推送 问题排查 调试 XtQuant 连接问题 解决数据订阅失败 处理交易接口报错 优化策略性能 核心概念 两大核心模块 xtdata - 行情数据模块 提供历史和实时的 K 线、分笔数据 财务数据、合约基础信息 板块和行业分类信息 需要先启动 MiniQMT 客户端 xttrader - 交易执行模块 报单、撤单操作 查询资产、委托、成交、持仓 接收资金、委托、成交等主推消息 支持回调机制处理交易事件 运行环境要求 Python 版本：3.6 - 3.12（64位） 必须先启动 MiniQMT 客户端 通过 session_id 区分不同策略会话 快速参考 1. 行情数据获取（基础模式） 从官方文档提取的完整示例： from xtquant import xtdata import time

设定标的列表和周期

code_list

[ "000001.SZ" ] period = "1d"

下载历史行情数据到本地

for code in code_list : xtdata . download_history_data ( code , period = period , incrementally = True )

下载财务和板块数据

xtdata . download_financial_data ( code_list ) xtdata . download_sector_data ( )

读取本地历史行情

history_data

xtdata . get_market_data_ex ( [ ] , code_list , period = period , count = - 1 ) print ( history_data ) 说明 ：XtQuant 的数据以压缩形式存储在本地，使用前需要先下载。 2. 实时行情订阅（回调模式） from xtquant import xtdata code_list = [ "000001.SZ" ] period = "1d"

定义回调函数

def on_data ( data ) : code_list = list ( data . keys ( ) ) kline = xtdata . get_market_data_ex ( [ ] , code_list , period = period ) print ( kline )

订阅行情并设置回调

for code in code_list : xtdata . subscribe_quote ( code , period = period , count = - 1 , callback = on_data )

阻塞程序以持续接收回调

xtdata . run ( ) 说明 ：使用回调模式时，必须调用 xtdata.run() 阻塞程序，否则程序会直接退出。 3. 交易模块初始化与下单 从官方文档提取的交易示例： from xtquant . xttrader import XtQuantTrader , XtQuantTraderCallback from xtquant . xttype import StockAccount from xtquant import xtconstant

定义交易回调类

class MyXtQuantTraderCallback ( XtQuantTraderCallback ) : def on_stock_order ( self , order ) : """委托回报推送""" print ( "委托回报:" , order . stock_code , order . order_status ) def on_stock_trade ( self , trade ) : """成交变动推送""" print ( "成交回报:" , trade . stock_code , trade . order_id ) def on_order_error ( self , order_error ) : """委托失败推送""" print ( "委托失败:" , order_error . error_msg )

初始化交易客户端

path

'D:\迅投极速交易终端\userdata_mini'

MiniQMT 安装路径

session_id

123456

会话编号，不同策略使用不同编号

xt_trader

XtQuantTrader ( path , session_id )

创建账号对象

acc

StockAccount ( '1000000365' )

替换为实际账号

注册回调

callback

MyXtQuantTraderCallback ( ) xt_trader . register_callback ( callback )

启动交易线程并连接

xt_trader . start ( ) connect_result = xt_trader . connect ( )

返回0表示成功

subscribe_result

xt_trader . subscribe ( acc )

订阅交易推送

下单示例

stock_code

'600000.SH' order_id = xt_trader . order_stock ( acc , stock_code , xtconstant . STOCK_BUY ,

买入

200 ,

数量

xtconstant . FIX_PRICE ,

限价单

10.5

价格

) print ( f"下单成功，订单号: { order_id } " ) 说明 ：交易前必须先启动 MiniQMT 客户端并登录账号。 4. 连接VIP服务器（高级功能） 从官方文档提取的VIP服务器连接示例： from xtquant import xtdatacenter as xtdc from xtquant import xtdata

设置token（从投研用户中心获取）

xtdc . set_token ( '这里输入你的token' )

设置VIP服务器连接池

addr_list

[ '115.231.218.73:55310' , '115.231.218.79:55310' , '42.228.16.211:55300' , '42.228.16.210:55300' ] xtdc . set_allow_optmize_address ( addr_list )

开启K线全推功能（VIP功能）

xtdc . set_kline_mirror_enabled ( True )

初始化并监听端口

xtdc . init ( ) port = xtdc . listen ( port = 58621 )

指定固定端口

xtdata . connect ( port = port ) print ( '连接成功' ) xtdata . run ( ) 说明 ：VIP服务器提供更快的行情推送和更多的数据服务，需要从投研用户中心获取token。 5. 指定端口避免冲突 from xtquant import xtdatacenter as xtdc xtdc . set_token ( "你的token" ) xtdc . init ( False )

不自动初始化

port

58601

自定义端口

xtdc . listen ( port = port ) print ( f"服务启动，开放端口： { port } " ) 说明 ：当58609默认端口被占用时，可以指定自定义端口。 常见问题与解决方案 问题1：导入xtquant库失败 错误信息 ： NO module named 'xtquant.IPythonAPiClient' 解决方案 ： 确认使用的是64位 Python 3.6-3.12 版本 检查 xtquant 库是否正确安装 如果出现 PermissionError，说明存在文件权限问题 问题2：连接失败返回-1 原因 ：同一个 session 的两次 Python 进程 connect 之间必须超过3秒 解决方案 ： 等待至少3秒后再次连接 或者使用不同的 session_id 问题3：端口58609被占用 错误信息 ：执行 xtdatacenter.init 时提示监听58609端口失败 解决方案 ：

方法1：指定自定义端口

xtdc . init ( False ) port = xtdc . listen ( port = 58601 )

方法2：关闭所有Python程序或重启电脑

问题4：委托备注字段被截断 问题描述 ：查询委托的投资备注只有前半部分 原因 ：极简客户端的 order_remark 字段最大24个英文字符（一个中文占3个），超出部分会被丢弃 解决方案 ：控制备注长度，或使用大QMT（无长度限制） 参考文档说明 本技能包含以下参考文档，使用 view 命令查看详细内容： api.md - API完整文档 来源 ：官方文档 置信度 ：中等 内容 ：5个页面，包含： 完整实例 ：行情订阅、交易下单的完整代码示例 XtData模块 ：行情数据获取的详细API说明 XtTrader模块 ：交易执行的详细API说明 常见问题 ：实际使用中的问题和解决方案 适用场景 ： 查找具体API的参数说明 学习完整的代码实现模式 解决开发中遇到的具体问题 getting_started.md - 快速入门 来源 ：官方文档 置信度 ：中等 内容 ：2个页面，包含： XtQuant 能提供的服务概述 运行依赖环境说明 XtQuant 运行逻辑介绍 xtdata 和 xttrader 两大模块简介 适用场景 ： 初次接触 XtQuant 了解整体架构和设计理念 确认环境配置要求 使用指南 初学者入门路径 第一步：环境准备 安装64位 Python 3.6-3.12 下载并安装 MiniQMT 客户端 安装 xtquant 库： pip install xtquant 第二步：学习基础 阅读 getting_started.md 了解整体架构 运行"快速参考"中的示例1（行情数据获取） 理解数据下载和读取的流程 第三步：实践进阶 尝试实时行情订阅（示例2） 学习回调机制的使用 查看 api.md 中的完整实例 中级用户进阶 行情数据处理 掌握多周期数据获取（1m, 5m, 1d等） 学习财务数据和板块数据的使用 实现数据缓存和增量更新策略 交易策略开发 理解交易回调机制（on_stock_order, on_stock_trade） 实现风险控制逻辑 处理委托失败和撤单场景 性能优化 使用异步查询接口（query_stock_orders_async） 合理设置订阅范围避免数据过载 控制session数量避免文件堆积 高级用户最佳实践 VIP服务器使用 配置VIP服务器连接池 开启K线全推功能获取全市场数据 优化网络连接和数据传输 多账户管理 使用不同session_id管理多个策略 实现账户间的资金调度 处理沪港通、深港通等特殊账户类型 生产环境部署 实现断线重连机制 添加日志记录和监控 设置异常告警和自动恢复 重要提示 使用前必读 MiniQMT客户端必须先启动 所有 xtdata 和 xttrader 功能都依赖 MiniQMT 客户端 确保客户端已登录并连接到行情服务器 数据下载机制 XtQuant 的历史数据以压缩形式存储在本地 使用前必须先调用 download_* 接口下载数据 订阅的实时数据会自动保存，无需重复下载 回调函数注意事项 使用回调模式时必须调用 xtdata.run() 或 xttrader.run() 阻塞程序 回调函数中不要执行耗时操作，避免阻塞数据接收 推荐在回调中使用异步查询接口 Session管理 不同策略使用不同的 session_id 同一 session 的两次连接间隔必须超过3秒 控制 session 范围避免产生大量 down_queue 文件 风险提示 本文档中的策略示例仅供参考学习 实盘交易前请充分测试 交易有风险，投资需谨慎 技能来源 本技能文档基于以下来源自动生成： 官方文档 ：迅投知识库 (dict.thinktrader.net) 抓取页面数 ：7个页面 文档分类 ：入门指南、API文档、完整示例、常见问题 生成时间 ：2026年1月 相关资源 官方网站 ： http://www.thinktrader.net 投研用户中心 ： https://xuntou.net/#/userInfo（获取VIP token） 迅投学院 ： https://www.xuntou.net/plugin.php?id=keke_video_base 技术支持 ：参考官方文档的常见问题部分