Skip to content

1692775560/Q_System

BranchesTags

Repository files navigation

📊 QSystem - AI 量化交易系统

Version Python License Status

基于 DeepSeek AI 和 Gate.io 的专业量化交易系统

快速开始 • 功能特性 • 使用文档 • API 文档 • 常见问题

📖 目录

🎯 项目简介

QSystem 是一个现代化的 AI 驱动量化交易系统，灵感来源于 open-nof1.ai。系统使用 DeepSeek AI 进行智能决策，通过 Gate.io 交易所执行交易，提供完整的自动化交易解决方案。

🌟 为什么选择 QSystem？

  • 🤖 AI 驱动决策 - 使用 DeepSeek 大语言模型分析市场，生成交易决策
  • 💹 真实交易 - 集成 Gate.io API，支持实盘和模拟交易
  • 📊 实时监控 - 美观的 Web 界面，实时展示账户、持仓、交易
  • 🔄 全自动化 - 60 秒间隔自动分析和交易，无需人工干预
  • 💼 多模型管理 - 支持多个独立的交易模型，分散风险
  • 📈 数据可视化 - ECharts 图表展示收益曲线和市场数据
  • 🎨 现代化界面 - 参考 open-nof1.ai 的简洁设计风格
  • 🛡️ 风险控制 - 内置止损、止盈、仓位管理等风险控制机制

🎓 适用场景

  • 量化交易学习 - 了解 AI 如何进行交易决策
  • 策略回测 - 测试不同的交易策略
  • 自动化交易 - 24/7 自动执行交易
  • 投资组合管理 - 管理多个交易模型
  • 市场研究 - 分析加密货币市场趋势

✨ 核心特性

1. 🤖 DeepSeek AI 智能分析

  • 深度市场分析 - 分析价格、成交量、技术指标
  • 情绪分析 - 理解市场情绪和趋势
  • 风险评估 - 评估每笔交易的风险收益比
  • 策略生成 - 自动生成买入/卖出/持有决策
  • 推理透明 - 完整的决策推理过程可查看

2. 💹 Gate.io 交易集成

  • 现货交易 - 支持 BTC、ETH、SOL、BNB、XRP 等主流币种
  • 测试网支持 - 安全的模拟交易环境
  • 实时行情 - 毫秒级行情数据更新
  • 订单管理 - 市价单、限价单支持
  • 账户查询 - 实时查询余额和持仓
  • 交易历史 - 完整的交易记录

3. 📊 实时数据监控

  • 账户价值 - 实时显示总资产和收益率
  • 持仓管理 - 查看所有持仓的盈亏情况
  • 交易历史 - 详细的交易记录和统计
  • 市场行情 - 5 种主流币种的实时价格
  • 收益曲线 - ECharts 可视化账户价值变化

4. 🔄 自动交易系统

  • 定时执行 - 每 60 秒自动分析和交易
  • 多币种支持 - 同时监控多个交易对
  • 智能决策 - AI 自动判断买入/卖出时机
  • 风险控制 - 自动止损止盈
  • 日志记录 - 完整的交易日志

5. 💼 多模型管理

  • 独立账户 - 每个模型独立的资金和持仓
  • 策略隔离 - 不同模型可使用不同策略
  • 性能对比 - 对比不同模型的表现
  • 灵活配置 - 每个模型独立的 API Key 和参数

6. 🎨 现代化界面

  • 响应式设计 - 适配桌面和移动设备
  • 实时更新 - 10 秒自动刷新数据
  • 简洁美观 - 参考 open-nof1.ai 设计
  • 交互友好 - 直观的操作界面
  • 数据可视化 - 图表展示关键指标

🏗️ 技术架构

系统架构图

┌─────────────────────────────────────────────────────────┐
│                     用户界面 (Web UI)                    │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────┐ │
│  │ 仪表盘   │  │ 模型管理 │  │ AI 分析  │  │ 设置    │ │
│  └──────────┘  └──────────┘  └──────────┘  └─────────┘ │
└─────────────────────────────────────────────────────────┘
                          ↕ HTTP/JSON
┌─────────────────────────────────────────────────────────┐
│                   Flask 后端 API                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────┐ │
│  │ 市场数据 │  │ 模型管理 │  │ 交易执行 │  │ 数据库  │ │
│  └──────────┘  └──────────┘  └──────────┘  └─────────┘ │
└─────────────────────────────────────────────────────────┘
         ↕                ↕                ↕
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  Gate.io API │  │ DeepSeek AI  │  │ SQLite DB    │
│  (行情/交易)  │  │  (智能决策)   │  │ (数据存储)    │
└──────────────┘  └──────────────┘  └──────────────┘

技术栈

