8000 feat: improve skill scores for miniqmt-skills by yogesh-tessl · Pull Request #2 · nnquant/miniqmt-skills · GitHub
[go: up one dir, main page]

Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
262 changes: 29 additions & 233 deletions SKILL.md
8000
Original file line number Diff line number Diff line change
@@ -1,67 +1,16 @@
---
name: miniqmt-skills
description: XtQuant (迅投量化) API 文档 - 用于量化交易的 Python API,包括行情数据获取、交易执行、策略回测等功能
description: "XtQuant (迅投量化/MiniQMT) Python API for Chinese A-share quantitative trading. Use when the user needs to subscribe to real-time quotes, download historical K-line data, place or cancel stock orders, query account positions and assets, handle trade callbacks, connect to VIP data servers, or debug xtquant connection issues."
---

# XtQuant (迅投量化) 技能文档

XtQuant 是基于迅投 MiniQMT 的完善 Python 策略运行框架,提供量化交易所需的行情和交易 API 接口。

## 何时使用此技能

在以下场景中应该使用此技能:

### 量化交易开发
- 开发 A 股量化交易策略
- 实现自动化交易系统
- 构建回测框架
- 编写交易信号生成逻辑

### 行情数据处理
- 获取历史 K 线数据(日线、分钟线等)
- 订阅实时行情推送
- 下载财务数据和板块信息
- 处理分笔成交数据

### 交易执行
- 程序化下单(限价单、市价单等)
- 批量撤单操作
- 查询账户资产、持仓、委托
- 接收交易回报推送

### 问题排查
- 调试 XtQuant 连接问题
- 解决数据订阅失败
- 处理交易接口报错
- 优化策略性能

## 核心概念

### 两大核心模块

**xtdata - 行情数据模块**
- 提供历史和实时的 K 线、分笔数据
- 财务数据、合约基础信息
- 板块和行业分类信息
- 需要先启动 MiniQMT 客户端

**xttrader - 交易执行模块**
- 报单、撤单操作
- 查询资产、委托、成交、持仓
- 接收资金、委托、成交等主推消息
- 支持回调机制处理交易事件

### 运行环境要求
- Python 版本:3.6 - 3.12(64位)
- 必须先启动 MiniQMT 客户端
- 通过 session_id 区分不同策略会话
XtQuant 是基于迅投 MiniQMT 的 Python 量化交易框架。两大核心模块:`xtdata`(行情数据:K线、财务、板块)和 `xttrader`(交易执行:下单、撤单、查询持仓)。运行需 64 位 Python 3.6-3.12 + MiniQMT 客户端已启动。

## 快速参考

### 1. 行情数据获取(基础模式)

从官方文档提取的完整示例:

```python
from xtquant import xtdata
import time
Expand All @@ -80,11 +29,12 @@ xtdata.download_sector_data()

# 读取本地历史行情
history_data = xtdata.get_market_data_ex([], code_list, period=period, count=-1)
for code, df in history_data.items():
if df.empty:
raise ValueError(f"未获取到 {code} 的数据,请检查下载是否成功")
print(history_data)
```

**说明**:XtQuant 的数据以压缩形式存储在本地,使用前需要先下载。

### 2. 实时行情订阅(回调模式)

```python
Expand All @@ -107,12 +57,8 @@ for code in code_list:
xtdata.run()
```

**说明**:使用回调模式时,必须调用 `xtdata.run()` 阻塞程序,否则程序会直接退出。

### 3. 交易模块初始化与下单

从官方文档提取的交易示例:

```python
from xtquant.xttrader import XtQuantTrader, XtQuantTraderCallback
from xtquant.xttype import StockAccount
Expand Down Expand Up @@ -146,8 +92,13 @@ xt_trader.register_callback(callback)

# 启动交易线程并连接
xt_trader.start()
connect_result = xt_trader.connect() # 返回0表示成功
subscribe_result = xt_trader.subscribe(acc) # 订阅交易推送
connect_result = xt_trader.connect()
if connect_result != 0:
raise RuntimeError(f"连接失败,错误码: {connect_result}")

subscribe_result = xt_trader.subscribe(acc)
if subscribe_result != 0:
raise RuntimeError(f"订阅失败,错误码: {subscribe_result}")

# 下单示例
stock_code = '600000.SH'
Expand All @@ -159,15 +110,13 @@ order_id = xt_trader.order_stock(
xtconstant.FIX_PRICE, # 限价单
10.5 # 价格
)
if order_id < 0:
raise RuntimeError(f"下单失败,错误码: {order_id}")
print(f"下单成功,订单号: {order_id}")
```

**说明**:交易前必须先启动 MiniQMT 客户端并登录账号。

### 4. 连接VIP服务器(高级功能)

从官方文档提取的VIP服务器连接示例:

