# vnpy_qmt

**Repository Path**: GuojinQuant/vnpy_qmt

## Basic Information

- **Project Name**: vnpy_qmt
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VeighNa框架的QMT数据服务与交易接口

<p align="center">
  <img src ="https://vnpy.oss-cn-shanghai.aliyuncs.com/vnpy-logo.png"/>
</p>

<p align="center">
    <img src ="https://img.shields.io/badge/version-2.0.0-blueviolet.svg"/>
    <img src ="https://img.shields.io/badge/platform-windows|linux-yellow.svg"/>
    <img src ="https://img.shields.io/badge/python-3.10|3.11|3.12-blue.svg" />
    <img src ="https://img.shields.io/github/license/vnpy/vnpy.svg?color=orange"/>
</p>

## 说明

基于迅投XtQuant和qgdata封装开发的数据服务与交易接口，提供双数据源支持：

* **qgdata数据源（回测首选）**：A股日线/分钟线/周线行情，跨平台支持
* **迅投研(XT)数据源**：实时行情、Tick数据、期货/期权市场，Windows平台

支持以下中国金融市场：

* 股票、基金、债券、ETF期权：
  * SSE：上海证券交易所
  * SZSE：深圳证券交易所
  * BSE：北京证券交易所
* 期货、期货期权（仅XT数据源）：
  * CFFEX：中国金融期货交易所
  * SHFE：上海期货交易所
  * DCE：大连商品交易所
  * CZCE：郑州商品交易所
  * INE：上海国际能源交易中心
  * GFEX：广州期货交易所


## 安装

安装环境推荐基于3.9.0版本以上的【[**VeighNa Studio**](https://www.vnpy.com/)】。

直接使用pip命令：

```
pip install vnpy_xt qgdata
```

完成基础安装后，克隆本项目代码并替换官方文件：
```bash
git clone https://gitee.com/GuojinQuant/vnpy_qmt.git

# 将 vnpy_qmt/vnpy_xt/ 目录内文件覆盖至官方安装路径：
#   Linux/Mac: /usr/local/lib/python3.x/site-packages/vnpy_xt/
#   Windows:   %PYTHON_HOME%\Lib\site-packages\vnpy_xt\
#   提示：可通过 pip show vnpy_xt 查询确切安装路径
```

## 使用

### qgdata数据源连接（回测首选）

qgdata为回测默认数据源，支持A股日线、分钟线、周线行情查询，无需启动本地客户端，跨平台可用。

1. 安装qgdata：`pip install qgdata`
2. 获取token：访问 [**quantgo.ai/data**](https://quantgo.ai/data) 注册获取数据服务token
3. 在VeighNa Trader的【全局配置】处进行数据服务配置：
    * datafeed.name：qg
    * datafeed.username：留空
    * datafeed.password：填写您的qgdata token（请勿将token提交到版本控制）
4. 支持的数据周期：1分钟(MINUTE)、1小时(HOUR)、日线(DAILY)、周线(WEEKLY)
5. 支持的市场：**仅A股** — 上交所(SSE)、深交所(SZSE)、北交所(BSE)
6. 注意事项：
    * qgdata暂不支持Tick数据，如需Tick请切换至迅投研(XT)数据源
    * 期货/期权市场（CFFEX/SHFE/DCE/CZCE/INE/GFEX）不在qgdata覆盖范围，请使用迅投研(XT)数据源

若需切换数据源，修改 `vnpy_xt/__init__.py` 中的导入：
```python
# 切换为迅投研数据源
from .xt_datafeed import XtDatafeed as Datafeed
# 切换为qgdata数据源（默认）
# from .qg_datafeed import QgDatafeed as Datafeed
```

### 迅投研(XT)数据源连接

**Token连接**

- 请使用官方版本

**客户端连接**

- 请使用官方版本

**券商miniQMT连接**

1. 连接请先登录迅投极速交易终端，同时确保xtquant模块可以正常加载（点击【下载Python库】-【Python库下载】，下载完成后拷贝"Python库路径"下Lib\site-packages文件夹中的xtquant包到自己使用的Python环境的site_packages文件夹下）。
2. 在VeighNa Trader的【全局配置】处进行数据服务配置：
    * datafeed.name：xt
    * datafeed.username：client
    * datafeed.password：留空
3. 连接XT中配置：
    * token：留空
    * QMT路径：C:\国金QMT交易端模拟
    * 资金账户：填写您在券商开户的资金账号
4. 请注意以客户端方式连接时，需要保持迅投客户端的运行。