diff --git a/README.md b/README.md index 5758e8cf..2cd60dbf 100644 --- a/README.md +++ b/README.md @@ -1,136 +1,140 @@ -# 🤖 NOFX - AI驱动的币安合约自动交易竞赛系统 +# 🤖 NOFX - AI-Driven Binance Futures Auto Trading Competition System [![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/) [![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/) [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) -一个基于 **DeepSeek/Qwen AI** 的币安合约自动交易系统,支持**多AI模型实盘竞赛**,具备完整的市场分析、AI决策、**自我学习机制**和专业的Web监控界面。 - -> ⚠️ **风险提示**:本系统为实验性项目,AI自动交易存在重大风险,强烈建议仅用于学习研究或小额资金测试! +**Languages:** [English](README.md) | [中文](README.zh-CN.md) | [Українська](README.uk.md) | [Русский](README.ru.md) --- -## ✨ 核心特性 +An automated Binance futures trading system powered by **DeepSeek/Qwen AI**, supporting **multi-AI model live trading competition**, featuring comprehensive market analysis, AI decision-making, **self-learning mechanism**, and professional Web monitoring interface. -### 🏆 多AI竞赛模式 -- **Qwen vs DeepSeek** 实盘对抗 -- 独立账户管理,独立决策日志 -- 实时性能对比图表 -- 收益率PK,胜率统计 - -### 🧠 AI自我学习机制(NEW!) -- **历史反馈**: 每次决策前分析最近20个周期的交易表现 -- **智能优化**: - - 识别表现最佳/最差币种 - - 计算胜率、盈亏比、平均盈利 - - 避免重复错误(连续亏损的币种) - - 强化成功策略(高胜率的交易模式) -- **动态调整**: AI根据历史表现自主调整交易风格 - -### 📊 智能市场分析 -- **3分钟K线**: 实时价格、EMA20、MACD、RSI(7) -- **4小时K线**: 长期趋势、EMA20/50、ATR、RSI(14) -- **持仓量分析**: 市场情绪、资金流向判断 -- **OI Top追踪**: 持仓量增长最快的20个币种 -- **AI500币种池**: 高评分币种自动筛选 -- **流动性过滤**: 自动过滤持仓价值<15M USD的低流动性币种 - -### 🎯 专业风险控制 -- **单币种仓位上限**: - - 山寨币 ≤ 1.5倍账户净值 - - BTC/ETH ≤ 10倍账户净值 -- **固定杠杆**: 山寨币20倍 | BTC/ETH 50倍 -- **保证金管理**: 总使用率≤90%,AI自主决策使用率 -- **风险回报比**: 强制≥1:2(止损:止盈) -- **防止仓位叠加**: 同币种同方向不允许重复开仓 - -### 🎨 风格UI -- **专业交易界面**: 视觉设计 -- **暗色主题**: 经典配色(金色#F0B90B + 深色背景) -- **实时数据**: 5秒刷新账户、持仓、图表 -- **收益率曲线**: 账户净值历史走势(美元/百分比切换) -- **性能对比图**: 多AI收益率实时对比 -- **动画效果**: 流畅的hover、过渡、加载动画 - -### 📝 完整决策记录 -- **思维链记录**: AI的完整推理过程(CoT) -- **历史表现**: 整体胜率、平均盈利、盈亏比 -- **最近交易**: 最近5笔交易详情(开仓价→平仓价→盈亏%) -- **币种统计**: 各币种表现(胜率、平均盈亏) -- **JSON日志**: 每次决策完整记录,便于复盘分析 +> ⚠️ **Risk Warning**: This system is experimental. AI auto-trading carries significant risks. Strongly recommended for learning/research purposes or testing with small amounts only! --- -## 🏗️ 技术架构 +## ✨ Core Features + +### 🏆 Multi-AI Competition Mode +- **Qwen vs DeepSeek** live trading battle +- Independent account management and decision logs +- Real-time performance comparison charts +- ROI PK and win rate statistics + +### 🧠 AI Self-Learning Mechanism (NEW!) +- **Historical Feedback**: Analyzes last 20 cycles of trading performance before each decision +- **Smart Optimization**: + - Identifies best/worst performing coins + - Calculates win rate, profit/loss ratio, average profit + - Avoids repeating mistakes (consecutive losing coins) + - Reinforces successful strategies (high win rate patterns) +- **Dynamic Adjustment**: AI autonomously adjusts trading style based on historical performance + +### 📊 Intelligent Market Analysis +- **3-minute K-line**: Real-time price, EMA20, MACD, RSI(7) +- **4-hour K-line**: Long-term trend, EMA20/50, ATR, RSI(14) +- **Open Interest Analysis**: Market sentiment, capital flow judgment +- **OI Top Tracking**: Top 20 coins with fastest growing open interest +- **AI500 Coin Pool**: Automatic high-score coin screening +- **Liquidity Filter**: Auto-filters low liquidity coins (<15M USD position value) + +### 🎯 Professional Risk Control +- **Per-Coin Position Limit**: + - Altcoins ≤ 1.5x account equity + - BTC/ETH ≤ 10x account equity +- **Fixed Leverage**: Altcoins 20x | BTC/ETH 50x +- **Margin Management**: Total usage ≤90%, AI autonomous decision on usage rate +- **Risk-Reward Ratio**: Mandatory ≥1:2 (stop-loss:take-profit) +- **Prevent Position Stacking**: No duplicate opening of same coin/direction + +### 🎨 Professional UI +- **Professional Trading Interface**: Binance-style visual design +- **Dark Theme**: Classic color scheme (Gold #F0B90B + dark background) +- **Real-time Data**: 5-second refresh for accounts, positions, charts +- **Equity Curve**: Historical account value trend (USD/percentage toggle) +- **Performance Comparison Chart**: Real-time multi-AI ROI comparison +- **Smooth Animations**: Fluid hover, transition, and loading effects + +### 📝 Complete Decision Recording +- **Chain of Thought**: AI's complete reasoning process (CoT) +- **Historical Performance**: Overall win rate, average profit, profit/loss ratio +- **Recent Trades**: Last 5 trade details (entry price → exit price → P/L%) +- **Coin Statistics**: Per-coin performance (win rate, average P/L) +- **JSON Logs**: Complete decision records for post-trade analysis + +--- + +## 🏗️ Technical Architecture ``` nofx/ -├── main.go # 程序入口(多trader管理器) -├── config.json # 配置文件(API密钥、多trader配置) +├── main.go # Program entry (multi-trader manager) +├── config.json # Configuration file (API keys, multi-trader config) │ -├── api/ # HTTP API服务 -│ └── server.go # Gin框架,RESTful API +├── api/ # HTTP API service +│ └── server.go # Gin framework, RESTful API │ -├── trader/ # 交易核心 -│ ├── auto_trader.go # 自动交易主控(单trader) -│ └── binance_futures.go # 币安合约API封装 +├── trader/ # Trading core +│ ├── auto_trader.go # Auto trading main controller (single trader) +│ └── binance_futures.go # Binance futures API wrapper │ -├── manager/ # 多trader管理 -│ └── trader_manager.go # 管理多个trader实例 +├── manager/ # Multi-trader management +│ └── trader_manager.go # Manages multiple trader instances │ -├── market/ # 市场数据与AI决策 -│ ├── market_data.go # 市场数据获取(K线、指标) -│ ├── ai_decision_engine.go # AI决策引擎(含历史反馈) -│ └── ai_signal.go # AI API调用(DeepSeek/Qwen) +├── market/ # Market data & AI decisions +│ ├── market_data.go # Market data fetching (K-line, indicators) +│ ├── ai_decision_engine.go # AI decision engine (with historical feedback) +│ └── ai_signal.go # AI API calls (DeepSeek/Qwen) │ -├── pool/ # 币种池管理 -│ └── coin_pool.go # AI500 + OI Top合并池 +├── pool/ # Coin pool management +│ └── coin_pool.go # AI500 + OI Top merged pool │ -├── logger/ # 日志系统 -│ └── decision_logger.go # 决策记录 + 表现分析 +├── logger/ # Logging system +│ └── decision_logger.go # Decision recording + performance analysis │ -├── decision_logs/ # 决策日志存储 -│ ├── trader1/ # Trader 1的日志 -│ └── trader2/ # Trader 2的日志 +├── decision_logs/ # Decision log storage +│ ├── trader1/ # Trader 1 logs +│ └── trader2/ # Trader 2 logs │ -└── web/ # React前端 +└── web/ # React frontend ├── src/ - │ ├── components/ # React组件 - │ │ ├── EquityChart.tsx # 收益率曲线图 - │ │ ├── ComparisonChart.tsx # 多AI对比图 - │ │ └── CompetitionPage.tsx # 竞赛排行榜 - │ ├── lib/api.ts # API调用封装 - │ ├── types/index.ts # TypeScript类型 - │ ├── index.css # Binance风格样式 - │ └── App.tsx # 主应用 + │ ├── components/ # React components + │ │ ├── EquityChart.tsx # Equity curve chart + │ │ ├── ComparisonChart.tsx # Multi-AI comparison chart + │ │ └── CompetitionPage.tsx # Competition leaderboard + │ ├── lib/api.ts # API call wrapper + │ ├── types/index.ts # TypeScript types + │ ├── index.css # Binance-style CSS + │ └── App.tsx # Main app └── package.json ``` -### 核心依赖 +### Core Dependencies -**后端 (Go)** -- `github.com/adshao/go-binance/v2` - 币安API客户端 -- `github.com/markcheno/go-talib` - 技术指标计算(TA-Lib) -- `github.com/gin-gonic/gin` - HTTP API框架 +**Backend (Go)** +- `github.com/adshao/go-binance/v2` - Binance API client +- `github.com/markcheno/go-talib` - Technical indicator calculation (TA-Lib) +- `github.com/gin-gonic/gin` - HTTP API framework -**前端 (React + TypeScript)** -- `react` + `react-dom` - UI框架 -- `recharts` - 图表库(收益率曲线、对比图) -- `swr` - 数据获取和缓存 -- `tailwindcss` - CSS框架 +**Frontend (React + TypeScript)** +- `react` + `react-dom` - UI framework +- `recharts` - Chart library (equity curve, comparison charts) +- `swr` - Data fetching and caching +- `tailwindcss` - CSS framework --- -## 🚀 快速开始 +## 🚀 Quick Start -### 1. 环境要求 +### 1. Environment Requirements - **Go 1.21+** - **Node.js 18+** -- **TA-Lib** 库(技术指标计算) +- **TA-Lib** library (technical indicator calculation) -#### 安装 TA-Lib +#### Installing TA-Lib **macOS:** ```bash @@ -142,32 +146,32 @@ brew install ta-lib sudo apt-get install libta-lib0-dev ``` -**其他系统**: 参考 [TA-Lib官方文档](https://github.com/markcheno/go-talib) +**Other systems**: Refer to [TA-Lib Official Documentation](https://github.com/markcheno/go-talib) -### 2. 克隆项目 +### 2. Clone the Project ```bash -git clone +git clone https://github.com/tinkle-community/nofx.git cd nofx ``` -### 3. 安装依赖 +### 3. Install Dependencies -**后端:** +**Backend:** ```bash go mod download ``` -**前端:** +**Frontend:** ```bash cd web npm install cd .. ``` -### 4. 配置系统 +### 4. System Configuration -创建 `config.json` 文件: +Create `config.json` file (use `config.json.example` as template): ```json { @@ -201,319 +205,240 @@ cd .. } ``` -**配置说明:** -- `traders`: 可配置1-N个trader(单AI或多AI竞赛) -- `id`: Trader唯一标识(用于日志目录) -- `ai_model`: "qwen" 或 "deepseek" -- `binance_api_key/secret_key`: 每个trader使用独立的币安账户 -- `initial_balance`: 初始余额(用于计算盈亏%) -- `scan_interval_minutes`: 决策周期(建议3-5分钟) -- `coin_pool_api_url`: AI500币种池API(可选) -- `oi_top_api_url`: OI Top持仓量API(可选) +**Configuration Notes:** +- `traders`: Configure 1-N traders (single AI or multi-AI competition) +- `id`: Unique trader identifier (used for log directory) +- `ai_model`: "qwen" or "deepseek" +- `binance_api_key/secret_key`: Each trader uses independent Binance account +- `initial_balance`: Initial balance (for calculating P/L%) +- `scan_interval_minutes`: Decision cycle (recommended 3-5 minutes) +- `coin_pool_api_url`: AI500 coin pool API (optional) +- `oi_top_api_url`: OI Top open interest API (optional) -### 5. 运行系统 +### 5. Run the System -**启动后端(AI交易系统 + API服务器):** +**Start backend (AI trading system + API server):** ```bash go build -o nofx ./nofx ``` -**启动前端(Web Dashboard):** +**Start frontend (Web Dashboard):** -新开终端窗口: +Open a new terminal: ```bash cd web npm run dev ``` -**访问界面:** +**Access the interface:** ``` Web Dashboard: http://localhost:3000 API Server: http://localhost:8080 ``` -### 6. 停止系统 +### 6. Stop the System -在两个终端中分别按 `Ctrl+C` +Press `Ctrl+C` in both terminals --- -## 📖 AI决策流程 +## 📖 AI Decision Flow -每个决策周期(默认3分钟),系统按以下流程运行: +Each decision cycle (default 3 minutes), the system runs the following process: ``` ┌─────────────────────────────────────────────────────┐ -│ 1. 分析历史表现(最近20个周期) │ +│ 1. Analyze Historical Performance (last 20 cycles) │ ├─────────────────────────────────────────────────────┤ -│ ✓ 计算整体胜率、平均盈利、盈亏比 │ -│ ✓ 统计各币种表现(胜率、平均盈亏) │ -│ ✓ 识别最佳/最差币种 │ -│ ✓ 列出最近5笔交易详情 │ +│ ✓ Calculate overall win rate, avg profit, P/L ratio│ +│ ✓ Statistics for each coin (win rate, avg P/L) │ +│ ✓ Identify best/worst coins │ +│ ✓ List last 5 trade details │ └─────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────┐ -│ 2. 获取账户状态 │ +│ 2. Get Account Status │ ├─────────────────────────────────────────────────────┤ -│ • 账户净值、可用余额 │ -│ • 持仓数量、总盈亏 │ -│ • 保证金使用率 │ +│ • Account equity, available balance │ +│ • Number of positions, total P/L │ +│ • Margin usage rate │ └─────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────┐ -│ 3. 分析现有持仓(如果有) │ +│ 3. Analyze Existing Positions (if any) │ ├─────────────────────────────────────────────────────┤ -│ • 获取每个持仓的市场数据 │ -│ • 计算技术指标(RSI、MACD、EMA) │ -│ • AI判断是否需要平仓 │ +│ • Get market data for each position │ +│ • Calculate technical indicators (RSI, MACD, EMA) │ +│ • AI decides whether to close positions │ └─────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────┐ -│ 4. 评估新机会(候选币种池) │ +│ 4. Evaluate New Opportunities (candidate coin pool) │ ├─────────────────────────────────────────────────────┤ -│ • 获取AI500高评分币种(前20个) │ -│ • 获取OI Top持仓增长币种(前20个) │ -│ • 合并去重,过滤低流动性币种(<15M) │ -│ • 批量获取市场数据和技术指标 │ +│ • Get AI500 high-score coins (top 20) │ +│ • Get OI Top growing coins (top 20) │ +│ • Merge and deduplicate, filter low liquidity │ +│ • Batch fetch market data and technical indicators │ └─────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────┐ -│ 5. AI综合决策 │ +│ 5. AI Comprehensive Decision │ ├─────────────────────────────────────────────────────┤ -│ • 查看历史反馈(胜率、最佳/最差币种) │ -│ • Chain of Thought 思维链分析 │ -│ • 输出决策:平仓/开仓/持有/观望 │ -│ • 包含杠杆、仓位、止损、止盈 │ +│ • Review historical feedback (win rate, best/worst)│ +│ • Chain of Thought analysis │ +│ • Output decision: close/open/hold/wait │ +│ • Includes leverage, position size, SL, TP │ └─────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────┐ -│ 6. 执行交易 │ +│ 6. Execute Trades │ ├─────────────────────────────────────────────────────┤ -│ • 优先级排序:先平仓,再开仓 │ -│ • 精度自动适配(LOT_SIZE) │ -│ • 防止仓位叠加(同币种同方向拒绝开仓) │ -│ • 平仓后自动取消所有挂单 │ +│ • Priority: close first, then open │ +│ • Auto-adapt precision (LOT_SIZE) │ +│ • Prevent position stacking (reject duplicate) │ +│ • Auto-cancel all orders after closing │ └─────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────┐ -│ 7. 记录日志 │ +│ 7. Record Logs │ ├─────────────────────────────────────────────────────┤ -│ • 保存完整决策记录到 decision_logs/ │ -│ • 包含思维链、决策JSON、账户快照、执行结果 │ +│ • Save complete decision to decision_logs/ │ +│ • Includes CoT, decision JSON, account snapshot │ └─────────────────────────────────────────────────────┘ ``` --- -## 🧠 AI自我学习示例 +## 🧠 AI Self-Learning Example -### 历史反馈(Prompt中自动添加) +### Historical Feedback (Auto-added to Prompt) ```markdown -## 📊 历史表现反馈 +## 📊 Historical Performance Feedback -### 整体表现 -- **总交易数**: 15 笔 (盈利: 8 | 亏损: 7) -- **胜率**: 53.3% -- **平均盈利**: +3.2% | 平均亏损: -2.1% -- **盈亏比**: 1.52:1 +### Overall Performance +- **Total Trades**: 15 (Profit: 8 | Loss: 7) +- **Win Rate**: 53.3% +- **Average Profit**: +3.2% | Average Loss: -2.1% +- **Profit/Loss Ratio**: 1.52:1 -### 最近交易 +### Recent Trades 1. BTCUSDT LONG: 95000.0000 → 97500.0000 = +2.63% ✓ 2. ETHUSDT SHORT: 3500.0000 → 3450.0000 = +1.43% ✓ 3. SOLUSDT LONG: 185.0000 → 180.0000 = -2.70% ✗ 4. BNBUSDT LONG: 610.0000 → 625.0000 = +2.46% ✓ 5. ADAUSDT LONG: 0.8500 → 0.8300 = -2.35% ✗ -### 币种表现 -- **最佳**: BTCUSDT (胜率75%, 平均+2.5%) -- **最差**: SOLUSDT (胜率25%, 平均-1.8%) +### Coin Performance +- **Best**: BTCUSDT (Win rate 75%, avg +2.5%) +- **Worst**: SOLUSDT (Win rate 25%, avg -1.8%) ``` -### AI如何使用反馈 +### How AI Uses Feedback -1. **避免连续亏损币种**: 看到SOLUSDT连续3次止损,AI会避开或更谨慎 -2. **强化成功策略**: BTC突破做多胜率75%,AI会继续这个模式 -3. **动态调整风格**: 胜率<40%时变保守,盈亏比>2时保持激进 -4. **识别市场环境**: 连续亏损可能说明市场震荡,减少交易频率 +1. **Avoid consecutive losers**: Seeing SOLUSDT with 3 consecutive stop-losses, AI avoids or is more cautious +2. **Reinforce successful strategies**: BTC breakout long with 75% win rate, AI continues this pattern +3. **Dynamic style adjustment**: Win rate <40% → conservative; P/L ratio >2 → maintain aggressive +4. **Identify market conditions**: Consecutive losses may indicate choppy market, reduce trading frequency --- -## 📊 Web界面功能 +## 📊 Web Interface Features -### 1. 竞赛页面(Competition) +### 1. Competition Page -- **🏆 排行榜**: 实时收益率排名,金色边框突出显示领先者 -- **📈 性能对比图**: 双AI收益率曲线对比(紫色vs蓝色) -- **⚔️ Head-to-Head**: 直接对比,显示领先差距 -- **实时数据**: 总净值、盈亏%、持仓数、保证金使用率 +- **🏆 Leaderboard**: Real-time ROI ranking, golden border highlights leader +- **📈 Performance Comparison**: Dual AI ROI curve comparison (purple vs blue) +- **⚔️ Head-to-Head**: Direct comparison showing lead margin +- **Real-time Data**: Total equity, P/L%, position count, margin usage -### 2. 详情页面(Details) +### 2. Details Page -- **账户净值曲线**: 历史走势图(美元/百分比切换) -- **统计信息**: 总周期、成功/失败、开仓/平仓统计 -- **持仓表格**: 所有持仓详情(入场价、当前价、盈亏%、强平价) -- **AI决策日志**: 最近决策记录(可展开思维链) +- **Equity Curve**: Historical trend chart (USD/percentage toggle) +- **Statistics**: Total cycles, success/fail, open/close stats +- **Position Table**: All position details (entry price, current price, P/L%, liquidation price) +- **AI Decision Logs**: Recent decision records (expandable CoT) -### 3. 实时更新 +### 3. Real-time Updates -- 系统状态、账户信息、持仓列表:**每5秒刷新** -- 决策日志、统计信息:**每10秒刷新** -- 收益率图表:**每10秒刷新** +- System status, account info, position list: **5-second refresh** +- Decision logs, statistics: **10-second refresh** +- Equity charts: **10-second refresh** --- -## 🎛️ API接口 +## 🎛️ API Endpoints -### 竞赛相关 +### Competition Related ```bash -GET /api/competition # 竞赛排行榜(所有trader) -GET /api/traders # Trader列表 +GET /api/competition # Competition leaderboard (all traders) +GET /api/traders # Trader list ``` -### 单Trader相关 +### Single Trader Related ```bash -GET /api/status?trader_id=xxx # 系统状态 -GET /api/account?trader_id=xxx # 账户信息 -GET /api/positions?trader_id=xxx # 持仓列表 -GET /api/equity-history?trader_id=xxx # 净值历史(图表数据) -GET /api/decisions/latest?trader_id=xxx # 最新5条决策 -GET /api/statistics?trader_id=xxx # 统计信息 +GET /api/status?trader_id=xxx # System status +GET /api/account?trader_id=xxx # Account info +GET /api/positions?trader_id=xxx # Position list +GET /api/equity-history?trader_id=xxx # Equity history (chart data) +GET /api/decisions/latest?trader_id=xxx # Latest 5 decisions +GET /api/statistics?trader_id=xxx # Statistics ``` -### 系统接口 +### System Endpoints ```bash -GET /health # 健康检查 -GET /api/config # 系统配置 +GET /health # Health check +GET /api/config # System configuration ``` --- -## 📝 决策日志格式 +## ⚠️ Important Risk Warnings -每次AI决策都会生成详细的JSON日志: +### Trading Risks -### 日志文件路径 -``` -decision_logs/ -├── qwen_trader/ -│ └── decision_20251028_153042_cycle15.json -└── deepseek_trader/ - └── decision_20251028_153045_cycle15.json -``` +1. **Cryptocurrency markets are extremely volatile**, AI decisions don't guarantee profit +2. **Futures trading uses leverage**, losses may exceed principal +3. **Extreme market conditions** may lead to liquidation risk +4. **Funding rates** may affect holding costs +5. **Liquidity risk**: Some coins may experience slippage -### 日志内容示例 +### Technical Risks -```json -{ - "timestamp": "2025-10-28T15:30:42+08:00", - "cycle_number": 15, - "cot_trace": "当前持仓:ETHUSDT多头盈利+2.3%,趋势良好继续持有...", - "decision_json": "[{\"symbol\":\"BTCUSDT\",\"action\":\"open_long\"...}]", - "account_state": { - "total_balance": 1045.80, - "available_balance": 823.40, - "position_count": 3, - "margin_used_pct": 21.3 - }, - "positions": [...], - "candidate_coins": ["BTCUSDT", "ETHUSDT", ...], - "decisions": [ - { - "action": "open_long", - "symbol": "BTCUSDT", - "quantity": 0.015, - "leverage": 50, - "price": 95800.0, - "order_id": 123456789, - "success": true - } - ], - "execution_log": ["✓ BTCUSDT open_long 成功"], - "success": true -} -``` +1. **Network latency** may cause price slippage +2. **API rate limits** may affect trade execution +3. **AI API timeouts** may cause decision failures +4. **System bugs** may trigger unexpected behavior + +### Usage Recommendations + +✅ **Recommended** +- Use only funds you can afford to lose for testing +- Start with small amounts (recommended 100-500 USDT) +- Regularly check system operation status +- Monitor account balance changes +- Analyze AI decision logs to understand strategy + +❌ **Not Recommended** +- Invest all funds or borrowed money +- Run unsupervised for long periods +- Blindly trust AI decisions +- Use without understanding the system +- Run during extreme market volatility --- -## 🔧 风险控制详解 +## 🛠️ Common Issues -### 单币种仓位限制 +### 1. Compilation error: TA-Lib not found -| 币种类型 | 仓位价值上限 | 杠杆 | 保证金占用 | 示例(1000U账户) | -|---------|-------------|------|-----------|------------------| -| 山寨币 | 1.5倍净值 | 20x | 7.5% | 最多开1500U仓位 = 75U保证金 | -| BTC/ETH | 10倍净值 | 50x | 20% | 最多开10000U仓位 = 200U保证金 | - -### 为什么这样设计? - -1. **高杠杆 + 小仓位 = 分散风险** - - 20倍杠杆,1500U仓位,只需75U保证金 - - 可以同时开10+个小仓位,分散单币种风险 - -2. **单币种风险可控** - - 山寨币仓位≤1.5倍净值,5%反向波动 = 7.5%损失 - - BTC仓位≤10倍净值,2%反向波动 = 20%损失 - -3. **不限制总保证金使用率** - - AI根据市场机会自主决策保证金使用率 - - 上限90%,但不强制满仓 - - 有好机会就开仓,没机会就观望 - -### 防止过度交易 - -- **同币种同方向不允许重复开仓**: 防止AI连续开同一个仓位导致超限 -- **先平仓后开仓**: 换仓时确保先释放保证金 -- **止损止盈强制检查**: 风险回报比≥1:2 - ---- - -## ⚠️ 重要风险提示 - -### 交易风险 - -1. **加密货币市场波动极大**,AI决策不保证盈利 -2. **合约交易使用杠杆**,亏损可能超过本金 -3. **市场极端行情**下可能出现爆仓风险 -4. **资金费率**可能影响持仓成本 -5. **流动性风险**:某些币种可能出现滑点 - -### 技术风险 - -1. **网络延迟**可能导致价格滑点 -2. **API限流**可能影响交易执行 -3. **AI API超时**可能导致决策失败 -4. **系统Bug**可能引发意外行为 - -### 使用建议 - -✅ **建议做法** -- 仅使用可承受损失的资金测试 -- 从小额资金开始(建议100-500 USDT) -- 定期检查系统运行状态 -- 监控账户余额变化 -- 分析AI决策日志,理解策略 - -❌ **不建议做法** -- 投入全部资金或借贷资金 -- 长时间无人监控运行 -- 盲目信任AI决策 -- 在不理解系统的情况下使用 -- 在市场极端波动时运行 - ---- - -## 🛠️ 常见问题 - -### 1. 编译错误:TA-Lib not found - -**解决**: 安装TA-Lib库 +**Solution**: Install TA-Lib library ```bash # macOS brew install ta-lib @@ -522,103 +447,103 @@ brew install ta-lib sudo apt-get install libta-lib0-dev ``` -### 2. 精度错误:Precision is over the maximum +### 2. Precision error: Precision is over the maximum -**解决**: 系统已自动处理精度,从Binance获取LOT_SIZE。如仍报错,检查网络连接。 +**Solution**: System auto-handles precision from Binance LOT_SIZE. If error persists, check network connection. -### 3. AI API超时 +### 3. AI API timeout -**解决**: -- 检查API密钥是否正确 -- 检查网络连接(可能需要代理) -- 系统超时时间已设置为120秒 +**Solution**: +- Check if API key is correct +- Check network connection (may need proxy) +- System timeout is set to 120 seconds -### 4. 前端无法连接后端 +### 4. Frontend can't connect to backend -**解决**: -- 确保后端正在运行(http://localhost:8080) -- 检查端口8080是否被占用 -- 查看浏览器控制台错误信息 +**Solution**: +- Ensure backend is running (http://localhost:8080) +- Check if port 8080 is occupied +- Check browser console for errors -### 5. 币种池API失败 +### 5. Coin pool API failure -**解决**: -- 币种池API是可选的 -- 如果API失败,系统会使用默认主流币种(BTC、ETH等) -- 检查config.json中的API URL和auth参数 +**Solution**: +- Coin pool API is optional +- If API fails, system uses default mainstream coins (BTC, ETH, etc.) +- Check API URL and auth parameter in config.json --- -## 📈 性能优化建议 +## 📈 Performance Optimization Tips -1. **合理设置决策周期**: 建议3-5分钟,避免过度交易 -2. **控制候选币种数量**: 系统默认分析AI500前20 + OI Top前20 -3. **定期清理日志**: 避免占用过多磁盘空间 -4. **监控API调用次数**: 避免触发Binance限流(权重限制) -5. **小额资金测试**: 先用100-500 USDT测试策略有效性 +1. **Set reasonable decision cycle**: Recommended 3-5 minutes, avoid over-trading +2. **Control candidate coin count**: System defaults to AI500 top 20 + OI Top top 20 +3. **Regularly clean logs**: Avoid excessive disk usage +4. **Monitor API call count**: Avoid triggering Binance rate limits +5. **Test with small capital**: First test with 100-500 USDT for strategy validation --- -## 🔄 更新日志 +## 🔄 Changelog ### v2.0.0 (2025-10-28) -**重大更新:** -- ✅ AI自我学习机制(历史反馈、表现分析) -- ✅ 多Trader竞赛模式(Qwen vs DeepSeek) -- ✅ Binance风格UI(完整模仿币安界面) -- ✅ 性能对比图表(收益率实时对比) -- ✅ 风险控制优化(单币种仓位上限调整) +**Major Updates:** +- ✅ AI self-learning mechanism (historical feedback, performance analysis) +- ✅ Multi-trader competition mode (Qwen vs DeepSeek) +- ✅ Binance-style UI (complete Binance interface imitation) +- ✅ Performance comparison charts (real-time ROI comparison) +- ✅ Risk control optimization (per-coin position limit adjustment) -**Bug修复:** -- 修复初始余额硬编码问题 -- 修复多trader数据同步问题 -- 优化图表数据对齐(使用cycle_number) +**Bug Fixes:** +- Fixed hardcoded initial balance issue +- Fixed multi-trader data sync issue +- Optimized chart data alignment (using cycle_number) ### v1.0.0 (2025-10-27) -- 初始版本发布 -- 基础AI交易功能 -- 决策日志系统 -- 简单Web界面 +- Initial release +- Basic AI trading functionality +- Decision logging system +- Simple Web interface --- -## 📄 开源协议 +## 📄 License -MIT License - 详见 [LICENSE](LICENSE) 文件 +MIT License - See [LICENSE](LICENSE) file for details --- -## 🤝 贡献 +## 🤝 Contributing -欢迎提交Issue和Pull Request! +Issues and Pull Requests are welcome! -### 开发指南 +### Development Guide -1. Fork项目 -2. 创建功能分支 (`git checkout -b feature/AmazingFeature`) -3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) -4. 推送到分支 (`git push origin feature/AmazingFeature`) -5. 开启Pull Request +1. Fork the project +2. Create feature branch (`git checkout -b feature/AmazingFeature`) +3. Commit changes (`git commit -m 'Add some AmazingFeature'`) +4. Push to branch (`git push origin feature/AmazingFeature`) +5. Open Pull Request --- -## 📬 联系方式 +## 📬 Contact -如有问题或建议,请提交 [GitHub Issue](https://github.com/yourusername/nofx/issues) +For questions or suggestions, please submit a [GitHub Issue](https://github.com/tinkle-community/nofx/issues) --- -## 🙏 致谢 +## 🙏 Acknowledgments -- [Binance API](https://binance-docs.github.io/apidocs/futures/cn/) - 币安合约API +- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance Futures API - [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API -- [Qwen](https://dashscope.aliyuncs.com/) - 阿里云通义千问 -- [TA-Lib](https://ta-lib.org/) - 技术指标库 -- [Recharts](https://recharts.org/) - React图表库 +- [Qwen](https://dashscope.aliyuncs.com/) - Alibaba Cloud Qwen +- [TA-Lib](https://ta-lib.org/) - Technical indicator library +- [Recharts](https://recharts.org/) - React chart library --- -**最后更新**: 2025-10-28 +**Last Updated**: 2025-10-28 -**⚡ 用AI的力量,探索量化交易的可能性!** +**⚡ Explore the possibilities of quantitative trading with the power of AI!** diff --git a/README.ru.md b/README.ru.md new file mode 100644 index 00000000..717b336f --- /dev/null +++ b/README.ru.md @@ -0,0 +1,291 @@ +# 🤖 NOFX - AI-управляемая система автоматической торговли фьючерсами Binance + +[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/) +[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/) +[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/) +[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) + +**Языки / Languages:** [English](README.md) | [中文](README.zh-CN.md) | [Українська](README.uk.md) | [Русский](README.ru.md) + +--- + +Автоматизированная система торговли фьючерсами Binance на базе **DeepSeek/Qwen AI**, поддерживающая **конкуренцию нескольких AI-моделей в реальной торговле**, с полным анализом рынка, принятием решений AI, **механизмом самообучения** и профессиональным веб-интерфейсом мониторинга. + +> ⚠️ **Предупреждение о рисках**: Эта система экспериментальная. Автоматическая торговля с AI несет значительные риски. Настоятельно рекомендуется использовать только для обучения/исследований или тестирования с небольшими суммами! + +--- + +## ✨ Основные возможности + +### 🏆 Режим конкуренции нескольких AI +- **Qwen против DeepSeek** - битва в реальной торговле +- Независимое управление счетами и журналами решений +- Графики сравнения производительности в реальном времени +- Статистика ROI и процента выигрышей + +### 🧠 Механизм самообучения AI (НОВИНКА!) +- **Исторический анализ**: Анализирует последние 20 циклов торговли перед каждым решением +- **Умная оптимизация**: + - Определяет лучшие/худшие монеты по производительности + - Рассчитывает процент выигрышей, соотношение прибыли/убытка, среднюю прибыль + - Избегает повторения ошибок (последовательно убыточные монеты) + - Усиливает успешные стратегии (паттерны с высоким процентом выигрышей) +- **Динамическая корректировка**: AI автономно корректирует торговый стиль на основе исторической производительности + +### 📊 Интеллектуальный анализ рынка +- **3-минутная свеча**: Цена в реальном времени, EMA20, MACD, RSI(7) +- **4-часовая свеча**: Долгосрочный тренд, EMA20/50, ATR, RSI(14) +- **Анализ открытого интереса**: Настроения рынка, определение денежных потоков +- **Отслеживание топ OI**: Топ-20 монет с самым быстрым ростом открытого интереса +- **Пул монет AI500**: Автоматический отбор монет с высоким рейтингом +- **Фильтр ликвидности**: Автоматическая фильтрация монет с низкой ликвидностью (<15M USD стоимости позиции) + +### 🎯 Профессиональный контроль рисков +- **Лимит позиции по монете**: + - Альткоины ≤ 1.5x капитал счета + - BTC/ETH ≤ 10x капитал счета +- **Фиксированное плечо**: Альткоины 20x | BTC/ETH 50x +- **Управление маржой**: Общее использование ≤90%, AI принимает автономные решения +- **Соотношение риск/доход**: Обязательное ≥1:2 (стоп-лосс:тейк-профит) +- **Предотвращение накопления позиций**: Запрет дублирования открытия той же монеты/направления + +### 🎨 Профессиональный UI +- **Профессиональный торговый интерфейс**: Визуальный дизайн в стиле Binance +- **Темная тема**: Классическая цветовая схема (Золотой #F0B90B + темный фон) +- **Данные в реальном времени**: Обновление каждые 5 секунд для счетов, позиций, графиков +- **Кривая капитала**: График исторического тренда стоимости счета (переключение USD/процент) +- **График сравнения производительности**: Сравнение ROI нескольких AI в реальном времени +- **Плавные анимации**: Плавные эффекты наведения, переходов и загрузки + +### 📝 Полная запись решений +- **Цепочка рассуждений**: Полный процесс рассуждений AI (CoT) +- **Историческая производительность**: Общий процент выигрышей, средняя прибыль, соотношение прибыли/убытка +- **Последние сделки**: Детали последних 5 сделок (цена входа → цена выхода → P/L%) +- **Статистика по монетам**: Производительность по каждой монете (процент выигрышей, средний P/L) +- **JSON логи**: Полные записи решений для пост-анализа + +--- + +## 🚀 Быстрый старт + +### 1. Требования к среде + +- **Go 1.21+** +- **Node.js 18+** +- **TA-Lib** библиотека (расчет технических индикаторов) + +#### Установка TA-Lib + +**macOS:** +```bash +brew install ta-lib +``` + +**Ubuntu/Debian:** +```bash +sudo apt-get install libta-lib0-dev +``` + +**Другие системы**: См. [Официальную документацию TA-Lib](https://github.com/markcheno/go-talib) + +### 2. Клонирование проекта + +```bash +git clone https://github.com/tinkle-community/nofx.git +cd nofx +``` + +### 3. Установка зависимостей + +**Backend:** +```bash +go mod download +``` + +**Frontend:** +```bash +cd web +npm install +cd .. +``` + +### 4. Конфигурация системы + +Создайте файл `config.json` (используйте `config.json.example` как шаблон): + +```json +{ + "traders": [ + { + "id": "qwen_trader", + "name": "Qwen AI Trader", + "ai_model": "qwen", + "binance_api_key": "ВАШ_BINANCE_API_KEY", + "binance_secret_key": "ВАШ_BINANCE_SECRET_KEY", + "use_qwen": true, + "qwen_key": "sk-xxxxx", + "scan_interval_minutes": 3, + "initial_balance": 1000.0 + }, + { + "id": "deepseek_trader", + "name": "DeepSeek AI Trader", + "ai_model": "deepseek", + "binance_api_key": "ВАШ_BINANCE_API_KEY_2", + "binance_secret_key": "ВАШ_BINANCE_SECRET_KEY_2", + "use_qwen": false, + "deepseek_key": "sk-xxxxx", + "scan_interval_minutes": 3, + "initial_balance": 1000.0 + } + ], + "coin_pool_api_url": "http://x.x.x.x:xxx/api/ai500/list?auth=ВАШ_AUTH", + "oi_top_api_url": "http://x.x.x.x:xxx/api/oi/top?auth=ВАШ_AUTH", + "api_server_port": 8080 +} +``` + +### 5. Запуск системы + +**Запуск backend (система AI торговли + API сервер):** + +```bash +go build -o nofx +./nofx +``` + +**Запуск frontend (веб-панель):** + +Откройте новый терминал: + +```bash +cd web +npm run dev +``` + +**Доступ к интерфейсу:** +``` +Веб-панель: http://localhost:3000 +API сервер: http://localhost:8080 +``` + +### 6. Остановка системы + +Нажмите `Ctrl+C` в обоих терминалах + +--- + +## ⚠️ Важные предупреждения о рисках + +### Торговые риски + +1. **Рынки криптовалют чрезвычайно волатильны**, решения AI не гарантируют прибыль +2. **Торговля фьючерсами использует плечо**, убытки могут превысить основную сумму +3. **Экстремальные рыночные условия** могут привести к ликвидации +4. **Комиссии за финансирование** могут повлиять на стоимость удержания +5. **Риск ликвидности**: Некоторые монеты могут испытывать проскальзывание + +### Технические риски + +1. **Задержка сети** может вызвать проскальзывание цены +2. **Лимиты API** могут повлиять на исполнение сделок +3. **Тайм-ауты AI API** могут вызвать сбои решений +4. **Системные ошибки** могут вызвать неожиданное поведение + +### Рекомендации по использованию + +✅ **Рекомендуется** +- Используйте только средства, потерю которых вы можете позволить для тестирования +- Начните с небольших сумм (рекомендуется 100-500 USDT) +- Регулярно проверяйте состояние работы системы +- Отслеживайте изменения баланса счета +- Анализируйте логи решений AI для понимания стратегии + +❌ **Не рекомендуется** +- Инвестировать все средства или заемные деньги +- Запускать без присмотра на длительные периоды +- Слепо доверять решениям AI +- Использовать без понимания системы +- Запускать во время экстремальной волатильности рынка + +--- + +## 🛠️ Частые проблемы + +### 1. Ошибка компиляции: TA-Lib не найдена + +**Решение**: Установите библиотеку TA-Lib +```bash +# macOS +brew install ta-lib + +# Ubuntu +sudo apt-get install libta-lib0-dev +``` + +### 2. Ошибка точности: Точность превышает максимум + +**Решение**: Система автоматически обрабатывает точность из Binance LOT_SIZE. Если ошибка сохраняется, проверьте сетевое подключение. + +### 3. Тайм-аут AI API + +**Решение**: +- Проверьте правильность API ключа +- Проверьте сетевое подключение (может потребоваться прокси) +- Тайм-аут системы установлен на 120 секунд + +### 4. Frontend не может подключиться к backend + +**Решение**: +- Убедитесь, что backend запущен (http://localhost:8080) +- Проверьте, не занят ли порт 8080 +- Проверьте ошибки в консоли браузера + +### 5. Сбой API пула монет + +**Решение**: +- API пула монет опционален +- Если API не работает, система использует основные монеты по умолчанию (BTC, ETH и т.д.) +- Проверьте URL API и параметр auth в config.json + +--- + +## 📄 Лицензия + +Лицензия MIT - См. файл [LICENSE](LICENSE) для деталей + +--- + +## 🤝 Вклад в проект + +Приветствуются Issues и Pull Requests! + +### Руководство по разработке + +1. Сделайте Fork проекта +2. Создайте ветку функции (`git checkout -b feature/AmazingFeature`) +3. Зафиксируйте изменения (`git commit -m 'Add some AmazingFeature'`) +4. Отправьте в ветку (`git push origin feature/AmazingFeature`) +5. Откройте Pull Request + +--- + +## 📬 Контакты + +Для вопросов или предложений, пожалуйста, создайте [GitHub Issue](https://github.com/tinkle-community/nofx/issues) + +--- + +## 🙏 Благодарности + +- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance Futures API +- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API +- [Qwen](https://dashscope.aliyuncs.com/) - Alibaba Cloud Qwen +- [TA-Lib](https://ta-lib.org/) - Библиотека технических индикаторов +- [Recharts](https://recharts.org/) - Библиотека графиков React + +--- + +**Последнее обновление**: 2025-10-28 + +**⚡ Исследуйте возможности количественной торговли с силой AI!** diff --git a/README.uk.md b/README.uk.md new file mode 100644 index 00000000..4e346c23 --- /dev/null +++ b/README.uk.md @@ -0,0 +1,291 @@ +# 🤖 NOFX - AI-керована система автоматичної торгівлі ф'ючерсами Binance + +[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/) +[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/) +[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/) +[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) + +**Мови / Languages:** [English](README.md) | [中文](README.zh-CN.md) | [Українська](README.uk.md) | [Русский](README.ru.md) + +--- + +Автоматизована система торгівлі ф'ючерсами Binance на базі **DeepSeek/Qwen AI**, що підтримує **змагання кількох AI-моделей у реальній торгівлі**, з повним аналізом ринку, прийняттям рішень AI, **механізмом самонавчання** та професійним веб-інтерфейсом моніторингу. + +> ⚠️ **Попередження про ризики**: Ця система експериментальна. Автоматична торгівля з AI несе значні ризики. Наполегливо рекомендується використовувати лише для навчання/досліджень або тестування з невеликими сумами! + +--- + +## ✨ Основні можливості + +### 🏆 Режим змагання кількох AI +- **Qwen проти DeepSeek** - битва в реальній торгівлі +- Незалежне управління рахунками та журналами рішень +- Графіки порівняння продуктивності в реальному часі +- Статистика ROI та відсотка виграшів + +### 🧠 Механізм самонавчання AI (НОВИНКА!) +- **Історичний аналіз**: Аналізує останні 20 циклів торгівлі перед кожним рішенням +- **Розумна оптимізація**: + - Визначає найкращі/найгірші монети за продуктивністю + - Розраховує відсоток виграшів, співвідношення прибутку/збитку, середній прибуток + - Уникає повторення помилок (послідовно збиткові монети) + - Посилює успішні стратегії (патерни з високим відсотком виграшів) +- **Динамічне коригування**: AI автономно коригує торговий стиль на основі історичної продуктивності + +### 📊 Інтелектуальний аналіз ринку +- **3-хвилинна свічка**: Ціна в реальному часі, EMA20, MACD, RSI(7) +- **4-годинна свічка**: Довгостроковий тренд, EMA20/50, ATR, RSI(14) +- **Аналіз відкритого інтересу**: Настрої ринку, визначення грошових потоків +- **Відстеження топ OI**: Топ-20 монет з найшвидшим зростанням відкритого інтересу +- **Пул монет AI500**: Автоматичний відбір монет з високим рейтингом +- **Фільтр ліквідності**: Автоматична фільтрація монет з низькою ліквідністю (<15M USD вартості позиції) + +### 🎯 Професійний контроль ризиків +- **Ліміт позиції по монеті**: + - Альткоїни ≤ 1.5x капітал рахунку + - BTC/ETH ≤ 10x капітал рахунку +- **Фіксоване плече**: Альткоїни 20x | BTC/ETH 50x +- **Управління маржею**: Загальне використання ≤90%, AI приймає автономні рішення +- **Співвідношення ризик/дохід**: Обов'язкове ≥1:2 (стоп-лосс:тейк-профіт) +- **Запобігання накопиченню позицій**: Заборона дублювання відкриття тієї ж монети/напрямку + +### 🎨 Професійний UI +- **Професійний торговий інтерфейс**: Візуальний дизайн у стилі Binance +- **Темна тема**: Класична колірна схема (Золотий #F0B90B + темний фон) +- **Дані в реальному часі**: Оновлення кожні 5 секунд для рахунків, позицій, графіків +- **Крива капіталу**: Графік історичного тренду вартості рахунку (перемикання USD/відсоток) +- **Графік порівняння продуктивності**: Порівняння ROI кількох AI в реальному часі +- **Плавні анімації**: Плавні ефекти наведення, переходів та завантаження + +### 📝 Повний запис рішень +- **Ланцюг міркувань**: Повний процес міркувань AI (CoT) +- **Історична продуктивність**: Загальний відсоток виграшів, середній прибуток, співвідношення прибутку/збитку +- **Останні угоди**: Деталі останніх 5 угод (ціна входу → ціна виходу → P/L%) +- **Статистика по монетах**: Продуктивність по кожній монеті (відсоток виграшів, середній P/L) +- **JSON логи**: Повні записи рішень для пост-аналізу + +--- + +## 🚀 Швидкий старт + +### 1. Вимоги до середовища + +- **Go 1.21+** +- **Node.js 18+** +- **TA-Lib** бібліотека (розрахунок технічних індикаторів) + +#### Встановлення TA-Lib + +**macOS:** +```bash +brew install ta-lib +``` + +**Ubuntu/Debian:** +```bash +sudo apt-get install libta-lib0-dev +``` + +**Інші системи**: Див. [Офіційну документацію TA-Lib](https://github.com/markcheno/go-talib) + +### 2. Клонування проєкту + +```bash +git clone https://github.com/tinkle-community/nofx.git +cd nofx +``` + +### 3. Встановлення залежностей + +**Backend:** +```bash +go mod download +``` + +**Frontend:** +```bash +cd web +npm install +cd .. +``` + +### 4. Конфігурація системи + +Створіть файл `config.json` (використовуйте `config.json.example` як шаблон): + +```json +{ + "traders": [ + { + "id": "qwen_trader", + "name": "Qwen AI Trader", + "ai_model": "qwen", + "binance_api_key": "ВАШ_BINANCE_API_KEY", + "binance_secret_key": "ВАШ_BINANCE_SECRET_KEY", + "use_qwen": true, + "qwen_key": "sk-xxxxx", + "scan_interval_minutes": 3, + "initial_balance": 1000.0 + }, + { + "id": "deepseek_trader", + "name": "DeepSeek AI Trader", + "ai_model": "deepseek", + "binance_api_key": "ВАШ_BINANCE_API_KEY_2", + "binance_secret_key": "ВАШ_BINANCE_SECRET_KEY_2", + "use_qwen": false, + "deepseek_key": "sk-xxxxx", + "scan_interval_minutes": 3, + "initial_balance": 1000.0 + } + ], + "coin_pool_api_url": "http://x.x.x.x:xxx/api/ai500/list?auth=ВАШ_AUTH", + "oi_top_api_url": "http://x.x.x.x:xxx/api/oi/top?auth=ВАШ_AUTH", + "api_server_port": 8080 +} +``` + +### 5. Запуск системи + +**Запуск backend (система AI торгівлі + API сервер):** + +```bash +go build -o nofx +./nofx +``` + +**Запуск frontend (веб-панель):** + +Відкрийте новий термінал: + +```bash +cd web +npm run dev +``` + +**Доступ до інтерфейсу:** +``` +Веб-панель: http://localhost:3000 +API сервер: http://localhost:8080 +``` + +### 6. Зупинка системи + +Натисніть `Ctrl+C` в обох терміналах + +--- + +## ⚠️ Важливі попередження про ризики + +### Торговельні ризики + +1. **Ринки криптовалют надзвичайно волатильні**, рішення AI не гарантують прибуток +2. **Торгівля ф'ючерсами використовує плече**, збитки можуть перевищити основну суму +3. **Екстремальні ринкові умови** можуть призвести до ліквідації +4. **Комісії за фінансування** можуть вплинути на вартість утримання +5. **Ризик ліквідності**: Деякі монети можуть відчувати проковзування + +### Технічні ризики + +1. **Затримка мережі** може викликати проковзування ціни +2. **Ліміти API** можуть вплинути на виконання угод +3. **Тайм-аути AI API** можуть викликати збої рішень +4. **Системні помилки** можуть викликати неочікувану поведінку + +### Рекомендації щодо використання + +✅ **Рекомендується** +- Використовуйте лише кошти, втрату яких ви можете дозволити для тестування +- Почніть з невеликих сум (рекомендується 100-500 USDT) +- Регулярно перевіряйте стан роботи системи +- Відстежуйте зміни балансу рахунку +- Аналізуйте логи рішень AI для розуміння стратегії + +❌ **Не рекомендується** +- Інвестувати всі кошти або позичені гроші +- Запускати без нагляду на тривалі періоди +- Сліпо довіряти рішенням AI +- Використовувати без розуміння системи +- Запускати під час екстремальної волатильності ринку + +--- + +## 🛠️ Часті проблеми + +### 1. Помилка компіляції: TA-Lib не знайдена + +**Рішення**: Встановіть бібліотеку TA-Lib +```bash +# macOS +brew install ta-lib + +# Ubuntu +sudo apt-get install libta-lib0-dev +``` + +### 2. Помилка точності: Точність перевищує максимум + +**Рішення**: Система автоматично обробляє точність з Binance LOT_SIZE. Якщо помилка зберігається, перевірте мережеве підключення. + +### 3. Тайм-аут AI API + +**Рішення**: +- Перевірте правильність API ключа +- Перевірте мережеве підключення (може знадобитися проксі) +- Тайм-аут системи встановлено на 120 секунд + +### 4. Frontend не може підключитися до backend + +**Рішення**: +- Переконайтеся, що backend запущено (http://localhost:8080) +- Перевірте, чи не зайнятий порт 8080 +- Перевірте помилки в консолі браузера + +### 5. Збій API пулу монет + +**Рішення**: +- API пулу монет опціонален +- Якщо API не працює, система використовує основні монети за замовчуванням (BTC, ETH тощо) +- Перевірте URL API та параметр auth в config.json + +--- + +## 📄 Ліцензія + +Ліцензія MIT - Див. файл [LICENSE](LICENSE) для деталей + +--- + +## 🤝 Внесок у проєкт + +Вітаються Issues та Pull Requests! + +### Керівництво з розробки + +1. Зробіть Fork проєкту +2. Створіть гілку функції (`git checkout -b feature/AmazingFeature`) +3. Зафіксуйте зміни (`git commit -m 'Add some AmazingFeature'`) +4. Надішліть до гілки (`git push origin feature/AmazingFeature`) +5. Відкрийте Pull Request + +--- + +## 📬 Контакти + +Для питань або пропозицій, будь ласка, створіть [GitHub Issue](https://github.com/tinkle-community/nofx/issues) + +--- + +## 🙏 Подяки + +- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance Futures API +- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API +- [Qwen](https://dashscope.aliyuncs.com/) - Alibaba Cloud Qwen +- [TA-Lib](https://ta-lib.org/) - Бібліотека технічних індикаторів +- [Recharts](https://recharts.org/) - Бібліотека графіків React + +--- + +**Останнє оновлення**: 2025-10-28 + +**⚡ Досліджуйте можливості кількісної торгівлі з силою AI!** diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 00000000..c5a81c9e --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,628 @@ +# 🤖 NOFX - AI驱动的币安合约自动交易竞赛系统 + +[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/) +[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/) +[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/) +[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) + +**语言 / Languages:** [English](README.md) | [中文](README.zh-CN.md) | [Українська](README.uk.md) | [Русский](README.ru.md) + +--- + +一个基于 **DeepSeek/Qwen AI** 的币安合约自动交易系统,支持**多AI模型实盘竞赛**,具备完整的市场分析、AI决策、**自我学习机制**和专业的Web监控界面。 + +> ⚠️ **风险提示**:本系统为实验性项目,AI自动交易存在重大风险,强烈建议仅用于学习研究或小额资金测试! + +--- + +## ✨ 核心特性 + +### 🏆 多AI竞赛模式 +- **Qwen vs DeepSeek** 实盘对抗 +- 独立账户管理,独立决策日志 +- 实时性能对比图表 +- 收益率PK,胜率统计 + +### 🧠 AI自我学习机制(NEW!) +- **历史反馈**: 每次决策前分析最近20个周期的交易表现 +- **智能优化**: + - 识别表现最佳/最差币种 + - 计算胜率、盈亏比、平均盈利 + - 避免重复错误(连续亏损的币种) + - 强化成功策略(高胜率的交易模式) +- **动态调整**: AI根据历史表现自主调整交易风格 + +### 📊 智能市场分析 +- **3分钟K线**: 实时价格、EMA20、MACD、RSI(7) +- **4小时K线**: 长期趋势、EMA20/50、ATR、RSI(14) +- **持仓量分析**: 市场情绪、资金流向判断 +- **OI Top追踪**: 持仓量增长最快的20个币种 +- **AI500币种池**: 高评分币种自动筛选 +- **流动性过滤**: 自动过滤持仓价值<15M USD的低流动性币种 + +### 🎯 专业风险控制 +- **单币种仓位上限**: + - 山寨币 ≤ 1.5倍账户净值 + - BTC/ETH ≤ 10倍账户净值 +- **固定杠杆**: 山寨币20倍 | BTC/ETH 50倍 +- **保证金管理**: 总使用率≤90%,AI自主决策使用率 +- **风险回报比**: 强制≥1:2(止损:止盈) +- **防止仓位叠加**: 同币种同方向不允许重复开仓 + +### 🎨 风格UI +- **专业交易界面**: 视觉设计 +- **暗色主题**: 经典配色(金色#F0B90B + 深色背景) +- **实时数据**: 5秒刷新账户、持仓、图表 +- **收益率曲线**: 账户净值历史走势(美元/百分比切换) +- **性能对比图**: 多AI收益率实时对比 +- **动画效果**: 流畅的hover、过渡、加载动画 + +### 📝 完整决策记录 +- **思维链记录**: AI的完整推理过程(CoT) +- **历史表现**: 整体胜率、平均盈利、盈亏比 +- **最近交易**: 最近5笔交易详情(开仓价→平仓价→盈亏%) +- **币种统计**: 各币种表现(胜率、平均盈亏) +- **JSON日志**: 每次决策完整记录,便于复盘分析 + +--- + +## 🏗️ 技术架构 + +``` +nofx/ +├── main.go # 程序入口(多trader管理器) +├── config.json # 配置文件(API密钥、多trader配置) +│ +├── api/ # HTTP API服务 +│ └── server.go # Gin框架,RESTful API +│ +├── trader/ # 交易核心 +│ ├── auto_trader.go # 自动交易主控(单trader) +│ └── binance_futures.go # 币安合约API封装 +│ +├── manager/ # 多trader管理 +│ └── trader_manager.go # 管理多个trader实例 +│ +├── market/ # 市场数据与AI决策 +│ ├── market_data.go # 市场数据获取(K线、指标) +│ ├── ai_decision_engine.go # AI决策引擎(含历史反馈) +│ └── ai_signal.go # AI API调用(DeepSeek/Qwen) +│ +├── pool/ # 币种池管理 +│ └── coin_pool.go # AI500 + OI Top合并池 +│ +├── logger/ # 日志系统 +│ └── decision_logger.go # 决策记录 + 表现分析 +│ +├── decision_logs/ # 决策日志存储 +│ ├── trader1/ # Trader 1的日志 +│ └── trader2/ # Trader 2的日志 +│ +└── web/ # React前端 + ├── src/ + │ ├── components/ # React组件 + │ │ ├── EquityChart.tsx # 收益率曲线图 + │ │ ├── ComparisonChart.tsx # 多AI对比图 + │ │ └── CompetitionPage.tsx # 竞赛排行榜 + │ ├── lib/api.ts # API调用封装 + │ ├── types/index.ts # TypeScript类型 + │ ├── index.css # Binance风格样式 + │ └── App.tsx # 主应用 + └── package.json +``` + +### 核心依赖 + +**后端 (Go)** +- `github.com/adshao/go-binance/v2` - 币安API客户端 +- `github.com/markcheno/go-talib` - 技术指标计算(TA-Lib) +- `github.com/gin-gonic/gin` - HTTP API框架 + +**前端 (React + TypeScript)** +- `react` + `react-dom` - UI框架 +- `recharts` - 图表库(收益率曲线、对比图) +- `swr` - 数据获取和缓存 +- `tailwindcss` - CSS框架 + +--- + +## 🚀 快速开始 + +### 1. 环境要求 + +- **Go 1.21+** +- **Node.js 18+** +- **TA-Lib** 库(技术指标计算) + +#### 安装 TA-Lib + +**macOS:** +```bash +brew install ta-lib +``` + +**Ubuntu/Debian:** +```bash +sudo apt-get install libta-lib0-dev +``` + +**其他系统**: 参考 [TA-Lib官方文档](https://github.com/markcheno/go-talib) + +### 2. 克隆项目 + +```bash +git clone +cd nofx +``` + +### 3. 安装依赖 + +**后端:** +```bash +go mod download +``` + +**前端:** +```bash +cd web +npm install +cd .. +``` + +### 4. 配置系统 + +创建 `config.json` 文件: + +```json +{ + "traders": [ + { + "id": "qwen_trader", + "name": "Qwen AI Trader", + "ai_model": "qwen", + "binance_api_key": "YOUR_BINANCE_API_KEY", + "binance_secret_key": "YOUR_BINANCE_SECRET_KEY", + "use_qwen": true, + "qwen_key": "sk-xxxxx", + "scan_interval_minutes": 3, + "initial_balance": 1000.0 + }, + { + "id": "deepseek_trader", + "name": "DeepSeek AI Trader", + "ai_model": "deepseek", + "binance_api_key": "YOUR_BINANCE_API_KEY_2", + "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_2", + "use_qwen": false, + "deepseek_key": "sk-xxxxx", + "scan_interval_minutes": 3, + "initial_balance": 1000.0 + } + ], + "coin_pool_api_url": "http://x.x.x.x:xxx/api/ai500/list?auth=YOUR_AUTH", + "oi_top_api_url": "http://x.x.x.x:xxx/api/oi/top?auth=YOUR_AUTH", + "api_server_port": 8080 +} +``` + +**配置说明:** +- `traders`: 可配置1-N个trader(单AI或多AI竞赛) +- `id`: Trader唯一标识(用于日志目录) +- `ai_model`: "qwen" 或 "deepseek" +- `binance_api_key/secret_key`: 每个trader使用独立的币安账户 +- `initial_balance`: 初始余额(用于计算盈亏%) +- `scan_interval_minutes`: 决策周期(建议3-5分钟) +- `coin_pool_api_url`: AI500币种池API(可选) +- `oi_top_api_url`: OI Top持仓量API(可选) + +### 5. 运行系统 + +**启动后端(AI交易系统 + API服务器):** + +```bash +go build -o nofx +./nofx +``` + +**启动前端(Web Dashboard):** + +新开终端窗口: + +```bash +cd web +npm run dev +``` + +**访问界面:** +``` +Web Dashboard: http://localhost:3000 +API Server: http://localhost:8080 +``` + +### 6. 停止系统 + +在两个终端中分别按 `Ctrl+C` + +--- + +## 📖 AI决策流程 + +每个决策周期(默认3分钟),系统按以下流程运行: + +``` +┌─────────────────────────────────────────────────────┐ +│ 1. 分析历史表现(最近20个周期) │ +├─────────────────────────────────────────────────────┤ +│ ✓ 计算整体胜率、平均盈利、盈亏比 │ +│ ✓ 统计各币种表现(胜率、平均盈亏) │ +│ ✓ 识别最佳/最差币种 │ +│ ✓ 列出最近5笔交易详情 │ +└─────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────┐ +│ 2. 获取账户状态 │ +├─────────────────────────────────────────────────────┤ +│ • 账户净值、可用余额 │ +│ • 持仓数量、总盈亏 │ +│ • 保证金使用率 │ +└─────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────┐ +│ 3. 分析现有持仓(如果有) │ +├─────────────────────────────────────────────────────┤ +│ • 获取每个持仓的市场数据 │ +│ • 计算技术指标(RSI、MACD、EMA) │ +│ • AI判断是否需要平仓 │ +└─────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────┐ +│ 4. 评估新机会(候选币种池) │ +├─────────────────────────────────────────────────────┤ +│ • 获取AI500高评分币种(前20个) │ +│ • 获取OI Top持仓增长币种(前20个) │ +│ • 合并去重,过滤低流动性币种(<15M) │ +│ • 批量获取市场数据和技术指标 │ +└─────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────┐ +│ 5. AI综合决策 │ +├─────────────────────────────────────────────────────┤ +│ • 查看历史反馈(胜率、最佳/最差币种) │ +│ • Chain of Thought 思维链分析 │ +│ • 输出决策:平仓/开仓/持有/观望 │ +│ • 包含杠杆、仓位、止损、止盈 │ +└─────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────┐ +│ 6. 执行交易 │ +├─────────────────────────────────────────────────────┤ +│ • 优先级排序:先平仓,再开仓 │ +│ • 精度自动适配(LOT_SIZE) │ +│ • 防止仓位叠加(同币种同方向拒绝开仓) │ +│ • 平仓后自动取消所有挂单 │ +└─────────────────────────────────────────────────────┘ + ↓ +┌─────────────────────────────────────────────────────┐ +│ 7. 记录日志 │ +├─────────────────────────────────────────────────────┤ +│ • 保存完整决策记录到 decision_logs/ │ +│ • 包含思维链、决策JSON、账户快照、执行结果 │ +└─────────────────────────────────────────────────────┘ +``` + +--- + +## 🧠 AI自我学习示例 + +### 历史反馈(Prompt中自动添加) + +```markdown +## 📊 历史表现反馈 + +### 整体表现 +- **总交易数**: 15 笔 (盈利: 8 | 亏损: 7) +- **胜率**: 53.3% +- **平均盈利**: +3.2% | 平均亏损: -2.1% +- **盈亏比**: 1.52:1 + +### 最近交易 +1. BTCUSDT LONG: 95000.0000 → 97500.0000 = +2.63% ✓ +2. ETHUSDT SHORT: 3500.0000 → 3450.0000 = +1.43% ✓ +3. SOLUSDT LONG: 185.0000 → 180.0000 = -2.70% ✗ +4. BNBUSDT LONG: 610.0000 → 625.0000 = +2.46% ✓ +5. ADAUSDT LONG: 0.8500 → 0.8300 = -2.35% ✗ + +### 币种表现 +- **最佳**: BTCUSDT (胜率75%, 平均+2.5%) +- **最差**: SOLUSDT (胜率25%, 平均-1.8%) +``` + +### AI如何使用反馈 + +1. **避免连续亏损币种**: 看到SOLUSDT连续3次止损,AI会避开或更谨慎 +2. **强化成功策略**: BTC突破做多胜率75%,AI会继续这个模式 +3. **动态调整风格**: 胜率<40%时变保守,盈亏比>2时保持激进 +4. **识别市场环境**: 连续亏损可能说明市场震荡,减少交易频率 + +--- + +## 📊 Web界面功能 + +### 1. 竞赛页面(Competition) + +- **🏆 排行榜**: 实时收益率排名,金色边框突出显示领先者 +- **📈 性能对比图**: 双AI收益率曲线对比(紫色vs蓝色) +- **⚔️ Head-to-Head**: 直接对比,显示领先差距 +- **实时数据**: 总净值、盈亏%、持仓数、保证金使用率 + +### 2. 详情页面(Details) + +- **账户净值曲线**: 历史走势图(美元/百分比切换) +- **统计信息**: 总周期、成功/失败、开仓/平仓统计 +- **持仓表格**: 所有持仓详情(入场价、当前价、盈亏%、强平价) +- **AI决策日志**: 最近决策记录(可展开思维链) + +### 3. 实时更新 + +- 系统状态、账户信息、持仓列表:**每5秒刷新** +- 决策日志、统计信息:**每10秒刷新** +- 收益率图表:**每10秒刷新** + +--- + +## 🎛️ API接口 + +### 竞赛相关 + +```bash +GET /api/competition # 竞赛排行榜(所有trader) +GET /api/traders # Trader列表 +``` + +### 单Trader相关 + +```bash +GET /api/status?trader_id=xxx # 系统状态 +GET /api/account?trader_id=xxx # 账户信息 +GET /api/positions?trader_id=xxx # 持仓列表 +GET /api/equity-history?trader_id=xxx # 净值历史(图表数据) +GET /api/decisions/latest?trader_id=xxx # 最新5条决策 +GET /api/statistics?trader_id=xxx # 统计信息 +``` + +### 系统接口 + +```bash +GET /health # 健康检查 +GET /api/config # 系统配置 +``` + +--- + +## 📝 决策日志格式 + +每次AI决策都会生成详细的JSON日志: + +### 日志文件路径 +``` +decision_logs/ +├── qwen_trader/ +│ └── decision_20251028_153042_cycle15.json +└── deepseek_trader/ + └── decision_20251028_153045_cycle15.json +``` + +### 日志内容示例 + +```json +{ + "timestamp": "2025-10-28T15:30:42+08:00", + "cycle_number": 15, + "cot_trace": "当前持仓:ETHUSDT多头盈利+2.3%,趋势良好继续持有...", + "decision_json": "[{\"symbol\":\"BTCUSDT\",\"action\":\"open_long\"...}]", + "account_state": { + "total_balance": 1045.80, + "available_balance": 823.40, + "position_count": 3, + "margin_used_pct": 21.3 + }, + "positions": [...], + "candidate_coins": ["BTCUSDT", "ETHUSDT", ...], + "decisions": [ + { + "action": "open_long", + "symbol": "BTCUSDT", + "quantity": 0.015, + "leverage": 50, + "price": 95800.0, + "order_id": 123456789, + "success": true + } + ], + "execution_log": ["✓ BTCUSDT open_long 成功"], + "success": true +} +``` + +--- + +## 🔧 风险控制详解 + +### 单币种仓位限制 + +| 币种类型 | 仓位价值上限 | 杠杆 | 保证金占用 | 示例(1000U账户) | +|---------|-------------|------|-----------|------------------| +| 山寨币 | 1.5倍净值 | 20x | 7.5% | 最多开1500U仓位 = 75U保证金 | +| BTC/ETH | 10倍净值 | 50x | 20% | 最多开10000U仓位 = 200U保证金 | + +### 为什么这样设计? + +1. **高杠杆 + 小仓位 = 分散风险** + - 20倍杠杆,1500U仓位,只需75U保证金 + - 可以同时开10+个小仓位,分散单币种风险 + +2. **单币种风险可控** + - 山寨币仓位≤1.5倍净值,5%反向波动 = 7.5%损失 + - BTC仓位≤10倍净值,2%反向波动 = 20%损失 + +3. **不限制总保证金使用率** + - AI根据市场机会自主决策保证金使用率 + - 上限90%,但不强制满仓 + - 有好机会就开仓,没机会就观望 + +### 防止过度交易 + +- **同币种同方向不允许重复开仓**: 防止AI连续开同一个仓位导致超限 +- **先平仓后开仓**: 换仓时确保先释放保证金 +- **止损止盈强制检查**: 风险回报比≥1:2 + +--- + +## ⚠️ 重要风险提示 + +### 交易风险 + +1. **加密货币市场波动极大**,AI决策不保证盈利 +2. **合约交易使用杠杆**,亏损可能超过本金 +3. **市场极端行情**下可能出现爆仓风险 +4. **资金费率**可能影响持仓成本 +5. **流动性风险**:某些币种可能出现滑点 + +### 技术风险 + +1. **网络延迟**可能导致价格滑点 +2. **API限流**可能影响交易执行 +3. **AI API超时**可能导致决策失败 +4. **系统Bug**可能引发意外行为 + +### 使用建议 + +✅ **建议做法** +- 仅使用可承受损失的资金测试 +- 从小额资金开始(建议100-500 USDT) +- 定期检查系统运行状态 +- 监控账户余额变化 +- 分析AI决策日志,理解策略 + +❌ **不建议做法** +- 投入全部资金或借贷资金 +- 长时间无人监控运行 +- 盲目信任AI决策 +- 在不理解系统的情况下使用 +- 在市场极端波动时运行 + +--- + +## 🛠️ 常见问题 + +### 1. 编译错误:TA-Lib not found + +**解决**: 安装TA-Lib库 +```bash +# macOS +brew install ta-lib + +# Ubuntu +sudo apt-get install libta-lib0-dev +``` + +### 2. 精度错误:Precision is over the maximum + +**解决**: 系统已自动处理精度,从Binance获取LOT_SIZE。如仍报错,检查网络连接。 + +### 3. AI API超时 + +**解决**: +- 检查API密钥是否正确 +- 检查网络连接(可能需要代理) +- 系统超时时间已设置为120秒 + +### 4. 前端无法连接后端 + +**解决**: +- 确保后端正在运行(http://localhost:8080) +- 检查端口8080是否被占用 +- 查看浏览器控制台错误信息 + +### 5. 币种池API失败 + +**解决**: +- 币种池API是可选的 +- 如果API失败,系统会使用默认主流币种(BTC、ETH等) +- 检查config.json中的API URL和auth参数 + +--- + +## 📈 性能优化建议 + +1. **合理设置决策周期**: 建议3-5分钟,避免过度交易 +2. **控制候选币种数量**: 系统默认分析AI500前20 + OI Top前20 +3. **定期清理日志**: 避免占用过多磁盘空间 +4. **监控API调用次数**: 避免触发Binance限流(权重限制) +5. **小额资金测试**: 先用100-500 USDT测试策略有效性 + +--- + +## 🔄 更新日志 + +### v2.0.0 (2025-10-28) + +**重大更新:** +- ✅ AI自我学习机制(历史反馈、表现分析) +- ✅ 多Trader竞赛模式(Qwen vs DeepSeek) +- ✅ Binance风格UI(完整模仿币安界面) +- ✅ 性能对比图表(收益率实时对比) +- ✅ 风险控制优化(单币种仓位上限调整) + +**Bug修复:** +- 修复初始余额硬编码问题 +- 修复多trader数据同步问题 +- 优化图表数据对齐(使用cycle_number) + +### v1.0.0 (2025-10-27) +- 初始版本发布 +- 基础AI交易功能 +- 决策日志系统 +- 简单Web界面 + +--- + +## 📄 开源协议 + +MIT License - 详见 [LICENSE](LICENSE) 文件 + +--- + +## 🤝 贡献 + +欢迎提交Issue和Pull Request! + +### 开发指南 + +1. Fork项目 +2. 创建功能分支 (`git checkout -b feature/AmazingFeature`) +3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) +4. 推送到分支 (`git push origin feature/AmazingFeature`) +5. 开启Pull Request + +--- + +## 📬 联系方式 + +如有问题或建议,请提交 [GitHub Issue](https://github.com/yourusername/nofx/issues) + +--- + +## 🙏 致谢 + +- [Binance API](https://binance-docs.github.io/apidocs/futures/cn/) - 币安合约API +- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API +- [Qwen](https://dashscope.aliyuncs.com/) - 阿里云通义千问 +- [TA-Lib](https://ta-lib.org/) - 技术指标库 +- [Recharts](https://recharts.org/) - React图表库 + +--- + +**最后更新**: 2025-10-28 + +**⚡ 用AI的力量,探索量化交易的可能性!**