```python
from xtquant import xtdatacenter as xtdc
from xtquant import xtdata
Expand Down Expand Up @@ -196,8 +145,6 @@ print('连接成功')
xtdata.run()
```

**说明**:VIP服务器提供更快的行情推送和更多的数据服务,需要从投研用户中心获取token。

### 5. 指定端口避免冲突

```python
Expand All @@ -210,175 +157,24 @@ 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端口失败

**解决方案**:
```python
# 方法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
- 了解整体架构和设计理念
- 确认环境配置要求

## 使用指南

### 初学者入门路径

**第一步:环境准备**
1. 安装64位 Python 3.6-3.12
2. 下载并安装 MiniQMT 客户端
3. 安装 xtquant 库:`pip install xtquant`

**第二步:学习基础**
1. 阅读 `getting_started.md` 了解整体架构
2. 运行"快速参考"中的示例1(行情数据获取)
3. 理解数据下载和读取的流程

**第三步:实践进阶**
1. 尝试实时行情订阅(示例2)
2. 学习回调机制的使用
3. 查看 `api.md` 中的完整实例

### 中级用户进阶

**行情数据处理**
- 掌握多周期数据获取(1m, 5m, 1d等)
- 学习财务数据和板块数据的使用
- 实现数据缓存和增量更新策略

**交易策略开发**
- 理解交易回调机制(on_stock_order, on_stock_trade)
- 实现风险控制逻辑
- 处理委托失败和撤单场景

**性能优化**
- 使用异步查询接口(query_stock_orders_async)
- 合理设置订阅范围避免数据过载
- 控制session数量避免文件堆积

### 高级用户最佳实践

**VIP服务器使用**
- 配置VIP服务器连接池
- 开启K线全推功能获取全市场数据
- 优化网络连接和数据传输

**多账户管理**
- 使用不同session_id管理多个策略
- 实现账户间的资金调度
- 处理沪港通、深港通等特殊账户类型

**生产环境部署**
- 实现断线重连机制
- 添加日志记录å’ 8000 Œ监控
- 设置异常告警和自动恢复

## 重要提示

### 使用前必读

1. **MiniQMT客户端必须先启动**
- 所有 xtdata 和 xttrader 功能都依赖 MiniQMT 客户端
- 确保客户端已登录并连接到行情服务器
## 常见问题

2. **数据下载机制**
- XtQuant 的历史数据以压缩形式存储在本地
- 使用前必须先调用 download_* 接口下载数据
- 订阅的实时数据会自动保存,无需重复下载
| 问题 | 原因 | 解决方案 |
|------|------|----------|
| `NO module named 'xtquant.IPythonAPiClient'` | Python 版本/架构不对 | 确认 64 位 Python 3.6-3.12 |
| `connect()` 返回 -1 | 同一 session 两次连接间隔 <3 秒 | 等待 3 秒或换 session_id |
| 端口 58609 被占用 | 另一个进程已监听该端口 | `xtdc.init(False); xtdc.listen(port=58601)` |

3. **回调函数注意事项**
- 使用回调模式时必须调用 `xtdata.run()` 或 `xttrader.run()` 阻塞程序
- 回调函数中不要执行耗时操作,避免阻塞数据接收
- 推荐在回调中使用异步查询接口

4. **Session管理**
- 不同策略使用不同的 session_id
- 同一 session 的两次连接间隔必须超过3秒
- 控制 session 范围避免产生大量 down_queue 文件

5. **风险提示**
- 本文档中的策略示例仅供参考学习
- 实盘交易前请充分测试
- 交易有风险,投资需谨慎

## 技能来源
## 参考文档

本技能文档基于以下来源自动生成:
- **api.md** — 完整 API 文档:xtdata/xttrader 模块参数说明、代码示例、常见问题
- **getting_started.md** — 快速入门:架构概述、环境配置、运行逻辑

- **官方文档**:迅投知识库 (dict.thinktrader.net)
- **抓取页面数**:7个页面
- **文档分类**:入门指南、API文档、完整示例、常见问题
- **生成时间**:2026年1月
## 关键约束

## 相关资源
- MiniQMT 客户端必须先启动并登录,所有 `xtdata`/`xttrader` 功能依赖它
- 历史数据使用前必须先调用 `download_*` 接口下载到本地
- 回调模式必须调用 `xtdata.run()` 或 `xttrader.run()` 阻塞程序,否则进程退出
- 同一 session_id 两次 connect 间隔必须超过 3 秒;不同策略用不同 session_id
- `order_remark` 极简客户端最大 24 英文字符(中文占 3),超出截断

- **官方网站**:http://www.thinktrader.net
- **投研用户中心**:https://xuntou.net/#/userInfo(获取VIP token)
- **迅投学院**:https://www.xuntou.net/plugin.php?id=keke_video_base
- **技术支持**:参考官方文档的常见问题部分
0