# ai-trader

**Repository Path**: yunwolf/ai-trader

## Basic Information

- **Project Name**: ai-trader
- **Description**: 量化交易机器人，使用deepseek分析市场数据 获得买卖的点 ，交易有风险投资需谨慎
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 41
- **Forks**: 21
- **Created**: 2025-11-13
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: stocks

**Tags**: None

## README

# 量化交易机器人

基于OKX API和DeepSeek AI的量化交易系统，支持多种技术指标策略和AI辅助决策，提供直观的图形化界面。

![输入图片说明](image.png)


## 功能特性

- 🔗 OKX交易所API集成
- 🤖 DeepSeek AI技术分析
- 📊 多种技术指标策略
- 🛡️ 完善的风险管理
- 📈 实时数据监控
- 📝 详细的交易日志
- 🖥️ 直观的图形化界面
- 📋 实时价格图表显示
- ⚙️ 可视化配置管理
- 📱 钉钉群通知功能

## 安装依赖

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

## 配置设置

编辑 `config.json` 文件，填入你的API密钥和交易参数：

```json
{
  "api": {
    "okx": {
      "api_key": "your_okx_api_key_here",
      "secret_key": "your_okx_secret_key_here", 
      "passphrase": "your_okx_passphrase_here"
    },
    "deepseek": {
      "api_key": "your_deepseek_api_key_here"
    },
    "dingtalk": {
      "webhook_url": "your_dingtalk_webhook_url_here",
      "secret": "your_dingtalk_secret_here",
      "keyword_prefix": "[SO] [交易提醒] "
    }
  },
  "trading": {
    "symbol": "BTC-USDT",
    "amount": 10
  },
  "strategy": {
    "use_ma_strategy": true,
    "use_rsi_strategy": true,
    "use_macd_strategy": true
  },
  "risk": {
    "max_position_size": 100,
    "stop_loss_percent": 0.02,
    "take_profit_percent": 0.04
  },
  "system": {
    "data_update_interval": 5,
    "deepseek_analysis_interval": 300
  }
}
```

**获取API密钥：**
- OKX API密钥：从[OKX官网](https://www.okx.com)获取
- DeepSeek API密钥：从[DeepSeek官网](https://www.deepseek.com)获取
- 钉钉Webhook URL：从[钉钉开发者平台](https://open.dingtalk.com/)创建自定义机器人获取

## 使用方法

### 启动GUI应用
```bash
python start_gui.py
```

### GUI界面功能
1. **实时监控**
   - 实时价格图表显示
   - 交易状态实时更新
   - AI分析结果展示
   - 运行时间和分析次数统计

2. **配置管理**
   - 可视化编辑API配置
   - 交易参数设置
   - 策略选择
   - 风险管理参数调整

3. **日志查看**
   - 实时日志显示
   - 多级别日志过滤
   - 日志刷新功能

4. **交易历史**
   - 交易记录表格显示
   - 详细的交易信息

### GUI操作流程
1. 启动GUI应用
2. 在"配置管理"选项卡中设置API密钥和交易参数
3. 点击"保存配置"按钮保存设置
4. 在"实时监控"选项卡中点击"启动机器人"按钮开始交易
5. 监控交易状态和图表
6. 需要停止时点击"停止机器人"按钮

### 安装依赖（Windows）
```cmd
# 推荐使用虚拟环境
python -m venv venv
venv\Scripts\activate

# 安装GUI版本依赖
pip install -r requirements_gui.txt -i https://mirrors.huaweicloud.com/repository/pypi/simple/
```

### 安装依赖（Linux/Mac）
```bash
# 推荐使用虚拟环境
python -m venv venv
source venv/bin/activate

# 安装GUI版本依赖
pip install -r requirements_gui.txt
```

## 安全提醒

⚠️ **重要安全提示**：
- 首次使用请在沙盒环境测试
- 不要在代码中硬编码API密钥
- 合理设置止损止盈参数
- 建议小额资金开始测试
- GUI版本中修改配置后请务必点击"保存配置"按钮
- 定期检查日志文件，监控交易活动

## 项目结构

```
├── src/
│   ├── api/          # API客户端
│   ├── strategy/     # 交易策略
│   ├── data/         # 数据管理
│   ├── risk/         # 风险管理
│   └── utils/        # 工具函数
├── main.py           # 主程序入口
├── start_gui.py      # GUI启动脚本
├── gui_app.py        # GUI主应用
├── gui_components.py # GUI组件
├── bot_manager.py    # 机器人管理器
├── config.json       # 配置文件
├── requirements_gui.txt # GUI版本依赖包
└── logs/             # 日志目录
```

## 企业微信群通知 -- 待开发
## 钉钉群通知

本项目已集成钉钉群通知功能，可以实时推送交易提醒、策略信号和系统状态到指定的钉钉群。

### 功能特点
- 支持文本消息和Markdown消息格式
- 可@指定用户或@所有人
- 支持自定义消息前缀和关键词
- 实时推送交易信号、开平仓通知
- 系统状态和异常警报

### 配置步骤
1. 登录[钉钉开发者平台](https://open.dingtalk.com/)
2. 创建一个自定义机器人
3. 获取Webhook URL和Secret
4. 在`config.json`中配置钉钉相关参数
5. 重启机器人使配置生效

### 通知类型
- 交易信号提醒：当策略产生交易信号时推送
- 开平仓通知：记录实际的交易操作
- 系统状态：机器人启动、停止等状态变化
- 异常警报：当系统出现异常或错误时推送

### 注意事项
- 请确保在钉钉机器人设置中添加了正确的关键词（默认："[SO] [交易提醒] "）
- 建议将机器人设置为"仅指定IP可发送"以提高安全性
- 合理设置通知频率，避免过于频繁的消息打扰

## 免责声明

本项目仅供学习和研究使用，不构成投资建议。使用本系统进行实盘交易的风险由用户自行承担。
开发不易感谢支持
![输入图片说明](%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20251114140444_95_263.jpg)