# QMTrader

**Repository Path**: thomascatlee/QMTrader

## Basic Information

- **Project Name**: QMTrader
- **Description**: Codebuddy还有免费的DS模型可用，拿来攒个量化交易的demo吧
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-14
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QLib股票数据Web展示系统

这是一个基于Flask的Web应用，用于展示QLib格式的股票数据。该应用可以从指定的QLib数据路径获取股票数据，并在网页上以表格形式展示，支持股票代码过滤功能。

## 功能特性

- 📊 **股票数据展示**：显示股票的开盘价、最高价、最低价、收盘价、成交量和市值
- 🔍 **股票代码过滤**：支持按股票代码进行搜索和过滤
- 📅 **日期范围选择**：可以自定义查询的日期范围
- 📈 **实时数据**：基于QLib实时获取最新股票数据
- 🎨 **美观界面**：采用Bootstrap设计的现代化响应式界面

## 系统要求

- Python 3.7+
- QLib数据（路径：`d:\work\QM\Data\qlib_bin`）

## 安装依赖

```bash
pip install -r requirements.txt
```

或者手动安装：

```bash
pip install flask==2.3.3 pandas==2.0.3 qlib==0.9.1 numpy==1.24.3 Werkzeug==2.3.7
```

## 快速启动

### 方法一：使用启动脚本（推荐）

```bash
python run_web.py
```

启动脚本会自动检查依赖和数据路径，然后启动Web应用。

### 方法二：直接运行

```bash
python app.py
```

## 访问应用

应用启动后，在浏览器中访问：

```
http://localhost:5000
```

## 使用说明

### 1. 数据路径配置

应用默认使用以下数据路径：
```
d:\work\QM\Data\qlib_bin
```

如果需要修改数据路径，请编辑 `app.py` 文件中的 `QLIB_DATA_PATH` 变量。

### 2. 股票代码过滤

- 在搜索框中输入股票代码（如：SH600000）
- 支持模糊搜索，可以输入部分代码
- 点击搜索按钮或按回车键进行过滤

### 3. 日期范围选择

- 可以设置开始日期和结束日期
- 默认显示2020-01-01到2022-12-31的数据
- 点击"更新"按钮应用新的日期范围

## API接口

### 获取股票数据
```
GET /api/stocks?filter=SH600000&start_date=2020-01-01&end_date=2022-12-31
```

参数：
- `filter`：股票代码过滤器（可选）
- `start_date`：开始日期（可选，默认2020-01-01）
- `end_date`：结束日期（可选，默认2022-12-31）

### 获取股票列表
```
GET /api/stock_list
```

## 项目结构

```
QLIB/
├── app.py                 # 主应用文件
├── run_web.py            # 启动脚本
├── requirements.txt      # 依赖包列表
├── README.md             # 项目说明
└── templates/
    └── index.html        # 网页模板
```

## 技术栈

- **后端**：Flask 2.3.3
- **前端**：Bootstrap 5.1.3 + Bootstrap Icons
- **数据处理**：Pandas 2.0.3
- **股票数据**：QLib 0.9.1

## 开发说明

### 修改数据字段

如需修改显示的股票数据字段，请编辑 `app.py` 文件中的 `get_stock_data` 函数：

```python
fields = ['$open', '$high', '$low', '$close', '$volume', '$market_value']
```

### 自定义界面样式

界面样式在 `templates/index.html` 文件的 `<style>` 标签中定义，可以根据需要修改CSS样式。

### 扩展功能

- 可以添加图表展示功能
- 支持更多股票技术指标
- 添加数据导出功能
- 实现用户登录和权限管理

## 常见问题

### Q: 应用启动失败，提示数据路径不存在
A: 请检查 `d:\work\QM\Data\qlib_bin` 路径是否存在，或者修改 `app.py` 中的 `QLIB_DATA_PATH` 变量。

### Q: 显示"QLib初始化失败"
A: 请确保已正确安装QLib，并且数据路径包含有效的QLib格式数据。

### Q: 网页显示空白或格式错误
A: 请检查网络连接，确保能正常访问Bootstrap CDN，或者下载Bootstrap资源到本地。

## 许可证

本项目仅供学习和研究使用。

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。