后端

  • Flask - 轻量级 Web 框架
  • SQLite - 嵌入式数据库
  • gate-api - Gate.io 官方 Python SDK
  • requests - HTTP 客户端

前端

  • HTML5 - 页面结构
  • CSS3 - 现代化样式
  • JavaScript (ES6+) - 交互逻辑
  • ECharts - 数据可视化
  • Bootstrap Icons - 图标库

AI & 交易

  • DeepSeek API - 大语言模型
  • Gate.io API - 加密货币交易
  • Technical Indicators - 技术指标计算

核心模块

模块 文件 功能
主程序 app.py Flask 应用，API 路由
配置 config.py 系统配置，API Key
数据库 database.py SQLite 数据库操作
市场数据 market_data.py Gate.io 行情获取
交易引擎 trading_engine.py AI 决策和交易执行
Gate.io gate_trading.py Gate.io API 封装
前端 templates/index.html Web 界面
样式 static/style.css 界面样式
脚本 static/app.js 前端逻辑

🚀 快速开始

前置要求

  • Python 3.8+ - 编程语言
  • pip - Python 包管理器
  • DeepSeek API Key - 获取地址
  • Gate.io API Key - 获取地址（可选）

安装步骤

1. 克隆项目

cd ~/Desktop/量化
cd QSystem

2. 安装依赖

pip install -r requirements.txt

依赖包括：

  • flask - Web 框架
  • flask-cors - 跨域支持
  • requests - HTTP 请求
  • gate-api - Gate.io SDK

3. 配置 API Key

编辑 config.py 文件：

# DeepSeek API 配置
DEEPSEEK_API_KEY = "sk-你的DeepSeek-API-Key"

# Gate.io API 配置（可选，不填只能查看行情）
GATE_API_KEY = "你的Gate-API-Key"
GATE_API_SECRET = "你的Gate-API-Secret"
GATE_USE_TESTNET = True  # 建议先用测试网

4. 启动系统

python app.py

看到以下输出表示启动成功：

============================================================
🚀 QSystem - AI量化交易系统
============================================================
✅ 数据库初始化完成
[自动交易] 已启用（间隔: 60秒）
============================================================
📊 服务器: http://localhost:8000
⌨️  按 Ctrl+C 停止
============================================================

5. 访问系统

打开浏览器访问：http://localhost:8000

⚙️ 详细配置

config.py 完整配置

"""
QSystem 配置文件
"""

# ============ DeepSeek AI 配置 ============
DEEPSEEK_API_KEY = "sk-你的API-Key"
DEEPSEEK_API_URL = "https://api.deepseek.com/v1/chat/completions"
DEEPSEEK_MODEL = "deepseek-chat"

# ============ Gate.io API 配置 ============
GATE_API_KEY = "你的API-Key"
GATE_API_SECRET = "你的API-Secret"
GATE_USE_TESTNET = True  # True=测试网，False=正式网
GATE_BASE_URL = "https://api-testnet.gateapi.io/api/v4"

# ============ 交易配置 ============
DEFAULT_INITIAL_CAPITAL = 10000  # 默认初始资金（USDT）
TRADE_FEE_RATE = 0.001  # 交易手续费率 0.1%

# ============ 监控币种 ============
MONITOR_COINS = [
    "BTC", "ETH", "SOL", "BNB", "XRP",
    "ADA", "DOGE", "AVAX", "DOT", "MATIC",
    "LINK", "UNI", "ATOM", "LTC", "BCH"
]

# ============ 自动交易配置 ============
AUTO_TRADING_ENABLED = True  # 是否启用自动交易
TRADING_INTERVAL = 60  # 交易间隔（秒）
AUTO_TRADING_COINS = ['BTC', 'ETH', 'SOL']  # 自动交易的币种

# ============ 服务器配置 ============
HOST = '0.0.0.0'  # 监听地址
PORT = 8000  # 端口
DEBUG = False  # 调试模式

获取 API Key

DeepSeek API Key

  1. 访问 https://platform.deepseek.com/
  2. 注册/登录账号
  3. 进入 API Keys 页面
  4. 点击"创建 API Key"
  5. 复制 Key（以 sk- 开头）

费用: DeepSeek 提供免费额度，新用户有 500 万 tokens 免费

Gate.io API Key

  1. 访问 https://www.gate.io/
  2. 注册/登录账号
  3. 进入"API 管理"页面
  4. 创建 API Key
  5. 设置权限：
    • ✅ 读取权限
    • ✅ 现货交易
    • ❌ 提现权限（不要开启）
  6. 复制 API Key 和 Secret

建议: 先使用测试网（GATE_USE_TESTNET = True）

📚 使用指南

