# mt5-mac

**Repository Path**: caonima12.com/mt5-mac

## Basic Information

- **Project Name**: mt5-mac
- **Description**: 11111111111111
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-11
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MT5 vs Trubit 套利分析系统

一个实时监控MT5黄金(XAUUSD)与Trubit PAXGUSDT价格差异的套利分析系统，基于布林带技术指标提供交易信号。

## 功能特性

- 🔄 实时获取MT5 XAUUSD价格数据
- 🌐 实时获取Trubit PAXGUSDT价格数据(通过WebSocket)
- 📈 计算价格差值并应用布林带指标
- 📊 Web界面实时展示价格图表和分析结果
- ⚡ 自动交易信号识别(超买超卖)
- 🔍 历史数据回溯和统计分析

## 系统要求

- Python 3.10+
- MT5终端正在运行并连接
- 网络连接支持访问Trubit API
- 代理服务器(默认: http://127.0.0.1:7890)

## 安装步骤

1. **安装依赖**:
```bash
/Users/lihuanjie/.pyenv/versions/3.10.4/bin/python3 -m pip install -r requirements.txt
```

2. **运行系统测试**:
```bash
/Users/lihuanjie/.pyenv/versions/3.10.4/bin/python3 test_basic.py
```

3. **启动完整系统**:
```bash
/Users/lihuanjie/.pyenv/versions/3.10.4/bin/python3 run_arbitrage.py
```

## 文件说明

### 核心模块
- `mt5_bridge.py` - MT5连接器，通过文件读取价格数据
- `trubit_client.py` - Trubit WebSocket客户端
- `arbitrage_analyzer.py` - 套利分析核心引擎
- `web_server.py` - Web界面服务器

### 启动脚本
- `run_arbitrage.py` - 主启动脚本
- `test_basic.py` - 系统测试脚本

### 配置文件
- `requirements.txt` - Python依赖包列表

## 使用方法

1. **启动系统**:
```bash
/Users/lihuanjie/.pyenv/versions/3.10.4/bin/python3 run_arbitrage.py
```

2. **访问Web界面**:
打开浏览器访问: http://127.0.0.1:8000

3. **监控功能**:
   - 实时价格监控
   - 价格差值计算
   - 布林带指标显示
   - 交易信号提醒

## 布林带指标说明

布林带参数:
- 周期: 20
- 标准差倍数: 2.0

信号说明:
- **价差突破上轨**: Trubit相对低估，MT5相对高估
- **价差跌破下轨**: MT5相对低估，Trubit相对高估
- **价差在带内**: 正常波动区间

## 技术架构

```
┌─────────────────┐    ┌──────────────────┐
│   MT5 Terminal  │────│   mt5_bridge.py  │
└─────────────────┘    └──────────────────┘
                              │
                              ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  Trubit API     │────│ trubit_client.py │────│ arbitrage_      │
│  (WebSocket)    │    └──────────────────┘    │ analyzer.py     │
└─────────────────┘                            └─────────────────┘
                                                       │
                                                       ▼
                                               ┌─────────────────┐
                                               │  web_server.py  │
                                               └─────────────────┘
                                                       │
                                                       ▼
                                               ┌─────────────────┐
                                               │  Web Browser    │
                                               │ (localhost:8000)│
                                               └─────────────────┘
```

## 网络配置

系统默认使用代理 `http://127.0.0.1:7890` 访问Trubit API。如需修改代理设置，请编辑 `trubit_client.py` 中的 `self.proxy` 配置。

## 风险提示

⚠️ **重要提醒**:
- 此系统仅供数据分析和参考，不构成投资建议
- 实际交易前请充分了解风险并谨慎决策
- 市场价格瞬息万变，请及时关注市场动态

## 故障排除

### 常见问题

1. **MT5连接失败**:
   - 确保MT5终端正在运行
   - 检查EA是否正常工作
   - 确认价格文件路径正确

2. **Trubit连接失败**:
   - 检查网络连接
   - 确认代理服务器正常运行
   - 验证API访问权限

3. **Web界面无法访问**:
   - 确认端口8000未被占用
   - 检查防火墙设置
   - 重启服务并查看日志

### 日志文件

系统运行时会生成 `arbitrage.log` 日志文件，记录详细的运行信息和错误信息。

## 版本信息

- 版本: 1.0.0
- 最后更新: 2025-11-10
- Python版本: 3.10.4
- 支持平台: macOS, Linux, Windows