1. 添加交易模型

  1. 点击右上角"Add Model"按钮
  2. 填写信息：
    • Model Name: 模型名称（如"DeepSeek BTC Trader"）
    • DeepSeek API Key: 你的 DeepSeek API Key
    • Initial Capital: 初始资金（USDT）
  3. 点击"Add Model"确认

2. 查看仪表盘

LIVE 标签页显示：

  • 加密货币行情 - 5 种主流币种的实时价格
  • 账户价值图表 - 总资产变化曲线
  • 持仓列表 - 当前所有持仓及盈亏
  • 交易历史 - 最近的交易记录

3. AI 分析

  1. 在右侧"AI Analysis"卡片中
  2. 选择要分析的币种
  3. 点击"Analyze with DeepSeek"
  4. 查看 AI 的分析结果：
    • Action: BUY/SELL/HOLD
    • Amount: 建议交易金额
    • Confidence: 置信度
    • Reasoning: 决策理由

4. 管理模型

MODELS 标签页显示所有交易模型：

  • 查看每个模型的资金和收益
  • 点击模型切换查看详情
  • 删除不需要的模型

5. 系统设置

SETTINGS 标签页可以配置：

  • Auto Trading: 开启/关闭自动交易
  • Trading Interval: 交易间隔时间
  • API Keys: 更新 API Key

🔌 API 文档

市场数据 API

GET /api/market/prices

获取市场价格

响应示例:

{
  "success": true,
  "data": {
    "BTC": {
      "price": 95428.60,
      "change_24h": -0.87,
      "name": "Bitcoin"
    },
    "ETH": {
      "price": 3159.84,
      "change_24h": -0.87,
      "name": "Ethereum"
    }
  }
}

GET /api/test/gate

测试 Gate.io API 连接

响应示例:

{
  "success": true,
  "message": "Gate.io API 连接成功！",
  "data": {
    "testnet": true,
    "base_url": "https://api-testnet.gateapi.io/api/v4",
    "ticker": {
      "symbol": "BTC",
      "current_price": 95428.60,
      "change_percentage": -0.87
    }
  }
}

模型管理 API

GET /api/models

获取所有交易模型

响应示例:

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "DeepSeek BTC Trader",
      "model_name": "deepseek-chat",
      "initial_capital": 10000,
      "current_cash": 10250.50,
      "created_at": "2025-11-16T22:00:00"
    }
  ]
}

POST /api/models

添加新的交易模型

请求体:

{
  "name": "My Trading Model",
  "api_key": "sk-...",
  "model_name": "deepseek-chat",
  "initial_capital": 10000
}

DELETE /api/models/{model_id}

删除交易模型

仪表盘 API

GET /api/dashboard

获取总体仪表盘数据

响应示例:

{
  "success": true,
  "data": {
    "total_value": 10250.50,
    "total_change": 2.51,
    "history": [...],
    "positions": [...],
    "trades": [...]
  }
}

AI 分析 API

POST /api/ai/analyze

AI 分析并生成交易决策

请求体:

{
  "coin": "BTC",
  "model_id": 1
}

响应示例:

{
  "success": true,
  "data": {
    "action": "BUY",
    "amount": 500,
    "confidence": 0.85,
    "reasoning": "BTC 价格在支撑位反弹，RSI 显示超卖..."
  }
}

💾 数据库设计

表结构

models - 交易模型表

CREATE TABLE models (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    api_key TEXT NOT NULL,
    model_name TEXT NOT NULL,
    initial_capital REAL DEFAULT 10000,
    current_cash REAL DEFAULT 10000,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)

positions - 持仓表

CREATE TABLE positions (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    model_id INTEGER NOT NULL,
    symbol TEXT NOT NULL,
    amount REAL NOT NULL,
    entry_price REAL NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (model_id) REFERENCES models(id)
)

trades - 交易记录表

CREATE TABLE trades (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    model_id INTEGER NOT NULL,
    symbol TEXT NOT NULL,
    side TEXT NOT NULL,
    amount REAL NOT NULL,
    price REAL NOT NULL,
    total REAL NOT NULL,
    fee REAL DEFAULT 0,
    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (model_id) REFERENCES models(id)
)

conversations - AI 对话记录表

CREATE TABLE conversations (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    model_id INTEGER NOT NULL,
    symbol TEXT NOT NULL,
    prompt TEXT NOT NULL,
    response TEXT NOT NULL,
    decision TEXT,
    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (model_id) REFERENCES models(id)
)

account_history - 账户历史表

CREATE TABLE account_history (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    model_id INTEGER NOT NULL,
    total_value REAL NOT NULL,
    cash REAL NOT NULL,
    positions_value REAL NOT NULL,
    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (model_id) REFERENCES models(id)
)

settings - 系统设置表

CREATE TABLE settings (
    key TEXT PRIMARY KEY,
    value TEXT NOT NULL,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)

📈 交易策略

AI 决策流程

1. 获取市场数据
   ├─ 当前价格
   ├─ 24h 涨跌幅
   ├─ 成交量
   ├─ RSI 指标
   └─ 价格位置

2. 构建 AI Prompt
   ├─ 市场数据
   ├─ 账户状态
   ├─ 持仓情况
   └─ 历史交易

3. DeepSeek AI 分析
   ├─ 技术分析
   ├─ 趋势判断
   ├─ 风险评估
   └─ 生成决策

4. 执行交易
   ├─ 验证决策
   ├─ 计算数量
   ├─ 下单交易
   └─ 记录日志

技术指标

  • RSI (相对强弱指标) - 判断超买超卖
  • 价格位置 - 当前价格在 24h 高低点的位置
  • 波动率 - 24h 价格波动幅度
  • 成交量 - 市场活跃度

风险控制

  • 止损 - 亏损达到 5% 自动止损
  • 止盈 - 盈利达到 10% 自动止盈
  • 仓位控制 - 单次交易不超过总资金的 20%
  • 分散投资 - 支持多币种交易

🛡️ 风险控制

资金安全

  1. 测试网优先 - 建议先在测试网测试
  2. 小额开始 - 初始资金不要太大
  3. API 权限 - 不要开启提现权限
  4. 密钥安全 - 不要泄露 API Key

交易风险

  1. 止损止盈 - 设置合理的止损止盈点
  2. 仓位管理 - 不要满仓操作
  3. 分散投资 - 不要只交易一个币种
  4. 监控日志 - 定期查看交易日志

系统风险

  1. 网络故障 - 确保网络稳定
  2. API 限流 - 注意 API 调用频率
  3. 数据备份 - 定期备份数据库
  4. 异常处理 - 系统有完善的异常处理

⚡ 性能优化

数据缓存

  • 市场数据缓存 10 秒
  • 减少 API 调用次数
  • 提高响应速度

数据库优化

  • 使用索引加速查询
  • 定期清理历史数据
  • 批量插入优化

前端优化

  • 按需加载数据
  • 防抖节流处理
  • 图表性能优化

❓ 常见问题

Q1: 如何获取 DeepSeek API Key？

访问 https://platform.deepseek.com/ 注册账号，在 API Keys 页面创建。

Q2: Gate.io 测试网和正式网有什么区别？

测试网使用虚拟资金，不会有真实损失，适合学习和测试。

Q3: 自动交易安全吗？

建议先在测试网测试，确认策略稳定后再使用真实资金。

Q4: 如何停止自动交易？

在 SETTINGS 页面关闭"Auto Trading"开关，或者停止程序。

Q5: 支持哪些币种？

目前支持 BTC、ETH、SOL、BNB、XRP 等主流币种。

Q6: 如何备份数据？

复制 qsystem.db 文件即可备份所有数据。

Q7: 系统占用资源多吗？

非常轻量，Python 进程占用约 50-100MB 内存。

Q8: 可以在服务器上运行吗？

可以，修改 HOST = '0.0.0.0' 即可远程访问。

🗺️ 开发路线图

v2.0.0 (当前版本) ✅

  • ✅ DeepSeek AI 集成
  • ✅ Gate.io 交易支持
  • ✅ 现代化 Web 界面
  • ✅ 自动交易功能
  • ✅ 多模型管理

v2.1.0 (计划中)

  • ⏳ 更多技术指标（MACD、布林带等）
  • ⏳ 策略回测功能
  • ⏳ 邮件/微信通知
  • ⏳ 移动端适配

v2.2.0 (未来)

  • 📋 支持更多交易所
  • 📋 机器学习策略
  • 📋 社区策略分享
  • 📋 云端部署支持

🤝 贡献指南

欢迎贡献代码、报告问题、提出建议！

如何贡献

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

代码规范

  • 遵循 PEP 8 Python 代码规范
  • 添加必要的注释和文档
  • 编写单元测试
  • 保持代码简洁清晰

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

⚠️ 免责声明

重要提示:

  1. 本系统仅供学习和研究使用，不构成任何投资建议
  2. 加密货币投资有极高风险，可能导致本金全部损失
  3. 请在充分了解风险的情况下谨慎使用
  4. 作者不对使用本系统造成的任何损失负责
  5. 请遵守当地法律法规，合法合规使用

📞 联系方式

  • 项目地址: QSystem
  • 版本: v2.0.0
  • 更新日期: 2025-11-16

🙏 致谢

⭐ 如果这个项目对你有帮助，请给一个 Star！⭐

Made with ❤️ by QSystem Team

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages