diff --git a/README.md b/README.md
index a64b24eb..b5018586 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# 🤖 NOFX - Agentic Trading OS
+# NOFX - Agentic Trading OS
[](https://golang.org/)
[](https://reactjs.org/)
@@ -6,130 +6,80 @@
[](LICENSE)
[](https://amber.ac)
-| 🎁 **CONTRIBUTOR AIRDROP PROGRAM** |
+| CONTRIBUTOR AIRDROP PROGRAM |
|:----------------------------------:|
| Code · Bug Fixes · Issues → Airdrop |
-| [Learn More](#-contributor-airdrop-program) |
+| [Learn More](#contributor-airdrop-program) |
-**Languages:** [English](README.md) | [中文](docs/i18n/zh-CN/README.md) | [Українська](docs/i18n/uk/README.md) | [Русский](docs/i18n/ru/README.md) | [日本語](docs/i18n/ja/README.md) | [한국어](docs/i18n/ko/README.md) | [Tiếng Việt](docs/i18n/vi/README.md)
-
-**📚 Documentation:** [Docs Home](docs/README.md) | [Getting Started](docs/getting-started/README.md) | [Prompt Writing Guide](docs/prompt-guide.md) ([中文](docs/prompt-guide.zh-CN.md)) | [Changelog](CHANGELOG.md) | [Contributing](CONTRIBUTING.md) | [Security](SECURITY.md) | [⚠️ Disclaimer](DISCLAIMER.md)
+**Languages:** [English](README.md) | [中文](docs/i18n/zh-CN/README.md)
---
-## 📑 Table of Contents
+## AI-Powered Crypto Trading Platform
-- [🚀 Universal AI Trading Operating System](#-universal-ai-trading-operating-system)
-- [👥 Developer Community](#-developer-community)
-- [📸 Screenshots](#-screenshots)
-- [🏦 Supported Exchanges (DEX/CEX Tutorials)](#-supported-exchanges-dexcex-tutorials)
-- [🤖 Supported AI Models](#-supported-ai-models)
-- [✨ Current Implementation](#-current-implementation---crypto-markets)
-- [🔮 Roadmap](#-roadmap---universal-market-expansion)
-- [🏗️ Technical Architecture](#️-technical-architecture)
-- [🚀 Quick Start](#-quick-start)
-- [📖 AI Decision Flow](#-ai-decision-flow)
-- [🧠 AI Self-Learning](#-ai-self-learning-example)
-- [📊 Web Interface Features](#-web-interface-features)
-- [🎛️ API Endpoints](#️-api-endpoints)
-- [⚠️ Important Risk Warnings](#️-important-risk-warnings)
-- [🛠️ Common Issues](#️-common-issues)
-- [📈 Performance Tips](#-performance-optimization-tips)
-- [🔄 Changelog](#-changelog)
-- [📄 License](#-license)
-- [🤝 Contributing](#-contributing)
-- [🎁 Contributor Airdrop Program](#-contributor-airdrop-program)
+**NOFX** is an open-source AI trading system that lets you run multiple AI models to trade crypto futures automatically. Configure strategies through a web interface, monitor performance in real-time, and let AI agents compete to find the best trading approach.
----
+### Core Features
-## 🚀 Universal AI Trading Operating System
+- **Multi-AI Support**: Run DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi - switch models anytime
+- **Multi-Exchange**: Trade on Binance, Bybit, OKX, Hyperliquid, Aster DEX, Lighter from one platform
+- **Strategy Studio**: Visual strategy builder with coin sources, indicators, and risk controls
+- **AI Competition Mode**: Multiple AI traders compete in real-time, track performance side by side
+- **Web-Based Config**: No JSON editing - configure everything through the web interface
+- **Real-Time Dashboard**: Live positions, P/L tracking, AI decision logs with Chain of Thought
-**NOFX** is a **universal Agentic Trading OS** built on a unified architecture. We've successfully closed the loop in crypto markets: **"Multi-Agent Decision → Unified Risk Control → Low-Latency Execution → Live/Paper Account Backtesting"**, and are now expanding this same technology stack to **stocks, futures, options, forex, and all financial markets**.
+### Backed by [Amber.ac](https://amber.ac)
-### 🎯 Core Features
-
-- **Universal Data & Backtesting Layer**: Cross-market, cross-timeframe, cross-exchange unified representation and factor library, accumulating transferable "strategy memory"
-- **Multi-Agent Self-Play & Self-Evolution**: Strategies automatically compete and select the best, continuously iterating based on account-level PnL and risk constraints
-- **Integrated Execution & Risk Control**: Low-latency routing, slippage/risk control sandbox, account-level limits, one-click market switching
-
-### 🏢 Backed by [Amber.ac](https://amber.ac)
-
-### 👥 Core Team
+### Core Team
- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **Official Twitter (Only)** - [@nofx_official](https://x.com/nofx_official)
+- **Official Twitter** - [@nofx_official](https://x.com/nofx_official)
-### 💼 Seed Funding Round Open
+> **Risk Warning**: This system is experimental. AI auto-trading carries significant risks. Strongly recommended for learning/research purposes or testing with small amounts only!
-We are currently raising our **seed round**.
+## Developer Community
-**For investment inquiries**, please DM **Tinkle** via Twitter.
+Join our Telegram developer community: **[NOFX Developer Community](https://t.me/nofx_dev_community)**
---
-> ⚠️ **Risk Warning**: This system is experimental. AI auto-trading carries significant risks. Strongly recommended for learning/research purposes or testing with small amounts only!
+## Screenshots
-## 👥 Developer Community
-
-Join our Telegram developer community to discuss, share ideas, and get support:
-
-**💬 [NOFX Developer Community](https://t.me/nofx_dev_community)**
-
----
-
-## 📸 Screenshots
-
-### 🏆 Competition Mode - Real-time AI Battle
+### Competition Mode - Real-time AI Battle
-*Multi-AI leaderboard with real-time performance comparison charts, live PnL tracking, and trader rankings*
+*Multi-AI leaderboard with real-time performance comparison*
-### 📊 Dashboard - Market Chart View
+### Dashboard - Market Chart View
-*Professional trading dashboard with TradingView-style candlestick charts, account equity stats, and AI decision logs with expandable chain-of-thought reasoning*
+*Professional trading dashboard with TradingView-style charts*
-### 📈 Dashboard - Positions & Decisions
-
-*Real-time position management with entry/mark prices, unrealized P&L, leverage info, and complete AI trading cycle history*
-
-### 📉 Dashboard - Full Overview
-
-*Complete trading interface combining market charts, multiple active positions, and detailed AI decision logs with success indicators*
-
-### 🎛️ Strategy Studio - Coin Sources & AI Test
+### Strategy Studio
-*Strategy configuration with multiple data sources (Static List, AI500 Coin Pool, OI Top), timeframe selection, and real-time AI test with prompt preview*
-
-### ⚙️ Strategy Studio - Technical Indicators
-
-*Advanced indicator configuration: Technical Indicators (EMA, MACD, RSI, ATR), Market Sentiment (Volume, Open Interest, Funding Rate), and Quant Data integration*
-
-### 🎯 Legacy Competition Details
-
-*Classic competition view with equity curve tracking, position management, and AI decision history (legacy interface)*
+*Strategy configuration with multiple data sources and AI test*
---
-## 🏦 Supported Exchanges (DEX/CEX Tutorials)
+## Supported Exchanges
### CEX (Centralized Exchanges)
-| Exchange | Status | Register (Fee Discount) | API Setup |
-|----------|--------|-------------------------|-----------|
-| **Binance** | ✅ Supported | [Register](https://www.binance.com/join?ref=NOFXENG) | [API Guide](docs/getting-started/binance-api.md) |
-| **Bybit** | ✅ Supported | [Register](https://partner.bybit.com/b/83856) | [API Guide](docs/getting-started/bybit-api.md) |
-| **OKX** | ✅ Supported | [Register](https://www.okx.com/join/1865360) | [API Guide](docs/getting-started/okx-api.md) |
+| Exchange | Status | Register (Fee Discount) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ Supported | [Register](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ Supported | [Register](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ Supported | [Register](https://www.okx.com/join/1865360) |
### Perp-DEX (Decentralized Perpetual Exchanges)
-| Exchange | Status | Register (Fee Discount) | Agent Wallet Setup |
-|----------|--------|-------------------------|--------------------|
-| **Hyperliquid** | ✅ Supported | [Register](https://app.hyperliquid.xyz/join/AITRADING) | [Agent Wallet Guide](docs/getting-started/hyperliquid-agent-wallet.md) |
-| **Aster DEX** | ✅ Supported | [Register](https://www.asterdex.com/en/referral/fdfc0e) | [API Wallet Guide](docs/getting-started/aster-api-wallet.md) |
-| **Lighter** | ✅ Supported | [Register](https://lighter.xyz) | [Agent Wallet Guide](docs/getting-started/lighter-agent-wallet.md) |
+| Exchange | Status | Register (Fee Discount) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ Supported | [Register](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ Supported | [Register](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ Supported | [Register](https://lighter.xyz) |
---
-## 🤖 Supported AI Models
+## Supported AI Models
| AI Model | Status | Get API Key |
|----------|--------|-------------|
@@ -143,828 +93,114 @@ Join our Telegram developer community to discuss, share ideas, and get support:
---
-## ✨ Current Implementation - Crypto Markets
+## Quick Start
-NOFX is currently **fully operational in cryptocurrency markets** with the following proven capabilities:
+### Option 1: Docker Deployment (Recommended)
-### 🏆 Multi-Agent Competition Framework
-- **Live Agent Battle**: Qwen vs DeepSeek models compete in real-time trading
-- **Independent Account Management**: Each agent maintains its own decision logs and performance metrics
-- **Real-time Performance Comparison**: Live ROI tracking, win rate statistics, and head-to-head analysis
-- **Self-Evolution Loop**: Agents learn from their historical performance and continuously improve
-
-### 🧠 AI Self-Learning & Optimization
-- **Historical Feedback System**: Analyzes last 20 trading cycles before each decision
-- **Smart Performance Analysis**:
- - Identifies best/worst performing assets
- - Calculates win rate, profit/loss ratio, average profit in real USDT terms
- - Avoids repeating mistakes (consecutive losing patterns)
- - Reinforces successful strategies (high win rate patterns)
-- **Dynamic Strategy Adjustment**: AI autonomously adapts trading style based on backtest results
-
-### 📊 Universal Market Data Layer (Crypto Implementation)
-- **Multi-Timeframe Analysis**: 3-minute real-time + 4-hour trend data
-- **Technical Indicators**: EMA20/50, MACD, RSI(7/14), ATR
-- **Open Interest Tracking**: Market sentiment, capital flow analysis
-- **Liquidity Filtering**: Auto-filters low liquidity assets (<15M USD)
-- **Cross-Exchange Support**: Binance, Hyperliquid, Aster DEX with unified data interface
-
-### 🎯 Unified Risk Control System
-- **Position Limits**: Per-asset limits (Altcoins ≤1.5x equity, BTC/ETH ≤10x equity)
-- **Configurable Leverage**: Dynamic leverage from 1x to 50x based on asset class and account type
-- **Margin Management**: Total usage ≤90%, AI-controlled allocation
-- **Risk-Reward Enforcement**: Mandatory ≥1:2 stop-loss to take-profit ratio
-- **Anti-Stacking Protection**: Prevents duplicate positions in same asset/direction
-
-### ⚡ Low-Latency Execution Engine
-- **Multi-Exchange API Integration**: Binance Futures, Hyperliquid DEX, Aster DEX
-- **Automatic Precision Handling**: Smart order size & price formatting per exchange
-- **Priority Execution**: Close existing positions first, then open new ones
-- **Slippage Control**: Pre-execution validation, real-time precision checks
-
-### 🎨 Professional Monitoring Interface
-- **Binance-Style Dashboard**: Professional dark theme with real-time updates
-- **Equity Curves**: Historical account value tracking (USD/percentage toggle)
-- **Performance Charts**: Multi-agent ROI comparison with live updates
-- **Complete Decision Logs**: Full Chain of Thought (CoT) reasoning for every trade
-- **5-Second Data Refresh**: Real-time account, position, and P/L updates
-
----
-
-## 🔮 Roadmap - Universal Market Expansion
-
-NOFX is on a mission to become the **Universal AI Trading Operating System** for all financial markets.
-
-**Vision:** Same architecture. Same agent framework. All markets.
-
-**Expansion Markets:**
-- 📈 **Stock Markets**: US equities, A-shares, Hong Kong stocks
-- 📊 **Futures Markets**: Commodity futures, index futures
-- 🎯 **Options Trading**: Equity options, crypto options
-- 💱 **Forex Markets**: Major currency pairs, cross rates
-
-**Upcoming Features:**
-- Enhanced AI capabilities (GPT-4, Claude 3, Gemini Pro, flexible prompt templates)
-- New exchange integrations (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- Project structure refactoring (high cohesion, low coupling, SOLID principles)
-- Security enhancements (AES-256 encryption for API keys, RBAC, 2FA improvements)
-- User experience improvements (mobile-responsive, TradingView charts, alert system)
-
-📖 **For detailed roadmap and timeline, see:**
-- **English:** [Roadmap Documentation](docs/roadmap/README.md)
-- **中文:** [路线图文档](docs/roadmap/README.zh-CN.md)
-
----
-
-## 🏗️ Technical Architecture
-
-NOFX is built with a modern, modular architecture:
-
-- **Backend:** Go with Gin framework, SQLite database
-- **Frontend:** React 18 + TypeScript + Vite + TailwindCSS
-- **Multi-Exchange Support:** Binance, Hyperliquid, Aster DEX
-- **AI Integration:** DeepSeek, Qwen, and custom OpenAI-compatible APIs
-- **State Management:** Zustand for frontend, database-driven for backend
-- **Real-time Updates:** SWR with 5-10s polling intervals
-
-**Key Features:**
-- 🗄️ Database-driven configuration (no more JSON editing)
-- 🔐 JWT authentication with optional 2FA support
-- 📊 Real-time performance tracking and analytics
-- 🤖 Multi-AI competition mode with live comparison
-- 🔌 RESTful API for all configuration and monitoring
-
-📖 **For detailed architecture documentation, see:**
-- **English:** [Architecture Documentation](docs/architecture/README.md)
-- **中文:** [架构文档](docs/architecture/README.zh-CN.md)
-
----
-
-## 🚀 Quick Start
-
-### 🐳 Option A: Docker One-Click Deployment (EASIEST - Recommended!)
-
-**⚡ Start the platform in 2 simple steps with Docker - No installation needed!**
-
-Docker automatically handles all dependencies (Go, Node.js, TA-Lib, SQLite) and environment setup.
-
-#### Step 1: Prepare Configuration
```bash
-# Copy configuration template
-cp config.json.example config.json
+# Clone the repository
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
-# Edit and fill in your API keys
-nano config.json # or use any editor
-```
-
-⚠️ **Note**: Basic config.json is still needed for some settings, but ~~trader configurations~~ are now done through the web interface.
-
-#### Step 2: One-Click Start
-```bash
-# Option 1: Use convenience script (Recommended)
+# Start with Docker
chmod +x ./start.sh
./start.sh start --build
-
-> #### Docker Compose Version Notes
->
-> **This project uses Docker Compose V2 syntax (with spaces)**
->
-> If you have the older standalone `docker-compose` installed, please upgrade to Docker Desktop or Docker 20.10+
-
-# Option 2: Use docker compose directly
-docker compose up -d --build
```
-#### Step 2: Access Web Interface
-Open your browser and visit: **http://localhost:3000**
+Access Web Interface: **http://localhost:3000**
-**That's it! 🎉** Your AI trading platform is now running!
-
-#### Initial Setup (Through Web Interface)
-1. **Configure AI Models**: Add your DeepSeek/Qwen API keys
-2. **Configure Exchanges**: Set up Binance/Hyperliquid credentials
-3. **Create Traders**: Combine AI models with exchanges
-4. **Start Trading**: Launch your configured traders
-
-#### Manage Your System
```bash
+# Management commands
./start.sh logs # View logs
./start.sh status # Check status
./start.sh stop # Stop services
./start.sh restart # Restart services
```
-**📖 For detailed Docker deployment guide, troubleshooting, and advanced configuration:**
-- **English**: See [docs/getting-started/docker-deploy.en.md](docs/getting-started/docker-deploy.en.md)
-- **中文**: 查看 [docs/getting-started/docker-deploy.zh-CN.md](docs/getting-started/docker-deploy.zh-CN.md)
+### Option 2: Manual Installation
----
-
-### 📦 Option B: Manual Installation (For Developers)
-
-**Note**: If you used Docker deployment above, skip this section. Manual installation is only needed if you want to modify the code or run without Docker.
-
-### 1. Environment Requirements
+#### Prerequisites
- **Go 1.21+**
- **Node.js 18+**
-- **TA-Lib** library (technical indicator calculation)
+- **TA-Lib** (technical indicator library)
-#### Installing TA-Lib
-
-**macOS:**
```bash
+# Install TA-Lib
+# macOS
brew install ta-lib
-```
-**Ubuntu/Debian:**
-```bash
+# Ubuntu/Debian
sudo apt-get install libta-lib0-dev
```
-**Other systems**: Refer to [TA-Lib Official Documentation](https://github.com/markcheno/go-talib)
-
-### 2. Clone the Project
+#### Installation Steps
```bash
-git clone https://github.com/tinkle-community/nofx.git
+# 1. Clone the repository
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
-```
-### 3. Install Dependencies
-
-**Backend:**
-```bash
+# 2. Install backend dependencies
go mod download
-```
-**Frontend:**
-```bash
+# 3. Install frontend dependencies
cd web
npm install
cd ..
-```
-### 4. Get AI API Keys
-
-Before configuring the system, you need to obtain AI API keys. Choose one of the following AI providers:
-
-#### Option 1: DeepSeek (Recommended for Beginners)
-
-**Why DeepSeek?**
-- 💰 Cheaper than GPT-4 (about 1/10 the cost)
-- 🚀 Fast response time
-- 🎯 Excellent trading decision quality
-- 🌍 Works globally without VPN
-
-**How to get DeepSeek API Key:**
-
-1. **Visit**: [https://platform.deepseek.com](https://platform.deepseek.com)
-2. **Register**: Sign up with email/phone number
-3. **Verify**: Complete email/phone verification
-4. **Top-up**: Add credits to your account
- - Minimum: ~$5 USD
- - Recommended: $20-50 USD for testing
-5. **Create API Key**:
- - Go to API Keys section
- - Click "Create New Key"
- - Copy and save the key (starts with `sk-`)
- - ⚠️ **Important**: Save it immediately - you can't see it again!
-
-**Pricing**: ~$0.14 per 1M tokens (very cheap!)
-
-#### Option 2: Qwen (Alibaba Cloud)
-
-**How to get Qwen API Key:**
-
-1. **Visit**: [https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
-2. **Register**: Sign up with Alibaba Cloud account
-3. **Enable Service**: Activate DashScope service
-4. **Create API Key**:
- - Go to API Key Management
- - Create new key
- - Copy and save (starts with `sk-`)
-
-**Note**: May require Chinese phone number for registration
-
----
-
-### 5. Start the System
-
-#### **Step 1: Start the Backend**
-
-```bash
-# Build the program (first time only, or after code changes)
+# 4. Build and start backend
go build -o nofx
-
-# Start the backend
./nofx
-```
-**What you should see:**
-
-```
-╔════════════════════════════════════════════════════════════╗
-║ 🤖 AI多模型交易系统 - 支持 DeepSeek & Qwen ║
-╚════════════════════════════════════════════════════════════╝
-
-🤖 数据库中的AI交易员配置:
- • 暂无配置的交易员，请通过Web界面创建
-
-🌐 API服务器启动在 http://localhost:8081
-```
-
-#### **Step 2: Start the Frontend**
-
-Open a **NEW terminal window**, then:
-
-```bash
+# 5. Start frontend (new terminal)
cd web
npm run dev
```
-#### **Step 3: Access the Web Interface**
-
-Open your browser and visit: **🌐 http://localhost:3000**
-
-### 6. Configure Through Web Interface
-
-**Now configure everything through the web interface - no more JSON editing!**
-
-#### **Step 1: Configure AI Models**
-1. Click "AI模型配置" button
-2. Enable DeepSeek or Qwen (or both)
-3. Enter your API keys
-4. Save configuration
-
-#### **Step 2: Configure Exchanges**
-1. Click "交易所配置" button
-2. Enable Binance or Hyperliquid (or both)
-3. Enter your API credentials
-4. Save configuration
-
-#### **Step 3: Create Traders**
-1. Click "创建交易员" button
-2. Select an AI model (must be configured first)
-3. Select an exchange (must be configured first)
-4. Set initial balance and trader name
-5. Create trader
-
-#### **Step 4: Start Trading**
-- Your traders will appear in the main interface
-- Use Start/Stop buttons to control them
-- Monitor performance in real-time
-
-**✅ No more JSON file editing - everything is done through the web interface!**
+Access Web Interface: **http://localhost:3000**
---
-#### ⚔️ Expert Mode: Multi-Trader Competition
+## Initial Setup (Web Interface)
-For running multiple AI traders competing against each other:
+After starting the system, configure through the web interface:
-```json
-{
- "traders": [
- {
- "id": "qwen_trader",
- "name": "Qwen AI Trader",
- "ai_model": "qwen",
- "binance_api_key": "YOUR_BINANCE_API_KEY_1",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
- "use_qwen": true,
- "qwen_key": "sk-xxxxx",
- "deepseek_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- },
- {
- "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,
- "qwen_key": "",
- "deepseek_key": "sk-xxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
+1. **Configure AI Models** - Add your AI API keys (DeepSeek, OpenAI, etc.)
+2. **Configure Exchanges** - Set up exchange API credentials
+3. **Create Strategy** - Configure trading strategy in Strategy Studio
+4. **Create Trader** - Combine AI model + Exchange + Strategy
+5. **Start Trading** - Launch your configured traders
-**Requirements for Competition Mode:**
-- 2 separate Binance futures accounts (different API keys)
-- Both AI API keys (Qwen + DeepSeek)
-- More capital for testing (recommended: 500+ USDT per account)
+All configuration is done through the web interface - no JSON file editing required.
---
-#### 📚 Configuration Field Explanations
+## Web Interface Features
-| Field | Description | Example Value | Required? |
-|-------|-------------|---------------|-----------|
-| `id` | Unique identifier for this trader | `"my_trader"` | ✅ Yes |
-| `name` | Display name | `"My AI Trader"` | ✅ Yes |
-| `enabled` | Whether this trader is enabled
Set to `false` to skip startup | `true` or `false` | ✅ Yes |
-| `ai_model` | AI provider to use | `"deepseek"` or `"qwen"` or `"custom"` | ✅ Yes |
-| `exchange` | Exchange to use | `"binance"` or `"hyperliquid"` or `"aster"` | ✅ Yes |
-| `binance_api_key` | Binance API key | `"abc123..."` | Required when using Binance |
-| `binance_secret_key` | Binance Secret key | `"xyz789..."` | Required when using Binance |
-| `hyperliquid_private_key` | Hyperliquid private key
⚠️ Remove `0x` prefix | `"your_key..."` | Required when using Hyperliquid |
-| `hyperliquid_wallet_addr` | Hyperliquid wallet address | `"0xabc..."` | Required when using Hyperliquid |
-| `hyperliquid_testnet` | Use testnet | `true` or `false` | ❌ No (defaults to false) |
-| `use_qwen` | Whether to use Qwen | `true` or `false` | ✅ Yes |
-| `deepseek_key` | DeepSeek API key | `"sk-xxx"` | If using DeepSeek |
-| `qwen_key` | Qwen API key | `"sk-xxx"` | If using Qwen |
-| `initial_balance` | Starting balance for P/L calculation | `1000.0` | ✅ Yes |
-| `scan_interval_minutes` | How often to make decisions | `3` (3-5 recommended) | ✅ Yes |
-| **`leverage`** | **Leverage configuration (v2.0.3+)** | See below | ✅ Yes |
-| `btc_eth_leverage` | Maximum leverage for BTC/ETH
⚠️ Subaccounts: ≤5x | `5` (default, safe)
`50` (main account max) | ✅ Yes |
-| `altcoin_leverage` | Maximum leverage for altcoins
⚠️ Subaccounts: ≤5x | `5` (default, safe)
`20` (main account max) | ✅ Yes |
-| `use_default_coins` | Use built-in coin list
**✨ Smart Default: `true`** (v2.0.2+)
Auto-enabled if no API URL provided | `true` or omit | ❌ No
(Optional, auto-defaults) |
-| `coin_pool_api_url` | Custom coin pool API
*Only needed when `use_default_coins: false`* | `""` (empty) | ❌ No |
-| `oi_top_api_url` | Open interest API
*Optional supplement data* | `""` (empty) | ❌ No |
-| `api_server_port` | Web dashboard port | `8080` | ✅ Yes |
+### Competition Page
+- Real-time ROI leaderboard
+- Multi-AI performance comparison charts
+- Live P/L tracking and rankings
-~~**Default Trading Coins** (when `use_default_coins: true`):
-- BTC, ETH, SOL, BNB, XRP, DOGE, ADA, HYPE~~
+### Dashboard
+- TradingView-style candlestick charts
+- Real-time position management
+- AI decision logs with Chain of Thought reasoning
+- Equity curve tracking
-*Note: Trading coins are now configured through the web interface*
+### Strategy Studio
+- Coin source configuration (Static list, AI500 pool, OI Top)
+- Technical indicators (EMA, MACD, RSI, ATR, Volume, OI, Funding Rate)
+- Risk control settings (leverage, position limits, margin usage)
+- AI test with real-time prompt preview
---
-#### ⚙️ Leverage Configuration (v2.0.3+)
-
-**What is leverage configuration?**
-
-The leverage settings control the maximum leverage the AI can use for each trade. This is crucial for risk management, especially for Binance subaccounts which have leverage restrictions.
-
-~~**Configuration format:**~~
-
-```json
-"leverage": {
- "btc_eth_leverage": 5, // Maximum leverage for BTC and ETH
- "altcoin_leverage": 5 // Maximum leverage for all other coins
-}
-```
-
-*Note: Leverage is now configured through the web interface*
-
-**⚠️ Important: Binance Subaccount Restrictions**
-
-- **Subaccounts**: Limited to **≤5x leverage** by Binance
-- **Main accounts**: Can use up to 20x (altcoins) or 50x (BTC/ETH)
-- If you're using a subaccount and set leverage >5x, trades will **fail** with error: `Subaccounts are restricted from using leverage greater than 5x`
-
-**Recommended settings:**
-
-| Account Type | BTC/ETH Leverage | Altcoin Leverage | Risk Level |
-|-------------|------------------|------------------|------------|
-| **Subaccount** | `5` | `5` | ✅ Safe (default) |
-| **Main (Conservative)** | `10` | `10` | 🟡 Medium |
-| **Main (Aggressive)** | `20` | `15` | 🔴 High |
-| **Main (Maximum)** | `50` | `20` | 🔴🔴 Very High |
-
-**Examples:**
-
-~~**Safe configuration (subaccount or conservative):**~~
-```json
-"leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
-}
-```
-
-~~**Aggressive configuration (main account only):**~~
-```json
-"leverage": {
- "btc_eth_leverage": 20,
- "altcoin_leverage": 15
-}
-```
-
-*Note: Leverage configuration is now done through the web interface*
-
-**How AI uses leverage:**
-
-- AI can choose **any leverage from 1x up to your configured maximum**
-- For example, with `altcoin_leverage: 20`, AI might decide to use 5x, 10x, or 20x based on market conditions
-- The configuration sets the **upper limit**, not a fixed value
-- AI considers volatility, risk-reward ratio, and account balance when choosing leverage
-
----
-
-#### ⚠️ Important: `use_default_coins` Field
-
-**Smart Default Behavior (v2.0.2+):**
-
-The system now automatically defaults to `use_default_coins: true` if:
-- You don't include this field in config.json, OR
-- You set it to `false` but don't provide `coin_pool_api_url`
-
-This makes it beginner-friendly! You can even omit this field entirely.
-
-**Configuration Examples:**
-
-✅ **Option 1: Explicitly set (Recommended for clarity)**
-```json
-"use_default_coins": true,
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-✅ **Option 2: Omit the field (uses default coins automatically)**
-```json
-// Just don't include "use_default_coins" at all
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-⚙️ **Advanced: Use external API**
-```json
-"use_default_coins": false,
-"coin_pool_api_url": "http://your-api.com/coins",
-"oi_top_api_url": "http://your-api.com/oi"
-```
-
----
-
-### 6. Run the System
-
-#### 🚀 Starting the System (2 steps)
-
-The system has **2 parts** that run separately:
-1. **Backend** (AI trading brain + API)
-2. **Frontend** (Web dashboard for monitoring)
-
----
-
-#### **Step 1: Start the Backend**
-
-Open a terminal and run:
-
-```bash
-# Build the program (first time only, or after code changes)
-go build -o nofx
-
-# Start the backend
-./nofx
-```
-
-**What you should see:**
-
-```
-🚀 启动自动交易系统...
-✓ Trader [my_trader] 已初始化
-✓ API服务器启动在端口 8080
-📊 开始交易监控...
-```
-
-**⚠️ If you see errors:**
-
-| Error Message | Solution |
-|--------------|----------|
-| `invalid API key` | Check your Binance API key in config.json |
-| `TA-Lib not found` | Run `brew install ta-lib` (macOS) |
-| `port 8080 already in use` | ~~Change `api_server_port` in config.json~~ *Change `API_PORT` in .env file* |
-| `DeepSeek API error` | Verify your DeepSeek API key and balance |
-
-**✅ Backend is running correctly when you see:**
-- No error messages
-- "开始交易监控..." appears
-- System shows account balance
-- Keep this terminal window open!
-
----
-
-#### **Step 2: Start the Frontend**
-
-Open a **NEW terminal window** (keep the first one running!), then:
-
-```bash
-cd web
-npm run dev
-```
-
-**What you should see:**
-
-```
-VITE v5.x.x ready in xxx ms
-
-➜ Local: http://localhost:3000/
-➜ Network: use --host to expose
-```
-
-**✅ Frontend is running when you see:**
-- "Local: http://localhost:3000/" message
-- No error messages
-- Keep this terminal window open too!
-
----
-
-#### **Step 3: Access the Dashboard**
-
-Open your web browser and visit:
-
-**🌐 http://localhost:3000**
-
-**What you'll see:**
-- 📊 Real-time account balance
-- 📈 Open positions (if any)
-- 🤖 AI decision logs
-- 📉 Equity curve chart
-
-**First-time tips:**
-- It may take 3-5 minutes for the first AI decision
-- Initial decisions might say "观望" (wait) - this is normal
-- AI needs to analyze market conditions first
-
----
-
-### 7. Monitor the System
-
-**What to watch:**
-
-✅ **Healthy System Signs:**
-- Backend terminal shows decision cycles every 3-5 minutes
-- No continuous error messages
-- Account balance updates
-- Web dashboard refreshes automatically
-
-⚠️ **Warning Signs:**
-- Repeated API errors
-- No decisions for 10+ minutes
-- Balance decreasing rapidly
-
-**Checking System Status:**
-
-```bash
-# In a new terminal window
-curl http://localhost:8080/api/health
-```
-
-Should return: `{"status":"ok"}`
-
----
-
-### 8. Stop the System
-
-**Graceful Shutdown (Recommended):**
-
-1. Go to the **backend terminal** (the first one)
-2. Press `Ctrl+C`
-3. Wait for "系统已停止" message
-4. Go to the **frontend terminal** (the second one)
-5. Press `Ctrl+C`
-
-**⚠️ Important:**
-- Always stop the backend first
-- Wait for confirmation before closing terminals
-- Don't force quit (don't close terminal directly)
-
----
-
-## 📖 AI Decision Flow
-
-Each decision cycle (default 3 minutes), the system executes the following intelligent process:
-
-### Step 1: 📊 Analyze Historical Performance (last 20 cycles)
-- ✓ Calculate overall win rate, avg profit, P/L ratio
-- ✓ Per-coin statistics (win rate, avg P/L in USDT)
-- ✓ Identify best/worst performing coins
-- ✓ List last 5 trade details with accurate PnL
-- ✓ Calculate Sharpe ratio for risk-adjusted performance
-- 📌 **NEW (v2.0.2)**: Accurate USDT PnL with leverage
-
-**↓**
-
-### Step 2: 💰 Get Account Status
-- Total equity & available balance
-- Number of open positions & unrealized P/L
-- Margin usage rate (AI manages up to 90%)
-- Daily P/L tracking & drawdown monitoring
-
-**↓**
-
-### Step 3: 🔍 Analyze Existing Positions (if any)
-- For each position, fetch latest market data
-- Calculate real-time technical indicators:
- - 3min K-line: RSI(7), MACD, EMA20
- - 4hour K-line: RSI(14), EMA20/50, ATR
-- Track position holding duration (e.g., "2h 15min")
-- 📌 **NEW (v2.0.2)**: Shows how long each position held
-- Display: Entry price, current price, P/L%, duration
-- AI evaluates: Should hold or close?
-
-**↓**
-
-### Step 4: 🎯 Evaluate New Opportunities (candidate coins)
-- Fetch coin pool (2 modes):
- - 🌟 **Default Mode**: BTC, ETH, SOL, BNB, XRP, etc.
- - ⚙️ **Advanced Mode**: AI500 (top 20) + OI Top (top 20)
-- Merge & deduplicate candidate coins
-- Filter: Remove low liquidity (<15M USD OI value)
-- Batch fetch market data + technical indicators
-- Calculate volatility, trend strength, volume surge
-
-**↓**
-
-### Step 5: 🧠 AI Comprehensive Decision (DeepSeek/Qwen)
-- Review historical feedback:
- - Recent win rate & profit factor
- - Best/worst coins performance
- - Avoid repeating mistakes
-- Analyze all raw sequence data:
- - 3min price sequences, 4hour K-line sequences
- - Complete indicator sequences (not just latest)
- - 📌 **NEW (v2.0.2)**: AI has full freedom to analyze
-- Chain of Thought (CoT) reasoning process
-- Output structured decisions:
- - Action: `close_long` / `close_short` / `open_long` / `open_short`
- - Coin symbol, quantity, leverage
- - Stop-loss & take-profit levels (≥1:2 ratio)
-- Decision: Wait / Hold / Close / Open
-
-**↓**
-
-### Step 6: ⚡ Execute Trades
-- Priority order: Close existing → Then open new
-- Risk checks before execution:
- - Position size limits (1.5x for altcoins, 10x BTC)
- - No duplicate positions (same coin + direction)
- - Margin usage within 90% limit
-- Auto-fetch & apply Binance LOT_SIZE precision
-- Execute orders via Binance Futures API
-- After closing: Auto-cancel all pending orders
-- Record actual execution price & order ID
-- 📌 Track position open time for duration calculation
-
-**↓**
-
-### Step 7: 📝 Record Complete Logs & Update Performance
-- Save decision log to `decision_logs/{trader_id}/`
-- Log includes:
- - Complete Chain of Thought (CoT)
- - Input prompt with all market data
- - Structured decision JSON
- - Account snapshot (balance, positions, margin)
- - Execution results (success/failure, prices)
-- Update performance database:
- - Match open/close pairs by `symbol_side` key
- - 📌 **NEW**: Prevents long/short conflicts
- - Calculate accurate USDT PnL:
- - `PnL = Position Value × Price Δ% × Leverage`
- - 📌 **NEW**: Considers quantity + leverage
- - Store: quantity, leverage, open time, close time
- - Update win rate, profit factor, Sharpe ratio
-- Performance data feeds back into next cycle
-
-**↓**
-
-**🔄 (Repeat every 3-5 min)**
-
-### Key Improvements in v2.0.2
-
-**📌 Position Duration Tracking:**
-- System now tracks how long each position has been held
-- Displayed in user prompt: "持仓时长2小时15分钟"
-- Helps AI make better decisions on when to exit
-
-**📌 Accurate PnL Calculation:**
-- Previously: Only percentage (100U@5% = 1000U@5% = both showed "5.0")
-- Now: Real USDT profit = Position Value × Price Change × Leverage
-- Example: 1000 USDT × 5% × 20x = 1000 USDT actual profit
-
-**📌 Enhanced AI Freedom:**
-- AI can freely analyze all raw sequence data
-- No longer restricted to predefined indicator combinations
-- Can perform own trend analysis, support/resistance calculation
-
-**📌 Improved Position Tracking:**
-- Uses `symbol_side` key (e.g., "BTCUSDT_long")
-- Prevents conflicts when holding both long & short
-- Stores complete data: quantity, leverage, open/close times
-
----
-
-## 🧠 AI Self-Learning Example
-
-### Historical Feedback (Auto-added to Prompt)
-
-```markdown
-## 📊 Historical Performance Feedback
-
-### 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% ✗
-
-### Coin Performance
-- **Best**: BTCUSDT (Win rate 75%, avg +2.5%)
-- **Worst**: SOLUSDT (Win rate 25%, avg -1.8%)
-```
-
-### How AI Uses Feedback
-
-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 Interface Features
-
-### 1. Competition Page
-
-- **🏆 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 Page
-
-- **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. Real-time Updates
-
-- System status, account info, position list: **5-second refresh**
-- Decision logs, statistics: **10-second refresh**
-- Equity charts: **10-second refresh**
-
----
-
-## 🎛️ API Endpoints
-
-### Configuration Management
-
-```bash
-GET /api/models # Get AI model configurations
-PUT /api/models # Update AI model configurations
-GET /api/exchanges # Get exchange configurations
-PUT /api/exchanges # Update exchange configurations
-```
+## API Endpoints
### Trader Management
-
-```bash
+```
GET /api/traders # List all traders
POST /api/traders # Create new trader
DELETE /api/traders/:id # Delete trader
@@ -972,68 +208,41 @@ POST /api/traders/:id/start # Start trader
POST /api/traders/:id/stop # Stop trader
```
-### Trading Data & Monitoring
-
-```bash
-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
-GET /api/performance?trader_id=xxx # AI performance analysis
+### Strategy Management
+```
+GET /api/strategies # List all strategies
+POST /api/strategies # Create new strategy
+PUT /api/strategies/:id # Update strategy
+DELETE /api/strategies/:id # Delete strategy
```
-### System Endpoints
-
-```bash
-GET /api/health # Health check
+### Trading Data
+```
+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/decisions/latest?trader_id=xxx # Latest decisions
```
---
-## ⚠️ Important Risk Warnings
+## Risk Warnings
-### Trading Risks
-
-1. **Cryptocurrency markets are extremely volatile**, AI decisions don't guarantee profit
-2. **Futures trading uses leverage**, losses may exceed principal
+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
-
-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
+**Recommendations:**
+- Use only funds you can afford to lose
+- Start with small amounts (100-500 USDT)
+- Regularly monitor system operation
+- Don't run unsupervised for long periods
---
-## 🛠️ Common Issues
+## Common Issues
-> 📖 **For detailed troubleshooting:** See the comprehensive [Troubleshooting Guide](docs/guides/TROUBLESHOOTING.md) ([中文版](docs/guides/TROUBLESHOOTING.zh-CN.md))
-
-### 1. Compilation error: TA-Lib not found
-
-**Solution**: Install TA-Lib library
+### TA-Lib not found
```bash
# macOS
brew install ta-lib
@@ -1042,151 +251,56 @@ brew install ta-lib
sudo apt-get install libta-lib0-dev
```
-### 2. Precision error: Precision is over the maximum
-
-**Solution**: System auto-handles precision from Binance LOT_SIZE. If error persists, check network connection.
-
-### 3. AI API timeout
-
-**Solution**:
+### AI API timeout
- Check if API key is correct
-- Check network connection (may need proxy)
-- System timeout is set to 120 seconds
+- Check network connection
+- System timeout is 120 seconds
-### 4. Frontend can't connect to backend
-
-**Solution**:
-- Ensure backend is running (http://localhost:8080)
-- Check if port 8080 is occupied
-- Check browser console for errors
-
-### 5. Coin pool API failure
-
-**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~~ *Check configuration in web interface*
+### Frontend can't connect to backend
+- Ensure backend is running on http://localhost:8080
+- Check if port is occupied
---
-## 📈 Performance Optimization Tips
+## License
-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
+This project is licensed under **GNU Affero General Public License v3.0 (AGPL-3.0)** - See [LICENSE](LICENSE) file.
---
-## 🔄 Changelog
+## Contributing
-📖 **For detailed version history and updates, see:**
-
-- **English:** [CHANGELOG.md](CHANGELOG.md)
-- **中文:** [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md)
-
-**Latest Release:** v3.0.0 (2025-10-30) - Major Architecture Transformation
-
-**Recent Highlights:**
-- 🚀 Complete system redesign with web-based configuration
-- 🗄️ Database-driven architecture (SQLite)
-- 🎨 No more JSON editing - all configuration through web interface
-- 🔧 Mix & match AI models with any exchange
-- 📊 Enhanced API layer with comprehensive endpoints
+We welcome contributions! See:
+- **[Contributing Guide](CONTRIBUTING.md)** - Development workflow and PR process
+- **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community guidelines
+- **[Security Policy](SECURITY.md)** - Report vulnerabilities
---
-## 📄 License
-
-This project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)** - See [LICENSE](LICENSE) file for details.
-
-**What this means:**
-- ✅ You can use, modify, and distribute this software
-- ✅ You must disclose source code of your modifications
-- ✅ If you run a modified version on a server, you must make the source code available to users
-- ✅ All derivatives must also be licensed under AGPL-3.0
-
-For commercial licensing or questions, please contact the maintainers.
-
----
-
-## 🤝 Contributing
-
-We welcome contributions from the community! See our comprehensive guides:
-
-- **📖 [Contributing Guide](CONTRIBUTING.md)** - Complete development workflow, code standards, and PR process
-- **🤝 [Code of Conduct](CODE_OF_CONDUCT.md)** - Community guidelines and standards
-- **💰 [Bounty Program](docs/community/bounty-guide.md)** - Earn rewards for contributions
-- **🔒 [Security Policy](SECURITY.md)** - Report vulnerabilities responsibly
-
-**Quick Start:**
-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
-
----
-
-## 🎁 Contributor Airdrop Program
+## Contributor Airdrop Program
All contributions are tracked on GitHub. When NOFX generates revenue, contributors will receive airdrops based on their contributions.
-### 🔥 Priority Rewards: Pinned Issues
-
**PRs that resolve [Pinned Issues](https://github.com/NoFxAiOS/nofx/issues) receive the HIGHEST rewards!**
-Check our pinned issues for high-priority features and bugs - these carry bonus multipliers.
-
-### Contribution Weights
-
-| Contribution Type | Weight | Description |
-|------------------|:------:|-------------|
-| **🔥 Pinned Issue PRs** | ⭐⭐⭐⭐⭐⭐ | PRs solving pinned/priority issues (HIGHEST REWARD) |
-| **Code Commits** (Merged PRs) | ⭐⭐⭐⭐⭐ | Core features, optimizations, new integrations |
-| **Bug Fixes** | ⭐⭐⭐⭐ | Fix confirmed bugs and issues |
-| **Feature Suggestions** (Adopted Issues) | ⭐⭐⭐ | Ideas that get implemented |
-| **Bug Reports** (Confirmed) | ⭐⭐ | Report valid bugs with reproducible steps |
-| **Documentation** | ⭐⭐ | Translations, guides, tutorials |
-
-### How It Works
-
-1. **Check Pinned Issues** - High-priority tasks with bonus rewards
-2. **Contribute** - Submit PRs, report bugs, suggest features
-3. **Track** - All contributions recorded via GitHub activity
-4. **Earn** - Receive airdrops proportional to your contribution weight
-
-> 💡 Start with [Pinned Issues](https://github.com/NoFxAiOS/nofx/issues) for maximum rewards!
+| Contribution Type | Weight |
+|------------------|:------:|
+| **Pinned Issue PRs** | ⭐⭐⭐⭐⭐⭐ |
+| **Code Commits** (Merged PRs) | ⭐⭐⭐⭐⭐ |
+| **Bug Fixes** | ⭐⭐⭐⭐ |
+| **Feature Suggestions** | ⭐⭐⭐ |
+| **Bug Reports** | ⭐⭐ |
+| **Documentation** | ⭐⭐ |
---
-## 📬 Contact
+## Contact
-
-### 🐛 Technical Support
-- **GitHub Issues**: [Submit an Issue](https://github.com/tinkle-community/nofx/issues)
+- **GitHub Issues**: [Submit an Issue](https://github.com/NoFxAiOS/nofx/issues)
- **Developer Community**: [Telegram Group](https://t.me/nofx_dev_community)
---
-## 🙏 Acknowledgments
-
-- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance Futures API
-- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API
-- [Qwen](https://dashscope.console.aliyun.com/) - Alibaba Cloud Qwen
-- [TA-Lib](https://ta-lib.org/) - Technical indicator library
-- [Recharts](https://recharts.org/) - React chart library
-
----
-
-**Last Updated**: 2025-10-30 (v3.0.0)
-
-**⚡ Explore the possibilities of quantitative trading with the power of AI!**
-
----
-
-## ⭐ Star History
-
-[](https://star-history.com/#tinkle-community/nofx&Date)
+## Star History
+[](https://star-history.com/#NoFxAiOS/nofx&Date)
diff --git a/docs/i18n/ja/README.md b/docs/i18n/ja/README.md
index 0bb0790f..36b39034 100644
--- a/docs/i18n/ja/README.md
+++ b/docs/i18n/ja/README.md
@@ -1,1244 +1,98 @@
-# 🤖 NOFX - Agentic Trading OS
+# NOFX - AI トレーディングシステム
[](https://golang.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
-[](LICENSE)
-[](https://amber.ac)
+[](LICENSE)
-| 🎁 **コントリビューターエアドロッププログラム** |
-|:----------------------------------:|
-| コード · バグ修正 · Issue → エアドロップ |
-| [詳細を見る](#-コントリビューターエアドロッププログラム) |
-
-**言語:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](README.md) | [한국어](../ko/README.md) | [Tiếng Việt](../vi/README.md)
-
-**📚 ドキュメント:** [⚠️ 免責事項](../../../DISCLAIMER.md)
+**言語:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [日本語](README.md)
---
-## 📑 目次
+## AI 駆動の暗号通貨取引プラットフォーム
-- [🚀 ユニバーサルAIトレーディングOS](#-ユニバーサルaiトレーディングos)
-- [👥 開発者コミュニティ](#-開発者コミュニティ)
-- [📸 スクリーンショット](#-スクリーンショット)
-- [🏦 対応取引所（DEX/CEXチュートリアル）](#-対応取引所dexcexチュートリアル)
-- [🤖 対応AIモデル](#-対応aiモデル)
-- [✨ 現在の実装 - 暗号通貨市場](#-現在の実装---暗号通貨市場)
-- [🔮 ロードマップ](#-ロードマップ---ユニバーサルマーケット拡大)
-- [🏗️ 技術アーキテクチャ](#️-技術アーキテクチャ)
-- [🚀 クイックスタート](#-クイックスタート)
-- [📖 AI判断フロー](#-ai判断フロー)
-- [🧠 AI自己学習の例](#-ai自己学習の例)
-- [📊 Webインターフェース機能](#-webインターフェース機能)
-- [🎛️ APIエンドポイント](#️-apiエンドポイント)
-- [⚠️ 重要なリスク警告](#️-重要なリスク警告)
-- [🛠️ よくある問題](#️-よくある問題)
-- [📈 パフォーマンス最適化のヒント](#-パフォーマンス最適化のヒント)
-- [🔄 変更履歴](#-変更履歴)
-- [📄 ライセンス](#-ライセンス)
-- [🤝 貢献](#-貢献)
-- [🎁 コントリビューターエアドロッププログラム](#-コントリビューターエアドロッププログラム)
-- [📬 お問い合わせ](#-お問い合わせ)
-- [🙏 謝辞](#-謝辞)
+**NOFX** は、複数の AI モデルを使用して暗号通貨先物を自動取引できるオープンソースの AI 取引システムです。Web インターフェースで戦略を設定し、リアルタイムでパフォーマンスを監視し、AI エージェントを競わせて最適な取引アプローチを見つけます。
+
+### コア機能
+
+- **マルチ AI サポート**: DeepSeek、Qwen、GPT、Claude、Gemini、Grok、Kimi を実行 - いつでもモデルを切り替え可能
+- **マルチ取引所**: Binance、Bybit、OKX、Hyperliquid、Aster DEX、Lighter で統一取引
+- **ストラテジースタジオ**: コインソース、インジケーター、リスク管理を設定するビジュアル戦略ビルダー
+- **AI 競争モード**: 複数の AI トレーダーがリアルタイムで競争、パフォーマンスを並べて追跡
+- **Web ベース設定**: JSON 編集不要 - Web インターフェースですべて設定
+- **リアルタイムダッシュボード**: ライブポジション、損益追跡、思考連鎖付き AI 決定ログ
+
+### [Amber.ac](https://amber.ac) 支援
+
+> **リスク警告**: このシステムは実験的です。AI 自動取引には重大なリスクがあります。学習/研究目的または少額でのテストのみを強くお勧めします！
+
+## 開発者コミュニティ
+
+Telegram 開発者コミュニティに参加: **[NOFX 開発者コミュニティ](https://t.me/nofx_dev_community)**
---
-## 🚀 ユニバーサルAIトレーディングOS
+## クイックスタート
-**NOFX**は、統合アーキテクチャに基づいて構築された**ユニバーサルAgenticトレーディングOS**です。暗号通貨市場において **「マルチエージェント判断 → 統一リスク管理 → 低レイテンシ実行 → ライブ/ペーパーアカウントバックテスト」** のループを成功裏に完成させ、現在この技術スタックを **株式、先物、オプション、外国為替、およびすべての金融市場** に拡大しています。
-
-### 🎯 コア機能
-
-- **ユニバーサルデータ＆バックテストレイヤー**: クロスマーケット、クロスタイムフレーム、クロス取引所の統一表現とファクターライブラリにより、転移可能な「戦略メモリ」を蓄積
-- **マルチエージェント自己対戦＆自己進化**: 戦略が自動的に競争し、最適なものを選択、アカウントレベルのPnLとリスク制約に基づいて継続的に反復
-- **統合実行＆リスク管理**: 低レイテンシルーティング、スリッページ/リスク管理サンドボックス、アカウントレベルの制限、ワンクリック市場切り替え
-
-### 🏢 [Amber.ac](https://amber.ac)の支援
-
-### 👥 コアチーム
-
-- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **唯一公式推特** - [@nofx_official](https://x.com/nofx_official)
-
-### 💼 シードラウンド募集中
-
-現在、**シードラウンド**の資金調達を行っています。
-
-**投資に関するお問い合わせ**は、TwitterでTinkleにDMをお送りください。
-
----
-
-> ⚠️ **リスク警告**: このシステムは実験的なものです。AI自動取引には大きなリスクが伴います。学習/研究目的、または少額でのテストのみを強く推奨します！
-
-## 👥 開発者コミュニティ
-
-Telegram開発者コミュニティに参加して、議論、アイデアの共有、サポートを受けましょう：
-
-**💬 [NOFX開発者コミュニティ](https://t.me/nofx_dev_community)**
-
----
-
-## 📸 スクリーンショット
-
-### 🏆 競争モード - リアルタイムAIバトル
-
-*QwenとDeepSeekのライブトレーディングバトルを示すリアルタイムパフォーマンス比較チャート付きマルチAIリーダーボード*
-
-### 📊 トレーダー詳細 - 完全なトレーディングダッシュボード
-
-*エクイティカーブ、ライブポジション、展開可能な入力プロンプトと思考連鎖推論を持つAI判断ログを備えたプロフェッショナルな取引インターフェース*
-
----
-
-## 🏦 対応取引所（DEX/CEXチュートリアル）
-
-### CEX（中央集権型取引所）
-
-| 取引所 | ステータス | 登録（手数料割引） | API設定 |
-|--------|------------|-------------------|---------|
-| **Binance** | ✅ 対応済み | [登録](https://www.binance.com/join?ref=NOFXJAPAN) | [APIガイド](../../getting-started/binance-api.md) |
-| **Bybit** | ✅ 対応済み | [登録](https://partner.bybit.com/b/83856) | [APIガイド](../../getting-started/bybit-api.md) |
-| **OKX** | ✅ 対応済み | [登録](https://www.okx.com/join/1865360) | [APIガイド](../../getting-started/okx-api.md) |
-
-### Perp-DEX（分散型無期限取引所）
-
-| 取引所 | ステータス | 登録（手数料割引） | エージェントウォレット設定 |
-|--------|------------|-------------------|---------------------------|
-| **Hyperliquid** | ✅ 対応済み | [登録](https://app.hyperliquid.xyz/join/AITRADING) | [エージェントウォレットガイド](../../getting-started/hyperliquid-agent-wallet.md) |
-| **Aster DEX** | ✅ 対応済み | [登録](https://www.asterdex.com/en/referral/fdfc0e) | [APIウォレットガイド](../../getting-started/aster-api-wallet.md) |
-| **Lighter** | ✅ 対応済み | [登録](https://lighter.xyz) | [エージェントウォレットガイド](../../getting-started/lighter-agent-wallet.md) |
-
----
-
-## 🤖 対応AIモデル
-
-| AIモデル | ステータス | APIキー取得 |
-|----------|------------|-------------|
-| **DeepSeek** | ✅ 対応済み | [APIキー取得](https://platform.deepseek.com) |
-| **Qwen** | ✅ 対応済み | [APIキー取得](https://dashscope.console.aliyun.com) |
-| **OpenAI (GPT)** | ✅ 対応済み | [APIキー取得](https://platform.openai.com) |
-| **Claude** | ✅ 対応済み | [APIキー取得](https://console.anthropic.com) |
-| **Gemini** | ✅ 対応済み | [APIキー取得](https://aistudio.google.com) |
-| **Grok** | ✅ 対応済み | [APIキー取得](https://console.x.ai) |
-| **Kimi** | ✅ 対応済み | [APIキー取得](https://platform.moonshot.cn) |
-
----
-
-## ✨ 現在の実装 - 暗号通貨市場
-
-NOFXは現在、以下の実証済み機能で**暗号通貨市場において完全に稼働**しています：
-
-### 🏆 マルチエージェント競争フレームワーク
-- **ライブエージェントバトル**: QwenとDeepSeekモデルがリアルタイム取引で競争
-- **独立したアカウント管理**: 各エージェントは独自の判断ログとパフォーマンスメトリクスを維持
-- **リアルタイムパフォーマンス比較**: ライブROI追跡、勝率統計、一対一分析
-- **自己進化ループ**: エージェントは過去のパフォーマンスから学習し、継続的に改善
-
-### 🧠 AI自己学習＆最適化
-- **過去フィードバックシステム**: 各判断前に過去20取引サイクルを分析
-- **スマートパフォーマンス分析**:
- - 最高/最悪パフォーマンス資産の特定
- - 実際のUSDT建てで勝率、損益比、平均利益を計算
- - 繰り返しミスを回避（連続損失パターン）
- - 成功戦略を強化（高勝率パターン）
-- **動的戦略調整**: AIはバックテスト結果に基づいて取引スタイルを自律的に適応
-
-### 📊 ユニバーサルマーケットデータレイヤー（暗号実装）
-- **マルチタイムフレーム分析**: 3分リアルタイム + 4時間トレンドデータ
-- **テクニカル指標**: EMA20/50、MACD、RSI(7/14)、ATR
-- **建玉追跡**: マーケットセンチメント、資金フロー分析
-- **流動性フィルタリング**: 低流動性資産（<1500万USD）の自動フィルタリング
-- **クロス取引所サポート**: 統一データインターフェースでBinance、Hyperliquid、Aster DEX
-
-### 🎯 統一リスク管理システム
-- **ポジション制限**: 資産ごとの制限（アルトコイン≤1.5x エクイティ、BTC/ETH≤10x エクイティ）
-- **設定可能なレバレッジ**: 資産クラスとアカウントタイプに基づいて1xから50xまでの動的レバレッジ
-- **証拠金管理**: 総使用量≤90%、AI制御配分
-- **リスクリワード強制**: 必須≥1:2 ストップロス対テイクプロフィット比率
-- **重複防止**: 同じ資産/方向での重複ポジションを防止
-
-### ⚡ 低レイテンシ実行エンジン
-- **マルチ取引所API統合**: Binance Futures、Hyperliquid DEX、Aster DEX
-- **自動精度処理**: 取引所ごとのスマートな注文サイズと価格フォーマット
-- **優先実行**: 既存ポジションを先にクローズし、その後新規を開く
-- **スリッページ管理**: 実行前検証、リアルタイム精度チェック
-
-### 🎨 プロフェッショナルモニタリングインターフェース
-- **Binanceスタイルダッシュボード**: リアルタイム更新付きプロフェッショナルダークテーマ
-- **エクイティカーブ**: 過去のアカウント価値追跡（USD/パーセンテージ切り替え）
-- **パフォーマンスチャート**: ライブ更新付きマルチエージェントROI比較
-- **完全な判断ログ**: すべての取引の完全な思考連鎖（CoT）推論
-- **5秒データ更新**: リアルタイムアカウント、ポジション、損益更新
-
----
-
-## 🔮 ロードマップ - ユニバーサルマーケット拡大
-
-実証済みの暗号インフラストラクチャを以下に拡張中：
-
-- **📈 株式市場**: 米国株式、A株、香港株
-- **📊 先物市場**: 商品先物、指数先物
-- **🎯 オプション取引**: 株式オプション、暗号オプション
-- **💱 外国為替市場**: 主要通貨ペア、クロスレート
-
-**同じアーキテクチャ。同じエージェントフレームワーク。すべての市場。**
-
----
-
-## 🏗️ 技術アーキテクチャ
-
-```
-nofx/
-├── main.go # プログラムエントリ（マルチトレーダーマネージャー）
-├── config.json # 設定ファイル（APIキー、マルチトレーダー設定）
-│
-├── api/ # HTTP APIサービス
-│ └── server.go # Ginフレームワーク、RESTful API
-│
-├── trader/ # トレーディングコア
-│ ├── auto_trader.go # 自動取引メインコントローラー（単一トレーダー）
-│ └── binance_futures.go # Binance先物APIラッパー
-│
-├── manager/ # マルチトレーダー管理
-│ └── trader_manager.go # 複数のトレーダーインスタンスを管理
-│
-├── mcp/ # Model Context Protocol - AI通信
-│ └── client.go # AIクライアント（DeepSeek/Qwen統合）
-│
-├── decision/ # AI判断エンジン
-│ └── engine.go # 過去フィードバック付き判断ロジック
-│
-├── market/ # マーケットデータ取得
-│ └── data.go # マーケットデータ＆テクニカル指標（K線、RSI、MACD）
-│
-├── pool/ # コインプール管理
-│ └── coin_pool.go # AI500 + OI Topマージプール
-│
-├── logger/ # ロギングシステム
-│ └── decision_logger.go # 判断記録 + パフォーマンス分析
-│
-├── decision_logs/ # 判断ログストレージ
-│ ├── qwen_trader/ # Qwenトレーダーログ
-│ └── deepseek_trader/ # DeepSeekトレーダーログ
-│
-└── web/ # Reactフロントエンド
- ├── src/
- │ ├── components/ # Reactコンポーネント
- │ │ ├── EquityChart.tsx # エクイティカーブチャート
- │ │ ├── ComparisonChart.tsx # マルチAI比較チャート
- │ │ └── CompetitionPage.tsx # 競争リーダーボード
- │ ├── lib/api.ts # API呼び出しラッパー
- │ ├── types/index.ts # TypeScript型
- │ ├── index.css # BinanceスタイルCSS
- │ └── App.tsx # メインアプリ
- └── package.json
-```
-
-### コア依存関係
-
-**バックエンド（Go）**
-- `github.com/adshao/go-binance/v2` - Binance 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フレームワーク
-
----
-
-## 🚀 クイックスタート
-
-### 🐳 オプションA：Dockerワンクリックデプロイ（最も簡単 - 初心者推奨！）
-
-**⚡ Dockerで3つの簡単なステップで取引開始 - インストール不要！**
-
-Dockerはすべての依存関係（Go、Node.js、TA-Lib）と環境設定を自動的に処理します。初心者に最適！
-
-#### ステップ1：設定を準備
+### オプション 1: Docker デプロイ（推奨）
```bash
-# 設定テンプレートをコピー
-cp config.json.example config.json
-
-# 編集してAPIキーを入力
-nano config.json # または任意のエディタを使用
-```
-
-#### ステップ2：ワンクリック起動
-
-```bash
-# オプション1：便利スクリプトを使用（推奨）
-chmod +x start.sh
-./start.sh start --build
-
-> #### Docker Composeバージョンに関する注意
->
-> **このプロジェクトはDocker Compose V2構文（スペース付き）を使用**
->
-> 古いスタンドアロン`docker-compose`がインストールされている場合は、Docker DesktopまたはDocker 20.10+にアップグレードしてください
-
-# オプション2：docker composeを直接使用
-docker compose up -d --build
-```
-
-#### ステップ3：ダッシュボードにアクセス
-
-ブラウザを開いて次にアクセス：**http://localhost:3000**
-
-**これで完了！🎉** AIトレーディングシステムが稼働中です！
-
-#### システム管理
-
-```bash
-./start.sh logs # ログを表示
-./start.sh status # ステータスを確認
-./start.sh stop # サービスを停止
-./start.sh restart # サービスを再起動
-```
-
-**📖 詳細なDockerデプロイガイド、トラブルシューティング、高度な設定について：**
-- **English**: See [docker-deploy.md](../../getting-started/docker-deploy.en.md)
-- **中文**: 查看 [docker-deploy.zh-CN.md](../../getting-started/docker-deploy.zh-CN.md)
-- **日本語**: [docker-deploy.md](docker-deploy.md)を参照
-
----
-
-### 📦 オプションB：手動インストール（開発者向け）
-
-**注意**: 上記のDockerデプロイを使用した場合は、このセクションをスキップしてください。手動インストールは、コードを変更したい場合、またはDockerなしで実行したい場合にのみ必要です。
-
-### 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
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
+chmod +x ./start.sh
+./start.sh start --build
```
-### 3. 依存関係をインストール
+Web インターフェースにアクセス: **http://localhost:3000**
-**バックエンド:**
-```bash
-go mod download
-```
-
-**フロントエンド:**
-```bash
-cd web
-npm install
-cd ..
-```
-
-### 4. AI APIキーを取得
-
-システムを設定する前に、AI APIキーを取得する必要があります。以下のAIプロバイダーのいずれかを選択してください：
-
-#### オプション1：DeepSeek（初心者推奨）
-
-**なぜDeepSeek？**
-- 💰 GPT-4より安価（約1/10のコスト）
-- 🚀 高速レスポンス時間
-- 🎯 優れた取引判断品質
-- 🌍 VPNなしで世界中で動作
-
-**DeepSeek APIキーの取得方法：**
-
-1. **アクセス**: [https://platform.deepseek.com](https://platform.deepseek.com)
-2. **登録**: メール/電話番号でサインアップ
-3. **認証**: メール/電話認証を完了
-4. **チャージ**: アカウントにクレジットを追加
- - 最低: 約$5 USD
- - 推奨: テスト用に$20-50 USD
-5. **APIキーを作成**：
- - APIキーセクションに移動
- - 「新しいキーを作成」をクリック
- - キーをコピーして保存（`sk-`で始まる）
- - ⚠️ **重要**: すぐに保存してください - 再度見ることはできません！
-
-**価格**: 約100万トークンあたり$0.14（非常に安い！）
-
-#### オプション2：Qwen（Alibaba Cloud）
-
-**Qwen APIキーの取得方法：**
-
-1. **アクセス**: [https://dashscope.aliyuncs.com](https://dashscope.aliyuncs.com)
-2. **登録**: Alibaba Cloudアカウントでサインアップ
-3. **サービスを有効化**: DashScopeサービスを有効化
-4. **APIキーを作成**：
- - APIキー管理に移動
- - 新しいキーを作成
- - コピーして保存（`sk-`で始まる）
-
-**注意**: 登録には中国の電話番号が必要な場合があります
-
----
-
-### 5. システム設定
-
-**2つの設定モードが利用可能：**
-- **🌟 初心者モード**: シングルトレーダー + デフォルトコイン（推奨！）
-- **⚔️ エキスパートモード**: 複数トレーダー競争
-
-#### 🌟 初心者モード設定（推奨）
-
-**ステップ1**: 設定例ファイルをコピーしてリネーム
+### オプション 2: 手動インストール
```bash
-cp config.json.example config.json
-```
+# 前提条件: Go 1.21+, Node.js 18+, TA-Lib
-**ステップ2**: APIキーで`config.json`を編集
-
-```json
-{
- "traders": [
- {
- "id": "my_trader",
- "name": "My AI Trader",
- "ai_model": "deepseek",
- "binance_api_key": "YOUR_BINANCE_API_KEY",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY",
- "use_qwen": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "qwen_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- },
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**ステップ3**: プレースホルダーを実際のキーに置き換え
-
-| プレースホルダー | 置き換え先 | 取得場所 |
-|------------|--------------|--------------|
-| `YOUR_BINANCE_API_KEY` | BinanceのAPIキー | Binance → アカウント → API管理 |
-| `YOUR_BINANCE_SECRET_KEY` | Binanceのシークレットキー | 上記と同じ |
-| `sk-xxxxxxxxxxxxx` | DeepSeek APIキー | [platform.deepseek.com](https://platform.deepseek.com) |
-
-**ステップ4**: 初期残高を調整（オプション）
-
-- `initial_balance`: 実際のBinance先物アカウント残高に設定
-- 損益パーセンテージの計算に使用
-- 例：500 USDTがある場合、`"initial_balance": 500.0`に設定
-
-**✅ 設定チェックリスト：**
-
-- [ ] Binance APIキーを入力（引用符の問題なし）
-- [ ] Binanceシークレットキーを入力（引用符の問題なし）
-- [ ] DeepSeek APIキーを入力（`sk-`で始まる）
-- [ ] `use_default_coins`を`true`に設定（初心者向け）
-- [ ] `initial_balance`をアカウント残高と一致させる
-- [ ] ファイルを`config.json`として保存（`.example`ではない）
-
----
-
-#### ⚔️ エキスパートモード：マルチトレーダー競争
-
-複数のAIトレーダーが互いに競争する場合：
-
-```json
-{
- "traders": [
- {
- "id": "qwen_trader",
- "name": "Qwen AI Trader",
- "ai_model": "qwen",
- "binance_api_key": "YOUR_BINANCE_API_KEY_1",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
- "use_qwen": true,
- "qwen_key": "sk-xxxxx",
- "deepseek_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- },
- {
- "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,
- "qwen_key": "",
- "deepseek_key": "sk-xxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**競争モードの要件:**
-- 2つの別々のBinance先物アカウント（異なるAPIキー）
-- 両方のAI APIキー（Qwen + DeepSeek）
-- テスト用により多くの資本（推奨：アカウントあたり500+ USDT）
-
----
-
-#### 📚 設定フィールド説明
-
-| フィールド | 説明 | 例の値 | 必須？ |
-|-------|-------------|---------------|-----------|
-| `id` | このトレーダーの一意の識別子 | `"my_trader"` | ✅ はい |
-| `name` | 表示名 | `"My AI Trader"` | ✅ はい |
-| `enabled` | このトレーダーが有効かどうか
起動をスキップする場合は`false`に設定 | `true`または`false` | ✅ はい |
-| `ai_model` | 使用するAIプロバイダー | `"deepseek"`または`"qwen"`または`"custom"` | ✅ はい |
-| `exchange` | 使用する取引所 | `"binance"`または`"hyperliquid"`または`"aster"` | ✅ はい |
-| `binance_api_key` | Binance APIキー | `"abc123..."` | Binance使用時に必須 |
-| `binance_secret_key` | Binanceシークレットキー | `"xyz789..."` | Binance使用時に必須 |
-| `hyperliquid_private_key` | Hyperliquid秘密鍵
⚠️ `0x`プレフィックスを削除 | `"your_key..."` | Hyperliquid使用時に必須 |
-| `hyperliquid_wallet_addr` | Hyperliquidウォレットアドレス | `"0xabc..."` | Hyperliquid使用時に必須 |
-| `hyperliquid_testnet` | テストネットを使用 | `true`または`false` | ❌ いいえ（デフォルトはfalse） |
-| `use_qwen` | Qwenを使用するかどうか | `true`または`false` | ✅ はい |
-| `deepseek_key` | DeepSeek APIキー | `"sk-xxx"` | DeepSeek使用時 |
-| `qwen_key` | Qwen APIキー | `"sk-xxx"` | Qwen使用時 |
-| `initial_balance` | 損益計算の開始残高 | `1000.0` | ✅ はい |
-| `scan_interval_minutes` | 判断を行う頻度 | `3`（3-5推奨） | ✅ はい |
-| **`leverage`** | **レバレッジ設定（v2.0.3+）** | 下記参照 | ✅ はい |
-| `btc_eth_leverage` | BTC/ETHの最大レバレッジ
⚠️ サブアカウント：≤5x | `5`（デフォルト、安全）
`50`（メインアカウント最大） | ✅ はい |
-| `altcoin_leverage` | アルトコインの最大レバレッジ
⚠️ サブアカウント：≤5x | `5`（デフォルト、安全）
`20`（メインアカウント最大） | ✅ はい |
-| `use_default_coins` | 組み込みコインリストを使用
**✨ スマートデフォルト：`true`**（v2.0.2+）
API URLが提供されていない場合自動有効化 | `true`または省略 | ❌ いいえ
（オプション、自動デフォルト） |
-| `coin_pool_api_url` | カスタムコインプールAPI
*`use_default_coins: false`の場合のみ必要* | `""`（空） | ❌ いいえ |
-| `oi_top_api_url` | 建玉API
*オプション補足データ* | `""`（空） | ❌ いいえ |
-| `api_server_port` | Webダッシュボードポート | `8080` | ✅ はい |
-
-**デフォルト取引コイン**（`use_default_coins: true`の場合）：
-- BTC、ETH、SOL、BNB、XRP、DOGE、ADA、HYPE
-
----
-
-#### ⚙️ レバレッジ設定（v2.0.3+）
-
-**レバレッジ設定とは？**
-
-レバレッジ設定は、AIが各取引で使用できる最大レバレッジを制御します。これは、特にレバレッジ制限があるBinanceサブアカウントでリスク管理に重要です。
-
-**設定形式：**
-
-```json
-"leverage": {
- "btc_eth_leverage": 5, // BTCとETHの最大レバレッジ
- "altcoin_leverage": 5 // その他すべてのコインの最大レバレッジ
-}
-```
-
-**⚠️ 重要：Binanceサブアカウント制限**
-
-- **サブアカウント**: Binanceにより**≤5xレバレッジ**に制限
-- **メインアカウント**: 最大20x（アルトコイン）または50x（BTC/ETH）を使用可能
-- サブアカウントを使用していてレバレッジを>5xに設定すると、取引は**失敗**し、エラーが表示されます：`Subaccounts are restricted from using leverage greater than 5x`
-
-**推奨設定：**
-
-| アカウントタイプ | BTC/ETHレバレッジ | アルトコインレバレッジ | リスクレベル |
-|-------------|------------------|------------------|------------|
-| **サブアカウント** | `5` | `5` | ✅ 安全（デフォルト） |
-| **メイン（保守的）** | `10` | `10` | 🟡 中程度 |
-| **メイン（積極的）** | `20` | `15` | 🔴 高 |
-| **メイン（最大）** | `50` | `20` | 🔴🔴 非常に高 |
-
-**例：**
-
-**安全な設定（サブアカウントまたは保守的）：**
-```json
-"leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
-}
-```
-
-**積極的な設定（メインアカウントのみ）：**
-```json
-"leverage": {
- "btc_eth_leverage": 20,
- "altcoin_leverage": 15
-}
-```
-
-**AIのレバレッジ使用方法：**
-
-- AIは設定された最大値まで**1xから任意のレバレッジを選択**できます
-- たとえば、`altcoin_leverage: 20`の場合、AIは市場条件に基づいて5x、10x、または20xを使用することを決定する可能性があります
-- 設定は固定値ではなく**上限**を設定します
-- AIはレバレッジを選択する際にボラティリティ、リスクリワード比率、アカウント残高を考慮します
-
----
-
-#### ⚠️ 重要：`use_default_coins`フィールド
-
-**スマートデフォルト動作（v2.0.2+）：**
-
-次の場合、システムは自動的に`use_default_coins: true`をデフォルトにします：
-- config.jsonにこのフィールドを含めていない、または
-- `false`に設定したが`coin_pool_api_url`を提供していない
-
-これにより初心者に優しくなります！このフィールドを完全に省略することもできます。
-
-**設定例：**
-
-✅ **オプション1：明示的に設定（明確性のため推奨）**
-```json
-"use_default_coins": true,
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-✅ **オプション2：フィールドを省略（デフォルトコインを自動使用）**
-```json
-// "use_default_coins"を含めないだけ
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-⚙️ **高度：外部APIを使用**
-```json
-"use_default_coins": false,
-"coin_pool_api_url": "http://your-api.com/coins",
-"oi_top_api_url": "http://your-api.com/oi"
-```
-
----
-
-### 6. システムを実行
-
-#### 🚀 システムの起動（2ステップ）
-
-システムには別々に実行される**2つの部分**があります：
-1. **バックエンド**（AIトレーディングブレイン + API）
-2. **フロントエンド**（監視用Webダッシュボード）
-
----
-
-#### **ステップ1：バックエンドを起動**
-
-ターミナルを開いて実行：
-
-```bash
-# プログラムをビルド（初回のみ、またはコード変更後）
-go build -o nofx
-
-# バックエンドを起動
-./nofx
-```
-
-**表示されるべきもの：**
-
-```
-🚀 启动自动交易系统...
-✓ Trader [my_trader] 已初始化
-✓ API服务器启动在端口 8080
-📊 开始交易监控...
-```
-
-**⚠️ エラーが表示される場合：**
-
-| エラーメッセージ | 解決策 |
-|--------------|----------|
-| `invalid API key` | config.jsonのBinance APIキーを確認 |
-| `TA-Lib not found` | `brew install ta-lib`を実行（macOS） |
-| `port 8080 already in use` | config.jsonの`api_server_port`を変更 |
-| `DeepSeek API error` | DeepSeek APIキーと残高を確認 |
-
-**✅ バックエンドが正しく実行されているとき：**
-- エラーメッセージなし
-- "开始交易监控..."が表示される
-- システムがアカウント残高を表示
-- このターミナルウィンドウを開いたままにしてください！
-
----
-
-#### **ステップ2：フロントエンドを起動**
-
-**新しいターミナルウィンドウ**を開き（最初のものは実行したまま）、次を実行：
-
-```bash
-cd web
-npm run dev
-```
-
-**表示されるべきもの：**
-
-```
-VITE v5.x.x ready in xxx ms
-
-➜ Local: http://localhost:3000/
-➜ Network: use --host to expose
-```
-
-**✅ フロントエンドが実行されているとき：**
-- "Local: http://localhost:3000/"メッセージ
-- エラーメッセージなし
-- このターミナルウィンドウも開いたままにしてください！
-
----
-
-#### **ステップ3：ダッシュボードにアクセス**
-
-Webブラウザを開いて次にアクセス：
-
-**🌐 http://localhost:3000**
-
-**表示されるもの：**
-- 📊 リアルタイムアカウント残高
-- 📈 オープンポジション（ある場合）
-- 🤖 AI判断ログ
-- 📉 エクイティカーブチャート
-
-**初回のヒント：**
-- 最初のAI判断まで3-5分かかることがあります
-- 初期判断は「観望」（待機）と言う場合があります - これは正常です
-- AIは最初に市場状況を分析する必要があります
-
----
-
-### 7. システムを監視
-
-**監視すべきもの：**
-
-✅ **健全なシステムの兆候：**
-- バックエンドターミナルが3-5分ごとに判断サイクルを表示
-- 継続的なエラーメッセージなし
-- アカウント残高の更新
-- Webダッシュボードの自動更新
-
-⚠️ **警告の兆候：**
-- 繰り返されるAPIエラー
-- 10分以上判断なし
-- 残高の急速な減少
-
-**システムステータスの確認：**
-
-```bash
-# 新しいターミナルウィンドウで
-curl http://localhost:8080/health
-```
-
-戻り値：`{"status":"ok"}`
-
----
-
-### 8. システムを停止
-
-**グレースフルシャットダウン（推奨）：**
-
-1. **バックエンドターミナル**（最初のもの）に移動
-2. `Ctrl+C`を押す
-3. "系统已停止"メッセージを待つ
-4. **フロントエンドターミナル**（2番目のもの）に移動
-5. `Ctrl+C`を押す
-
-**⚠️ 重要：**
-- 常にバックエンドを最初に停止
-- ターミナルを閉じる前に確認を待つ
-- 強制終了しない（ターミナルを直接閉じない）
-
----
-
-## 📖 AI判断フロー
-
-各判断サイクル（デフォルト3分）で、システムは以下のインテリジェントプロセスを実行します：
-
-```
-┌──────────────────────────────────────────────────────────┐
-│ 1. 📊 過去パフォーマンスを分析（過去20サイクル） │
-├──────────────────────────────────────────────────────────┤
-│ ✓ 総合勝率、平均利益、損益比を計算 │
-│ ✓ コインごとの統計（勝率、平均損益（USDT）） │
-│ ✓ 最高/最悪パフォーマンスコインを特定 │
-│ ✓ 正確なPnLを含む最後の5取引の詳細をリスト │
-│ ✓ リスク調整パフォーマンスのシャープレシオを計算 │
-│ 📌 NEW（v2.0.2）：レバレッジを含む正確なUSDT PnL │
-└──────────────────────────────────────────────────────────┘
- ↓
-┌──────────────────────────────────────────────────────────┐
-│ 2. 💰 アカウントステータスを取得 │
-├──────────────────────────────────────────────────────────┤
-│ • 総エクイティと利用可能残高 │
-│ • オープンポジション数と未実現損益 │
-│ • 証拠金使用率（AIは最大90%を管理） │
-│ • 日次損益追跡とドローダウン監視 │
-└──────────────────────────────────────────────────────────┘
- ↓
-┌──────────────────────────────────────────────────────────┐
-│ 3. 🔍 既存ポジションを分析（ある場合） │
-├──────────────────────────────────────────────────────────┤
-│ • 各ポジションについて、最新の市場データを取得 │
-│ • リアルタイムのテクニカル指標を計算： │
-│ - 3分K線：RSI(7)、MACD、EMA20 │
-│ - 4時間K線：RSI(14)、EMA20/50、ATR │
-│ • ポジション保有期間を追跡（例：「2時間15分」） │
-│ 📌 NEW（v2.0.2）：各ポジションの保有期間を表示 │
-│ • 表示：エントリー価格、現在価格、損益%、期間 │
-│ • AIが評価：保持するかクローズするか？ │
-└──────────────────────────────────────────────────────────┘
- ↓
-┌──────────────────────────────────────────────────────────┐
-│ 4. 🎯 新しい機会を評価（候補コイン） │
-├──────────────────────────────────────────────────────────┤
-│ • コインプールを取得（2モード）： │
-│ 🌟 デフォルトモード：BTC、ETH、SOL、BNB、XRPなど │
-│ ⚙️ 高度モード：AI500（上位20）+ OI Top（上位20） │
-│ • 候補コインをマージして重複削除 │
-│ • フィルター：低流動性を削除（<1500万USD OI値） │
-│ • 市場データ + テクニカル指標をバッチ取得 │
-│ • ボラティリティ、トレンド強度、出来高急増を計算 │
-└──────────────────────────────────────────────────────────┘
- ↓
-┌──────────────────────────────────────────────────────────┐
-│ 5. 🧠 AI総合判断（DeepSeek/Qwen） │
-├──────────────────────────────────────────────────────────┤
-│ • 過去フィードバックをレビュー： │
-│ - 最近の勝率と利益率 │
-│ - 最高/最悪コインパフォーマンス │
-│ - 繰り返しミスを回避 │
-│ • すべての生シーケンスデータを分析： │
-│ - 3分価格シーケンス、4時間K線シーケンス │
-│ - 完全な指標シーケンス（最新のみではない） │
-│ 📌 NEW（v2.0.2）：AIは分析の完全な自由を持つ │
-│ • 思考連鎖（CoT）推論プロセス │
-│ • 構造化された判断を出力： │
-│ - アクション：close_long/close_short/open_long/open_short│
-│ - コインシンボル、数量、レバレッジ │
-│ - ストップロスとテイクプロフィットレベル（≥1:2比率） │
-│ • 判断：待機/保持/クローズ/オープン │
-└──────────────────────────────────────────────────────────┘
- ↓
-┌──────────────────────────────────────────────────────────┐
-│ 6. ⚡ 取引を実行 │
-├──────────────────────────────────────────────────────────┤
-│ • 優先順位：既存をクローズ → その後新規をオープン │
-│ • 実行前のリスクチェック： │
-│ - ポジションサイズ制限（アルトコイン1.5x、BTC 10x） │
-│ - 重複ポジションなし（同じコイン + 方向） │
-│ - 証拠金使用量が90%制限内 │
-│ • Binance LOT_SIZE精度を自動取得して適用 │
-│ • Binance Futures APIで注文を実行 │
-│ • クローズ後：すべての保留注文を自動キャンセル │
-│ • 実際の実行価格と注文IDを記録 │
-│ 📌 期間計算のためにポジションオープン時間を追跡 │
-└──────────────────────────────────────────────────────────┘
- ↓
-┌──────────────────────────────────────────────────────────┐
-│ 7. 📝 完全なログを記録してパフォーマンスを更新 │
-├──────────────────────────────────────────────────────────┤
-│ • decision_logs/{trader_id}/に判断ログを保存 │
-│ • ログには以下が含まれます： │
-│ - 完全な思考連鎖（CoT） │
-│ - すべての市場データを含む入力プロンプト │
-│ - 構造化された判断JSON │
-│ - アカウントスナップショット（残高、ポジション、証拠金）│
-│ - 実行結果（成功/失敗、価格） │
-│ • パフォーマンスデータベースを更新： │
-│ - symbol_sideキーでオープン/クローズペアをマッチ │
-│ 📌 NEW：ロング/ショート競合を防止 │
-│ - 正確なUSDT PnLを計算： │
-│ PnL = ポジション価値 × 価格変化% × レバレッジ │
-│ 📌 NEW：数量 + レバレッジを考慮 │
-│ - 保存：数量、レバレッジ、オープン時間、クローズ時間 │
-│ - 更新：勝率、利益率、シャープレシオ │
-│ • パフォーマンスデータは次のサイクルにフィードバック │
-└──────────────────────────────────────────────────────────┘
- ↓
- （3-5分ごとに繰り返し）
-```
-
-### v2.0.2の主な改善点
-
-**📌 ポジション期間追跡：**
-- システムが各ポジションの保有期間を追跡
-- ユーザープロンプトに表示：「持仓时长2小时15分钟」
-- AIが出口タイミングについてより良い判断を下すのに役立つ
-
-**📌 正確なPnL計算：**
-- 以前：パーセンテージのみ（100U@5% = 1000U@5% = 両方とも「5.0」と表示）
-- 現在：実際のUSDT利益 = ポジション価値 × 価格変化 × レバレッジ
-- 例：1000 USDT × 5% × 20x = 1000 USDT実際の利益
-
-**📌 AI自由度の向上：**
-- AIはすべての生シーケンスデータを自由に分析可能
-- 事前定義された指標の組み合わせに制限されない
-- 独自のトレンド分析、サポート/レジスタンス計算を実行可能
-
-**📌 改善されたポジション追跡：**
-- `symbol_side`キーを使用（例：「BTCUSDT_long」）
-- ロングとショートの両方を保有する際の競合を防止
-- 完全なデータを保存：数量、レバレッジ、オープン/クローズ時間
-
----
-
-## 🧠 AI自己学習の例
-
-### 過去フィードバック（プロンプトに自動追加）
-
-```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. 競争ページ
-
-- **🏆 リーダーボード**: リアルタイムROIランキング、ゴールドボーダーでリーダーをハイライト
-- **📈 パフォーマンス比較**: デュアルAI ROIカーブ比較（紫対青）
-- **⚔️ 一対一**: リードマージンを示す直接比較
-- **リアルタイムデータ**: 総エクイティ、損益%、ポジション数、証拠金使用量
-
-### 2. 詳細ページ
-
-- **エクイティカーブ**: 過去トレンドチャート（USD/パーセンテージ切り替え）
-- **統計**: 総サイクル、成功/失敗、オープン/クローズ統計
-- **ポジションテーブル**: すべてのポジション詳細（エントリー価格、現在価格、損益%、清算価格）
-- **AI判断ログ**: 最近の判断記録（展開可能なCoT）
-
-### 3. リアルタイム更新
-
-- システムステータス、アカウント情報、ポジションリスト：**5秒更新**
-- 判断ログ、統計：**10秒更新**
-- エクイティチャート：**10秒更新**
-
----
-
-## 🎛️ APIエンドポイント
-
-### 競争関連
-
-```bash
-GET /api/competition # 競争リーダーボード（全トレーダー）
-GET /api/traders # トレーダーリスト
-```
-
-### 単一トレーダー関連
-
-```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 # システム設定
-```
-
----
-
-## ⚠️ 重要なリスク警告
-
-### 取引リスク
-
-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
+# TA-Lib インストール (macOS)
brew install ta-lib
-# Ubuntu
-sudo apt-get install libta-lib0-dev
+# クローンとセットアップ
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
+go mod download
+cd web && npm install && cd ..
+
+# バックエンド起動
+go build -o nofx && ./nofx
+
+# フロントエンド起動（新しいターミナル）
+cd web && npm run 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と認証パラメータを確認
+1. **AI モデル設定** - AI API キーを追加
+2. **取引所設定** - 取引所 API 認証情報を設定
+3. **戦略作成** - ストラテジースタジオで取引戦略を設定
+4. **トレーダー作成** - AI モデル + 取引所 + 戦略を組み合わせ
+5. **取引開始** - 設定したトレーダーを起動
---
-## 📈 パフォーマンス最適化のヒント
+## リスク警告
-1. **合理的な判断サイクルを設定**: 3-5分を推奨、過剰取引を避ける
-2. **候補コイン数を制御**: システムはデフォルトでAI500上位20 + OI Top上位20
-3. **ログを定期的にクリーン**: 過度なディスク使用を避ける
-4. **API呼び出し数を監視**: Binanceレート制限のトリガーを避ける
-5. **少額資本でテスト**: まず100-500 USDTで戦略検証をテスト
+1. 暗号通貨市場は非常に変動が激しい - AI の決定は利益を保証しない
+2. 先物取引はレバレッジを使用 - 損失は元本を超える可能性がある
+3. 極端な市場状況では清算リスクがある
---
-## 🔄 変更履歴
+## ライセンス
-### v2.0.2（2025-10-29）
-
-**重大なバグ修正 - 取引履歴とパフォーマンス分析：**
-
-このバージョンは、収益性統計に大きく影響した過去取引記録とパフォーマンス分析システムの**重大な計算エラー**を修正します。
-
-**1. PnL計算 - 主要エラー修正**（logger/decision_logger.go）
-- **問題**: 以前はパーセンテージのみで計算され、ポジションサイズとレバレッジを完全に無視
- - 例：100 USDTポジションが5%獲得と1000 USDTポジションが5%獲得の両方が利益として`5.0`と表示
- - これによりパフォーマンス分析が完全に不正確に
-- **解決策**: 実際のUSDT利益額を計算
- ```
- PnL（USDT）= ポジション価値 × 価格変化% × レバレッジ
- 例：1000 USDT × 5% × 20x = 1000 USDT実際の利益
- ```
-- **影響**: 勝率、利益率、シャープレシオが正確なUSDT額に基づくようになりました
-
-**2. ポジション追跡 - 重要データの欠落**
-- **問題**: オープンポジション記録が価格と時間のみを保存、数量とレバレッジが欠落
-- **解決策**: 完全な取引データを保存：
- - `quantity`: ポジションサイズ（コイン単位）
- - `leverage`: レバレッジ倍率（例：20x）
- - これらは正確なPnL計算に不可欠
-
-**3. ポジションキーロジック - ロング/ショート競合**
-- **問題**: `symbol`をポジションキーとして使用し、ロングとショートの両方を保有する際にデータ競合を引き起こす
- - 例：BTCUSDTロングとBTCUSDTショートが互いに上書き
-- **解決策**: `symbol_side`形式に変更（例：`BTCUSDT_long`、`BTCUSDT_short`）
- - ロングとショートポジションを適切に区別
-
-**4. シャープレシオ計算 - コード最適化**
-- **問題**: 平方根計算にカスタムニュートン法を使用
-- **解決策**: 標準ライブラリ`math.Sqrt`に置き換え
- - より信頼性が高く、保守可能で効率的
-
-**このアップデートが重要な理由：**
-- ✅ 過去取引統計が無意味なパーセンテージではなく**実際のUSDT損益**を表示
-- ✅ 異なるレバレッジ取引間のパフォーマンス比較が正確に
-- ✅ AI自己学習メカニズムが正しい過去フィードバックを受信
-- ✅ 利益率とシャープレシオの計算が意味を持つように
-- ✅ マルチポジション追跡（ロング + ショート同時）が正しく機能
-
-**推奨**: このアップデート前にシステムを実行していた場合、過去統計は不正確でした。v2.0.2にアップデート後、新しい取引は正しく計算されます。
-
-### v2.0.2（2025-10-29）
-
-**バグ修正：**
-- ✅ Aster取引所精度エラーを修正（コード-1111：「Precision is over the maximum defined for this asset」）
-- ✅ 取引所の精度要件に合わせて価格と数量のフォーマットを改善
-- ✅ デバッグ用の詳細な精度処理ログを追加
-- ✅ 適切な精度処理ですべての注文関数（OpenLong、OpenShort、CloseLong、CloseShort、SetStopLoss、SetTakeProfit）を強化
-
-**技術詳細：**
-- float64を正しい精度で文字列に変換する`formatFloatWithPrecision`関数を追加
-- 価格と数量パラメータが取引所の`pricePrecision`と`quantityPrecision`仕様に従ってフォーマットされるようになりました
-- API リクエストを最適化するために、フォーマットされた値から末尾のゼロを削除
-
-### v2.0.1（2025-10-29）
-
-**バグ修正：**
-- ✅ ComparisonChartデータ処理ロジックを修正 - cycle_numberからタイムスタンプグループ化に切り替え
-- ✅ バックエンド再起動時にcycle_numberがリセットされるとチャートがフリーズする問題を解決
-- ✅ チャートデータ表示を改善 - すべての過去データポイントを時系列で表示
-- ✅ トラブルシューティングを改善するためのデバッグログを強化
-
-### v2.0.0（2025-10-28）
-
-**主要アップデート：**
-- ✅ AI自己学習メカニズム（過去フィードバック、パフォーマンス分析）
-- ✅ マルチトレーダー競争モード（Qwen対DeepSeek）
-- ✅ BinanceスタイルUI（完全なBinanceインターフェース模倣）
-- ✅ パフォーマンス比較チャート（リアルタイムROI比較）
-- ✅ リスク管理最適化（コインごとのポジション制限調整）
-
-**バグ修正：**
-- 初期残高のハードコーディング問題を修正
-- マルチトレーダーデータ同期問題を修正
-- チャートデータの整列を最適化（cycle_numberを使用）
-
-### v1.0.0（2025-10-27）
-- 初回リリース
-- 基本的なAI取引機能
-- 判断ログシステム
-- シンプルなWebインターフェース
+**GNU Affero General Public License v3.0 (AGPL-3.0)**
---
-## 📄 ライセンス
+## コンタクト
-MITライセンス - 詳細は[LICENSE](LICENSE)ファイルを参照してください
-
----
-
-## 🤝 貢献
-
-IssueとPull Requestを歓迎します！
-
-### 開発ガイド
-
-1. プロジェクトをフォーク
-2. 機能ブランチを作成（`git checkout -b feature/AmazingFeature`）
-3. 変更をコミット（`git commit -m 'Add some AmazingFeature'`）
-4. ブランチにプッシュ（`git push origin feature/AmazingFeature`）
-5. Pull Requestを開く
-
----
-
-## 🎁 コントリビューターエアドロッププログラム
-
-すべての貢献はGitHubで記録されます。NOFXが収益を上げた際、貢献者は貢献度に応じてエアドロップを受け取ります。
-
-### 🔥 優先報酬：ピン留めIssue
-
-**[ピン留めIssue](https://github.com/NoFxAiOS/nofx/issues)を解決するPRは最高の報酬を受け取ります！**
-
-ピン留めIssueで高優先度の機能とバグをチェック - ボーナス倍率が適用されます。
-
-### 貢献ウェイト
-
-| 貢献タイプ | ウェイト | 説明 |
-|----------|:------:|------|
-| **🔥 ピン留めIssue PR** | ⭐⭐⭐⭐⭐⭐ | ピン留め/優先Issueを解決するPR（最高報酬） |
-| **コードコミット** (マージされたPR) | ⭐⭐⭐⭐⭐ | コア機能、最適化、新しい統合 |
-| **バグ修正** | ⭐⭐⭐⭐ | 確認されたバグの修正 |
-| **機能提案** (採用されたIssue) | ⭐⭐⭐ | 実装されたアイデア |
-| **バグ報告** (確認済み) | ⭐⭐ | 再現可能な有効なバグの報告 |
-| **ドキュメント** | ⭐⭐ | 翻訳、ガイド、チュートリアル |
-
-### 仕組み
-
-1. **ピン留めIssueをチェック** - 高優先度タスク、ボーナス報酬
-2. **貢献** - PR提出、バグ報告、機能提案
-3. **追跡** - すべての貢献はGitHubアクティビティで記録
-4. **獲得** - 貢献ウェイトに比例してエアドロップを受け取る
-
-> 💡 [ピン留めIssue](https://github.com/NoFxAiOS/nofx/issues)から始めて、最高の報酬を獲得しましょう！
-
----
-
-## 📬 お問い合わせ
-
-
-### 🐛 技術サポート
-- **GitHub Issues**: [Issueを提出](https://github.com/tinkle-community/nofx/issues)
-- **開発者コミュニティ**: [Telegramグループ](https://t.me/nofx_dev_community)
-
----
-
-## 🙏 謝辞
-
-- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance先物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-29（v2.0.3）
-
-**⚡ AIの力で量的取引の可能性を探求しましょう！**
-
----
-
-## ⭐ Star履歴
-
-[](https://star-history.com/#tinkle-community/nofx&Date)
+- **GitHub Issues**: [Issue を提出](https://github.com/NoFxAiOS/nofx/issues)
+- **開発者コミュニティ**: [Telegram グループ](https://t.me/nofx_dev_community)
diff --git a/docs/i18n/ko/README.md b/docs/i18n/ko/README.md
index 04f6d41e..361ed9d0 100644
--- a/docs/i18n/ko/README.md
+++ b/docs/i18n/ko/README.md
@@ -1,737 +1,98 @@
-# 🤖 NOFX - Agentic Trading OS
+# NOFX - AI 트레이딩 시스템
[](https://golang.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](LICENSE)
-[](https://amber.ac)
-| 🎁 **기여자 에어드롭 프로그램** |
-|:----------------------------------:|
-| 코드 · 버그 수정 · Issue → 에어드롭 |
-| [자세히 보기](#-기여자-에어드롭-프로그램) |
-
-**언어 / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](README.md) | [Tiếng Việt](../vi/README.md)
-
-**📚 문서:** [문서 홈](../../README.md) | [시작 가이드](../../getting-started/README.md) | [커뮤니티](../../community/README.md) | [변경 로그](../../../CHANGELOG.md) | [⚠️ 면책 조항](../../../DISCLAIMER.md)
+**언어:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [한국어](README.md)
---
-## 📑 목차
+## AI 기반 암호화폐 거래 플랫폼
-- [🚀 범용 AI 트레이딩 운영 체제](#-범용-ai-트레이딩-운영-체제)
-- [👥 개발자 커뮤니티](#-개발자-커뮤니티)
-- [📸 시스템 스크린샷](#-시스템-스크린샷)
-- [🏦 지원 거래소 (DEX/CEX 튜토리얼)](#-지원-거래소-dexcex-튜토리얼)
-- [🤖 지원 AI 모델](#-지원-ai-모델)
-- [✨ 현재 구현](#-현재-구현---암호화폐-시장)
-- [🔮 로드맵](#-로드맵---범용-시장-확장)
-- [🏗️ 기술 아키텍처](#️-기술-아키텍처)
-- [🚀 빠른 시작](#-빠른-시작)
-- [📖 AI 의사결정 흐름](#-ai-의사결정-흐름)
-- [🧠 AI 자가학습 예시](#-ai-자가학습-예시)
-- [📊 웹 인터페이스 기능](#-웹-인터페이스-기능)
-- [⚠️ 중요한 위험 경고](#️-중요한-위험-경고)
-- [🛠️ 일반적인 문제](#️-일반적인-문제)
-- [📈 성능 최적화 팁](#-성능-최적화-팁)
-- [🔄 변경 로그](#-변경-로그)
-- [📄 라이선스](#-라이선스)
-- [🤝 기여하기](#-기여하기)
-- [🎁 기여자 에어드롭 프로그램](#-기여자-에어드롭-프로그램)
+**NOFX**는 여러 AI 모델을 실행하여 암호화폐 선물을 자동으로 거래할 수 있는 오픈소스 AI 거래 시스템입니다. 웹 인터페이스를 통해 전략을 구성하고, 실시간으로 성과를 모니터링하며, AI 에이전트들이 최적의 거래 방식을 찾도록 경쟁시킵니다.
+
+### 핵심 기능
+
+- **다중 AI 지원**: DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi 실행 - 언제든 모델 전환 가능
+- **다중 거래소**: Binance, Bybit, OKX, Hyperliquid, Aster DEX, Lighter에서 통합 거래
+- **전략 스튜디오**: 코인 소스, 지표, 리스크 제어를 설정하는 시각적 전략 빌더
+- **AI 경쟁 모드**: 여러 AI 트레이더가 실시간으로 경쟁, 성과를 나란히 추적
+- **웹 기반 설정**: JSON 편집 불필요 - 웹 인터페이스에서 모든 설정 완료
+- **실시간 대시보드**: 실시간 포지션, 손익 추적, 사고의 연쇄가 포함된 AI 결정 로그
+
+### [Amber.ac](https://amber.ac) 후원
+
+> **위험 경고**: 이 시스템은 실험적입니다. AI 자동 거래에는 상당한 위험이 있습니다. 학습/연구 목적 또는 소액 테스트만 강력히 권장합니다!
+
+## 개발자 커뮤니티
+
+Telegram 개발자 커뮤니티 참여: **[NOFX 개발자 커뮤니티](https://t.me/nofx_dev_community)**
---
-## 🚀 범용 AI 트레이딩 운영 체제
+## 빠른 시작
-**NOFX**는 통합 아키텍처를 기반으로 구축된 **범용 Agentic Trading OS**입니다. 암호화폐 시장에서 **"멀티 에이전트 의사결정 → 통합 리스크 관리 → 저지연 실행 → 실제/모의 계정 백테스팅"** 루프를 성공적으로 완성했으며, 현재 이 기술 스택을 **주식, 선물, 옵션, 외환 및 모든 금융 시장**으로 확장하고 있습니다.
-
-### 🎯 핵심 기능
-
-- **범용 데이터 및 백테스팅 레이어**: 크로스 마켓, 크로스 타임프레임, 크로스 거래소 통합 표현 및 팩터 라이브러리, 전이 가능한 "전략 메모리" 축적
-- **멀티 에이전트 자가 대전 및 자가 진화**: 전략이 자동으로 경쟁하고 최고를 선택하며, 계정 수준 PnL과 리스크 제약을 기반으로 지속적으로 반복
-- **통합 실행 및 리스크 관리**: 저지연 라우팅, 슬리피지/리스크 관리 샌드박스, 계정 수준 제한, 원클릭 마켓 전환
-
-### 🏢 [Amber.ac](https://amber.ac) 후원
-
-### 👥 핵심 팀
-
-- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **유일한 공식 트위터** - [@nofx_official](https://x.com/nofx_official)
-
-### 💼 시드 펀딩 라운드 진행 중
-
-현재 **시드 라운드** 자금을 조달 중입니다.
-
-**투자 문의**는 Twitter를 통해 **Tinkle**에게 DM을 보내주세요.
-
----
-
-> ⚠️ **위험 경고**: 이 시스템은 실험적입니다. AI 자동 거래는 상당한 위험을 수반합니다. 학습/연구 목적 또는 소액 테스트용으로만 사용할 것을 강력히 권장합니다!
-
-## 👥 개발자 커뮤니티
-
-텔레그램 개발자 커뮤니티에 가입하여 토론하고, 아이디어를 공유하고, 지원을 받으세요:
-
-**💬 [NOFX 개발자 커뮤니티](https://t.me/nofx_dev_community)**
-
----
-
-## 📸 시스템 스크린샷
-
-### 🏆 경쟁 모드 - 실시간 AI 배틀
-
-*Qwen vs DeepSeek 실시간 거래 배틀을 보여주는 멀티 AI 리더보드와 실시간 성능 비교 차트*
-
-### 📊 트레이더 상세 - 완전한 거래 대시보드
-
-*자본 곡선, 실시간 포지션, 확장 가능한 입력 프롬프트와 사고 연쇄 추론이 포함된 AI 의사결정 로그가 있는 전문 거래 인터페이스*
-
----
-
-> 📘 **참고**: 이것은 간소화된 한국어 버전 README입니다. 시스템 아키텍처, API 인터페이스 및 고급 구성을 포함한 전체 기술 문서는 [영문 버전](../../../README.md) 또는 [중문 버전](../zh-CN/README.md)을 참조하세요.
-
----
-
-## 🏦 지원 거래소 (DEX/CEX 튜토리얼)
-
-### CEX (중앙화 거래소)
-
-| 거래소 | 상태 | 등록 (수수료 할인) | API 설정 |
-|--------|------|-------------------|----------|
-| **Binance** | ✅ 지원됨 | [등록](https://www.binance.com/join?ref=NOFXKOREA) | [API 가이드](../../getting-started/binance-api.md) |
-| **Bybit** | ✅ 지원됨 | [등록](https://partner.bybit.com/b/83856) | [API 가이드](../../getting-started/bybit-api.md) |
-| **OKX** | ✅ 지원됨 | [등록](https://www.okx.com/join/1865360) | [API 가이드](../../getting-started/okx-api.md) |
-
-### Perp-DEX (탈중앙화 무기한 거래소)
-
-| 거래소 | 상태 | 등록 (수수료 할인) | 에이전트 지갑 설정 |
-|--------|------|-------------------|-------------------|
-| **Hyperliquid** | ✅ 지원됨 | [등록](https://app.hyperliquid.xyz/join/AITRADING) | [에이전트 지갑 가이드](../../getting-started/hyperliquid-agent-wallet.md) |
-| **Aster DEX** | ✅ 지원됨 | [등록](https://www.asterdex.com/en/referral/fdfc0e) | [API 지갑 가이드](../../getting-started/aster-api-wallet.md) |
-| **Lighter** | ✅ 지원됨 | [등록](https://lighter.xyz) | [에이전트 지갑 가이드](../../getting-started/lighter-agent-wallet.md) |
-
----
-
-## 🤖 지원 AI 모델
-
-| AI 모델 | 상태 | API 키 받기 |
-|---------|------|-------------|
-| **DeepSeek** | ✅ 지원됨 | [API 키 받기](https://platform.deepseek.com) |
-| **Qwen** | ✅ 지원됨 | [API 키 받기](https://dashscope.console.aliyun.com) |
-| **OpenAI (GPT)** | ✅ 지원됨 | [API 키 받기](https://platform.openai.com) |
-| **Claude** | ✅ 지원됨 | [API 키 받기](https://console.anthropic.com) |
-| **Gemini** | ✅ 지원됨 | [API 키 받기](https://aistudio.google.com) |
-| **Grok** | ✅ 지원됨 | [API 키 받기](https://console.x.ai) |
-| **Kimi** | ✅ 지원됨 | [API 키 받기](https://platform.moonshot.cn) |
-
----
-
-## ✨ 현재 구현 - 암호화폐 시장
-
-NOFX는 현재 다음과 같은 검증된 기능으로 **암호화폐 시장에서 완전히 운영**되고 있습니다:
-
-### 🏆 멀티 에이전트 경쟁 프레임워크
-- **실시간 에이전트 배틀**: Qwen vs DeepSeek 모델의 실시간 거래 경쟁
-- **독립적인 계정 관리**: 각 에이전트는 자체 의사결정 로그와 성능 지표 유지
-- **실시간 성능 비교**: 실시간 ROI 추적, 승률 통계, 1:1 분석
-- **자가 진화 루프**: 에이전트가 과거 성능에서 학습하여 지속적으로 개선
-
-### 🧠 AI 자가학습 및 최적화
-- **과거 피드백 시스템**: 각 의사결정 전 최근 20개 거래 주기 분석
-- **스마트 성능 분석**:
- - 최고/최악 성과 자산 식별
- - 실제 USDT 기준으로 승률, 손익비, 평균 수익 계산
- - 반복되는 실수 회피 (연속 손실 패턴)
- - 성공적인 전략 강화 (높은 승률 패턴)
-- **동적 전략 조정**: AI가 백테스트 결과를 기반으로 거래 스타일을 자율적으로 조정
-
-### 📊 범용 시장 데이터 레이어 (암호화폐 구현)
-- **멀티 타임프레임 분석**: 3분 실시간 + 4시간 트렌드 데이터
-- **기술적 지표**: EMA20/50, MACD, RSI(7/14), ATR
-- **미결제약정 추적**: 시장 심리, 자금 흐름 분석
-- **유동성 필터링**: 낮은 유동성 자산 자동 필터링 (<15M USD)
-- **크로스 거래소 지원**: 통합 데이터 인터페이스로 Binance, Hyperliquid, Aster DEX
-
-### 🎯 통합 리스크 관리 시스템
-- **포지션 제한**: 자산별 제한 (알트코인 ≤1.5x 자본, BTC/ETH ≤10x 자본)
-- **구성 가능한 레버리지**: 자산 클래스 및 계정 유형에 따라 1x에서 50x까지 동적 레버리지
-- **마진 관리**: 총 사용량 ≤90%, AI 제어 할당
-- **리스크-보상 강제**: 필수 ≥1:2 손절/익절 비율
-- **중복 방지**: 동일 자산/방향의 중복 포지션 방지
-
-### ⚡ 저지연 실행 엔진
-- **다중 거래소 API 통합**: Binance Futures, Hyperliquid DEX, Aster DEX
-- **자동 정밀도 처리**: 거래소별 스마트 주문 크기 및 가격 포맷팅
-- **우선순위 실행**: 기존 포지션 먼저 청산, 그 다음 신규 개설
-- **슬리피지 제어**: 실행 전 검증, 실시간 정밀도 체크
-
-### 🎨 전문 모니터링 인터페이스
-- **바이낸스 스타일 대시보드**: 실시간 업데이트가 있는 전문 다크 테마
-- **자본 곡선**: 과거 계정 가치 추적 (USD/백분율 전환)
-- **성능 차트**: 실시간 업데이트가 있는 멀티 에이전트 ROI 비교
-- **완전한 의사결정 로그**: 모든 거래에 대한 완전한 사고 연쇄(CoT) 추론
-- **5초 데이터 새로고침**: 실시간 계정, 포지션, P/L 업데이트
-
----
-
-## 🔮 로드맵 - 범용 시장 확장
-
-NOFX의 미션은 모든 금융 시장을 위한 **범용 AI 트레이딩 OS**가 되는 것입니다.
-
-**비전:** 동일한 아키텍처. 동일한 에이전트 프레임워크. 모든 시장.
-
-**확장 시장:**
-- 📈 **주식 시장**: 미국 주식, A주, 홍콩 주식
-- 📊 **선물 시장**: 상품 선물, 지수 선물
-- 🎯 **옵션 거래**: 주식 옵션, 암호화폐 옵션
-- 💱 **외환 시장**: 주요 통화쌍, 교차 환율
-
-**예정된 기능:**
-- 향상된 AI 기능 (GPT-4, Claude 3, Gemini Pro, 유연한 프롬프트 템플릿)
-- 새로운 거래소 통합 (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- 프로젝트 구조 리팩토링 (높은 응집도, 낮은 결합도, SOLID 원칙)
-- 보안 강화 (API 키 AES-256 암호화, RBAC, 2FA 개선)
-- 사용자 경험 개선 (모바일 반응형, TradingView 차트, 알림 시스템)
-
-📖 **자세한 로드맵 및 일정은 다음을 참조하세요:**
-- **English:** [Roadmap Documentation](../../roadmap/README.md)
-- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
-
----
-
-## 🏗️ 기술 아키텍처
-
-NOFX는 현대적이고 모듈화된 아키텍처로 구축되었습니다:
-
-- **백엔드:** Gin 프레임워크가 있는 Go, SQLite 데이터베이스
-- **프론트엔드:** React 18 + TypeScript + Vite + TailwindCSS
-- **다중 거래소 지원:** Binance, Hyperliquid, Aster DEX
-- **AI 통합:** DeepSeek, Qwen 및 사용자 정의 OpenAI 호환 API
-- **상태 관리:** 프론트엔드용 Zustand, 백엔드용 데이터베이스 기반
-- **실시간 업데이트:** 5-10초 폴링 간격의 SWR
-
-**주요 기능:**
-- 🗄️ 데이터베이스 기반 구성 (JSON 편집 불필요)
-- 🔐 선택적 2FA 지원이 있는 JWT 인증
-- 📊 실시간 성능 추적 및 분석
-- 🤖 실시간 비교가 있는 멀티 AI 경쟁 모드
-- 🔌 모든 구성 및 모니터링을 위한 RESTful API
-
-📖 **자세한 아키텍처 문서는 다음을 참조하세요:**
-- **English:** [Architecture Documentation](../../architecture/README.md)
-- **中文:** [架构文档](../../architecture/README.zh-CN.md)
-
----
-
-## 🚀 빠른 시작
-
-### 🐳 옵션 A: Docker 원클릭 배포 (가장 쉬움 - 초보자 권장!)
-
-**⚡ Docker로 3가지 간단한 단계로 거래 시작 - 설치 불필요!**
-
-Docker는 모든 종속성 (Go, Node.js, TA-Lib)과 환경 설정을 자동으로 처리합니다. 초보자에게 완벽합니다!
-
-#### 1단계: 구성 준비
-```bash
-# 구성 템플릿 복사
-cp config.json.example config.json
-
-# API 키를 입력하여 편집
-nano config.json # 또는 원하는 편집기 사용
-```
-
-#### 2단계: 원클릭 시작
-```bash
-# 옵션 1: 편리한 스크립트 사용 (권장)
-chmod +x scripts/start.sh
-./scripts/start.sh start --build
-
-# 옵션 2: docker compose 직접 사용
-# 이 프로젝트는 Docker Compose V2 구문을 사용합니다 (공백 포함)
-# 이전 독립 실행형 `docker-compose`가 설치되어 있는 경우 Docker Desktop 또는 Docker 20.10+로 업그레이드하세요
-docker compose up -d --build
-```
-
-#### 3단계: 대시보드 접속
-브라우저에서 열기: **http://localhost:3000**
-
-**이게 전부입니다! 🎉** AI 트레이딩 시스템이 실행 중입니다!
-
-#### 시스템 관리
-```bash
-./scripts/start.sh logs # 로그 보기
-./scripts/start.sh status # 상태 확인
-./scripts/start.sh stop # 서비스 중지
-./scripts/start.sh restart # 서비스 재시작
-```
-
-**📖 자세한 Docker 배포 가이드, 문제 해결 및 고급 구성:**
-- **한국어**: Docker 문서 참조 (곧 제공 예정)
-- **English**: See [DOCKER_DEPLOY.en.md](../../getting-started/docker-deploy.en.md)
-- **中文**: 查看 [DOCKER_DEPLOY.md](../../getting-started/docker-deploy.zh-CN.md)
-
----
-
-### 📦 옵션 B: 수동 설치 (개발자용)
-
-**참고**: 위의 Docker 배포를 사용한 경우 이 섹션을 건너뛰세요. 수동 설치는 코드를 수정하거나 Docker 없이 실행하려는 경우에만 필요합니다.
-
-### 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. 프로젝트 클론
+### 옵션 1: Docker 배포 (권장)
```bash
-git clone https://github.com/tinkle-community/nofx.git
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
+chmod +x ./start.sh
+./start.sh start --build
```
-### 3. 종속성 설치
+웹 인터페이스 접속: **http://localhost:3000**
-**백엔드:**
-```bash
-go mod download
-```
-
-**프론트엔드:**
-```bash
-cd web
-npm install
-cd ..
-```
-
-### 4. AI API 키 가져오기
-
-시스템을 구성하기 전에 AI API 키를 가져와야 합니다. 다음 AI 제공업체 중 하나를 선택하세요:
-
-#### 옵션 1: DeepSeek (초보자 권장)
-
-**왜 DeepSeek인가?**
-- 💰 GPT-4보다 저렴 (약 1/10 비용)
-- 🚀 빠른 응답 시간
-- 🎯 우수한 거래 결정 품질
-- 🌍 VPN 없이 전 세계에서 작동
-
-**DeepSeek API 키 가져오는 방법:**
-
-1. **방문**: [https://platform.deepseek.com](https://platform.deepseek.com)
-2. **등록**: 이메일/전화번호로 가입
-3. **인증**: 이메일/전화 인증 완료
-4. **충전**: 계정에 크레딧 추가
- - 최소: ~$5 USD
- - 권장: 테스트용 $20-50 USD
-5. **API 키 생성**:
- - API Keys 섹션으로 이동
- - "새 키 생성" 클릭
- - 키 복사 및 저장 (`sk-`로 시작)
- - ⚠️ **중요**: 즉시 저장하세요 - 다시 볼 수 없습니다!
-
-**가격**: 약 100만 토큰당 $0.14 (매우 저렴!)
-
-#### 옵션 2: Qwen (Alibaba Cloud)
-
-**Qwen API 키 가져오는 방법:**
-
-1. **방문**: [https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
-2. **등록**: Alibaba Cloud 계정으로 가입
-3. **서비스 활성화**: DashScope 서비스 활성화
-4. **API 키 생성**:
- - API 키 관리로 이동
- - 새 키 생성
- - 복사 및 저장 (`sk-`로 시작)
-
-**참고**: 등록을 위해 중국 전화번호가 필요할 수 있습니다
-
----
-
-### 5. 시스템 구성
-
-**두 가지 구성 모드 사용 가능:**
-- **🌟 초보자 모드**: 단일 트레이더 + 기본 코인 (권장!)
-- **⚔️ 전문가 모드**: 다중 트레이더 경쟁
-
-#### 🌟 초보자 모드 구성 (권장)
-
-**1단계**: 예제 구성 파일 복사 및 이름 변경
+### 옵션 2: 수동 설치
```bash
-cp config.json.example config.json
-```
+# 필수 조건: Go 1.21+, Node.js 18+, TA-Lib
-**2단계**: `config.json` 편집 및 API 키 입력
-
-*이제 웹 인터페이스를 통해 구성하므로 JSON 파일 편집이 필요 없습니다*
-
----
-
-## 📖 AI 의사결정 흐름
-
-각 의사결정 주기 (기본 3분)마다 시스템은 다음 프로세스를 실행합니다:
-
-### 1단계: 📊 과거 성능 분석 (최근 20주기)
-- ✓ 전체 승률, 평균 수익, 손익비 계산
-- ✓ 코인별 통계 (승률, USDT 평균 손익)
-- ✓ 최고/최악 성과 코인 식별
-- ✓ 정확한 손익이 포함된 최근 5개 거래 세부 정보 나열
-- ✓ 리스크 조정 성능에 대한 샤프 비율 계산
-- 📌 **신규 (v2.0.2)**: 레버리지를 고려한 정확한 USDT 손익
-
-**↓**
-
-### 2단계: 💰 계정 상태 가져오기
-- 총 자본 및 사용 가능 잔액
-- 미결 포지션 수 및 미실현 손익
-- 마진 사용률 (AI가 최대 90%까지 관리)
-- 일일 손익 추적 및 손실폭 모니터링
-
-**↓**
-
-### 3단계: 🔍 기존 포지션 분석 (있는 경우)
-- 각 포지션에 대해 최신 시장 데이터 가져오기
-- 실시간 기술적 지표 계산:
- - 3분 K선: RSI(7), MACD, EMA20
- - 4시간 K선: RSI(14), EMA20/50, ATR
-- 포지션 보유 기간 추적 (예: "2시간 15분")
-- 📌 **신규 (v2.0.2)**: 각 포지션의 보유 기간 표시
-- 표시: 진입 가격, 현재 가격, 손익%, 기간
-- AI 평가: 보유할지 청산할지?
-
-**↓**
-
-### 4단계: 🎯 새로운 기회 평가 (후보 코인)
-- 코인 풀 가져오기 (2가지 모드):
- - 🌟 **기본 모드**: BTC, ETH, SOL, BNB, XRP 등
- - ⚙️ **고급 모드**: AI500 (상위 20) + OI Top (상위 20)
-- 후보 코인 병합 및 중복 제거
-- 필터: 낮은 유동성 제거 (<15M USD OI 가치)
-- 시장 데이터 + 기술적 지표 일괄 가져오기
-- 변동성, 추세 강도, 거래량 급등 계산
-
-**↓**
-
-### 5단계: 🧠 AI 종합 의사결정 (DeepSeek/Qwen)
-- 과거 피드백 검토:
- - 최근 승률 및 수익 요인
- - 최고/최악 코인 성과
- - 반복되는 실수 회피
-- 모든 원시 시퀀스 데이터 분석:
- - 3분 가격 시퀀스, 4시간 K선 시퀀스
- - 완전한 지표 시퀀스 (최신만이 아님)
- - 📌 **신규 (v2.0.2)**: AI가 분석할 완전한 자유
-- 사고 연쇄(CoT) 추론 프로세스
-- 구조화된 의사결정 출력:
- - 액션: `close_long` / `close_short` / `open_long` / `open_short`
- - 코인 심볼, 수량, 레버리지
- - 손절 및 익절 수준 (≥1:2 비율)
-- 의사결정: 대기 / 보유 / 청산 / 개설
-
-**↓**
-
-### 6단계: ⚡ 거래 실행
-- 우선순위: 기존 포지션 청산 → 그 다음 신규 개설
-- 실행 전 리스크 체크:
- - 포지션 크기 제한 (알트코인 1.5x, BTC 10x)
- - 중복 포지션 없음 (동일 코인 + 방향)
- - 90% 한도 내 마진 사용
-- 바이낸스 LOT_SIZE 정밀도 자동 가져오기 및 적용
-- 바이낸스 선물 API를 통해 주문 실행
-- 청산 후: 모든 보류 주문 자동 취소
-- 실제 실행 가격 및 주문 ID 기록
-- 📌 기간 계산을 위한 포지션 개설 시간 추적
-
-**↓**
-
-### 7단계: 📝 완전한 로그 기록 및 성능 업데이트
-- 의사결정 로그를 `decision_logs/{trader_id}/`에 저장
-- 로그 포함 내용:
- - 완전한 사고 연쇄(CoT)
- - 모든 시장 데이터가 포함된 입력 프롬프트
- - 구조화된 의사결정 JSON
- - 계정 스냅샷 (잔액, 포지션, 마진)
- - 실행 결과 (성공/실패, 가격)
-- 성능 데이터베이스 업데이트:
- - `symbol_side` 키로 개설/청산 쌍 매칭
- - 📌 **신규**: 롱/숏 충돌 방지
- - 정확한 USDT 손익 계산:
- - `손익 = 포지션 가치 × 가격 변화% × 레버리지`
- - 📌 **신규**: 수량 + 레버리지 고려
- - 저장: 수량, 레버리지, 개설 시간, 청산 시간
- - 업데이트: 승률, 수익 요인, 샤프 비율
-- 성능 데이터가 다음 주기로 피드백
-
-**↓**
-
-**🔄 (3-5분마다 반복)**
-
----
-
-## 🧠 AI 자가학습 예시
-
-### 과거 피드백 (프롬프트에 자동 추가)
-
-```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. **시장 상황 식별**: 연속 손실은 변동성 높은 시장을 나타낼 수 있으며 거래 빈도 감소
-
----
-
-## 📊 웹 인터페이스 기능
-
-### 1. 경쟁 페이지
-
-- **🏆 리더보드**: 실시간 ROI 순위, 리더 강조 표시용 골드 테두리
-- **📈 성능 비교**: 듀얼 AI ROI 곡선 비교 (보라색 vs 파란색)
-- **⚔️ 1:1 대결**: 리드 마진을 보여주는 직접 비교
-- **실시간 데이터**: 총 자본, 손익%, 포지션 수, 마진 사용
-
-### 2. 상세 페이지
-
-- **자본 곡선**: 과거 추세 차트 (USD/백분율 전환)
-- **통계**: 총 주기, 성공/실패, 개설/청산 통계
-- **포지션 테이블**: 모든 포지션 세부 정보 (진입 가격, 현재 가격, 손익%, 청산 가격)
-- **AI 의사결정 로그**: 최근 의사결정 기록 (확장 가능한 CoT)
-
-### 3. 실시간 업데이트
-
-- 시스템 상태, 계정 정보, 포지션 목록: **5초마다 새로고침**
-- 의사결정 로그, 통계: **10초마다 새로고침**
-- 자본 차트: **10초마다 새로고침**
-
----
-
-## ⚠️ 중요한 위험 경고
-
-### 거래 위험
-
-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
+# TA-Lib 설치 (macOS)
brew install ta-lib
-# Ubuntu
-sudo apt-get install libta-lib0-dev
+# 클론 및 설정
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
+go mod download
+cd web && npm install && cd ..
+
+# 백엔드 시작
+go build -o nofx && ./nofx
+
+# 프론트엔드 시작 (새 터미널)
+cd web && npm run dev
```
-### 2. 정밀도 오류: 정밀도가 최대값을 초과
+---
-**해결책**: 시스템이 바이낸스 LOT_SIZE에서 정밀도를 자동 처리합니다. 오류가 지속되면 네트워크 연결을 확인하세요.
+## 초기 설정
-### 3. AI API 시간 초과
-
-**해결책**:
-- API 키가 올바른지 확인
-- 네트워크 연결 확인 (프록시가 필요할 수 있음)
-- 시스템 시간 초과는 120초로 설정됨
-
-### 4. 프론트엔드가 백엔드에 연결할 수 없음
-
-**해결책**:
-- 백엔드가 실행 중인지 확인 (http://localhost:8080)
-- 포트 8080이 사용 중인지 확인
-- 브라우저 콘솔에서 오류 확인
-
-### 5. 코인 풀 API 실패
-
-**해결책**:
-- 코인 풀 API는 선택 사항입니다
-- API가 실패하면 시스템은 기본 주류 코인을 사용합니다 (BTC, ETH 등)
-- 웹 인터페이스에서 구성 확인
+1. **AI 모델 설정** - AI API 키 추가
+2. **거래소 설정** - 거래소 API 자격 증명 설정
+3. **전략 생성** - 전략 스튜디오에서 거래 전략 구성
+4. **트레이더 생성** - AI 모델 + 거래소 + 전략 조합
+5. **거래 시작** - 설정된 트레이더 시작
---
-## 📈 성능 최적화 팁
+## 위험 경고
-1. **합리적인 의사결정 주기 설정**: 3-5분 권장, 과도한 거래 회피
-2. **후보 코인 수 제어**: 시스템 기본값은 AI500 상위 20 + OI Top 상위 20
-3. **로그 정기적으로 정리**: 과도한 디스크 사용 회피
-4. **API 호출 수 모니터링**: 바이낸스 속도 제한 트리거 회피
-5. **소액 자본으로 테스트**: 전략 검증을 위해 먼저 100-500 USDT로 테스트
+1. 암호화폐 시장은 매우 변동성이 높음 - AI 결정이 수익을 보장하지 않음
+2. 선물 거래는 레버리지 사용 - 손실이 원금을 초과할 수 있음
+3. 극단적인 시장 상황에서 청산 위험 있음
---
-## 🔄 변경 로그
+## 라이선스
-📖 **자세한 버전 기록 및 업데이트는 다음을 참조하세요:**
-
-- **한국어:** [CHANGELOG.zh-CN.md](../../../CHANGELOG.zh-CN.md)
-- **English:** [CHANGELOG.md](../../../CHANGELOG.md)
-
-**최신 릴리스:** v3.0.0 (2025-10-30) - 주요 아키텍처 변환
-
-**최근 하이라이트:**
-- 🚀 웹 기반 구성으로 전체 시스템 재설계
-- 🗄️ 데이터베이스 기반 아키텍처 (SQLite)
-- 🎨 JSON 편집 불필요 - 웹 인터페이스를 통한 모든 구성
-- 🔧 AI 모델을 모든 거래소와 혼합 및 매칭
-- 📊 포괄적인 엔드포인트가 있는 향상된 API 레이어
-- 🔐 JWT 인증 + 2FA 지원
-- 🌐 사용자 정의 API 지원 (OpenAI 호환)
-- 📈 원격 인증이 있는 프롬프트 템플릿 시스템
-
-**⚡ AI의 힘으로 정량적 거래의 가능성을 탐험하세요!**
+**GNU Affero General Public License v3.0 (AGPL-3.0)**
---
-## 📄 라이선스
+## 연락처
-이 프로젝트는 **GNU Affero 일반 공중 라이선스 v3.0 (AGPL-3.0)** 하에 라이선스가 부여됩니다 - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
-
-**이것이 의미하는 바:**
-- ✅ 이 소프트웨어를 사용, 수정 및 배포할 수 있습니다
-- ✅ 수정 버전의 소스 코드를 공개해야 합니다
-- ✅ 서버에서 수정 버전을 실행하는 경우 사용자에게 소스 코드를 제공해야 합니다
-- ✅ 모든 파생물도 AGPL-3.0 하에 라이선스가 부여되어야 합니다
-
-상업적 라이선스 또는 질문이 있는 경우 유지 관리자에게 문의하세요.
-
----
-
-## 🤝 기여하기
-
-Issue 및 Pull Request를 환영합니다!
-
-### 개발 가이드
-
-1. 프로젝트 포크
-2. 기능 브랜치 생성 (`git checkout -b feature/AmazingFeature`)
-3. 변경 사항 커밋 (`git commit -m 'Add some AmazingFeature'`)
-4. 브랜치에 푸시 (`git push origin feature/AmazingFeature`)
-5. Pull Request 열기
-
----
-
-## 🎁 기여자 에어드롭 프로그램
-
-모든 기여는 GitHub에서 추적됩니다. NOFX가 수익을 창출하면, 기여자는 기여도에 따라 에어드롭을 받게 됩니다.
-
-### 🔥 우선 보상: 고정된 Issue
-
-**[고정된 Issue](https://github.com/NoFxAiOS/nofx/issues)를 해결하는 PR은 최고 보상을 받습니다!**
-
-고정된 Issue에서 우선순위 높은 기능과 버그를 확인하세요 - 보너스 배율이 적용됩니다.
-
-### 기여 가중치
-
-| 기여 유형 | 가중치 | 설명 |
-|----------|:------:|------|
-| **🔥 고정된 Issue PR** | ⭐⭐⭐⭐⭐⭐ | 고정된/우선순위 Issue를 해결하는 PR (최고 보상) |
-| **코드 커밋** (병합된 PR) | ⭐⭐⭐⭐⭐ | 핵심 기능, 최적화, 새로운 통합 |
-| **버그 수정** | ⭐⭐⭐⭐ | 확인된 버그 수정 |
-| **기능 제안** (채택된 Issue) | ⭐⭐⭐ | 구현된 아이디어 |
-| **버그 보고** (확인됨) | ⭐⭐ | 재현 가능한 유효한 버그 보고 |
-| **문서** | ⭐⭐ | 번역, 가이드, 튜토리얼 |
-
-### 작동 방식
-
-1. **고정된 Issue 확인** - 우선순위 높은 작업, 보너스 보상
-2. **기여** - PR 제출, 버그 보고, 기능 제안
-3. **추적** - 모든 기여는 GitHub 활동으로 기록
-4. **획득** - 기여 가중치에 비례하여 에어드롭 수령
-
-> 💡 [고정된 Issue](https://github.com/NoFxAiOS/nofx/issues)부터 시작하여 최고 보상을 받으세요!
-
----
-
-## 📬 연락처
-
-### 🐛 기술 지원
-- **GitHub Issues**: [Issue 제출](https://github.com/tinkle-community/nofx/issues)
-- **개발자 커뮤니티**: [텔레그램 그룹](https://t.me/nofx_dev_community)
-
----
-
-## 🙏 감사의 말
-
-- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - 바이낸스 선물 API
-- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API
-- [Qwen](https://dashscope.console.aliyun.com/) - Alibaba Cloud Qwen
-- [TA-Lib](https://ta-lib.org/) - 기술적 지표 라이브러리
-- [Recharts](https://recharts.org/) - React 차트 라이브러리
-
----
-
-**마지막 업데이트**: 2025-10-30 (v3.0.0)
-
-**⚡ AI의 힘으로 정량적 거래의 가능성을 탐험하세요!**
-
----
-
-## ⭐ Star History
-
-[](https://star-history.com/#tinkle-community/nofx&Date)
+- **GitHub Issues**: [Issue 제출](https://github.com/NoFxAiOS/nofx/issues)
+- **개발자 커뮤니티**: [Telegram 그룹](https://t.me/nofx_dev_community)
diff --git a/docs/i18n/ru/README.md b/docs/i18n/ru/README.md
index e0966beb..e68ce41f 100644
--- a/docs/i18n/ru/README.md
+++ b/docs/i18n/ru/README.md
@@ -1,1278 +1,98 @@
-# 🤖 NOFX - Agentic Trading OS
+# NOFX - AI Торговая Система
[](https://golang.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](LICENSE)
-[](https://amber.ac)
-**Языки / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md) | [Tiếng Việt](../vi/README.md)
-
-**📚 Документация:** [Главная](../../README.md) | [Начало работы](../../getting-started/README.md) | [Журнал изменений](../../../CHANGELOG.zh-CN.md) | [Сообщество](../../community/README.md) | [⚠️ Отказ от ответственности](../../../DISCLAIMER.md)
+**Языки:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Русский](README.md)
---
-## 📑 Содержание
+## Криптовалютная торговая платформа на базе ИИ
-- [🚀 Универсальная AI Торговая Операционная Система](#-универсальная-ai-торговая-операционная-система)
-- [👥 Сообщество Разработчиков](#-сообщество-разработчиков)
-- [🆕 Что Нового](#-что-нового)
-- [📸 Скриншоты](#-скриншоты)
-- [✨ Текущая Реализация - Криптовалютные Рынки](#-текущая-реализация---криптовалютные-рынки)
-- [🔮 Дорожная Карта](#-дорожная-карта---расширение-на-универсальные-рынки)
-- [🏗️ Техническая Архитектура](#️-техническая-архитектура)
-- [💰 Регистрация аккаунта Binance](#-регистрация-аккаунта-binance-экономьте-на-комиссиях)
-- [🔷 Регистрация аккаунта Hyperliquid](#-использование-биржи-hyperliquid)
-- [🔶 Регистрация аккаунта Aster DEX](#-использование-биржи-aster-dex)
-- [🚀 Быстрый Старт](#-быстрый-старт)
-- [📊 Функции Web-интерфейса](#-функции-web-интерфейса)
-- [⚠️ Важные Предупреждения о Рисках](#️-важные-предупреждения-о-рисках)
-- [🛠️ Общие Проблемы](#️-общие-проблемы)
-- [🔄 Журнал Изменений](#-журнал-изменений)
+**NOFX** — это open-source AI торговая система, позволяющая запускать несколько AI моделей для автоматической торговли криптовалютными фьючерсами. Настраивайте стратегии через веб-интерфейс, отслеживайте эффективность в реальном времени и позвольте AI агентам конкурировать за лучший торговый подход.
+
+### Основные функции
+
+- **Мульти-AI поддержка**: Запускайте DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi — переключайтесь между моделями в любое время
+- **Мульти-биржа**: Торгуйте на Binance, Bybit, OKX, Hyperliquid, Aster DEX, Lighter с единой платформы
+- **Студия стратегий**: Визуальный конструктор стратегий с источниками монет, индикаторами и контролем рисков
+- **Режим AI-соревнования**: Несколько AI трейдеров соревнуются в реальном времени, отслеживание эффективности бок о бок
+- **Веб-конфигурация**: Без редактирования JSON — настройка всего через веб-интерфейс
+- **Панель реального времени**: Живые позиции, отслеживание P/L, логи решений AI с цепочкой рассуждений
+
+### При поддержке [Amber.ac](https://amber.ac)
+
+> **Предупреждение о рисках**: Эта система экспериментальная. AI автоторговля несёт значительные риски. Настоятельно рекомендуется использовать только для обучения/исследований или тестирования с небольшими суммами!
+
+## Сообщество разработчиков
+
+Присоединяйтесь к Telegram сообществу: **[NOFX Developer Community](https://t.me/nofx_dev_community)**
---
-## 🚀 Универсальная AI Торговая Операционная Система
+## Быстрый старт
-**NOFX** - это **универсальная Agentic Trading OS**, построенная на единой архитектуре. Мы успешно замкнули цикл на криптовалютных рынках: **"Решение Multi-Agent → Единый Контроль Рисков → Исполнение с Низкой Задержкой → Бэктестинг Реальных/Бумажных Счетов"**, и сейчас расширяем этот же технологический стек на **акции, фьючерсы, опционы, форекс и все финансовые рынки**.
-
-### 🎯 Основные Возможности
-
-- **Универсальный Слой Данных и Бэктестинга**: Кросс-рыночное, кросс-таймфреймовое, кросс-биржевое единое представление и библиотека факторов, накапливающая переносимую "память стратегий"
-- **Multi-Agent Самоигра и Самоэволюция**: Стратегии автоматически конкурируют и выбирают лучшие, непрерывно итерируясь на основе PnL на уровне счета и ограничений рисков
-- **Интегрированное Исполнение и Контроль Рисков**: Маршрутизация с низкой задержкой, песочница проскальзывания/контроля рисков, лимиты на уровне счета, переключение рынков одним кликом
-
-### 🏢 При поддержке [Amber.ac](https://amber.ac)
-
-### 👥 Основная Команда
-
-- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **Единственный Официальный Twitter** - [@nofx_official](https://x.com/nofx_official)
-
-### 💼 Открыт Посевной Раунд Финансирования
-
-Мы в настоящее время привлекаем **посевной раунд**.
-
-**По вопросам инвестиций**, пишите в DM **Tinkle** в Twitter.
-
----
-
-> ⚠️ **Предупреждение о рисках**: Эта система экспериментальная. Автоматическая торговля с AI несет значительные риски. Настоятельно рекомендуется использовать только для обучения/исследований или тестирования с небольшими суммами!
-
-## 👥 Сообщество разработчиков
-
-Присоединяйтесь к нашему сообществу разработчиков в Telegram для обсуждения, обмена идеями и получения поддержки:
-
-**💬 [Сообщество разработчиков NOFX](https://t.me/nofx_dev_community)**
-
----
-
-## 🆕 Последние обновления
-
-### 🚀 Поддержка нескольких бирж!
-
-NOFX теперь поддерживает **три основные биржи**: Binance, Hyperliquid и Aster DEX!
-
-#### **Биржа Hyperliquid**
-
-Высокопроизводительная децентрализованная биржа бессрочных фьючерсов!
-
-**Ключевые особенности:**
-- ✅ Полная поддержка торговли (лонг/шорт, плечо, стоп-лосс/тейк-профит)
-- ✅ Автоматическая обработка точности (размер и цена ордера)
-- ✅ Единый интерфейс трейдера (бесшовное переключение бирж)
-- ✅ Поддержка мейннета и тестнета
-- ✅ Не нужны API ключи - только приватный ключ Ethereum
-
-**Почему Hyperliquid?**
-- 🔥 Более низкие комиссии чем на централизованных биржах
-- 🔒 Без хранения - вы контролируете свои средства
-- ⚡ Быстрое исполнение с расчетом на цепи
-- 🌍 Не нужна KYC
-
-**Быстрый старт:**
-1. Получите приватный ключ MetaMask (удалите префикс `0x`)
-2. ~~Установите `"exchange": "hyperliquid"` в config.json~~ *Настройте через веб-интерфейс*
-3. Добавьте `"hyperliquid_private_key": "your_key"`
-4. Начните торговать!
-
-См. [Руководство по конфигурации](#-альтернатива-использование-биржи-hyperliquid).
-
-#### **Биржа Aster DEX** (НОВОЕ! v2.0.2)
-
-Децентрализованная биржа бессрочных фьючерсов, совместимая с Binance!
-
-**Ключевые особенности:**
-- ✅ API в стиле Binance (легкая миграция с Binance)
-- ✅ Web3 аутентификация кошелька (безопасно и децентрализованно)
-- ✅ Полная поддержка торговли с автоматической обработкой точности
-- ✅ Более низкие комиссии за торговлю чем CEX
-- ✅ Совместимость с EVM (Ethereum, BSC, Polygon и т.д.)
-
-**Почему Aster?**
-- 🎯 **API совместимый с Binance** - нужны минимальные изменения кода
-- 🔐 **Система API кошелька** - отдельный торговый кошелек для безопасности
-- 💰 **Конкурентные комиссии** - ниже чем большинство централизованных бирж
-- 🌐 **Поддержка нескольких цепей** - торгуйте на вашей любимой EVM цепи
-
-**Быстрый старт:**
-1. Зарегистрируйтесь по [реферальной ссылке Aster](https://www.asterdex.com/en/referral/fdfc0e) (получите скидку на комиссии!)
-2. Посетите [Aster API Wallet](https://www.asterdex.com/en/api-wallet)
-3. Подключите основной кошелек и создайте API кошелек
-4. Скопируйте адрес API Signer и приватный ключ
-5. Установите `"exchange": "aster"` в config.json
-6. Добавьте `"aster_user"`, `"aster_signer"` и `"aster_private_key"`
-
----
-
-## 📸 Скриншоты
-
-### 🏆 Режим конкуренции - Битва AI в реальном времени
-
-*Лидерборд с несколькими AI и графики сравнения производительности в реальном времени показывают битву Qwen против DeepSeek*
-
-### 📊 Детали трейдера - Полная торговая панель
-
-*Профессиональный торговый интерфейс с кривыми капитала, живыми позициями и логами решений AI с раскрываемыми входными промптами и цепочкой рассуждений*
-
----
-
-> 📘 **Примечание**: Это упрощенная русская версия README. Для получения полной технической документации, включая архитектуру системы, API-интерфейсы и расширенные конфигурации, см. [Английскую версию](../../../README.md) или [Китайскую версию](../zh-CN/README.md).
-
----
-
-## ✨ Текущая реализация - Рынки криптовалют
-
-NOFX в настоящее время **полностью работает на криптовалютных рынках** со следующими проверенными возможностями:
-
-### 🏆 Структура конкуренции Multi-Agent
-- **Реальная битва AI-агентов**: Торговое соревнование моделей Qwen vs DeepSeek в реальном времени
-- **Независимое управление счетами**: Каждый агент ведет отдельные журналы решений и метрики производительности
-- **Сравнение производительности в реальном времени**: Отслеживание ROI в реальном времени, статистика винрейта, прямой анализ
-- **Цикл самоэволюции**: Агенты учатся на исторической производительности, постоянно совершенствуясь
-
-### 🧠 AI Самообучение и Оптимизация
-- **Система исторической обратной связи**: Анализ последних 20 торговых циклов перед каждым решением
-- **Интеллектуальный анализ производительности**:
- - Определяет лучшие/худшие активы по производительности
- - Рассчитывает винрейт, коэффициент прибыли/убытка, среднюю прибыль в реальных USDT
- - Избегает повторяющихся ошибок (паттерны последовательных убытков)
- - Усиливает успешные стратегии (высокие паттерны винрейта)
-- **Динамическая корректировка стратегии**: AI автономно регулирует торговый стиль на основе результатов бэктеста
-
-### 📊 Универсальный слой рыночных данных (Криптореализация)
-- **Многотаймфреймовый анализ**: 3-минутные реальные данные + 4-часовые трендовые данные
-- **Технические индикаторы**: EMA20/50, MACD, RSI(7/14), ATR
-- **Отслеживание открытого интереса**: Анализ настроений рынка, денежных потоков
-- **Фильтрация ликвидности**: Автоматическая фильтрация активов с низкой ликвидностью (<15M USD)
-- **Поддержка кросс-биржевой торговли**: Binance, Hyperliquid, Aster DEX, единый интерфейс данных
-
-### 🎯 Единая система контроля рисков
-- **Лимиты позиций**: Лимиты на актив (Альткоины≤1.5x капитал, BTC/ETH≤10x капитал)
-- **Настраиваемое кредитное плечо**: Динамическая настройка от 1x до 50x на основе класса активов и типа счета
-- **Управление маржой**: Общее использование≤90%, AI контролирует распределение
-- **Принудительное соотношение риск/вознаграждение**: Обязательное соотношение стоп-лосс/тейк-профит ≥1:2
-- **Защита от наслоения**: Предотвращает дублирование позиций по одному активу/направлению
-
-### ⚡ Движок исполнения с низкой задержкой
-- **Интеграция API множества бирж**: Binance Futures, Hyperliquid DEX, Aster DEX
-- **Автоматическая обработка точности**: Интеллектуальное форматирование размера и цены ордера для каждой биржи
-- **Приоритетное исполнение**: Сначала закрытие существующих позиций, затем открытие новых
-- **Контроль проскальзывания**: Проверка перед исполнением, проверка точности в реальном времени
-
-### 🎨 Профессиональный интерфейс мониторинга
-- **Dashboard в стиле Binance**: Профессиональная темная тема с обновлениями в реальном времени
-- **Кривые капитала**: Историческое отслеживание стоимости счета (переключение USD/процент)
-- **Графики производительности**: Сравнение ROI множества AI-агентов, обновления в реальном времени
-- **Полные журналы решений**: Полное рассуждение цепочки мыслей (CoT) для каждой сделки
-- **5-секундное обновление данных**: Обновления счета, позиций и P&L в реальном времени
-
----
-
-## 🔮 Дорожная карта - Расширение универсального рынка
-
-Миссия NOFX - стать **универсальной AI-торговой ОС для всех финансовых рынков**.
-
-**Видение:** Одна архитектура. Одна агентная структура. Все рынки.
-
-**Расширяемые рынки:**
-- 📈 **Фондовые рынки**: Акции США, акции Китая, Гонконгские акции
-- 📊 **Фьючерсные рынки**: Товарные фьючерсы, индексные фьючерсы
-- 🎯 **Опционная торговля**: Опционы на акции, криптоопционы
-- 💱 **Рынок Forex**: Основные валютные пары, кросс-пары
-
-**Предстоящие функции:**
-- Расширенные возможности AI (GPT-4, Claude 3, Gemini Pro, гибкие шаблоны промптов)
-- Интеграция новых бирж (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- Рефакторинг структуры проекта (высокая связность, низкая связанность, принципы SOLID)
-- Улучшения безопасности (AES-256 шифрование API-ключей, RBAC, улучшенная 2FA)
-- Улучшения UX (отзывчивость мобильных устройств, графики TradingView, система оповещений)
-
-📖 **Для детальной дорожной карты и графиков см.:**
-- **English:** [Roadmap Documentation](../../roadmap/README.md)
-- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
-
----
-
-## ✨ Основные возможности
-
-### 🏆 Режим конкуренции нескольких 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 капитал счета
-- **Настраиваемое плечо** (v2.0.3+):
- - Установите максимальное плечо в config.json
- - По умолчанию: 5x для всех монет (безопасно для субаккаунтов)
- - Основные аккаунты могут увеличить: Альткоины до 20x, BTC/ETH до 50x
- - ⚠️ Субаккаунты Binance ограничены ≤5x плечом
-- **Управление маржой**: Общее использование ≤90%, AI принимает автономные решения
-- **Соотношение риск/доход**: Обязательное ≥1:2 (стоп-лосс:тейк-профит)
-- **Предотвращение накопления позиций**: Запрет дублирования открытия той же монеты/направления
-
-### 🎨 Профессиональный UI
-- **Профессиональный торговый интерфейс**: Визуальный дизайн в стиле Binance
-- **Темная тема**: Классическая цветовая схема (Золотой #F0B90B + темный фон)
-- **Данные в реальном времени**: Обновление каждые 5 секунд для счетов, позиций, графиков
-- **Кривая капитала**: График исторического тренда стоимости счета (переключение USD/процент)
-- **График сравнения производительности**: Сравнение ROI нескольких AI в реальном времени
-- **Плавные анимации**: Плавные эффекты наведения, переходов и загрузки
-
-### 📝 Полная запись решений
-- **Цепочка рассуждений**: Полный процесс рассуждений AI (CoT)
-- **Историческая производительность**: Общий процент выигрышей, средняя прибыль, соотношение прибыли/убытка
-- **Последние сделки**: Детали последних 5 сделок (цена входа → цена выхода → P/L%)
-- **Статистика по монетам**: Производительность по каждой монете (процент выигрышей, средний P/L)
-- **JSON логи**: Полные записи решений для пост-анализа
-
----
-
-## 🔮 Дорожная Карта - Расширение на Универсальные Рынки
-
-Миссия NOFX - стать **Универсальной AI Торговой Операционной Системой** для всех финансовых рынков.
-
-**Видение:** Та же архитектура. Та же агентная структура. Все рынки.
-
-**Расширение на Рынки:**
-- 📈 **Фондовые Рынки**: Акции США, A-акции, Гонконгская биржа
-- 📊 **Рынки Фьючерсов**: Товарные фьючерсы, индексные фьючерсы
-- 🎯 **Опционная Торговля**: Опционы на акции, крипто опционы
-- 💱 **Рынки Форекс**: Основные валютные пары, кросс-курсы
-
-**Предстоящие Функции:**
-- Расширенные AI возможности (GPT-4, Claude 3, Gemini Pro, гибкие шаблоны промптов)
-- Новые интеграции бирж (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- Рефакторинг структуры проекта (высокая связность, низкая связанность, принципы SOLID)
-- Улучшения безопасности (AES-256 шифрование API ключей, RBAC, улучшения 2FA)
-- Улучшения пользовательского опыта (мобильный интерфейс, графики TradingView, система оповещений)
-
-📖 **Для подробной дорожной карты и сроков см.:**
-- **English:** [Roadmap Documentation](../../roadmap/README.md)
-- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
-
----
-
-## 🏗️ Техническая Архитектура
-
-NOFX построен на современной модульной архитектуре:
-
-- **Backend:** Go с фреймворком Gin, база данных SQLite
-- **Frontend:** React 18 + TypeScript + Vite + TailwindCSS
-- **Поддержка Бирж:** Binance, Hyperliquid, Aster DEX
-- **Интеграция AI:** DeepSeek, Qwen и пользовательские OpenAI-совместимые API
-- **Управление Состоянием:** Zustand для фронтенда, на основе базы данных для бэкенда
-- **Обновления в Реальном Времени:** SWR с интервалами опроса 5-10 секунд
-
-**Ключевые Особенности:**
-- 🗄️ Конфигурация на основе базы данных (больше никакого редактирования JSON)
-- 🔐 JWT аутентификация с опциональной поддержкой 2FA
-- 📊 Отслеживание производительности и аналитика в реальном времени
-- 🤖 Режим конкуренции Multi-AI с живым сравнением
-- 🔌 RESTful API для всех настроек и мониторинга
-
-📖 **Для подробной документации по архитектуре см.:**
-- **Русский:** [Документация по Архитектуре](../../architecture/README.md)
-- **中文:** [架构文档](../../architecture/README.zh-CN.md)
-
----
-
-## 💰 Регистрация аккаунта Binance (Экономьте на комиссиях!)
-
-Перед использованием этой системы вам нужен аккаунт Binance Futures. **Используйте нашу реферальную ссылку для получения скидки на комиссии:**
-
-**🎁 [Зарегистрироваться на Binance - Получить скидку](https://www.binance.com/join?ref=NOFXRUS)**
-
-### Шаги регистрации:
-
-1. **Нажмите на ссылку выше** чтобы перейти на страницу регистрации Binance
-2. **Завершите регистрацию** используя email/номер телефона
-3. **Пройдите KYC верификацию** (требуется для торговли фьючерсами)
-4. **Активируйте аккаунт Futures**:
- - Перейдите на главную страницу Binance → Деривативы → USD-M Фьючерсы
- - Нажмите "Открыть сейчас" для активации торговли фьючерсами
-5. **Создайте API ключ**:
- - Перейдите в Аккаунт → Управление API
- - Создайте новый API ключ, **включите разрешение "Futures"**
- - Сохраните API Key и Secret Key (необходимо для config.json)
- - **Важно**: Добавьте свой IP адрес в белый список для безопасности
-
-### Преимущества скидки:
-
-- ✅ **Спотовая торговля**: Скидка до 30% на комиссии
-- ✅ **Торговля фьючерсами**: Скидка до 30% на комиссии
-- ✅ **Пожизненная**: Постоянная скидка на все сделки
-
----
-
-## 🚀 Быстрый старт
-
-### 🐳 Вариант A: Docker развертывание в один клик (ПРОЩЕ ВСЕГО - Рекомендуется для новичков!)
-
-**⚡ Начните торговать за 3 простых шага с Docker - Не нужно ничего устанавливать!**
-
-Docker автоматически обрабатывает все зависимости (Go, Node.js, TA-Lib) и настройку среды. Идеально для новичков!
-
-#### Шаг 1: Подготовьте конфигурацию
-```bash
-# Скопируйте шаблон конфигурации
-cp config.json.example config.json
-
-# Отредактируйте и заполните ваши API ключи
-nano config.json # или используйте любой редактор
-```
-
-#### Шаг 2: Запуск в один клик
-```bash
-# Вариант 1: Используйте удобный скрипт (Рекомендуется)
-chmod +x scripts/start.sh
-./scripts/start.sh start --build
-
-# Вариант 2: Используйте docker compose напрямую
-# Этот проект использует синтаксис Docker Compose V2 (с пробелами)
-# Если у вас установлена старая версия `docker-compose`, обновитесь до Docker Desktop или Docker 20.10+
-docker compose up -d --build
-```
-
-#### Шаг 3: Доступ к панели
-Откройте в браузере: **http://localhost:3000**
-
-**Вот и все! 🎉** Ваша AI торговая система теперь работает!
-
-#### Управление вашей системой
-```bash
-./scripts/start.sh logs # Просмотреть логи
-./scripts/start.sh status # Проверить статус
-./scripts/start.sh stop # Остановить сервисы
-./scripts/start.sh restart # Перезапустить сервисы
-```
-
-**📖 Подробное руководство по развертыванию Docker, устранению неполадок и расширенной конфигурации:**
-- **Русский**: См. документацию Docker (скоро будет доступно)
-- **English**: See [DOCKER_DEPLOY.en.md](DOCKER_DEPLOY.en.md)
-- **中文**: 查看 [DOCKER_DEPLOY.md](DOCKER_DEPLOY.md)
-- **日本語**: [DOCKER_DEPLOY.ja.md](DOCKER_DEPLOY.ja.md)を参照
-
----
-
-### 📦 Вариант B: Ручная установка (Для разработчиков)
-
-**Примечание**: Если вы использовали развертывание Docker выше, пропустите этот раздел. Ручная установка нужна только если вы хотите изменить код или запустить без Docker.
-
-### 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. Клонирование проекта
+### Вариант 1: Docker развёртывание (рекомендуется)
```bash
-git clone https://github.com/tinkle-community/nofx.git
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
+chmod +x ./start.sh
+./start.sh start --build
```
-### 3. Установка зависимостей
+Доступ к веб-интерфейсу: **http://localhost:3000**
-**Backend:**
-```bash
-go mod download
-```
-
-**Frontend:**
-```bash
-cd web
-npm install
-cd ..
-```
-
-### 4. Получение AI API ключей
-
-Перед настройкой системы вам необходимо получить AI API ключ. Выберите одного из следующих AI провайдеров:
-
-#### Вариант 1: DeepSeek (Рекомендуется для новичков)
-
-**Почему DeepSeek?**
-- 💰 Дешевле чем GPT-4 (примерно 1/10 стоимости)
-- 🚀 Быстрое время отклика
-- 🎯 Отличное качество торговых решений
-- 🌍 Доступен глобально без VPN
-
-**Как получить DeepSeek API ключ:**
-
-1. **Посетите**: [https://platform.deepseek.com](https://platform.deepseek.com)
-2. **Зарегистрируйтесь**: Используя email/номер телефона
-3. **Подтвердите**: Завершите подтверждение email/телефона
-4. **Пополните**: Добавьте баланс на аккаунт
- - Минимум: ~$5 USD
- - Рекомендуется: $20-50 USD для тестирования
-5. **Создайте API ключ**:
- - Перейдите в раздел API Keys
- - Нажмите "Создать новый ключ"
- - Скопируйте и сохраните ключ (начинается с `sk-`)
- - ⚠️ **Важно**: Сохраните немедленно - позже увидеть не сможете!
-
-**Цена**: Примерно $0.14 за миллион токенов (очень дешево!)
-
-#### Вариант 2: Qwen (Alibaba Cloud Tongyi Qianwen)
-
-**Как получить Qwen API ключ:**
-
-1. **Посетите**: [https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
-2. **Зарегистрируйтесь**: Используя аккаунт Alibaba Cloud
-3. **Активируйте сервис**: Активируйте DashScope сервис
-4. **Создайте API ключ**:
- - Перейдите в управление API ключами
- - Создайте новый ключ
- - Скопируйте и сохраните (начинается с `sk-`)
-
-**Примечание**: Может потребоваться китайский номер телефона для регистрации
-
----
-
-### 5. Конфигурация системы
-
-**Доступны два режима конфигурации:**
-- **🌟 Режим новичка**: Один трейдер + монеты по умолчанию (Рекомендуется!)
-- **⚔️ Экспертный режим**: Конкуренция нескольких трейдеров
-
-#### 🌟 Конфигурация режима новичка (Рекомендуется)
-
-**Шаг 1**: Скопируйте и переименуйте файл примера конфигурации
+### Вариант 2: Ручная установка
```bash
-cp config.json.example config.json
-```
+# Требования: Go 1.21+, Node.js 18+, TA-Lib
-**Шаг 2**: Отредактируйте `config.json` и заполните ваши API ключи
-
-```json
-{
- "traders": [
- {
- "id": "my_trader",
- "name": "Мой AI Трейдер",
- "ai_model": "deepseek",
- "binance_api_key": "YOUR_BINANCE_API_KEY",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY",
- "use_qwen": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "qwen_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- },
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**Шаг 3**: Замените заполнители вашими фактическими ключами
-
-| Заполнитель | Заменить на | Где получить |
-|-------------|-------------|--------------|
-| `YOUR_BINANCE_API_KEY` | Ваш Binance API ключ | Binance → Аккаунт → Управление API |
-| `YOUR_BINANCE_SECRET_KEY` | Ваш Binance Secret ключ | То же самое |
-| `sk-xxxxxxxxxxxxx` | Ваш DeepSeek API ключ | [platform.deepseek.com](https://platform.deepseek.com) |
-
-**Шаг 4**: Настройте начальный баланс (опционально)
-
-- `initial_balance`: Установите ваш фактический баланс Binance Futures аккаунта
-- Используется для расчета P/L процентов
-- Пример: Если у вас 500 USDT, установите `"initial_balance": 500.0`
-
-**✅ Контрольный список конфигурации:**
-
-- [ ] Binance API ключ заполнен (без кавычек)
-- [ ] Binance Secret ключ заполнен (без кавычек)
-- [ ] DeepSeek API ключ заполнен (начинается с `sk-`)
-- [ ] `use_default_coins` установлен в `true` (для новичков)
-- [ ] `initial_balance` соответствует балансу аккаунта
-- [ ] Файл сохранен как `config.json` (не `.example`)
-
----
-
-#### 🔷 Использование биржи Hyperliquid
-
-**NOFX поддерживает Hyperliquid** - высокопроизводительную децентрализованную биржу бессрочных фьючерсов!
-
-**Почему выбрать Hyperliquid?**
-- 🚀 **Высокая производительность**: Молниеносное исполнение на L1 блокчейне
-- 💰 **Низкие комиссии**: Конкурентные комиссии мейкер/тейкер
-- 🔐 **Без хранения**: Ваши ключи, ваши монеты
-- 🌐 **Без KYC**: Анонимная торговля
-- 💎 **Глубокая ликвидность**: Книга ордеров институционального уровня
-
----
-
-### 📝 Руководство по регистрации и настройке
-
-**Шаг 1: Регистрация аккаунта Hyperliquid**
-
-1. **Посетите Hyperliquid по реферальной ссылке** (получите преимущества!):
-
- **🎁 [Зарегистрироваться на Hyperliquid - Присоединиться AITRADING](https://app.hyperliquid.xyz/join/AITRADING)**
-
-2. **Подключите кошелек**:
- - Нажмите "Connect Wallet" в правом верхнем углу
- - Выберите MetaMask, WalletConnect или другие Web3 кошельки
- - Подтвердите подключение
-
-3. **Включите торговлю**:
- - При первом подключении появится запрос на подпись сообщения
- - Это авторизует ваш кошелек для торговли (без комиссий за газ)
- - Вы увидите отображенный адрес кошелька
-
-**Шаг 2: Пополнение кошелька**
-
-1. **Мост активов в Arbitrum**:
- - Hyperliquid работает на Arbitrum L2
- - Переведите USDC с Ethereum mainnet или других сетей
- - Или напрямую выведите USDC с бирж на Arbitrum
-
-2. **Депозит в Hyperliquid**:
- - Нажмите "Deposit" в интерфейсе Hyperliquid
- - Выберите сумму USDC для депозита
- - Подтвердите транзакцию (небольшая комиссия за газ на Arbitrum)
- - Средства появятся на вашем аккаунте Hyperliquid в течение секунд
-
-**Шаг 3: Настройка Agent Wallet (Рекомендуется)**
-
-Hyperliquid поддерживает **Agent Wallets** - безопасные подкошельки специально для торговой автоматизации!
-
-⚠️ **Зачем использовать Agent Wallet:**
-- ✅ **Более безопасно**: Никогда не раскрывайте приватный ключ основного кошелька
-- ✅ **Ограниченный доступ**: У агента есть только торговые разрешения
-- ✅ **Отзывается**: Может быть отключен в любое время из интерфейса Hyperliquid
-- ✅ **Отдельные средства**: Держите основные активы в безопасности
-
-**Как создать Agent Wallet:**
-
-1. **Войдите в Hyperliquid** используя основной кошелек
- - Посетите [https://app.hyperliquid.xyz](https://app.hyperliquid.xyz)
- - Подключитесь с кошельком, который вы зарегистрировали (по реферальной ссылке)
-
-2. **Перейдите в настройки агента**:
- - Нажмите на адрес кошелька (правый верхний угол)
- - Перейдите в "Settings" → "API & Agents"
- - Или посетите: [https://app.hyperliquid.xyz/agents](https://app.hyperliquid.xyz/agents)
-
-3. **Создайте нового агента**:
- - Нажмите "Create Agent" или "Add Agent"
- - Система автоматически сгенерирует новый кошелек агента
- - **Сохраните адрес кошелька агента** (начинается с `0x`)
- - **Сохраните приватный ключ агента** (показывается только один раз!)
-
-4. **Детали Agent Wallet**:
- - Основной кошелек: Ваш подключенный кошелек (хранит средства)
- - Кошелек агента: Подкошелек для торговли (NOFX будет использовать его)
- - Приватный ключ: Нужен только для конфигурации NOFX
-
-5. **Пополните агента** (Опционально):
- - Переведите USDC с основного кошелька на кошелек агента
- - Или оставьте средства в основном кошельке (агент может торговать с него)
-
-6. **Сохраните учетные данные для NOFX**:
- - Адрес основного кошелька: `0xYourMainWalletAddress` (с `0x`)
- - Приватный ключ агента: `YourAgentPrivateKeyWithout0x` (удалите префикс `0x`)
-
----
-
-~~Настройте `config.json` для Hyperliquid~~ *Настройте через веб-интерфейс*
-
-```json
-{
- "traders": [
- {
- "id": "hyperliquid_trader",
- "name": "My Hyperliquid Trader",
- "enabled": true,
- "ai_model": "deepseek",
- "exchange": "hyperliquid",
- "hyperliquid_private_key": "your_private_key_without_0x",
- "hyperliquid_wallet_addr": "your_ethereum_address",
- "hyperliquid_testnet": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "api_server_port": 8080
-}
-```
-
-**Ключевые отличия от конфигурации Binance:**
-- Замените `binance_api_key` + `binance_secret_key` на `hyperliquid_private_key`
-- Добавьте поле `"exchange": "hyperliquid"`
-- Установите `hyperliquid_testnet: false` для мейннета (или `true` для тестнета)
-
-**⚠️ Предупреждение безопасности**: Никогда не делитесь приватным ключом! Используйте отдельный кошелек для торговли, а не основной.
-
----
-
-#### 🔶 Использование биржи Aster DEX
-
-**NOFX поддерживает Aster DEX** - децентрализованную биржу бессрочных фьючерсов, совместимую с Binance!
-
-**Почему выбрать Aster?**
-- 🎯 API совместимый с Binance (легкая миграция)
-- 🔐 Система безопасности API кошелька
-- 💰 Более низкие комиссии за торговлю
-- 🌐 Поддержка нескольких цепей (ETH, BSC, Polygon)
-- 🌍 Не нужна KYC
-
-**Шаг 1**: Зарегистрируйтесь и создайте Aster API кошелек
-
-1. Зарегистрируйтесь по [реферальной ссылке Aster](https://www.asterdex.com/en/referral/fdfc0e) (получите скидку на комиссии!)
-2. Посетите [Aster API Wallet](https://www.asterdex.com/en/api-wallet)
-3. Подключите основной кошелек (MetaMask, WalletConnect и т.д.)
-4. Нажмите "Создать API кошелек"
-5. **Сохраните эти 3 элемента немедленно:**
- - Адрес основного кошелька (User)
- - Адрес API кошелька (Signer)
- - Приватный ключ API кошелька (⚠️ показывается только один раз!)
-
-**Шаг 2**: Настройте `config.json` для Aster
-
-```json
-{
- "traders": [
- {
- "id": "aster_deepseek",
- "name": "Aster DeepSeek Trader",
- "enabled": true,
- "ai_model": "deepseek",
- "exchange": "aster",
-
- "aster_user": "0xYOUR_MAIN_WALLET_ADDRESS_HERE",
- "aster_signer": "0xYOUR_API_WALLET_SIGNER_ADDRESS_HERE",
- "aster_private_key": "your_api_wallet_private_key_without_0x_prefix",
-
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "api_server_port": 8080,
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- }
-}
-```
-
-**Ключевые поля конфигурации:**
-- `"exchange": "aster"` - Установите биржу на Aster
-- `aster_user` - Адрес вашего основного кошелька
-- `aster_signer` - Адрес API кошелька (из Шага 1)
-- `aster_private_key` - Приватный ключ API кошелька (без префикса `0x`)
-
-**⚠️ Примечания безопасности**:
-- API кошелек отдельный от основного (дополнительный уровень безопасности)
-- Никогда не делитесь приватным ключом API
-- Вы можете отозвать доступ API кошелька в любое время на [asterdex.com](https://www.asterdex.com/en/api-wallet)
-
----
-
-#### ⚔️ Экспертный режим: Конкуренция нескольких трейдеров
-
-Для запуска нескольких AI трейдеров, конкурирующих друг с другом:
-
-```json
-{
- "traders": [
- {
- "id": "qwen_trader",
- "name": "Qwen AI Trader",
- "ai_model": "qwen",
- "binance_api_key": "YOUR_BINANCE_API_KEY_1",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
- "use_qwen": true,
- "qwen_key": "sk-xxxxx",
- "deepseek_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- },
- {
- "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,
- "qwen_key": "",
- "deepseek_key": "sk-xxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**Требования для режима конкуренции:**
-- 2 отдельных Binance Futures аккаунта (разные API ключи)
-- Оба AI API ключа (Qwen + DeepSeek)
-- Больше тестовых средств (Рекомендуется: 500+ USDT на аккаунт)
-
----
-
-#### 📚 Объяснение полей конфигурации
-
-| Поле | Описание | Пример значения | Обязательно? |
-|------|----------|-----------------|--------------|
-| `id` | Уникальный идентификатор для этого трейдера | `"my_trader"` | ✅ Да |
-| `name` | Отображаемое имя | `"Мой AI Трейдер"` | ✅ Да |
-| `enabled` | Включен ли этот трейдер
Установите в `false` для пропуска запуска | `true` или `false` | ✅ Да |
-| `ai_model` | Используемый AI провайдер | `"deepseek"` или `"qwen"` или `"custom"` | ✅ Да |
-| `exchange` | Используемая биржа | `"binance"` или `"hyperliquid"` или `"aster"` | ✅ Да |
-| `binance_api_key` | Binance API ключ | `"abc123..."` | Требуется при использовании Binance |
-| `binance_secret_key` | Binance Secret ключ | `"xyz789..."` | Требуется при использовании Binance |
-| `hyperliquid_private_key` | Hyperliquid приватный ключ
⚠️ Удалите префикс `0x` | `"your_key..."` | Требуется при использовании Hyperliquid |
-| `hyperliquid_wallet_addr` | Hyperliquid адрес кошелька | `"0xabc..."` | Требуется при использовании Hyperliquid |
-| `hyperliquid_testnet` | Использовать тестнет | `true` или `false` | ❌ Нет (по умолчанию false) |
-| `use_qwen` | Использовать ли Qwen | `true` или `false` | ✅ Да |
-| `deepseek_key` | DeepSeek API ключ | `"sk-xxx"` | Требуется при использовании DeepSeek |
-| `qwen_key` | Qwen API ключ | `"sk-xxx"` | Требуется при использовании Qwen |
-| `initial_balance` | Начальный баланс для расчета P/L | `1000.0` | ✅ Да |
-| `scan_interval_minutes` | Частота решений (минуты) | `3` (рекомендуется 3-5) | ✅ Да |
-| **`leverage`** | **Конфигурация плеча (v2.0.3+)** | См. ниже | ✅ Да |
-| `btc_eth_leverage` | Максимальное плечо для BTC/ETH
⚠️ Субаккаунты: ≤5x | `5` (по умолчанию, безопасно)
`50` (максимум для основного аккаунта) | ✅ Да |
-| `altcoin_leverage` | Максимальное плечо для альткоинов
⚠️ Субаккаунты: ≤5x | `5` (по умолчанию, безопасно)
`20` (максимум для основного аккаунта) | ✅ Да |
-| `use_default_coins` | Использовать встроенный список монет
**✨ Умное значение по умолчанию: `true`** (v2.0.2+)
Автоматически включается без API | `true` или опустить | ❌ Нет
(Опционально, авто) |
-| `coin_pool_api_url` | API пользовательского пула монет
*Требуется только при `use_default_coins: false`* | `""` (пусто) | ❌ Нет |
-| `oi_top_api_url` | API открытого интереса
*Опциональные дополнительные данные* | `""` (пусто) | ❌ Нет |
-| `api_server_port` | Порт веб-панели | `8080` | ✅ Да |
-
-**Монеты по умолчанию для торговли** (когда `use_default_coins: true`):
-- BTC, ETH, SOL, BNB, XRP, DOGE, ADA, HYPE
-
----
-
-#### ⚙️ Конфигурация плеча (v2.0.3+)
-
-**Что такое конфигурация плеча?**
-
-Настройки плеча контролируют максимальное плечо, которое AI может использовать для каждой сделки. Это критически важно для управления рисками, особенно для субаккаунтов Binance, которые имеют ограничения по плечу.
-
-**Формат конфигурации:**
-
-```json
-"leverage": {
- "btc_eth_leverage": 5, // Максимальное плечо для BTC и ETH
- "altcoin_leverage": 5 // Максимальное плечо для всех других монет
-}
-```
-
-**⚠️ Важно: Ограничения субаккаунтов Binance**
-
-- **Субаккаунты**: Ограничены **≤5x плечом** от Binance
-- **Основные аккаунты**: Могут использовать до 20x (альткоины) или 50x (BTC/ETH)
-- Если вы используете субаккаунт и установите плечо >5x, сделки будут **завершаться с ошибкой**: `Subaccounts are restricted from using leverage greater than 5x`
-
-**Рекомендуемые настройки:**
-
-| Тип аккаунта | Плечо BTC/ETH | Плечо альткоинов | Уровень риска |
-|--------------|---------------|------------------|---------------|
-| **Субаккаунт** | `5` | `5` | ✅ Безопасно (по умолчанию) |
-| **Основной (Консервативно)** | `10` | `10` | 🟡 Средний |
-| **Основной (Агрессивно)** | `20` | `15` | 🔴 Высокий |
-| **Основной (Максимум)** | `50` | `20` | 🔴🔴 Очень высокий |
-
-**Примеры:**
-
-**Безопасная конфигурация (субаккаунт или консервативная):**
-```json
-"leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
-}
-```
-
-**Агрессивная конфигурация (только основной аккаунт):**
-```json
-"leverage": {
- "btc_eth_leverage": 20,
- "altcoin_leverage": 15
-}
-```
-
-**Как AI использует плечо:**
-
-- AI может выбрать **любое плечо от 1x до вашего настроенного максимума**
-- Например, с `altcoin_leverage: 20`, AI может решить использовать 5x, 10x или 20x в зависимости от рыночных условий
-- Конфигурация устанавливает **верхний лимит**, а не фиксированное значение
-- AI учитывает волатильность, соотношение риск/доход и баланс аккаунта при выборе плеча
-
----
-
-#### ⚠️ Важно: Поле `use_default_coins`
-
-**Умное поведение по умолчанию (v2.0.2+):**
-
-Система теперь автоматически устанавливает `use_default_coins: true`, если:
-- Вы не включили это поле в config.json, или
-- Вы установили его в `false`, но не предоставили `coin_pool_api_url`
-
-Это делает систему более дружелюбной для новичков! Вы даже можете полностью опустить это поле.
-
-**Примеры конфигурации:**
-
-✅ **Вариант 1: Явное указание (Рекомендуется для ясности)**
-```json
-"use_default_coins": true,
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-✅ **Вариант 2: Опустить поле (Автоматически использует монеты по умолчанию)**
-```json
-// Не включать "use_default_coins" вообще
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-⚙️ **Расширенное: Использовать внешний API**
-```json
-"use_default_coins": false,
-"coin_pool_api_url": "http://your-api.com/coins",
-"oi_top_api_url": "http://your-api.com/oi"
-```
-
----
-
-### 6. Запуск системы
-
-#### 🚀 Запуск системы (2 шага)
-
-Система состоит из **2 частей**, которые необходимо запустить отдельно:
-1. **Backend** (AI торговый мозг + API)
-2. **Frontend** (Веб-панель мониторинга)
-
----
-
-#### **Шаг 1: Запустите Backend**
-
-Откройте терминал и выполните:
-
-```bash
-# Соберите программу (первый запуск или после изменений кода)
-go build -o nofx
-
-# Запустите backend
-./nofx
-```
-
-**Вы должны увидеть:**
-
-```
-🚀 Запуск системы автоматической торговли...
-✓ Трейдер [my_trader] инициализирован
-✓ API сервер запущен на порту 8080
-📊 Начинается мониторинг торговли...
-```
-
-**⚠️ Если видите ошибки:**
-
-| Сообщение об ошибке | Решение |
-|---------------------|---------|
-| `invalid API key` | Проверьте Binance API ключи в config.json |
-| `TA-Lib not found` | Выполните `brew install ta-lib` (macOS) |
-| `port 8080 already in use` | ~~Измените `api_server_port` в config.json~~ *Измените `API_PORT` в файле .env* |
-| `DeepSeek API error` | Проверьте DeepSeek API ключ и баланс |
-
-**✅ Признаки работы Backend:**
-- Нет сообщений об ошибках
-- Появляется "Начинается мониторинг торговли..."
-- Система показывает баланс аккаунта
-- Держите это окно терминала открытым!
-
----
-
-#### **Шаг 2: Запустите Frontend**
-
-Откройте **новое окно терминала** (держите первое открытым!), затем:
-
-```bash
-cd web
-npm run dev
-```
-
-**Вы должны увидеть:**
-
-```
-VITE v5.x.x ready in xxx ms
-
-➜ Local: http://localhost:3000/
-➜ Network: use --host to expose
-```
-
-**✅ Признаки работы Frontend:**
-- Сообщение "Local: http://localhost:3000/"
-- Нет сообщений об ошибках
-- Также держите это окно терминала открытым!
-
----
-
-#### **Шаг 3: Доступ к панели**
-
-Откройте в веб-браузере:
-
-**🌐 http://localhost:3000**
-
-**Вы увидите:**
-- 📊 Баланс аккаунта в реальном времени
-- 📈 Позиции (если есть)
-- 🤖 AI логи решений
-- 📉 График капитала
-
-**Подсказки для первого использования:**
-- Первое AI решение может занять 3-5 минут
-- Начальное решение может показать "наблюдение" - это нормально
-- AI должен сначала проанализировать рынок
-
----
-
-### 7. Мониторинг системы
-
-**Что отслеживать:**
-
-✅ **Признаки здоровой системы:**
-- Backend терминал показывает циклы решений каждые 3-5 минут
-- Нет постоянных сообщений об ошибках
-- Обновляется баланс аккаунта
-- Веб-панель автоматически обновляется
-
-⚠️ **Признаки предупреждения:**
-- Повторяющиеся API ошибки
-- Нет решений более 10 минут
-- Быстро падающий баланс
-
-**Проверка состояния системы:**
-
-```bash
-# В новом окне терминала
-curl http://localhost:8080/api/health
-```
-
-Должно вернуть: `{"status":"ok"}`
-
----
-
-### 8. Остановка системы
-
-**Изящное завершение (Рекомендуется):**
-
-1. Перейдите к **Backend терминалу** (первому)
-2. Нажмите `Ctrl+C`
-3. Дождитесь сообщения "Система остановлена"
-4. Перейдите к **Frontend терминалу** (второму)
-5. Нажмите `Ctrl+C`
-
-**⚠️ Важно:**
-- Всегда останавливайте backend первым
-- Дождитесь подтверждения перед закрытием терминалов
-- Не принудительно завершайте (не закрывайте терминалы сразу)
-
----
-
-## 📖 Процесс принятия решений AI
-
-Каждый цикл принятия решений (по умолчанию 3 минуты), система работает по следующему процессу:
-
-### Шаг 1: 📊 Анализ исторической производительности (последние 20 циклов)
-- ✓ Расчет общего процента выигрышей, средней прибыли, соотношения прибыли/убытка
-- ✓ Статистика по каждой монете (процент выигрышей, средний P/L в USDT)
-- ✓ Определение лучших/худших монет по производительности
-- ✓ Список деталей последних 5 сделок с точным P/L
-- ✓ Расчет коэффициента Шарпа для оценки риска
-- 📌 **НОВОЕ (v2.0.2)**: Точный P/L в USDT с учетом плеча
-
-**↓**
-
-### Шаг 2: 💰 Получение состояния аккаунта
-- Капитал аккаунта, доступный баланс, нереализованный P/L
-- Количество позиций, общий P/L (реализованный + нереализованный)
-- Использование маржи (текущее/максимальное)
-- Индикаторы оценки риска
-
-**↓**
-
-### Шаг 3: 🔍 Анализ существующих позиций (если есть)
-- Получение рыночных данных для каждой позиции (3-минутные + 4-часовые свечи)
-- Расчет технических индикаторов (RSI, MACD, EMA)
-- Отображение длительности удержания позиции (например, "удерживается 2 часа 15 минут")
-- AI определяет, нужно ли закрыть (тейк-профит, стоп-лосс или корректировка)
-- 📌 **НОВОЕ (v2.0.2)**: Отслеживание длительности позиции помогает AI решать
-
-**↓**
-
-### Шаг 4: 🎯 Оценка новых возможностей (пул кандидатов монет)
-- Получение пула монет (2 режима):
- - 🌟 **Режим по умолчанию**: BTC, ETH, SOL, BNB, XRP и т.д.
- - ⚙️ **Расширенный режим**: AI500 (топ-20) + OI Top (топ-20)
-- Объединение, удаление дубликатов, фильтрация монет с низкой ликвидностью (OI < 15M USD)
-- Массовое получение рыночных данных и технических индикаторов
-- Подготовка полных последовательностей сырых данных для каждой монеты-кандидата
-
-**↓**
-
-### Шаг 5: 🧠 Комплексное решение AI
-- Просмотр исторической обратной связи (процент выигрышей, коэффициент P/L, лучшие/худшие монеты)
-- Получение всех данных последовательностей (свечи, индикаторы, открытый интерес)
-- Анализ Chain of Thought
-- Вывод решения: закрыть/открыть/удерживать/наблюдать
-- Включает параметры плеча, размера, стоп-лосса, тейк-профита
-- 📌 **НОВОЕ (v2.0.2)**: AI может свободно анализировать сырые последовательности, не ограничен заранее определенными индикаторами
-
-**↓**
-
-### Шаг 6: ⚡ Исполнение сделок
-- Приоритизация: сначала закрытие, затем открытие
-- Автоматическая адаптация точности (правила LOT_SIZE)
-- Предотвращение накопления позиций (отклонение дублирования монета/направление)
-- Автоматическая отмена всех ордеров после закрытия
-- Запись времени открытия для отслеживания длительности позиции
-- 📌 Отслеживание времени открытия позиции
-
-**↓**
-
-### Шаг 7: 📝 Запись логов
-- Сохранение полной записи решения в `decision_logs/`
-- Включает цепочку рассуждений, JSON решения, снимок аккаунта, результаты исполнения
-- Хранение полных данных позиции (количество, плечо, время открытия/закрытия)
-- Использование ключей `symbol_side` для предотвращения конфликтов лонг/шорт
-- 📌 **НОВОЕ (v2.0.2)**: Предотвращение конфликтов при удержании лонг + шорт, учет количества + плеча
-
-**↓**
-
-**🔄 (Повтор каждые 3-5 минут)**
-
-### Ключевые улучшения в v2.0.2
-
-**📌 Отслеживание длительности позиции:**
-- Система теперь отслеживает, как долго каждая позиция удерживается
-- Отображается в промпте пользователя: "удерживается 2 часа 15 минут"
-- Помогает AI принимать лучшие решения о том, когда выйти
-
-**📌 Точный расчет P/L:**
-- Ранее: Только процент (100U@5% = 1000U@5% = оба показывали "5.0")
-- Теперь: Реальная прибыль в USDT = Стоимость позиции × Изменение цены × Плечо
-- Пример: 1000 USDT × 5% × 20x = 1000 USDT фактической прибыли
-
-**📌 Расширенная свобода AI:**
-- AI может свободно анализировать все данные сырых последовательностей
-- Больше не ограничен заранее определенными комбинациями индикаторов
-- Может выполнять собственный анализ трендов, расчет поддержки/сопротивления
-
-**📌 Улучшенное отслеживание позиций:**
-- Использует ключ `symbol_side` (например, "BTCUSDT_long")
-- Предотвращает конфликты при одновременном удержании лонг и шорт
-- Хранит полные данные: количество, плечо, время открытия/закрытия
-
----
-
-## ⚠️ Важные предупреждения о рисках
-
-### Торговые риски
-
-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
+# Установка TA-Lib (macOS)
brew install ta-lib
-# Ubuntu
-sudo apt-get install libta-lib0-dev
+# Клонирование и настройка
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
+go mod download
+cd web && npm install && cd ..
+
+# Запуск бэкенда
+go build -o nofx && ./nofx
+
+# Запуск фронтенда (новый терминал)
+cd web && npm run 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
+1. **Настройка AI моделей** — Добавьте API ключи AI
+2. **Настройка бирж** — Установите API учётные данные бирж
+3. **Создание стратегии** — Настройте торговую стратегию в Студии стратегий
+4. **Создание трейдера** — Объедините AI модель + Биржу + Стратегию
+5. **Начало торговли** — Запустите настроенных трейдеров
---
-## 📄 Лицензия
+## Предупреждения о рисках
-Лицензия MIT - См. файл [LICENSE](LICENSE) для деталей
+1. Криптовалютные рынки крайне волатильны — AI решения не гарантируют прибыль
+2. Торговля фьючерсами использует плечо — убытки могут превысить депозит
+3. Экстремальные рыночные условия могут привести к ликвидации
---
-## 🤝 Вклад в проект
+## Лицензия
-Приветствуются 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
+**GNU Affero General Public License v3.0 (AGPL-3.0)**
---
-## 📬 Контакты
+## Контакты
-- **Twitter/X**: [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **GitHub Issues**: [Создать 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.console.aliyun.com/) - Alibaba Cloud Qwen
-- [TA-Lib](https://ta-lib.org/) - Библиотека технических индикаторов
-- [Recharts](https://recharts.org/) - Библиотека графиков React
-
----
-
-## 🔄 Журнал Изменений
-
-📖 **Для подробной истории версий и обновлений см.:**
-
-- **Русский:** [CHANGELOG.zh-CN.md](../../../CHANGELOG.zh-CN.md)
-- **English:** [CHANGELOG.md](../../../CHANGELOG.md)
-
-**Последняя Версия:** v3.0.0 (2025-10-30) - Масштабная Трансформация Архитектуры
-
-**Недавние Основные Моменты:**
-- 🚀 Полная переработка системы с веб-конфигурацией
-- 🗄️ Архитектура на основе базы данных (SQLite)
-- 🎨 Никакого редактирования JSON - вся конфигурация через веб-интерфейс
-- 🔧 Комбинируйте AI модели с любой биржей
-- 📊 Расширенный API слой с комплексными эндпоинтами
-- 🔐 Аутентификация JWT + поддержка 2FA
-- 🌐 Поддержка кастомных API (совместимых с OpenAI)
-- 📈 Система шаблонов промптов с удаленной аутентификацией
-
-**⚡ Исследуйте возможности количественной торговли с силой AI!**
-
----
-
-## ⭐ Star History
-
-[](https://star-history.com/#tinkle-community/nofx&Date)
+- **GitHub Issues**: [Создать Issue](https://github.com/NoFxAiOS/nofx/issues)
+- **Сообщество разработчиков**: [Telegram группа](https://t.me/nofx_dev_community)
diff --git a/docs/i18n/uk/README.md b/docs/i18n/uk/README.md
index 22b30607..c91414c5 100644
--- a/docs/i18n/uk/README.md
+++ b/docs/i18n/uk/README.md
@@ -1,1250 +1,98 @@
-# 🤖 NOFX - Agentic Trading OS
+# NOFX - AI Торгова Система
[](https://golang.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](LICENSE)
-[](https://amber.ac)
-**Мови / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md) | [Tiếng Việt](../vi/README.md)
-
-**📚 Документація:** [Головна](../../README.md) | [Початок роботи](../../getting-started/README.md) | [Спільнота](../../community/README.md) | [Журнал Змін](../../../CHANGELOG.md) | [⚠️ Відмова від відповідальності](../../../DISCLAIMER.md)
+**Мови:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](README.md)
---
-## 📑 Зміст
+## Криптовалютна торгова платформа на базі ШІ
-- [🚀 Універсальна AI Торгова Операційна Система](#-універсальна-ai-торгова-операційна-система)
-- [👥 Спільнота розробників](#-спільнота-розробників)
-- [🆕 Останні оновлення](#-останні-оновлення)
-- [🏗️ Технічна Архітектура](#️-технічна-архітектура)
-- [💰 Реєстрація акаунта Binance](#-реєстрація-акаунта-binance-заощаджуйте-на-комісіях)
-- [🔷 Реєстрація акаунта Hyperliquid](#-використання-біржі-hyperliquid)
-- [🔶 Реєстрація акаунта Aster DEX](#-використання-біржі-aster-dex)
-- [📸 Системні Скріншоти](#-системні-скріншоти)
-- [🎮 Швидкий Старт](#-швидкий-старт)
-- [📊 AI Модель](#-ai-модель)
-- [📈 Огляд Продуктивності](#-огляд-продуктивності)
-- [📄 Ліцензія](#-ліцензія)
-- [🤝 Внесок у проєкт](#-внесок-у-проєкт)
-- [📬 Контакти](#-контакти)
-- [🙏 Подяки](#-подяки)
-- [🔄 Журнал Змін](#-журнал-змін)
+**NOFX** — це open-source AI торгова система, що дозволяє запускати кілька AI моделей для автоматичної торгівлі криптовалютними ф'ючерсами. Налаштовуйте стратегії через веб-інтерфейс, відстежуйте ефективність у реальному часі та дозвольте AI агентам конкурувати за найкращий торговий підхід.
+
+### Основні функції
+
+- **Мульти-AI підтримка**: Запускайте DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi — перемикайтеся між моделями будь-коли
+- **Мульти-біржа**: Торгуйте на Binance, Bybit, OKX, Hyperliquid, Aster DEX, Lighter з єдиної платформи
+- **Студія стратегій**: Візуальний конструктор стратегій з джерелами монет, індикаторами та контролем ризиків
+- **Режим AI-змагання**: Кілька AI трейдерів змагаються в реальному часі, відстеження ефективності пліч-о-пліч
+- **Веб-конфігурація**: Без редагування JSON — налаштування всього через веб-інтерфейс
+- **Панель реального часу**: Живі позиції, відстеження P/L, логи рішень AI з ланцюжком міркувань
+
+### За підтримки [Amber.ac](https://amber.ac)
+
+> **Попередження про ризики**: Ця система експериментальна. AI автоторгівля несе значні ризики. Наполегливо рекомендується використовувати лише для навчання/досліджень або тестування з невеликими сумами!
+
+## Спільнота розробників
+
+Приєднуйтесь до Telegram спільноти: **[NOFX Developer Community](https://t.me/nofx_dev_community)**
---
-## 🚀 Універсальна AI Торгова Операційна Система
+## Швидкий старт
-**NOFX** - це **універсальна Agentic Trading OS**, побудована на єдиній архітектурі. Ми успішно замкнули цикл на криптовалютних ринках: **"Рішення Multi-Agent → Єдиний Контроль Ризиків → Виконання з Низькою Затримкою → Бектестинг Реальних/Паперових Рахунків"**, і зараз розширюємо цей же технологічний стек на **акції, ф'ючерси, опціони, форекс та всі фінансові ринки**.
-
-### 🎯 Основні Можливості
-
-- **Універсальний Шар Даних та Бектестингу**: Крос-ринкове, крос-таймфреймове, крос-біржеве єдине представлення та бібліотека факторів, що накопичує переносиму "пам'ять стратегій"
-- **Multi-Agent Самогра та Самоеволюція**: Стратегії автоматично конкурують і вибирають кращі, безперервно ітеруючись на основі PnL на рівні рахунку та обмежень ризиків
-- **Інтегроване Виконання та Контроль Ризиків**: Маршрутизація з низькою затримкою, пісочниця прослизання/контролю ризиків, ліміти на рівні рахунку, перемикання ринків одним кліком
-
-### 🏢 За підтримки [Amber.ac](https://amber.ac)
-
-### 👥 Основна Команда
-
-- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **Єдиний Офіційний Twitter** - [@nofx_official](https://x.com/nofx_official)
-
-### 💼 Відкритий Посівний Раунд Фінансування
-
-Ми зараз залучаємо **посівний раунд**.
-
-**З питань інвестицій**, пишіть в DM **Tinkle** в Twitter.
-
----
-
-> ⚠️ **Попередження про ризики**: Ця система експериментальна. Автоматична торгівля з AI несе значні ризики. Наполегливо рекомендується використовувати лише для навчання/досліджень або тестування з невеликими сумами!
-
-## 👥 Спільнота розробників
-
-Приєднуйтесь до нашої спільноти розробників у Telegram для обговорення, обміну ідеями та отримання підтримки:
-
-**💬 [Спільнота розробників NOFX](https://t.me/nofx_dev_community)**
-
----
-
-## 🆕 Останні оновлення
-
-### 🚀 Підтримка кількох бірж!
-
-NOFX тепер підтримує **три основні біржі**: Binance, Hyperliquid та Aster DEX!
-
-#### **Біржа Hyperliquid**
-
-Високопродуктивна децентралізована біржа безстрокових ф'ючерсів!
-
-**Ключові особливості:**
-- ✅ Повна підтримка торгівлі (лонг/шорт, плече, стоп-лосс/тейк-профіт)
-- ✅ Автоматична обробка точності (розмір та ціна ордера)
-- ✅ Єдиний інтерфейс трейдера (безшовне перемикання бірж)
-- ✅ Підтримка мейннету та тестнету
-- ✅ Не потрібні API ключі - тільки приватний ключ Ethereum
-
-**Чому Hyperliquid?**
-- 🔥 Нижчі комісії ніж на централізованих біржах
-- 🔒 Без зберігання - ви контролюєте свої кошти
-- ⚡ Швидке виконання з розрахунком на ланцюзі
-- 🌍 Не потрібна KYC
-
-**Швидкий старт:**
-1. Отримайте приватний ключ MetaMask (видаліть префікс `0x`)
-2. ~~Встановіть `"exchange": "hyperliquid"` в config.json~~ *Налаштуйте через веб-інтерфейс*
-3. Додайте `"hyperliquid_private_key": "your_key"`
-4. Почніть торгувати!
-
-Див. [Посібник з конфігурації](#-використання-біржі-hyperliquid).
-
-#### **Біржа Aster DEX** (НОВЕ! v2.0.2)
-
-Децентралізована біржа безстрокових ф'ючерсів, сумісна з Binance!
-
-**Ключові особливості:**
-- ✅ API в стилі Binance (легка міграція з Binance)
-- ✅ Web3 автентифікація гаманця (безпечно та децентралізовано)
-- ✅ Повна підтримка торгівлі з автоматичною обробкою точності
-- ✅ Нижчі комісії за торгівлю ніж CEX
-- ✅ Сумісність з EVM (Ethereum, BSC, Polygon тощо)
-
-**Чому Aster?**
-- 🎯 **API сумісний з Binance** - потрібні мінімальні зміни коду
-- 🔐 **Система API гаманця** - окремий торговий гаманець для безпеки
-- 💰 **Конкурентні комісії** - нижче ніж більшість централізованих бірж
-- 🌐 **Підтримка кількох ланцюгів** - торгуйте на вашому улюбленому EVM ланцюзі
-
-**Швидкий старт:**
-1. Зареєструйтеся за [реферальним посиланням Aster](https://www.asterdex.com/en/referral/fdfc0e) (отримайте знижку на комісії!)
-2. Відвідайте [Aster API Wallet](https://www.asterdex.com/en/api-wallet)
-3. Підключіть основний гаманець і створіть API гаманець
-4. Скопіюйте адресу API Signer та приватний ключ
-5. Встановіть `"exchange": "aster"` в config.json
-6. Додайте `"aster_user"`, `"aster_signer"` та `"aster_private_key"`
-
----
-
-## 📸 Скриншоти
-
-### 🏆 Режим змагання - Битва AI в реальному часі
-
-*Лідерборд з кількома AI та графіки порівняння продуктивності в реальному часі показують битву Qwen проти DeepSeek*
-
-### 📊 Деталі трейдера - Повна торгова панель
-
-*Професійний торговий інтерфейс з кривими капіталу, живими позиціями та логами рішень AI з розкриваємими вхідними промптами та ланцюгом міркувань*
-
----
-
-> 📘 **Примітка**: Це спрощена українська версія README. Для отримання повної технічної документації, включаючи архітектуру системи, API-інтерфейси та розширені конфігурації, див. [Англійську версію](../../../README.md) або [Китайську версію](../zh-CN/README.md).
-
----
-
-## ✨ Поточна реалізація - Ринки криптовалют
-
-NOFX наразі **повністю працює на криптовалютних ринках** з наступними перевіреними можливостями:
-
-### 🏆 Структура конкуренції Multi-Agent
-- **Реальна битва AI-агентів**: Торгове змагання моделей Qwen vs DeepSeek у реальному часі
-- **Незалежне управління рахунками**: Кожен агент веде окремі журнали рішень та метрики продуктивності
-- **Порівняння продуктивності в реальному часі**: Відстеження ROI в реальному часі, статистика вінрейту, прямий аналіз
-- **Цикл самоеволюції**: Агенти вчаться на історичній продуктивності, постійно вдосконалюючись
-
-### 🧠 AI Самонавчання та Оптимізація
-- **Система історичного зворотного зв'язку**: Аналіз останніх 20 торгових циклів перед кожним рішенням
-- **Інтелектуальний аналіз продуктивності**:
- - Визначає кращі/гірші активи за продуктивністю
- - Розраховує вінрейт, коефіцієнт прибутку/збитку, середній прибуток у реальних USDT
- - Уникає повторюваних помилок (патерни послідовних збитків)
- - Посилює успішні стратегії (високі патерни вінрейту)
-- **Динамічне коригування стратегії**: AI автономно регулює торговий стиль на основі результатів бектесту
-
-### 📊 Універсальний шар ринкових даних (Криптореалізація)
-- **Багатотаймфреймовий аналіз**: 3-хвилинні реальні дані + 4-годинні трендові дані
-- **Технічні індикатори**: EMA20/50, MACD, RSI(7/14), ATR
-- **Відстеження відкритого інтересу**: Аналіз настроїв ринку, грошових потоків
-- **Фільтрація ліквідності**: Автоматична фільтрація активів з низькою ліквідністю (<15M USD)
-- **Підтримка крос-біржової торгівлі**: Binance, Hyperliquid, Aster DEX, єдиний інтерфейс даних
-
-### 🎯 Єдина система контролю ризиків
-- **Ліміти позицій**: Ліміти на актив (Альткоїни≤1.5x капітал, BTC/ETH≤10x капітал)
-- **Налаштоване кредитне плече**: Динамічне налаштування від 1x до 50x на основі класу активів та типу рахунку
-- **Управління маржею**: Загальне використання≤90%, AI контролює розподіл
-- **Примусове співвідношення ризик/винагорода**: Обов'язкове співвідношення стоп-лосс/тейк-профіт ≥1:2
-- **Захист від нашарування**: Запобігає дублюванню позицій по одному активу/напрямку
-
-### ⚡ Рушій виконання з низькою затримкою
-- **Інтеграція API множини бірж**: Binance Futures, Hyperliquid DEX, Aster DEX
-- **Автоматична обробка точності**: Інтелектуальне форматування розміру та ціни ордера для кожної біржі
-- **Пріоритетне виконання**: Спочатку закриття існуючих позицій, потім відкриття нових
-- **Контроль прослизання**: Перевірка перед виконанням, перевірка точності в реальному часі
-
-### 🎨 Професійний інтерфейс моніторингу
-- **Dashboard у стилі Binance**: Професійна темна тема з оновленнями в реальному часі
-- **Криві капіталу**: Історичне відстеження вартості рахунку (перемикання USD/відсоток)
-- **Графіки продуктивності**: Порівняння ROI множини AI-агентів, оновлення в реальному часі
-- **Повні журнали рішень**: Повне міркування ланцюга думок (CoT) для кожної угоди
-- **5-секундне оновлення даних**: Оновлення рахунку, позицій та P&L у реальному часі
-
----
-
-## 🔮 Дорожня карта - Розширення універсального ринку
-
-Місія NOFX - стати **універсальною AI-торговою ОС для всіх фінансових ринків**.
-
-**Бачення:** Одна архітектура. Одна агентна структура. Всі ринки.
-
-**Розширювані ринки:**
-- 📈 **Фондові ринки**: Акції США, акції Китаю, Гонконгські акції
-- 📊 **Ф'ючерсні ринки**: Товарні ф'ючерси, індексні ф'ючерси
-- 🎯 **Опціонна торгівля**: Опціони на акції, крипто-опціони
-- 💱 **Ринок Forex**: Основні валютні пари, крос-пари
-
-**Майбутні функції:**
-- Розширені можливості AI (GPT-4, Claude 3, Gemini Pro, гнучкі шаблони промптів)
-- Інтеграція нових бірж (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- Рефакторинг структури проекту (висока зв'язність, низька зв'язаність, принципи SOLID)
-- Поліпшення безпеки (AES-256 шифрування API-ключів, RBAC, покращена 2FA)
-- Поліпшення UX (відгук мобільних пристроїв, графіки TradingView, система сповіщень)
-
-📖 **Для детальної дорожньої карти та графіків див.:**
-- **English:** [Roadmap Documentation](../../roadmap/README.md)
-- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
-
----
-
-## ✨ Основні можливості
-
-### 🏆 Режим змагання кількох 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 капітал рахунку
-- **Налаштовуване плече** (v2.0.3+):
- - Встановіть максимальне плече в config.json
- - За замовчуванням: 5x для всіх монет (безпечно для субакаунтів)
- - Основні акаунти можуть збільшити: Альткоїни до 20x, BTC/ETH до 50x
- - ⚠️ Субакаунти Binance обмежені ≤5x плечем
-- **Управління маржею**: Загальне використання ≤90%, AI приймає автономні рішення
-- **Співвідношення ризик/дохід**: Обов'язкове ≥1:2 (стоп-лосс:тейк-профіт)
-- **Запобігання накопиченню позицій**: Заборона дублювання відкриття тієї ж монети/напрямку
-
-### 🎨 Професійний UI
-- **Професійний торговий інтерфейс**: Візуальний дизайн у стилі Binance
-- **Темна тема**: Класична колірна схема (Золотий #F0B90B + темний фон)
-- **Дані в реальному часі**: Оновлення кожні 5 секунд для рахунків, позицій, графіків
-- **Крива капіталу**: Графік історичного тренду вартості рахунку (перемикання USD/відсоток)
-- **Графік порівняння продуктивності**: Порівняння ROI кількох AI в реальному часі
-- **Плавні анімації**: Плавні ефекти наведення, переходів та завантаження
-
-### 📝 Повний запис рішень
-- **Ланцюг міркувань**: Повний процес міркувань AI (CoT)
-- **Історична продуктивність**: Загальний відсоток виграшів, середній прибуток, співвідношення прибутку/збитку
-- **Останні угоди**: Деталі останніх 5 угод (ціна входу → ціна виходу → P/L%)
-- **Статистика по монетах**: Продуктивність по кожній монеті (відсоток виграшів, середній P/L)
-- **JSON логи**: Повні записи рішень для пост-аналізу
-
----
-
-## 🔮 Дорожня Карта - Розширення на Універсальні Ринки
-
-Місія NOFX - стати **Універсальною AI Торговою Операційною Системою** для всіх фінансових ринків.
-
-**Бачення:** Та сама архітектура. Та сама агентна структура. Всі ринки.
-
-**Розширення на Ринки:**
-- 📈 **Фондові Ринки**: Акції США, A-акції, Гонконгська біржа
-- 📊 **Ринки Ф'ючерсів**: Товарні ф'ючерси, індексні ф'ючерси
-- 🎯 **Опціонна Торгівля**: Опціони на акції, крипто опціони
-- 💱 **Ринки Форекс**: Основні валютні пари, крос-курси
-
-**Майбутні Функції:**
-- Розширені AI можливості (GPT-4, Claude 3, Gemini Pro, гнучкі шаблони промптів)
-- Нові інтеграції бірж (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- Рефакторинг структури проєкту (висока зв'язність, низька зчепленість, принципи SOLID)
-- Покращення безпеки (AES-256 шифрування API ключів, RBAC, покращення 2FA)
-- Покращення користувацького досвіду (мобільний інтерфейс, графіки TradingView, система сповіщень)
-
-📖 **Для детальної дорожньої карти та термінів див.:**
-- **English:** [Roadmap Documentation](../../roadmap/README.md)
-- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
-
----
-
-## 🏗️ Технічна Архітектура
-
-NOFX побудовано на сучасній модульній архітектурі:
-
-- **Backend:** Go з фреймворком Gin, база даних SQLite
-- **Frontend:** React 18 + TypeScript + Vite + TailwindCSS
-- **AI інтеграція:** DeepSeek, Qwen, кастомні API (сумісні з OpenAI)
-- **Підтримка бірж:** Binance Futures, Hyperliquid DEX, Aster DEX
-- **Аутентифікація:** JWT токени + підтримка 2FA
-- **Управління станом:** Zustand (легковагове)
-- **Отримання даних:** SWR з опитуванням 5-10с
-- **Графіки:** Recharts для кривих капіталу та порівнянь
-
-**Ключові особливості:**
-- 🔧 Архітектура на основі бази даних (конфігурація через веб-інтерфейс, без JSON)
-- 🎯 Комбінуйте будь-яку AI модель з будь-якою біржею
-- 📊 RESTful API з комплексними ендпоінтами
-- 🔐 Безпечне управління облікових даних
-- 📈 Система шаблонів промптів з віддаленою аутентифікацією
-
-📖 **Детальна документація по архітектурі:**
-- **English:** [Architecture Documentation](../../architecture/README.md)
-- **中文:** [架构文档](../../architecture/README.zh-CN.md)
-
----
-
-## 💰 Реєстрація акаунта Binance (Заощаджуйте на комісіях!)
-
-Перед використанням цієї системи вам потрібен акаунт Binance Futures. **Використовуйте наше реферальне посилання для отримання знижки на комісії:**
-
-**🎁 [Зареєструватися на Binance - Отримати знижку](https://www.binance.com/join?ref=NOFXUK)**
-
-### Кроки реєстрації:
-
-1. **Натисніть на посилання вище** щоб перейти на сторінку реєстрації Binance
-2. **Завершіть реєстрацію** використовуючи email/номер телефону
-3. **Пройдіть KYC верифікацію** (потрібно для торгівлі ф'ючерсами)
-4. **Активуйте акаунт Futures**:
- - Перейдіть на головну сторінку Binance → Деривативи → USD-M Ф'ючерси
- - Натисніть "Відкрити зараз" для активації торгівлі ф'ючерсами
-5. **Створіть API ключ**:
- - Перейдіть в Акаунт → Управління API
- - Створіть новий API ключ, **увімкніть дозвіл "Futures"**
- - Збережіть API Key та Secret Key (необхідно для config.json)
- - **Важливо**: Додайте свою IP адресу до білого списку для безпеки
-
-### Переваги знижки:
-
-- ✅ **Спотова торгівля**: Знижка до 30% на комісії
-- ✅ **Торгівля ф'ючерсами**: Знижка до 30% на комісії
-- ✅ **Довічна**: Постійна знижка на всі угоди
-
----
-
-## 🚀 Швидкий старт
-
-### 🐳 Варіант A: Docker розгортання в один клік (НАЙПРОСТІШЕ - Рекомендується для новачків!)
-
-**⚡ Почніть торгувати за 3 прості кроки з Docker - Не потрібно нічого встановлювати!**
-
-Docker автоматично обробляє всі залежності (Go, Node.js, TA-Lib) та налаштування середовища. Ідеально для новачків!
-
-#### Крок 1: Підготуйте конфігурацію
-```bash
-# Скопіюйте шаблон конфігурації
-cp config.json.example config.json
-
-# Відредагуйте та заповніть ваші API ключі
-nano config.json # або використайте будь-який редактор
-```
-
-#### Крок 2: Запуск в один клік
-```bash
-# Варіант 1: Використайте зручний скрипт (Рекомендується)
-chmod +x scripts/start.sh
-./scripts/start.sh start --build
-
-# Варіант 2: Використайте docker compose безпосередньо
-# Цей проект використовує синтаксис Docker Compose V2 (з пробілами)
-# Якщо у вас встановлена стара версія `docker-compose`, оновіть до Docker Desktop або Docker 20.10+
-docker compose up -d --build
-```
-
-#### Крок 3: Доступ до панелі
-Відкрийте у браузері: **http://localhost:3000**
-
-**От і все! 🎉** Ваша AI торгова система зараз працює!
-
-#### Керування вашою системою
-```bash
-./scripts/start.sh logs # Переглянути логи
-./scripts/start.sh status # Перевірити статус
-./scripts/start.sh stop # Зупинити сервіси
-./scripts/start.sh restart # Перезапустити сервіси
-```
-
-**📖 Детальний посібник з розгортання Docker, усунення несправностей та розширеної конфігурації:**
-- **Українська**: Дивіться документацію Docker (скоро буде доступно)
-- **English**: See [DOCKER_DEPLOY.en.md](DOCKER_DEPLOY.en.md)
-- **中文**: 查看 [DOCKER_DEPLOY.md](DOCKER_DEPLOY.md)
-- **日本語**: [DOCKER_DEPLOY.ja.md](DOCKER_DEPLOY.ja.md)を参照
-
----
-
-### 📦 Варіант B: Ручне встановлення (Для розробників)
-
-**Примітка**: Якщо ви використали розгортання Docker вище, пропустіть цей розділ. Ручне встановлення потрібне лише якщо ви хочете змінити код або запустити без Docker.
-
-### 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. Клонування проєкту
+### Варіант 1: Docker розгортання (рекомендовано)
```bash
-git clone https://github.com/tinkle-community/nofx.git
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
+chmod +x ./start.sh
+./start.sh start --build
```
-### 3. Встановлення залежностей
+Доступ до веб-інтерфейсу: **http://localhost:3000**
+
+### Варіант 2: Ручна установка
-**Backend:**
```bash
+# Вимоги: Go 1.21+, Node.js 18+, TA-Lib
+
+# Встановлення TA-Lib (macOS)
+brew install ta-lib
+
+# Клонування та налаштування
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
go mod download
-```
+cd web && npm install && cd ..
-**Frontend:**
-```bash
-cd web
-npm install
-cd ..
-```
+# Запуск бекенду
+go build -o nofx && ./nofx
-### 4. Отримання AI API ключів
-
-Перед налаштуванням системи вам необхідно отримати AI API ключ. Виберіть одного з наступних AI провайдерів:
-
-#### Варіант 1: DeepSeek (Рекомендується для новачків)
-
-**Чому DeepSeek?**
-- 💰 Дешевше ніж GPT-4 (приблизно 1/10 вартості)
-- 🚀 Швидкий час відгуку
-- 🎯 Відмінна якість торгових рішень
-- 🌍 Доступний глобально без VPN
-
-**Як отримати DeepSeek API ключ:**
-
-1. **Відвідайте**: [https://platform.deepseek.com](https://platform.deepseek.com)
-2. **Зареєструйтеся**: Використовуючи email/номер телефону
-3. **Підтвердіть**: Завершіть підтвердження email/телефону
-4. **Поповніть**: Додайте баланс на акаунт
- - Мінімум: ~$5 USD
- - Рекомендується: $20-50 USD для тестування
-5. **Створіть API ключ**:
- - Перейдіть у розділ API Keys
- - Натисніть "Створити новий ключ"
- - Скопіюйте та збережіть ключ (починається з `sk-`)
- - ⚠️ **Важливо**: Збережіть негайно - пізніше побачити не зможете!
-
-**Ціна**: Приблизно $0.14 за мільйон токенів (дуже дешево!)
-
-#### Варіант 2: Qwen (Alibaba Cloud Tongyi Qianwen)
-
-**Як отримати Qwen API ключ:**
-
-1. **Відвідайте**: [https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
-2. **Зареєструйтеся**: Використовуючи акаунт Alibaba Cloud
-3. **Активуйте сервіс**: Активуйте DashScope сервіс
-4. **Створіть API ключ**:
- - Перейдіть в управління API ключами
- - Створіть новий ключ
- - Скопіюйте та збережіть (починається з `sk-`)
-
-**Примітка**: Може знадобитися китайський номер телефону для реєстрації
-
----
-
-### 5. Конфігурація системи
-
-**Доступні два режими конфігурації:**
-- **🌟 Режим новачка**: Один трейдер + монети за замовчуванням (Рекомендується!)
-- **⚔️ Експертний режим**: Змагання кількох трейдерів
-
-#### 🌟 Конфігурація режиму новачка (Рекомендується)
-
-**Крок 1**: Скопіюйте та перейменуйте файл прикладу конфігурації
-
-```bash
-cp config.json.example config.json
-```
-
-**Крок 2**: Відредагуйте `config.json` та заповніть ваші API ключі
-
-```json
-{
- "traders": [
- {
- "id": "my_trader",
- "name": "Мій AI Трейдер",
- "ai_model": "deepseek",
- "binance_api_key": "YOUR_BINANCE_API_KEY",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY",
- "use_qwen": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "qwen_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- },
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**Крок 3**: Замініть заповнювачі вашими фактичними ключами
-
-| Заповнювач | Замінити на | Де отримати |
-|------------|-------------|-------------|
-| `YOUR_BINANCE_API_KEY` | Ваш Binance API ключ | Binance → Акаунт → Управління API |
-| `YOUR_BINANCE_SECRET_KEY` | Ваш Binance Secret ключ | Те ж саме |
-| `sk-xxxxxxxxxxxxx` | Ваш DeepSeek API ключ | [platform.deepseek.com](https://platform.deepseek.com) |
-
-**Крок 4**: Налаштуйте початковий баланс (опціонально)
-
-- `initial_balance`: Встановіть ваш фактичний баланс Binance Futures акаунта
-- Використовується для розрахунку P/L відсотків
-- Приклад: Якщо у вас 500 USDT, встановіть `"initial_balance": 500.0`
-
-**✅ Контрольний список конфігурації:**
-
-- [ ] Binance API ключ заповнено (без лапок)
-- [ ] Binance Secret ключ заповнено (без лапок)
-- [ ] DeepSeek API ключ заповнено (починається з `sk-`)
-- [ ] `use_default_coins` встановлено в `true` (для новачків)
-- [ ] `initial_balance` відповідає балансу акаунта
-- [ ] Файл збережено як `config.json` (не `.example`)
-
----
-
-#### 🔷 Використання біржі Hyperliquid
-
-**NOFX підтримує Hyperliquid** - високопродуктивну децентралізовану біржу безстрокових ф'ючерсів!
-
-**Чому обрати Hyperliquid?**
-- 🚀 **Висока продуктивність**: Блискавично швидке виконання на блокчейні L1
-- 💰 **Низькі комісії**: Конкурентні комісії мейкера/тейкера
-- 🔐 **Без зберігання**: Ваші ключі, ваші монети
-- 🌐 **Без KYC**: Анонімна торгівля
-- 💎 **Глибока ліквідність**: Книга ордерів інституційного рівня
-
----
-
-### 📝 Посібник з реєстрації та налаштування
-
-**Крок 1: Зареєструйте акаунт Hyperliquid**
-
-1. **Відвідайте Hyperliquid за реферальним посиланням** (отримайте переваги!):
-
- **🎁 [Зареєструватися на Hyperliquid - Приєднатися до AITRADING](https://app.hyperliquid.xyz/join/AITRADING)**
-
-2. **Підключіть свій гаманець**:
- - Натисніть "Connect Wallet" у верхньому правому куті
- - Виберіть MetaMask, WalletConnect або інші Web3 гаманці
- - Підтвердіть підключення
-
-3. **Увімкніть торгівлю**:
- - Перше підключення запропонує вам підписати повідомлення
- - Це авторизує ваш гаманець для торгівлі (без комісій за газ)
- - Ви побачите відображену адресу вашого гаманця
-
-**Крок 2: Поповніть свій гаманець**
-
-1. **Переведіть активи на Arbitrum**:
- - Hyperliquid працює на Arbitrum L2
- - Переведіть USDC з Ethereum мейннету або інших ланцюгів
- - Або безпосередньо виведіть USDC з бірж на Arbitrum
-
-2. **Внесіть депозит на Hyperliquid**:
- - Натисніть "Deposit" в інтерфейсі Hyperliquid
- - Виберіть суму USDC для депозиту
- - Підтвердіть транзакцію (невелика комісія за газ на Arbitrum)
- - Кошти з'являться на вашому рахунку Hyperliquid протягом кількох секунд
-
-**Крок 3: Налаштуйте Agent Wallet (Рекомендується)**
-
-Hyperliquid підтримує **Agent Wallets** - безпечні під-гаманці спеціально для автоматизації торгівлі!
-
-⚠️ **Чому використовувати Agent Wallet:**
-- ✅ **Більше безпеки**: Ніколи не розкривайте приватний ключ основного гаманця
-- ✅ **Обмежений доступ**: Agent має лише торгові дозволи
-- ✅ **Відкликання**: Можна відключити в будь-який час з інтерфейсу Hyperliquid
-- ✅ **Окремі кошти**: Тримайте основні активи в безпеці
-
-**Як створити Agent Wallet:**
-
-1. **Увійдіть на Hyperliquid** використовуючи основний гаманець
- - Відвідайте [https://app.hyperliquid.xyz](https://app.hyperliquid.xyz)
- - Підключіться з гаманцем, який ви зареєстрували (за реферальним посиланням)
-
-2. **Перейдіть до налаштувань Agent**:
- - Натисніть на адресу вашого гаманця (верхній правий кут)
- - Перейдіть до "Settings" → "API & Agents"
- - Або відвідайте: [https://app.hyperliquid.xyz/agents](https://app.hyperliquid.xyz/agents)
-
-3. **Створіть новий Agent**:
- - Натисніть "Create Agent" або "Add Agent"
- - Система автоматично згенерує новий agent гаманець
- - **Збережіть адресу agent гаманця** (починається з `0x`)
- - **Збережіть приватний ключ agent** (показується лише один раз!)
-
-4. **Деталі Agent Wallet**:
- - Main Wallet: Ваш підключений гаманець (зберігає кошти)
- - Agent Wallet: Під-гаманець для торгівлі (NOFX використовуватиме його)
- - Private Key: Потрібен лише для конфігурації NOFX
-
-5. **Поповніть свій Agent** (Опціонально):
- - Переведіть USDC з основного гаманця на agent гаманець
- - Або тримайте кошти в основному гаманці (agent може торгувати з нього)
-
-6. **Збережіть облікові дані для NOFX**:
- - Адреса основного гаманця: `0xYourMainWalletAddress` (з `0x`)
- - Приватний ключ Agent: `YourAgentPrivateKeyWithout0x` (видаліть префікс `0x`)
-
----
-
-~~Налаштуйте `config.json` для Hyperliquid~~ *Налаштуйте через веб-інтерфейс*
-
-```json
-{
- "traders": [
- {
- "id": "hyperliquid_trader",
- "name": "My Hyperliquid Trader",
- "enabled": true,
- "ai_model": "deepseek",
- "exchange": "hyperliquid",
- "hyperliquid_private_key": "your_private_key_without_0x",
- "hyperliquid_wallet_addr": "your_ethereum_address",
- "hyperliquid_testnet": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "api_server_port": 8080
-}
-```
-
-**Ключові відмінності від конфігурації Binance:**
-- Замініть `binance_api_key` + `binance_secret_key` на `hyperliquid_private_key`
-- Додайте поле `"exchange": "hyperliquid"`
-- Встановіть `hyperliquid_testnet: false` для мейннету (або `true` для тестнету)
-
-**⚠️ Попередження безпеки**: Ніколи не діліться приватним ключем! Використовуйте окремий гаманець для торгівлі, а не основний.
-
----
-
-#### 🔶 Використання біржі Aster DEX
-
-**NOFX підтримує Aster DEX** - децентралізовану біржу безстрокових ф'ючерсів, сумісну з Binance!
-
-**Чому обрати Aster?**
-- 🎯 API сумісний з Binance (легка міграція)
-- 🔐 Система безпеки API гаманця
-- 💰 Нижчі комісії за торгівлю
-- 🌐 Підтримка кількох ланцюгів (ETH, BSC, Polygon)
-- 🌍 Не потрібна KYC
-
-**Крок 1**: Зареєструйтеся та створіть Aster API гаманець
-
-1. Зареєструйтеся за [реферальним посиланням Aster](https://www.asterdex.com/en/referral/fdfc0e) (отримайте знижку на комісії!)
-2. Відвідайте [Aster API Wallet](https://www.asterdex.com/en/api-wallet)
-3. Підключіть основний гаманець (MetaMask, WalletConnect тощо)
-4. Натисніть "Створити API гаманець"
-5. **Збережіть ці 3 елементи негайно:**
- - Адреса основного гаманця (User)
- - Адреса API гаманця (Signer)
- - Приватний ключ API гаманця (⚠️ показується лише один раз!)
-
-**Крок 2**: Налаштуйте `config.json` для Aster
-
-```json
-{
- "traders": [
- {
- "id": "aster_deepseek",
- "name": "Aster DeepSeek Trader",
- "enabled": true,
- "ai_model": "deepseek",
- "exchange": "aster",
-
- "aster_user": "0xYOUR_MAIN_WALLET_ADDRESS_HERE",
- "aster_signer": "0xYOUR_API_WALLET_SIGNER_ADDRESS_HERE",
- "aster_private_key": "your_api_wallet_private_key_without_0x_prefix",
-
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "api_server_port": 8080,
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- }
-}
-```
-
-**Ключові поля конфігурації:**
-- `"exchange": "aster"` - Встановіть біржу на Aster
-- `aster_user` - Адреса вашого основного гаманця
-- `aster_signer` - Адреса API гаманця (з Кроку 1)
-- `aster_private_key` - Приватний ключ API гаманця (без префікса `0x`)
-
-**⚠️ Примітки безпеки**:
-- API гаманець окремий від основного (додатковий рівень безпеки)
-- Ніколи не діліться приватним ключем API
-- Ви можете відкликати доступ API гаманця в будь-який час на [asterdex.com](https://www.asterdex.com/en/api-wallet)
-
----
-
-#### ⚔️ Експертний режим: Змагання кількох трейдерів
-
-Для запуску кількох AI трейдерів, що змагаються один з одним:
-
-```json
-{
- "traders": [
- {
- "id": "qwen_trader",
- "name": "Qwen AI Trader",
- "ai_model": "qwen",
- "binance_api_key": "YOUR_BINANCE_API_KEY_1",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
- "use_qwen": true,
- "qwen_key": "sk-xxxxx",
- "deepseek_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- },
- {
- "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,
- "qwen_key": "",
- "deepseek_key": "sk-xxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**Вимоги для режиму змагання:**
-- 2 окремі Binance Futures акаунти (різні API ключі)
-- Обидва AI API ключі (Qwen + DeepSeek)
-- Більше тестових коштів (Рекомендується: 500+ USDT на акаунт)
-
----
-
-#### 📚 Пояснення полів конфігурації
-
-| Поле | Опис | Приклад значення | Обов'язково? |
-|------|------|------------------|--------------|
-| `id` | Унікальний ідентифікатор для цього трейдера | `"my_trader"` | ✅ Так |
-| `name` | Відображуване ім'я | `"Мій AI Трейдер"` | ✅ Так |
-| `enabled` | Чи увімкнений цей трейдер
Встановіть в `false` для пропуску запуску | `true` або `false` | ✅ Так |
-| `ai_model` | Використовуваний AI провайдер | `"deepseek"` або `"qwen"` або `"custom"` | ✅ Так |
-| `exchange` | Використовувана біржа | `"binance"` або `"hyperliquid"` або `"aster"` | ✅ Так |
-| `binance_api_key` | Binance API ключ | `"abc123..."` | Потрібно при використанні Binance |
-| `binance_secret_key` | Binance Secret ключ | `"xyz789..."` | Потрібно при використанні Binance |
-| `hyperliquid_private_key` | Hyperliquid приватний ключ
⚠️ Видаліть префікс `0x` | `"your_key..."` | Потрібно при використанні Hyperliquid |
-| `hyperliquid_wallet_addr` | Hyperliquid адреса гаманця | `"0xabc..."` | Потрібно при використанні Hyperliquid |
-| `hyperliquid_testnet` | Використовувати тестнет | `true` або `false` | ❌ Ні (за замовчуванням false) |
-| `use_qwen` | Використовувати чи Qwen | `true` або `false` | ✅ Так |
-| `deepseek_key` | DeepSeek API ключ | `"sk-xxx"` | Потрібно при використанні DeepSeek |
-| `qwen_key` | Qwen API ключ | `"sk-xxx"` | Потрібно при використанні Qwen |
-| `initial_balance` | Початковий баланс для розрахунку P/L | `1000.0` | ✅ Так |
-| `scan_interval_minutes` | Частота рішень (хвилини) | `3` (рекомендується 3-5) | ✅ Так |
-| **`leverage`** | **Конфігурація плеча (v2.0.3+)** | Див. нижче | ✅ Так |
-| `btc_eth_leverage` | Максимальне плече для BTC/ETH
⚠️ Субакаунти: ≤5x | `5` (за замовчуванням, безпечно)
`50` (максимум для основного акаунта) | ✅ Так |
-| `altcoin_leverage` | Максимальне плече для альткоїнів
⚠️ Субакаунти: ≤5x | `5` (за замовчуванням, безпечно)
`20` (максимум для основного акаунта) | ✅ Так |
-| `use_default_coins` | Використовувати вбудований список монет
**✨ Розумне значення за замовчуванням: `true`** (v2.0.2+)
Автоматично включається без API | `true` або опустити | ❌ Ні
(Опціонально, авто) |
-| `coin_pool_api_url` | API користувацького пулу монет
*Потрібно лише при `use_default_coins: false`* | `""` (пусто) | ❌ Ні |
-| `oi_top_api_url` | API відкритого інтересу
*Опціональні додаткові дані* | `""` (пусто) | ❌ Ні |
-| `api_server_port` | Порт веб-панелі | `8080` | ✅ Так |
-
-**Монети за замовчуванням для торгівлі** (коли `use_default_coins: true`):
-- BTC, ETH, SOL, BNB, XRP, DOGE, ADA, HYPE
-
----
-
-#### ⚙️ Конфігурація плеча (v2.0.3+)
-
-**Що таке конфігурація плеча?**
-
-Налаштування плеча контролюють максимальне плече, яке AI може використовувати для кожної угоди. Це критично важливо для управління ризиками, особливо для субакаунтів Binance, які мають обмеження по плечу.
-
-**Формат конфігурації:**
-
-```json
-"leverage": {
- "btc_eth_leverage": 5, // Максимальне плече для BTC та ETH
- "altcoin_leverage": 5 // Максимальне плече для всіх інших монет
-}
-```
-
-**⚠️ Важливо: Обмеження субакаунтів Binance**
-
-- **Субакаунти**: Обмежені **≤5x плечем** від Binance
-- **Основні акаунти**: Можуть використовувати до 20x (альткоїни) або 50x (BTC/ETH)
-- Якщо ви використовуєте субакаунт і встановите плече >5x, угоди будуть **завершуватися з помилкою**: `Subaccounts are restricted from using leverage greater than 5x`
-
-**Рекомендовані налаштування:**
-
-| Тип акаунта | Плече BTC/ETH | Плече альткоїнів | Рівень ризику |
-|-------------|---------------|------------------|---------------|
-| **Субакаунт** | `5` | `5` | ✅ Безпечно (за замовчуванням) |
-| **Основний (Консервативно)** | `10` | `10` | 🟡 Середній |
-| **Основний (Агресивно)** | `20` | `15` | 🔴 Високий |
-| **Основний (Максимум)** | `50` | `20` | 🔴🔴 Дуже високий |
-
-**Приклади:**
-
-**Безпечна конфігурація (субакаунт або консервативна):**
-```json
-"leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
-}
-```
-
-**Агресивна конфігурація (тільки основний акаунт):**
-```json
-"leverage": {
- "btc_eth_leverage": 20,
- "altcoin_leverage": 15
-}
-```
-
-**Як AI використовує плече:**
-
-- AI може вибрати **будь-яке плече від 1x до вашого налаштованого максимуму**
-- Наприклад, з `altcoin_leverage: 20`, AI може вирішити використовувати 5x, 10x або 20x залежно від ринкових умов
-- Конфігурація встановлює **верхню межу**, а не фіксоване значення
-- AI враховує волатильність, співвідношення ризик/дохід та баланс акаунта при виборі плеча
-
----
-
-#### ⚠️ Важливо: Поле `use_default_coins`
-
-**Розумна поведінка за замовчуванням (v2.0.2+):**
-
-Система тепер автоматично встановлює `use_default_coins: true`, якщо:
-- Ви не включили це поле в config.json, або
-- Ви встановили його в `false`, але не надали `coin_pool_api_url`
-
-Це робить систему більш дружньою для новачків! Ви навіть можете повністю опустити це поле.
-
-**Приклади конфігурації:**
-
-✅ **Варіант 1: Явне вказання (Рекомендується для ясності)**
-```json
-"use_default_coins": true,
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-✅ **Варіант 2: Опустити поле (Автоматично використовує монети за замовчуванням)**
-```json
-// Не включати "use_default_coins" взагалі
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-⚙️ **Розширене: Використовувати зовнішній API**
-```json
-"use_default_coins": false,
-"coin_pool_api_url": "http://your-api.com/coins",
-"oi_top_api_url": "http://your-api.com/oi"
+# Запуск фронтенду (новий термінал)
+cd web && npm run dev
```
---
-### 6. Запуск системи
+## Початкове налаштування
-#### 🚀 Запуск системи (2 кроки)
-
-Система складається з **2 частин**, які необхідно запустити окремо:
-1. **Backend** (AI торговий мозок + API)
-2. **Frontend** (Веб-панель моніторингу)
+1. **Налаштування AI моделей** — Додайте API ключі AI
+2. **Налаштування бірж** — Встановіть API облікові дані бірж
+3. **Створення стратегії** — Налаштуйте торгову стратегію в Студії стратегій
+4. **Створення трейдера** — Об'єднайте AI модель + Біржу + Стратегію
+5. **Початок торгівлі** — Запустіть налаштованих трейдерів
---
-#### **Крок 1: Запустіть Backend**
+## Попередження про ризики
-Відкрийте термінал та виконайте:
-
-```bash
-# Зберіть програму (перший запуск або після змін коду)
-go build -o nofx
-
-# Запустіть backend
-./nofx
-```
-
-**Ви повинні побачити:**
-
-```
-🚀 Запуск системи автоматичної торгівлі...
-✓ Трейдер [my_trader] ініціалізовано
-✓ API сервер запущено на порту 8080
-📊 Починається моніторинг торгівлі...
-```
-
-**⚠️ Якщо бачите помилки:**
-
-| Повідомлення про помилку | Рішення |
-|--------------------------|---------|
-| `invalid API key` | Перевірте Binance API ключі в config.json |
-| `TA-Lib not found` | Виконайте `brew install ta-lib` (macOS) |
-| `port 8080 already in use` | ~~Змініть `api_server_port` в config.json~~ *Змініть `API_PORT` у файлі .env* |
-| `DeepSeek API error` | Перевірте DeepSeek API ключ та баланс |
-
-**✅ Ознаки роботи Backend:**
-- Немає повідомлень про помилки
-- З'являється "Починається моніторинг торгівлі..."
-- Система показує баланс акаунта
-- Тримайте це вікно терміналу відкритим!
+1. Криптовалютні ринки надзвичайно волатильні — AI рішення не гарантують прибуток
+2. Торгівля ф'ючерсами використовує плече — збитки можуть перевищити депозит
+3. Екстремальні ринкові умови можуть призвести до ліквідації
---
-#### **Крок 2: Запустіть Frontend**
+## Ліцензія
-Відкрийте **нове вікно терміналу** (тримайте перше відкритим!), потім:
-
-```bash
-cd web
-npm run dev
-```
-
-**Ви повинні побачити:**
-
-```
-VITE v5.x.x ready in xxx ms
-
-➜ Local: http://localhost:3000/
-➜ Network: use --host to expose
-```
-
-**✅ Ознаки роботи Frontend:**
-- Повідомлення "Local: http://localhost:3000/"
-- Немає повідомлень про помилки
-- Також тримайте це вікно терміналу відкритим!
+**GNU Affero General Public License v3.0 (AGPL-3.0)**
---
-#### **Крок 3: Доступ до панелі**
+## Контакти
-Відкрийте у веб-браузері:
-
-**🌐 http://localhost:3000**
-
-**Ви побачите:**
-- 📊 Баланс акаунта в реальному часі
-- 📈 Позиції (якщо є)
-- 🤖 AI логи рішень
-- 📉 Графік капіталу
-
-**Підказки для першого використання:**
-- Перше AI рішення може зайняти 3-5 хвилин
-- Початкове рішення може показати "спостереження" - це нормально
-- AI повинен спочатку проаналізувати ринок
-
----
-
-### 7. Моніторинг системи
-
-**Що відстежувати:**
-
-✅ **Ознаки здорової системи:**
-- Backend термінал показує цикли рішень кожні 3-5 хвилин
-- Немає постійних повідомлень про помилки
-- Оновлюється баланс акаунта
-- Веб-панель автоматично оновлюється
-
-⚠️ **Ознаки попередження:**
-- Повторювані API помилки
-- Немає рішень більше 10 хвилин
-- Швидко падаючий баланс
-
-**Перевірка стану системи:**
-
-```bash
-# У новому вікні терміналу
-curl http://localhost:8080/api/health
-```
-
-Повинно повернути: `{"status":"ok"}`
-
----
-
-### 8. Зупинка системи
-
-**Витончене завершення (Рекомендується):**
-
-1. Перейдіть до **Backend терміналу** (першого)
-2. Натисніть `Ctrl+C`
-3. Дочекайтеся повідомлення "Система зупинена"
-4. Перейдіть до **Frontend терміналу** (другого)
-5. Натисніть `Ctrl+C`
-
-**⚠️ Важливо:**
-- Завжди зупиняйте backend першим
-- Дочекайтеся підтвердження перед закриттям терміналів
-- Не примусово завершуйте (не закривайте термінали одразу)
-
----
-
-## 📖 Процес прийняття рішень AI
-
-Кожен цикл прийняття рішень (за замовчуванням 3 хвилини), система працює за наступним процесом:
-
-### Крок 1: 📊 Аналіз історичної продуктивності (останні 20 циклів)
-- ✓ Розрахунок загального відсотка виграшів, середнього прибутку, співвідношення прибутку/збитку
-- ✓ Статистика по кожній монеті (відсоток виграшів, середній P/L в USDT)
-- ✓ Визначення найкращих/найгірших монет за продуктивністю
-- ✓ Список деталей останніх 5 угод з точним P/L
-- ✓ Розрахунок коефіцієнта Шарпа для оцінки ризику
-- 📌 **НОВЕ (v2.0.2)**: Точний P/L в USDT з врахуванням плеча
-
-**↓**
-
-### Крок 2: 💰 Отримання стану акаунта
-- Капітал акаунта, доступний баланс, нереалізований P/L
-- Кількість позицій, загальний P/L (реалізований + нереалізований)
-- Використання маржі (поточне/максимальне)
-- Індикатори оцінки ризику
-
-**↓**
-
-### Крок 3: 🔍 Аналіз існуючих позицій (якщо є)
-- Отримання ринкових даних для кожної позиції (3-хвилинні + 4-годинні свічки)
-- Розрахунок технічних індикаторів (RSI, MACD, EMA)
-- Відображення тривалості утримання позиції (наприклад, "утримується 2 години 15 хвилин")
-- AI визначає, чи потрібно закрити (тейк-профіт, стоп-лосс або коригування)
-- 📌 **НОВЕ (v2.0.2)**: Відстеження тривалості позиції допомагає AI вирішувати
-
-**↓**
-
-### Крок 4: 🎯 Оцінка нових можливостей (пул кандидатів монет)
-- Отримання пулу монет (2 режими):
- - 🌟 **Режим за замовчуванням**: BTC, ETH, SOL, BNB, XRP тощо
- - ⚙️ **Розширений режим**: AI500 (топ-20) + OI Top (топ-20)
-- Об'єднання, видалення дублікатів, фільтрація монет з низькою ліквідністю (OI < 15M USD)
-- Масове отримання ринкових даних та технічних індикаторів
-- Підготовка повних послідовностей сирих даних для кожної монети-кандидата
-
-**↓**
-
-### Крок 5: 🧠 Комплексне рішення AI
-- Перегляд історичного зворотного зв'язку (відсоток виграшів, коефіцієнт P/L, найкращі/найгірші монети)
-- Отримання всіх даних послідовностей (свічки, індикатори, відкритий інтерес)
-- Аналіз Chain of Thought
-- Вивід рішення: закрити/відкрити/утримувати/спостерігати
-- Включає параметри плеча, розміру, стоп-лосса, тейк-профіта
-- 📌 **НОВЕ (v2.0.2)**: AI може вільно аналізувати сирі послідовності, не обмежений заздалегідь визначеними індикаторами
-
-**↓**
-
-### Крок 6: ⚡ Виконання угод
-- Пріоритизація: спочатку закриття, потім відкриття
-- Автоматична адаптація точності (правила LOT_SIZE)
-- Запобігання накопиченню позицій (відхилення дублювання монета/напрямок)
-- Автоматична відміна всіх ордерів після закриття
-- Запис часу відкриття для відстеження тривалості позиції
-- 📌 Відстеження часу відкриття позиції
-
-**↓**
-
-### Крок 7: 📝 Запис логів
-- Збереження повного запису рішення в `decision_logs/`
-- Включає ланцюг міркувань, JSON рішення, знімок акаунта, результати виконання
-- Зберігання повних даних позиції (кількість, плече, час відкриття/закриття)
-- Використання ключів `symbol_side` для запобігання конфліктів лонг/шорт
-- 📌 **НОВЕ (v2.0.2)**: Запобігання конфліктів при утриманні лонг + шорт, врахування кількості + плеча
-
-**↓**
-
-**🔄 (Повтор кожні 3-5 хвилин)**
-
-### Ключові покращення в v2.0.2
-
-**📌 Відстеження тривалості позиції:**
-- Система тепер відстежує, як довго кожна позиція утримується
-- Відображається в промпті користувача: "утримується 2 години 15 хвилин"
-- Допомагає AI приймати кращі рішення про те, коли вийти
-
-**📌 Точний розрахунок P/L:**
-- Раніше: Лише відсоток (100U@5% = 1000U@5% = обидва показували "5.0")
-- Тепер: Реальний прибуток в USDT = Вартість позиції × Зміна ціни × Плече
-- Приклад: 1000 USDT × 5% × 20x = 1000 USDT фактичного прибутку
-
-**📌 Розширена свобода AI:**
-- AI може вільно аналізувати всі дані сирих послідовностей
-- Більше не обмежений заздалегідь визначеними комбінаціями індикаторів
-- Може виконувати власний аналіз трендів, розрахунок підтримки/опору
-
-**📌 Покращене відстеження позицій:**
-- Використовує ключ `symbol_side` (наприклад, "BTCUSDT_long")
-- Запобігає конфліктам при одночасному утриманні лонг та шорт
-- Зберігає повні дані: кількість, плече, час відкриття/закриття
-
----
-
-## ⚠️ Важливі попередження про ризики
-
-### Торговельні ризики
-```
- {
- "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
- }
- ],
- "use_default_coins": false,
- "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
-}
-```
-
-**Примітки до конфігурації:**
-- `traders`: Налаштуйте 1-N трейдерів (один AI або змагання кількох AI)
-- `id`: Унікальний ідентифікатор трейдера (використовується для директорії логів)
-- `ai_model`: "qwen" або "deepseek"
-- `binance_api_key/secret_key`: Кожен трейдер використовує незалежний акаунт Binance
-- `initial_balance`: Початковий баланс (для розрахунку P/L%)
-- `scan_interval_minutes`: Цикл прийняття рішень (рекомендується 3-5 хвилин)
-- `use_default_coins`: **true** = Використовувати 8 основних монет за замовчуванням | **false** = Використовувати API пул монет (рекомендується для новачків: true)
-- `coin_pool_api_url`: API пулу монет AI500 (опціонально, ігнорується при use_default_coins=true)
-- `oi_top_api_url`: API відкритого інтересу OI Top (опціонально, якщо порожньо, дані OI Top пропускаються)
-
-**Список монет за замовчуванням** (коли `use_default_coins: true`):
-- BTC, ETH, SOL, BNB, XRP, DOGE, ADA, HYPE
-
-### 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` в обох терміналах
-
----
-
----
-
-## 🔄 Журнал Змін
-
-📖 **Для детальної історії версій та оновлень див.:**
-
-- **Українська:** [CHANGELOG.zh-CN.md](../../../CHANGELOG.zh-CN.md)
-- **English:** [CHANGELOG.md](../../../CHANGELOG.md)
-
-**Остання Версія:** v3.0.0 (2025-10-30) - Масштабна Трансформація Архітектури
-
-**Недавні Основні Моменти:**
-- 🚀 Повна переробка системи з веб-конфігурацією
-- 🗄️ Архітектура на основі бази даних (SQLite)
-- 🎨 Ніякого редагування JSON - вся конфігурація через веб-інтерфейс
-- 🔧 Комбінуйте AI моделі з будь-якою біржею
-- 📊 Розширений API шар з комплексними ендпоінтами
-- 🔐 Аутентифікація JWT + підтримка 2FA
-- 🌐 Підтримка кастомних API (сумісних з OpenAI)
-- 📈 Система шаблонів промптів з віддаленою аутентифікацією
-
-**⚡ Досліджуйте можливості кількісної торгівлі з силою AI!**
-
----
-
-## ⭐ Star History
-
-[](https://star-history.com/#tinkle-community/nofx&Date)
+- **GitHub Issues**: [Створити Issue](https://github.com/NoFxAiOS/nofx/issues)
+- **Спільнота розробників**: [Telegram група](https://t.me/nofx_dev_community)
diff --git a/docs/i18n/vi/README.md b/docs/i18n/vi/README.md
index 4fd09634..31ad045c 100644
--- a/docs/i18n/vi/README.md
+++ b/docs/i18n/vi/README.md
@@ -1,680 +1,98 @@
-# 🤖 NOFX - Hệ Điều Hành Giao Dịch Tự Động
+# NOFX - Hệ Thống Giao Dịch AI
[](https://golang.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](LICENSE)
-[](https://amber.ac)
-**Ngôn ngữ:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md) | [Tiếng Việt](README.md)
-
-**📚 Tài liệu:** [Trang chủ Docs](../../README.md) | [Bắt đầu](../../getting-started/README.md) | [Hướng dẫn viết Prompt](../../prompt-guide.md) ([中文](../../prompt-guide.zh-CN.md)) | [Nhật ký thay đổi](../../../CHANGELOG.md) | [Đóng góp](../../../CONTRIBUTING.md) | [Bảo mật](../../../SECURITY.md) | [⚠️ Miễn Trừ Trách Nhiệm](../../../DISCLAIMER.md)
+**Ngôn ngữ:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Tiếng Việt](README.md)
---
-## 📑 Mục lục
+## Nền Tảng Giao Dịch Crypto Sử Dụng AI
-- [🚀 Hệ Điều Hành Giao Dịch AI Toàn Diện](#-hệ-điều-hành-giao-dịch-ai-toàn-diện)
-- [👥 Cộng đồng Phát triển](#-cộng-đồng-phát-triển)
-- [🆕 Cập nhật Mới nhất](#-cập-nhật-mới-nhất)
-- [📸 Ảnh Chụp Màn Hình](#-ảnh-chụp-màn-hình)
-- [✨ Triển Khai Hiện Tại](#-triển-khai-hiện-tại---thị-trường-crypto)
-- [🔮 Lộ Trình](#-lộ-trình---mở-rộng-thị-trường-toàn-cầu)
-- [🏗️ Kiến Trúc Kỹ Thuật](#️-kiến-trúc-kỹ-thuật)
-- [💰 Đăng Ký Tài Khoản Binance](#-đăng-ký-tài-khoản-binance-tiết-kiệm-phí)
-- [🔷 Đăng Ký Tài Khoản Hyperliquid](#-sử-dụng-sàn-hyperliquid)
-- [🔶 Đăng Ký Tài Khoản Aster DEX](#-sử-dụng-sàn-aster-dex)
-- [🚀 Bắt Đầu Nhanh](#-bắt-đầu-nhanh)
-- [📖 Quy Trình Quyết Định AI](#-quy-trình-quyết-định-ai)
-- [🧠 Tự Học của AI](#-tự-học-của-ai-ví-dụ)
-- [📊 Tính Năng Giao Diện Web](#-tính-năng-giao-diện-web)
-- [🎛️ API Endpoints](#️-api-endpoints)
-- [⚠️ Cảnh Báo Rủi Ro Quan Trọng](#️-cảnh-báo-rủi-ro-quan-trọng)
-- [🛠️ Vấn Đề Thường Gặp](#️-vấn-đề-thường-gặp)
-- [📈 Mẹo Tối Ưu Hiệu Suất](#-mẹo-tối-ưu-hiệu-suất)
-- [🔄 Nhật Ký Thay Đổi](#-nhật-ký-thay-đổi)
-- [📄 Giấy Phép](#-giấy-phép)
-- [🤝 Đóng Góp](#-đóng-góp)
+**NOFX** là hệ thống giao dịch AI mã nguồn mở cho phép bạn chạy nhiều mô hình AI để tự động giao dịch hợp đồng tương lai crypto. Cấu hình chiến lược qua giao diện web, theo dõi hiệu suất theo thời gian thực, và để các AI agent cạnh tranh tìm ra phương pháp giao dịch tốt nhất.
+
+### Tính Năng Chính
+
+- **Hỗ trợ Đa AI**: Chạy DeepSeek, Qwen, GPT, Claude, Gemini, Grok, Kimi - chuyển đổi mô hình bất cứ lúc nào
+- **Đa Sàn Giao Dịch**: Giao dịch trên Binance, Bybit, OKX, Hyperliquid, Aster DEX, Lighter từ một nền tảng
+- **Strategy Studio**: Trình tạo chiến lược trực quan với nguồn coin, chỉ báo và kiểm soát rủi ro
+- **Chế Độ Thi Đấu AI**: Nhiều AI trader cạnh tranh theo thời gian thực, theo dõi hiệu suất song song
+- **Cấu Hình Web**: Không cần chỉnh sửa JSON - cấu hình mọi thứ qua giao diện web
+- **Dashboard Thời Gian Thực**: Vị thế trực tiếp, theo dõi P/L, nhật ký quyết định AI với chuỗi suy luận
+
+### Được hỗ trợ bởi [Amber.ac](https://amber.ac)
+
+> **Cảnh Báo Rủi Ro**: Hệ thống này mang tính thử nghiệm. Giao dịch tự động AI có rủi ro đáng kể. Chỉ nên sử dụng cho mục đích học tập/nghiên cứu hoặc kiểm tra với số tiền nhỏ!
+
+## Cộng Đồng Nhà Phát Triển
+
+Tham gia cộng đồng Telegram: **[NOFX Developer Community](https://t.me/nofx_dev_community)**
---
-## 🚀 Hệ Điều Hành Giao Dịch AI Toàn Diện
+## Bắt Đầu Nhanh
-**NOFX** là một **Hệ điều hành giao dịch tự động toàn diện** được xây dựng trên kiến trúc thống nhất. Chúng tôi đã hoàn thành thành công vòng lặp trong thị trường crypto: **"Quyết Định Đa Tác Nhân → Kiểm Soát Rủi Ro Thống Nhất → Thực Thi Độ Trễ Thấp → Kiểm Tra Ngược Tài Khoản Thực/Giả Lập"**, và hiện đang mở rộng công nghệ này sang **cổ phiếu, hợp đồng tương lai, quyền chọn, ngoại hối và tất cả thị trường tài chính**.
+### Tùy chọn 1: Triển khai Docker (Khuyến nghị)
-### 🎯 Tính Năng Cốt Lõi
-
-- **Lớp Dữ Liệu & Kiểm Tra Ngược Toàn Diện**: Biểu diễn thống nhất xuyên thị trường, xuyên khung thời gian, xuyên sàn giao dịch và thư viện yếu tố, tích lũy "bộ nhớ chiến lược" có thể chuyển giao
-- **Tự Cạnh Tranh & Tự Tiến Hóa Đa Tác Nhân**: Các chiến lược tự động cạnh tranh và lựa chọn tốt nhất, liên tục cải tiến dựa trên PnL và ràng buộc rủi ro cấp tài khoản
-- **Thực Thi & Kiểm Soát Rủi Ro Tích Hợp**: Định tuyến độ trễ thấp, sandbox kiểm soát trượt giá/rủi ro, giới hạn cấp tài khoản, chuyển đổi thị trường một cú nhấp chuột
-
-### 🏢 Được Hỗ Trợ Bởi [Amber.ac](https://amber.ac)
-
-### 👥 Nhóm Cốt Lõi
-
-- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **Twitter Chính Thức (Duy Nhất)** - [@nofx_official](https://x.com/nofx_official)
-
-### 💼 Vòng Gọi Vốn Seed Đang Mở
-
-Chúng tôi hiện đang gọi vốn **vòng seed**.
-
-**Để biết thông tin đầu tư**, vui lòng DM **Tinkle** qua Twitter.
-
----
-
-> ⚠️ **Cảnh Báo Rủi Ro**: Hệ thống này là thử nghiệm. Giao dịch tự động AI mang rủi ro đáng kể. Khuyến nghị mạnh mẽ chỉ dùng cho mục đích học tập/nghiên cứu hoặc thử nghiệm với số tiền nhỏ!
-
-## 👥 Cộng đồng Phát triển
-
-Tham gia cộng đồng phát triển Telegram của chúng tôi để thảo luận, chia sẻ ý tưởng và nhận hỗ trợ:
-
-**💬 [Cộng Đồng Phát Triển NOFX](https://t.me/nofx_dev_community)**
-
----
-
-## 🆕 Cập nhật Mới nhất
-
-### 🚀 Hỗ Trợ Đa Sàn Giao Dịch!
-
-NOFX hiện hỗ trợ **ba sàn giao dịch lớn**: Binance, Hyperliquid và Aster DEX!
-
-#### **Sàn Hyperliquid**
-
-Một sàn giao dịch hợp đồng tương lai vĩnh viễn phi tập trung hiệu suất cao!
-
-**Tính Năng Chính:**
-- ✅ Hỗ trợ giao dịch đầy đủ (long/short, đòn bẩy, stop-loss/take-profit)
-- ✅ Xử lý độ chính xác tự động (kích thước lệnh & giá)
-- ✅ Giao diện trader thống nhất (chuyển đổi sàn liền mạch)
-- ✅ Hỗ trợ cả mainnet và testnet
-- ✅ Không cần API key - chỉ cần private key Ethereum của bạn
-
-**Quy Trình Làm Việc Mới:**
-1. **Cấu Hình Mô Hình AI**: Thêm API key DeepSeek/Qwen qua giao diện web
-2. **Cấu Hình Sàn Giao Dịch**: Thiết lập thông tin Binance/Hyperliquid
-3. **Tạo Traders**: Kết hợp bất kỳ mô hình AI với bất kỳ sàn nào để tạo traders tùy chỉnh
-4. **Giám Sát & Điều Khiển**: Bắt đầu/dừng traders và giám sát hiệu suất theo thời gian thực
-
-**Tại Sao Cập Nhật Này?**
-- 🎯 **Thân Thiện Người Dùng**: Không cần chỉnh sửa file JSON hoặc khởi động lại server
-- 🔧 **Linh Hoạt**: Kết hợp các mô hình AI khác nhau với các sàn khác nhau
-- 📊 **Mở Rộng**: Tạo kết hợp trader không giới hạn
-- 🔒 **Bảo Mật**: Lưu trữ cơ sở dữ liệu với quản lý dữ liệu hợp lý
-
-Xem [Bắt Đầu Nhanh](#-bắt-đầu-nhanh) cho quy trình thiết lập mới!
-
-#### **Sàn Aster DEX** (MỚI! v2.0.2)
-
-Một sàn giao dịch hợp đồng tương lai vĩnh viễn phi tập trung tương thích Binance!
-
-**Tính Năng Chính:**
-- ✅ API kiểu Binance (dễ dàng di chuyển từ Binance)
-- ✅ Xác thực ví Web3 (an toàn và phi tập trung)
-- ✅ Hỗ trợ giao dịch đầy đủ với xử lý độ chính xác tự động
-- ✅ Phí giao dịch thấp hơn CEX
-- ✅ Tương thích EVM (Ethereum, BSC, Polygon, v.v.)
-
-**Tại Sao Chọn Aster?**
-- 🎯 **API tương thích Binance** - yêu cầu thay đổi mã tối thiểu
-- 🔐 **Hệ Thống Ví API** - ví giao dịch riêng cho bảo mật
-- 💰 **Phí cạnh tranh** - thấp hơn hầu hết sàn tập trung
-- 🌐 **Hỗ trợ đa chuỗi** - giao dịch trên chuỗi EVM ưa thích của bạn
-
-**Bắt Đầu Nhanh:**
-1. Đăng ký qua [Link Giới Thiệu Aster](https://www.asterdex.com/en/referral/fdfc0e) (nhận giảm phí!)
-2. Truy cập [Ví API Aster](https://www.asterdex.com/en/api-wallet)
-3. Kết nối ví chính và tạo ví API
-4. Sao chép địa chỉ API Signer và Private Key
-5. Đặt `"exchange": "aster"` trong config.json
-6. Thêm `"aster_user"`, `"aster_signer"` và `"aster_private_key"`
-
----
-
-## 📸 Ảnh Chụp Màn Hình
-
-### 🏆 Chế Độ Cạnh Tranh - Trận Chiến AI Thời Gian Thực
-
-*Bảng xếp hạng Đa AI với biểu đồ so sánh hiệu suất thời gian thực hiển thị trận chiến giao dịch trực tiếp giữa Qwen và DeepSeek*
-
-### 📊 Chi Tiết Trader - Bảng Điều Khiển Giao Dịch Hoàn Chỉnh
-
-*Giao diện giao dịch chuyên nghiệp với đường cong vốn, vị thế trực tiếp và nhật ký quyết định AI với các input prompt và chuỗi suy luận có thể mở rộng*
-
----
-
-## ✨ Triển Khai Hiện Tại - Thị Trường Crypto
-
-NOFX hiện đang **hoạt động đầy đủ trong thị trường tiền điện tử** với các khả năng đã được chứng minh sau:
-
-### 🏆 Khung Cạnh Tranh Đa Tác Nhân
-- **Trận Chiến Tác Nhân Trực Tiếp**: Các mô hình Qwen vs DeepSeek cạnh tranh trong giao dịch thời gian thực
-- **Quản Lý Tài Khoản Độc Lập**: Mỗi tác nhân duy trì nhật ký quyết định và số liệu hiệu suất riêng
-- **So Sánh Hiệu Suất Thời Gian Thực**: Theo dõi ROI trực tiếp, thống kê tỷ lệ thắng và phân tích đối đầu
-- **Vòng Lặp Tự Tiến Hóa**: Các tác nhân học từ hiệu suất lịch sử và liên tục cải thiện
-
-### 🧠 Tự Học & Tối Ưu Hóa AI
-- **Hệ Thống Phản Hồi Lịch Sử**: Phân tích 20 chu kỳ giao dịch cuối trước mỗi quyết định
-- **Phân Tích Hiệu Suất Thông Minh**:
- - Xác định tài sản hoạt động tốt/kém nhất
- - Tính tỷ lệ thắng, tỷ lệ lãi/lỗ, lợi nhuận trung bình bằng USDT thực
- - Tránh lặp lại sai lầm (mô hình thua liên tiếp)
- - Củng cố chiến lược thành công (mô hình tỷ lệ thắng cao)
-- **Điều Chỉnh Chiến Lược Động**: AI tự động thích nghi phong cách giao dịch dựa trên kết quả kiểm tra ngược
-
-### 📊 Lớp Dữ Liệu Thị Trường Toàn Diện (Triển Khai Crypto)
-- **Phân Tích Đa Khung Thời Gian**: Dữ liệu thời gian thực 3 phút + dữ liệu xu hướng 4 giờ
-- **Chỉ Báo Kỹ Thuật**: EMA20/50, MACD, RSI(7/14), ATR
-- **Theo Dõi Open Interest**: Tâm lý thị trường, phân tích dòng vốn
-- **Lọc Thanh Khoản**: Tự động lọc tài sản thanh khoản thấp (<15M USD)
-- **Hỗ Trợ Đa Sàn**: Binance, Hyperliquid, Aster DEX với giao diện dữ liệu thống nhất
-
-### 🎯 Hệ Thống Kiểm Soát Rủi Ro Thống Nhất
-- **Giới Hạn Vị Thế**: Giới hạn mỗi tài sản (Altcoin ≤1.5x vốn, BTC/ETH ≤10x vốn)
-- **Đòn Bẩy Cấu Hình Được**: Đòn bẩy động từ 1x đến 50x dựa trên loại tài sản và loại tài khoản
-- **Quản Lý Ký Quỹ**: Tổng sử dụng ≤90%, phân bổ do AI kiểm soát
-- **Thực Thi Rủi Ro-Phần Thưởng**: Bắt buộc tỷ lệ stop-loss/take-profit ≥1:2
-- **Bảo Vệ Chống Chồng Lớp**: Ngăn vị thế trùng lặp trong cùng tài sản/hướng
-
-### ⚡ Công Cụ Thực Thi Độ Trễ Thấp
-- **Tích Hợp API Đa Sàn**: Binance Futures, Hyperliquid DEX, Aster DEX
-- **Xử Lý Độ Chính Xác Tự Động**: Định dạng kích thước lệnh & giá thông minh mỗi sàn
-- **Thực Thi Ưu Tiên**: Đóng vị thế hiện tại trước, sau đó mở mới
-- **Kiểm Soát Trượt Giá**: Xác thực trước thực thi, kiểm tra độ chính xác thời gian thực
-
-### 🎨 Giao Diện Giám Sát Chuyên Nghiệp
-- **Bảng Điều Khiển Kiểu Binance**: Chủ đề tối chuyên nghiệp với cập nhật thời gian thực
-- **Đường Cong Vốn**: Theo dõi giá trị tài khoản lịch sử (chuyển đổi USD/phần trăm)
-- **Biểu Đồ Hiệu Suất**: So sánh ROI đa tác nhân với cập nhật trực tiếp
-- **Nhật Ký Quyết Định Hoàn Chỉnh**: Chuỗi Suy Luận (CoT) đầy đủ cho mọi giao dịch
-- **Làm Mới Dữ Liệu 5 Giây**: Cập nhật tài khoản, vị thế và P/L thời gian thực
-
----
-
-## 🔮 Lộ Trình - Mở Rộng Thị Trường Toàn Cầu
-
-NOFX đang trên sứ mệnh trở thành **Hệ Điều Hành Giao Dịch AI Toàn Diện** cho tất cả thị trường tài chính.
-
-**Tầm Nhìn:** Cùng kiến trúc. Cùng khung tác nhân. Tất cả thị trường.
-
-**Thị Trường Mở Rộng:**
-- 📈 **Thị Trường Cổ Phiếu**: Cổ phiếu Mỹ, A-shares, cổ phiếu Hồng Kông
-- 📊 **Thị Trường Hợp Đồng Tương Lai**: Hợp đồng tương lai hàng hóa, chỉ số
-- 🎯 **Giao Dịch Quyền Chọn**: Quyền chọn cổ phiếu, quyền chọn crypto
-- 💱 **Thị Trường Ngoại Hối**: Cặp tiền tệ chính, tỷ giá chéo
-
-**Tính Năng Sắp Tới:**
-- Nâng cao khả năng AI (GPT-4, Claude 3, Gemini Pro, mẫu prompt linh hoạt)
-- Tích hợp sàn mới (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
-- Tái cấu trúc dự án (gắn kết cao, ghép nối thấp, nguyên tắc SOLID)
-- Tăng cường bảo mật (mã hóa AES-256 cho API key, RBAC, cải thiện 2FA)
-- Cải thiện trải nghiệm người dùng (responsive di động, biểu đồ TradingView, hệ thống cảnh báo)
-
-📖 **Để biết lộ trình chi tiết và thời gian, xem:**
-- **English:** [Tài Liệu Lộ Trình](docs/roadmap/README.md)
-- **中文:** [路线图文档](docs/roadmap/README.zh-CN.md)
-
----
-
-## 🏗️ Kiến Trúc Kỹ Thuật
-
-NOFX được xây dựng với kiến trúc hiện đại, modular:
-
-- **Backend:** Go với framework Gin, cơ sở dữ liệu SQLite
-- **Frontend:** React 18 + TypeScript + Vite + TailwindCSS
-- **Hỗ Trợ Đa Sàn:** Binance, Hyperliquid, Aster DEX
-- **Tích Hợp AI:** DeepSeek, Qwen và API tương thích OpenAI tùy chỉnh
-- **Quản Lý Trạng Thái:** Zustand cho frontend, điều khiển bằng database cho backend
-- **Cập Nhật Thời Gian Thực:** SWR với khoảng thăm dò 5-10 giây
-
-**Tính Năng Chính:**
-- 🗄️ Cấu hình điều khiển bằng database (không cần chỉnh sửa JSON)
-- 🔐 Xác thực JWT với hỗ trợ 2FA tùy chọn
-- 📊 Theo dõi hiệu suất và phân tích thời gian thực
-- 🤖 Chế độ cạnh tranh đa AI với so sánh trực tiếp
-- 🔌 API RESTful cho tất cả cấu hình và giám sát
-
-📖 **Để biết tài liệu kiến trúc chi tiết, xem:**
-- **English:** [Tài Liệu Kiến Trúc](docs/architecture/README.md)
-- **中文:** [架构文档](docs/architecture/README.zh-CN.md)
-
----
-
-## 💰 Đăng Ký Tài Khoản Binance (Tiết Kiệm Phí!)
-
-Trước khi sử dụng hệ thống này, bạn cần một tài khoản Binance Futures. **Sử dụng link giới thiệu của chúng tôi để tiết kiệm phí giao dịch:**
-
-**🎁 [Đăng Ký Binance - Nhận Giảm Phí](https://www.binance.com/join?ref=NOFXVIET)**
-
-### Các Bước Đăng Ký:
-
-1. **Nhấp vào link trên** để truy cập trang đăng ký Binance
-2. **Hoàn tất đăng ký** bằng email/số điện thoại
-3. **Hoàn tất xác minh KYC** (bắt buộc cho giao dịch futures)
-4. **Kích hoạt tài khoản Futures**:
- - Vào trang chủ Binance → Derivatives → USD-M Futures
- - Nhấp "Open Now" để kích hoạt giao dịch futures
-5. **Tạo API Key**:
- - Vào Account → API Management
- - Tạo API key mới, **bật quyền "Futures"**
- - Lưu API Key và Secret Key (cần cho giao diện web)
- - **Quan trọng**: Thêm địa chỉ IP của bạn vào whitelist để bảo mật
-
-### Ưu Đãi Giảm Phí:
-
-- ✅ **Giao dịch Spot**: Giảm phí lên đến 30%
-- ✅ **Giao dịch Futures**: Giảm phí lên đến 30%
-- ✅ **Hiệu lực vĩnh viễn**: Giảm giá vĩnh viễn cho tất cả giao dịch
-
----
-
-## 🚀 Bắt Đầu Nhanh
-
-### 🐳 Tùy Chọn A: Triển Khai Docker Một Cú Nhấp (DỄ NHẤT - Khuyến Nghị!)
-
-**⚡ Khởi động nền tảng trong 2 bước đơn giản với Docker - Không cần cài đặt!**
-
-Docker tự động xử lý tất cả phụ thuộc (Go, Node.js, TA-Lib, SQLite) và thiết lập môi trường.
-
-#### Bước 1: Chuẩn Bị Cấu Hình
```bash
-# Sao chép mẫu cấu hình
-cp config.json.example config.json
-
-# Chỉnh sửa và điền API key của bạn
-nano config.json # hoặc sử dụng trình soạn thảo bất kỳ
-```
-
-⚠️ **Lưu ý**: config.json cơ bản vẫn cần cho một số cài đặt, nhưng cấu hình trader giờ được thực hiện qua giao diện web.
-
-#### Bước 2: Khởi Động Một Cú Nhấp
-```bash
-# Tùy chọn 1: Sử dụng script tiện lợi (Khuyến nghị)
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
chmod +x ./start.sh
./start.sh start --build
-
-> #### Lưu Ý Phiên Bản Docker Compose
->
-> **Dự án này sử dụng cú pháp Docker Compose V2 (với khoảng trắng)**
->
-> Nếu bạn có phiên bản `docker-compose` cũ, vui lòng nâng cấp lên Docker Desktop hoặc Docker 20.10+
-
-# Tùy chọn 2: Sử dụng docker compose trực tiếp
-docker compose up -d --build
```
-#### Bước 3: Truy Cập Giao Diện Web
-Mở trình duyệt và truy cập: **http://localhost:3000**
+Truy cập giao diện Web: **http://localhost:3000**
-**Xong! 🎉** Nền tảng giao dịch AI của bạn đã chạy!
+### Tùy chọn 2: Cài đặt Thủ công
-#### Thiết Lập Ban Đầu (Qua Giao Diện Web)
-1. **Cấu Hình Mô Hình AI**: Thêm API key DeepSeek/Qwen
-2. **Cấu Hình Sàn Giao Dịch**: Thiết lập thông tin Binance/Hyperliquid
-3. **Tạo Traders**: Kết hợp mô hình AI với sàn giao dịch
-4. **Bắt Đầu Giao Dịch**: Khởi chạy các trader đã cấu hình
-
-#### Quản Lý Hệ Thống
```bash
-./start.sh logs # Xem nhật ký
-./start.sh status # Kiểm tra trạng thái
-./start.sh stop # Dừng dịch vụ
-./start.sh restart # Khởi động lại dịch vụ
-```
+# Yêu cầu: Go 1.21+, Node.js 18+, TA-Lib
-**📖 Để biết hướng dẫn triển khai Docker chi tiết, xử lý sự cố và cấu hình nâng cao:**
-- **English**: Xem [docs/getting-started/docker-deploy.en.md](docs/getting-started/docker-deploy.en.md)
-- **中文**: 查看 [docs/getting-started/docker-deploy.zh-CN.md](docs/getting-started/docker-deploy.zh-CN.md)
-
----
-
-### 📦 Tùy Chọn B: Cài Đặt Thủ Công (Cho Nhà Phát Triển)
-
-**Lưu ý**: Nếu bạn đã sử dụng triển khai Docker ở trên, bỏ qua phần này. Cài đặt thủ công chỉ cần nếu bạn muốn sửa đổi mã hoặc chạy không dùng Docker.
-
-### 1. Yêu Cầu Môi Trường
-
-- **Go 1.21+**
-- **Node.js 18+**
-- **TA-Lib** library (tính toán chỉ báo kỹ thuật)
-
-#### Cài Đặt TA-Lib
-
-**macOS:**
-```bash
+# Cài đặt TA-Lib (macOS)
brew install ta-lib
-```
-**Ubuntu/Debian:**
-```bash
-sudo apt-get install libta-lib0-dev
-```
-
-**Hệ thống khác**: Tham khảo [Tài Liệu Chính Thức TA-Lib](https://github.com/markcheno/go-talib)
-
-### 2. Clone Dự Án
-
-```bash
-git clone https://github.com/tinkle-community/nofx.git
+# Clone và thiết lập
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
-```
-
-### 3. Cài Đặt Phụ Thuộc
-
-**Backend:**
-```bash
go mod download
-```
-
-**Frontend:**
-```bash
-cd web
-npm install
-cd ..
-```
-
-### 4. Lấy API Key AI
-
-Trước khi cấu hình hệ thống, bạn cần lấy API key AI. Chọn một trong các nhà cung cấp AI sau:
-
-#### Tùy Chọn 1: DeepSeek (Khuyến Nghị Cho Người Mới)
-
-**Tại Sao DeepSeek?**
-- 💰 Rẻ hơn GPT-4 (khoảng 1/10 chi phí)
-- 🚀 Thời gian phản hồi nhanh
-- 🎯 Chất lượng quyết định giao dịch xuất sắc
-- 🌍 Hoạt động toàn cầu không cần VPN
-
-**Cách lấy DeepSeek API Key:**
-
-1. **Truy cập**: [https://platform.deepseek.com](https://platform.deepseek.com)
-2. **Đăng ký**: Đăng ký bằng email/số điện thoại
-3. **Xác minh**: Hoàn tất xác minh email/điện thoại
-4. **Nạp tiền**: Thêm tín dụng vào tài khoản
- - Tối thiểu: ~$5 USD
- - Khuyến nghị: $20-50 USD để thử nghiệm
-5. **Tạo API Key**:
- - Vào phần API Keys
- - Nhấp "Create New Key"
- - Sao chép và lưu key (bắt đầu bằng `sk-`)
- - ⚠️ **Quan trọng**: Lưu ngay lập tức - bạn không thể xem lại!
-
-**Giá**: ~$0.14 trên 1M token (rất rẻ!)
-
-#### Tùy Chọn 2: Qwen (Alibaba Cloud)
-
-**Cách lấy Qwen API Key:**
-
-1. **Truy cập**: [https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
-2. **Đăng ký**: Đăng ký bằng tài khoản Alibaba Cloud
-3. **Kích Hoạt Dịch Vụ**: Kích hoạt dịch vụ DashScope
-4. **Tạo API Key**:
- - Vào API Key Management
- - Tạo key mới
- - Sao chép và lưu (bắt đầu bằng `sk-`)
-
-**Lưu ý**: Có thể yêu cầu số điện thoại Trung Quốc để đăng ký
-
----
-
-### 5. Khởi Động Hệ Thống
-
-#### **Bước 1: Khởi Động Backend**
-
-```bash
-# Build chương trình (lần đầu tiên, hoặc sau khi thay đổi mã)
-go build -o nofx
+cd web && npm install && cd ..
# Khởi động backend
-./nofx
+go build -o nofx && ./nofx
+
+# Khởi động frontend (terminal mới)
+cd web && npm run dev
```
-**Điều bạn nên thấy:**
-
-```
-╔════════════════════════════════════════════════════════════╗
-║ 🤖 AI多模型交易系统 - 支持 DeepSeek & Qwen ║
-╚════════════════════════════════════════════════════════════╝
-
-🤖 数据库中的AI交易员配置:
- • 暂无配置的交易员，请通过Web界面创建
-
-🌐 API服务器启动在 http://localhost:8081
-```
-
-#### **Bước 2: Khởi Động Frontend**
-
-Mở một cửa sổ terminal **MỚI**, sau đó:
-
-```bash
-cd web
-npm run dev
-```
-
-#### **Bước 3: Truy Cập Giao Diện Web**
-
-Mở trình duyệt và truy cập: **🌐 http://localhost:3000**
-
-### 6. Cấu Hình Qua Giao Diện Web
-
-**Giờ cấu hình mọi thứ qua giao diện web - không cần chỉnh sửa JSON!**
-
-#### **Bước 1: Cấu Hình Mô Hình AI**
-1. Nhấp nút "AI模型配置"
-2. Bật DeepSeek hoặc Qwen (hoặc cả hai)
-3. Nhập API key của bạn
-4. Lưu cấu hình
-
-#### **Bước 2: Cấu Hình Sàn Giao Dịch**
-1. Nhấp nút "交易所配置"
-2. Bật Binance hoặc Hyperliquid (hoặc cả hai)
-3. Nhập thông tin API
-4. Lưu cấu hình
-
-#### **Bước 3: Tạo Traders**
-1. Nhấp nút "创建交易员"
-2. Chọn mô hình AI (phải cấu hình trước)
-3. Chọn sàn giao dịch (phải cấu hình trước)
-4. Đặt số dư ban đầu và tên trader
-5. Tạo trader
-
-#### **Bước 4: Bắt Đầu Giao Dịch**
-- Traders của bạn sẽ xuất hiện trong giao diện chính
-- Sử dụng nút Start/Stop để điều khiển
-- Giám sát hiệu suất theo thời gian thực
-
-**✅ Không cần chỉnh sửa file JSON - mọi thứ được thực hiện qua giao diện web!**
-
---
-#### 🔷 Sử Dụng Sàn Hyperliquid
+## Thiết Lập Ban Đầu
-**NOFX hỗ trợ Hyperliquid** - một sàn giao dịch hợp đồng tương lai vĩnh viễn phi tập trung hiệu suất cao!
-
-**Tại Sao Chọn Hyperliquid?**
-- 🚀 **Hiệu Suất Cao**: Thực thi cực nhanh trên blockchain L1
-- 💰 **Phí Thấp**: Phí maker/taker cạnh tranh
-- 🔐 **Không Giữ Hộ**: Key của bạn, coin của bạn
-- 🌐 **Không KYC**: Giao dịch ẩn danh
-- 💎 **Thanh Khoản Sâu**: Sổ lệnh cấp tổ chức
+1. **Cấu hình Mô hình AI** — Thêm API key AI
+2. **Cấu hình Sàn giao dịch** — Thiết lập thông tin API sàn
+3. **Tạo Chiến lược** — Cấu hình chiến lược giao dịch trong Strategy Studio
+4. **Tạo Trader** — Kết hợp Mô hình AI + Sàn + Chiến lược
+5. **Bắt đầu Giao dịch** — Khởi động các trader đã cấu hình
---
-### 📝 Hướng Dẫn Đăng Ký & Thiết Lập
+## Cảnh Báo Rủi Ro
-**Bước 1: Đăng Ký Tài Khoản Hyperliquid**
-
-1. **Truy cập Hyperliquid với Link Giới Thiệu** (nhận lợi ích!):
-
- **🎁 [Đăng Ký Hyperliquid - Tham Gia AITRADING](https://app.hyperliquid.xyz/join/AITRADING)**
-
-2. **Kết Nối Ví Của Bạn**:
- - Nhấp "Connect Wallet" ở góc trên bên phải
- - Chọn MetaMask, WalletConnect, hoặc ví Web3 khác
- - Phê duyệt kết nối
-
-3. **Kích Hoạt Giao Dịch**:
- - Kết nối lần đầu sẽ nhắc bạn ký tin nhắn
- - Điều này ủy quyền ví của bạn cho giao dịch (không mất phí gas)
- - Bạn sẽ thấy địa chỉ ví được hiển thị
-
-**Bước 2: Nạp Tiền Vào Ví**
-
-1. **Bridge Tài Sản Sang Arbitrum**:
- - Hyperliquid chạy trên Arbitrum L2
- - Bridge USDC từ Ethereum mainnet hoặc chuỗi khác
- - Hoặc rút USDC trực tiếp từ sàn sang Arbitrum
-
-2. **Nạp Vào Hyperliquid**:
- - Nhấp "Deposit" trên giao diện Hyperliquid
- - Chọn số lượng USDC để nạp
- - Xác nhận giao dịch (phí gas nhỏ trên Arbitrum)
- - Tiền xuất hiện trong tài khoản Hyperliquid trong vài giây
-
-**Bước 3: Thiết Lập Ví Agent (Khuyến Nghị)**
-
-Hyperliquid hỗ trợ **Ví Agent** - ví phụ an toàn đặc biệt cho tự động hóa giao dịch!
-
-⚠️ **Tại Sao Sử Dụng Ví Agent:**
-- ✅ **An Toàn Hơn**: Không bao giờ lộ private key ví chính
-- ✅ **Truy Cập Giới Hạn**: Agent chỉ có quyền giao dịch
-- ✅ **Có Thể Thu Hồi**: Có thể vô hiệu hóa bất cứ lúc nào từ giao diện Hyperliquid
-- ✅ **Tách Biệt Tiền**: Giữ nắm giữ chính an toàn
-
-**Cách Tạo Ví Agent:**
-
-1. **Đăng nhập Hyperliquid** bằng ví chính
- - Truy cập [https://app.hyperliquid.xyz](https://app.hyperliquid.xyz)
- - Kết nối với ví bạn đã đăng ký (từ link giới thiệu)
-
-2. **Điều Hướng Đến Cài Đặt Agent**:
- - Nhấp vào địa chỉ ví (góc trên bên phải)
- - Vào "Settings" → "API & Agents"
- - Hoặc truy cập: [https://app.hyperliquid.xyz/agents](https://app.hyperliquid.xyz/agents)
-
-3. **Tạo Agent Mới**:
- - Nhấp "Create Agent" hoặc "Add Agent"
- - Hệ thống sẽ tự động tạo ví agent mới
- - **Lưu địa chỉ ví agent** (bắt đầu bằng `0x`)
- - **Lưu private key agent** (chỉ hiển thị một lần!)
-
-4. **Chi Tiết Ví Agent**:
- - Ví Chính: Ví kết nối của bạn (giữ tiền)
- - Ví Agent: Ví phụ cho giao dịch (NOFX sẽ dùng cái này)
- - Private Key: Chỉ cần cho cấu hình NOFX
-
-5. **Nạp Tiền Cho Agent** (Tùy chọn):
- - Chuyển USDC từ ví chính sang ví agent
- - Hoặc giữ tiền trong ví chính (agent có thể giao dịch từ đó)
-
-6. **Lưu Thông Tin Cho NOFX**:
- - Địa Chỉ Ví Chính: `0xYourMainWalletAddress` (với `0x`)
- - Private Key Agent: `YourAgentPrivateKeyWithout0x` (bỏ tiền tố `0x`)
+1. Thị trường crypto biến động cực kỳ mạnh — Quyết định AI không đảm bảo lợi nhuận
+2. Giao dịch hợp đồng tương lai sử dụng đòn bẩy — Thua lỗ có thể vượt quá vốn
+3. Điều kiện thị trường cực đoan có thể dẫn đến thanh lý
---
-Cấu hình qua giao diện web
+## Giấy Phép
-```json
-{
- "traders": [
- {
- "id": "hyperliquid_trader",
- "name": "My Hyperliquid Trader",
- "enabled": true,
- "ai_model": "deepseek",
- "exchange": "hyperliquid",
- "hyperliquid_private_key": "your_private_key_without_0x",
- "hyperliquid_wallet_addr": "your_ethereum_address",
- "hyperliquid_testnet": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "api_server_port": 8080
-}
-```
-
-**Khác Biệt Chính Với Cấu Hình Binance:**
-- Thay `binance_api_key` + `binance_secret_key` bằng `hyperliquid_private_key`
-- Thêm trường `"exchange": "hyperliquid"`
-- Đặt `hyperliquid_testnet: false` cho mainnet (hoặc `true` cho testnet)
-
-**⚠️ Cảnh Báo Bảo Mật**: Không bao giờ chia sẻ private key! Sử dụng ví riêng cho giao dịch, không phải ví chính.
+**GNU Affero General Public License v3.0 (AGPL-3.0)**
---
-#### 🔶 Sử Dụng Sàn Aster DEX
+## Liên Hệ
-**NOFX hỗ trợ Aster DEX** - một sàn giao dịch hợp đồng tương lai vĩnh viễn phi tập trung tương thích Binance!
-
-**Tại Sao Chọn Aster?**
-- 🎯 API tương thích Binance (di chuyển dễ dàng)
-- 🔐 Hệ thống bảo mật Ví API
-- 💰 Phí giao dịch thấp hơn
-- 🌐 Hỗ trợ đa chuỗi (ETH, BSC, Polygon)
-- 🌍 Không yêu cầu KYC
-
-**Bước 1**: Đăng Ký và Tạo Ví API Aster
-
-1. Đăng ký qua [Link Giới Thiệu Aster](https://www.asterdex.com/en/referral/fdfc0e) (nhận giảm phí!)
-2. Truy cập [Ví API Aster](https://www.asterdex.com/en/api-wallet)
-3. Kết nối ví chính (MetaMask, WalletConnect, v.v.)
-4. Nhấp "Create API Wallet"
-5. **Lưu ngay 3 mục này:**
- - Địa chỉ Ví Chính (User)
- - Địa chỉ Ví API (Signer)
- - Private Key Ví API (⚠️ chỉ hiển thị một lần!)
-
-**Bước 2**: Cấu hình qua giao diện web
-
-```json
-{
- "traders": [
- {
- "id": "aster_deepseek",
- "name": "Aster DeepSeek Trader",
- "enabled": true,
- "ai_model": "deepseek",
- "exchange": "aster",
-
- "aster_user": "0xYOUR_MAIN_WALLET_ADDRESS_HERE",
- "aster_signer": "0xYOUR_API_WALLET_SIGNER_ADDRESS_HERE",
- "aster_private_key": "your_api_wallet_private_key_without_0x_prefix",
-
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "api_server_port": 8080,
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- }
-}
-```
-
-**Các Trường Cấu Hình Chính:**
-- `"exchange": "aster"` - Đặt sàn thành Aster
-- `aster_user` - Địa chỉ ví chính của bạn
-- `aster_signer` - Địa chỉ ví API (từ Bước 1)
-- `aster_private_key` - Private key ví API (không có tiền tố `0x`)
-
-**📖 Để biết hướng dẫn thiết lập chi tiết, xem**: [Hướng Dẫn Tích Hợp Aster](ASTER_INTEGRATION.md)
-
-**⚠️ Lưu Ý Bảo Mật**:
-- Ví API tách biệt với ví chính (lớp bảo mật thêm)
-- Không bao giờ chia sẻ private key API
-- Bạn có thể thu hồi quyền truy cập ví API bất cứ lúc nào tại [asterdex.com](https://www.asterdex.com/en/api-wallet)
-
----
-
-*Phần còn lại của README tiếp tục với các phần về Chế Độ Chuyên Gia, Cấu Hình Chi Tiết, Quy Trình Quyết Định AI, v.v. - vui lòng xem phiên bản tiếng Anh đầy đủ để biết tất cả chi tiết.*
-
-**Cập Nhật Cuối**: 2025-10-30 (v3.0.0)
-
-**⚡ Khám phá khả năng của giao dịch định lượng với sức mạnh của AI!**
+- **GitHub Issues**: [Gửi Issue](https://github.com/NoFxAiOS/nofx/issues)
+- **Cộng đồng Nhà phát triển**: [Nhóm Telegram](https://t.me/nofx_dev_community)
diff --git a/docs/i18n/zh-CN/README.md b/docs/i18n/zh-CN/README.md
index 02f12569..398842f7 100644
--- a/docs/i18n/zh-CN/README.md
+++ b/docs/i18n/zh-CN/README.md
@@ -1,4 +1,4 @@
-# 🤖 NOFX - AI交易操作系统
+# NOFX - AI 交易系统
[](https://golang.org/)
[](https://reactjs.org/)
@@ -6,1043 +6,243 @@
[](LICENSE)
[](https://amber.ac)
-| 🎁 **贡献者空投计划** |
+| 贡献者空投计划 |
|:----------------------------------:|
-| 代码提交 · Bug修复 · Issue反馈 → 空投 |
-| [了解详情](#-贡献者空投计划) |
+| 代码 · Bug修复 · Issue → 空投奖励 |
+| [了解更多](#贡献者空投计划) |
-**语言 / Languages:** [English](../../../README.md) | [中文](../zh-CN/README.md) | [Українська](../uk/README.md) | [Русский](../ru/README.md) | [日本語](../ja/README.md) | [한국어](../ko/README.md) | [Tiếng Việt](../vi/README.md)
-
-**📚 文档中心:** [文档首页](../../README.md) | [快速开始](../../getting-started/README.zh-CN.md) | [更新日志](../../../CHANGELOG.zh-CN.md) | [社区指南](../../community/README.md) | [⚠️ 免责声明](../../../DISCLAIMER.md)
+**语言:** [English](../../../README.md) | [中文](README.md)
---
-## 📑 目录
+## AI 驱动的加密货币交易平台
-- [🚀 通用AI交易操作系统](#-通用ai交易操作系统)
-- [👥 开发者社区](#-开发者社区)
-- [📸 系统截图](#-系统截图)
-- [🏦 支持的交易所（DEX/CEX教程）](#-支持的交易所dexcex教程)
-- [🤖 支持的AI模型](#-支持的ai模型)
-- [✨ 当前实现](#-当前实现---加密货币市场)
-- [🔮 路线图](#-路线图---通用市场扩展)
-- [🏗️ 技术架构](#️-技术架构)
-- [🚀 快速开始](#-快速开始)
-- [📖 AI决策流程](#-ai决策流程)
-- [🧠 AI自我学习示例](#-ai自我学习示例)
-- [📊 Web界面功能](#-web界面功能)
-- [🎛️ API接口](#️-api接口)
-- [📝 决策日志格式](#-决策日志格式)
-- [🔧 风险控制详解](#-风险控制详解)
-- [⚠️ 重要风险提示](#️-重要风险提示)
-- [🛠️ 常见问题](#️-常见问题)
-- [📈 性能优化建议](#-性能优化建议)
-- [🔄 更新日志](#-更新日志)
-- [📄 开源协议](#-开源协议)
-- [🤝 贡献指南](#-贡献指南)
-- [🎁 贡献者空投计划](#-贡献者空投计划)
+**NOFX** 是一个开源的 AI 交易系统，让你可以运行多个 AI 模型自动交易加密货币期货。通过 Web 界面配置策略，实时监控表现，让多个 AI 代理竞争找出最佳交易方案。
----
+### 核心功能
-## 🚀 通用AI交易操作系统
+- **多 AI 支持**: 运行 DeepSeek、通义千问、GPT、Claude、Gemini、Grok、Kimi - 随时切换模型
+- **多交易所**: 在 Binance、Bybit、OKX、Hyperliquid、Aster DEX、Lighter 统一交易
+- **策略工作室**: 可视化策略构建器，配置币种来源、指标和风控参数
+- **AI 竞赛模式**: 多个 AI 交易员实时竞争，并排追踪表现
+- **Web 配置**: 无需编辑 JSON - 通过 Web 界面完成所有配置
+- **实时仪表板**: 实时持仓、盈亏追踪、AI 决策日志与思维链
-**NOFX** 是通用架构的 **AI交易操作系统（Agentic Trading OS）**。我们已在加密市场打通"**多智能体决策 → 统一风控 → 低延迟执行 → 真实/纸面账户复盘**"的闭环，正按同一技术栈扩展到**股票、期货、期权、外汇等所有市场**。
+### 由 [Amber.ac](https://amber.ac) 支持
-### 🎯 核心特性
-
-- **通用数据与回测层**：跨市场、跨周期、跨交易所统一表示与因子库，沉淀可迁移的"策略记忆"
-- **多智能体自博弈与自进化**：策略自动对战择优，按账户级 PnL 与风险约束持续迭代
-- **执行与风控一体化**：低延迟路由、滑点/风控沙箱、账户级限额，一键切换市场
-
-### 🏢 由 [Amber.ac](https://amber.ac) 背书
-
-### 👥 核心团队
+### 核心团队
- **Tinkle** - [@Web3Tinkle](https://x.com/Web3Tinkle)
-- **唯一官方推特** - [@nofx_official](https://x.com/nofx_official)
+- **官方 Twitter** - [@nofx_official](https://x.com/nofx_official)
-### 💼 种子轮融资进行中
+> **风险提示**: 本系统为实验性质。AI 自动交易存在重大风险。强烈建议仅用于学习/研究目的或小额测试！
-我们正在进行**种子轮融资**。
+## 开发者社区
-**投资咨询**，请通过 Twitter 私信联系 **Tinkle**。
+加入我们的 Telegram 开发者社区: **[NOFX 开发者社区](https://t.me/nofx_dev_community)**
---
-> ⚠️ **风险提示**：本系统为实验性项目，AI自动交易存在重大风险，强烈建议仅用于学习研究或小额资金测试！
+## 截图
-## 👥 开发者社区
-
-加入我们的Telegram开发者社区，讨论、分享想法并获得支持：
-
-**💬 [NOFX开发者社区](https://t.me/nofx_dev_community)**
-
----
-
-## 📸 系统截图
-
-### 🏆 竞赛模式 - AI实时对战
+### 竞赛模式 - 实时 AI 对战
-*多AI排行榜和实时性能对比图表，展示Qwen vs DeepSeek实时交易对战*
+*多 AI 排行榜，实时性能对比*
-### 📊 交易详情 - 完整交易仪表盘
-
-*专业交易界面，包含权益曲线、实时持仓、AI决策日志，支持展开查看输入提示词和AI思维链推理过程*
+### 仪表板 - 市场图表视图
+
+*专业交易仪表板，TradingView 风格图表*
-### 🎛️ 策略工作室 - 自定义策略构建器
+### 策略工作室
-*三栏式策略编辑器，支持多时间周期选择（5m/15m/1h/4h）、技术指标配置、风险控制设置，以及基于实时市场数据的AI测试运行*
+*多数据源策略配置与 AI 测试*
---
-## 🏦 支持的交易所（DEX/CEX教程）
+## 支持的交易所
-### CEX（中心化交易所）
+### CEX (中心化交易所)
-| 交易所 | 状态 | 注册（手续费优惠） | API设置 |
-|--------|------|-------------------|---------|
-| **Binance** | ✅ 已支持 | [注册](https://www.binance.com/join?ref=NOFXCHI) | [API指南](../../getting-started/binance-api.md) |
-| **Bybit** | ✅ 已支持 | [注册](https://partner.bybit.com/b/83856) | [API指南](../../getting-started/bybit-api.md) |
-| **OKX** | ✅ 已支持 | [注册](https://www.okx.com/join/1865360) | [API指南](../../getting-started/okx-api.md) |
+| 交易所 | 状态 | 注册 (手续费折扣) |
+|----------|--------|-------------------------|
+| **Binance** | ✅ 已支持 | [注册](https://www.binance.com/join?ref=NOFXENG) |
+| **Bybit** | ✅ 已支持 | [注册](https://partner.bybit.com/b/83856) |
+| **OKX** | ✅ 已支持 | [注册](https://www.okx.com/join/1865360) |
-### Perp-DEX（去中心化永续交易所）
+### Perp-DEX (去中心化永续交易所)
-| 交易所 | 状态 | 注册（手续费优惠） | 代理钱包设置 |
-|--------|------|-------------------|--------------|
-| **Hyperliquid** | ✅ 已支持 | [注册](https://app.hyperliquid.xyz/join/AITRADING) | [代理钱包指南](../../getting-started/hyperliquid-agent-wallet.md) |
-| **Aster DEX** | ✅ 已支持 | [注册](https://www.asterdex.com/en/referral/fdfc0e) | [API钱包指南](../../getting-started/aster-api-wallet.md) |
-| **Lighter** | ✅ 已支持 | [注册](https://lighter.xyz) | [代理钱包指南](../../getting-started/lighter-agent-wallet.md) |
+| 交易所 | 状态 | 注册 (手续费折扣) |
+|----------|--------|-------------------------|
+| **Hyperliquid** | ✅ 已支持 | [注册](https://app.hyperliquid.xyz/join/AITRADING) |
+| **Aster DEX** | ✅ 已支持 | [注册](https://www.asterdex.com/en/referral/fdfc0e) |
+| **Lighter** | ✅ 已支持 | [注册](https://lighter.xyz) |
---
-## 🤖 支持的AI模型
+## 支持的 AI 模型
-| AI模型 | 状态 | 获取API密钥 |
-|--------|------|-------------|
-| **DeepSeek** | ✅ 已支持 | [获取API密钥](https://platform.deepseek.com) |
-| **Qwen (通义千问)** | ✅ 已支持 | [获取API密钥](https://dashscope.console.aliyun.com) |
-| **OpenAI (GPT)** | ✅ 已支持 | [获取API密钥](https://platform.openai.com) |
-| **Claude** | ✅ 已支持 | [获取API密钥](https://console.anthropic.com) |
-| **Gemini** | ✅ 已支持 | [获取API密钥](https://aistudio.google.com) |
-| **Grok** | ✅ 已支持 | [获取API密钥](https://console.x.ai) |
-| **Kimi (月之暗面)** | ✅ 已支持 | [获取API密钥](https://platform.moonshot.cn) |
+| AI 模型 | 状态 | 获取 API Key |
+|----------|--------|-------------|
+| **DeepSeek** | ✅ 已支持 | [获取 API Key](https://platform.deepseek.com) |
+| **通义千问** | ✅ 已支持 | [获取 API Key](https://dashscope.console.aliyun.com) |
+| **OpenAI (GPT)** | ✅ 已支持 | [获取 API Key](https://platform.openai.com) |
+| **Claude** | ✅ 已支持 | [获取 API Key](https://console.anthropic.com) |
+| **Gemini** | ✅ 已支持 | [获取 API Key](https://aistudio.google.com) |
+| **Grok** | ✅ 已支持 | [获取 API Key](https://console.x.ai) |
+| **Kimi** | ✅ 已支持 | [获取 API Key](https://platform.moonshot.cn) |
---
-## ✨ 当前实现 - 加密货币市场
+## 快速开始
-NOFX 目前已在**加密货币市场全面运行**，具备以下经过验证的能力：
+### 方式一: Docker 部署 (推荐)
-### 🏆 多智能体竞赛框架
-- **实时智能体对战**：Qwen vs DeepSeek 模型实时交易竞赛
-- **独立账户管理**：每个智能体维护独立的决策日志和性能指标
-- **实时性能对比**：实时 ROI 追踪、胜率统计、正面对抗分析
-- **自进化循环**：智能体从历史表现中学习，持续改进
-
-### 🧠 AI 自学习与优化
-- **历史反馈系统**：每次决策前分析最近 20 个交易周期
-- **智能性能分析**：
- - 识别表现最佳/最差资产
- - 计算胜率、盈亏比、以真实 USDT 计的平均盈利
- - 避免重复错误（连续亏损模式）
- - 强化成功策略（高胜率模式）
-- **动态策略调整**：AI 根据回测结果自主调整交易风格
-
-### 📊 通用市场数据层（加密货币实现）
-- **多时间框架分析**：3分钟实时 + 4小时趋势数据
-- **技术指标**：EMA20/50、MACD、RSI(7/14)、ATR
-- **持仓量追踪**：市场情绪、资金流向分析
-- **流动性过滤**：自动过滤低流动性资产（<15M USD）
-- **跨交易所支持**：Binance、Hyperliquid、Aster DEX，统一数据接口
-
-### 🎯 统一风控系统
-- **仓位限制**：单资产限制（山寨币≤1.5x净值，BTC/ETH≤10x净值）
-- **可配置杠杆**：根据资产类别和账户类型动态调整 1x 到 50x
-- **保证金管理**：总使用率≤90%，AI 控制分配
-- **风险回报强制执行**：强制≥1:2 的止损止盈比
-- **防叠加保护**：防止同一资产/方向的重复仓位
-
-### ⚡ 低延迟执行引擎
-- **多交易所 API 集成**：Binance Futures、Hyperliquid DEX、Aster DEX
-- **自动精度处理**：每个交易所智能订单大小和价格格式化
-- **优先级执行**：先平仓现有持仓，再开新仓
-- **滑点控制**：执行前验证，实时精度检查
-
-### 🎨 专业监控界面
-- **币安风格仪表板**：专业暗色主题，实时更新
-- **净值曲线**：历史账户价值追踪（USD/百分比切换）
-- **性能图表**：多智能体 ROI 对比，实时更新
-- **完整决策日志**：每笔交易的完整思维链（CoT）推理
-- **5秒数据刷新**：实时账户、持仓和盈亏更新
-
----
-
-## 🔮 路线图 - 通用市场扩展
-
-NOFX 的使命是成为所有金融市场的**通用 AI 交易操作系统**。
-
-**愿景：** 相同架构。相同智能体框架。所有市场。
-
-**扩展市场：**
-- 📈 **股票市场**：美股、A股、港股
-- 📊 **期货市场**：商品期货、指数期货
-- 🎯 **期权交易**：股票期权、加密期权
-- 💱 **外汇市场**：主要货币对、交叉盘
-
-**即将推出的功能：**
-- 增强AI能力（GPT-4、Claude 3、Gemini Pro、灵活prompt模板）
-- 新交易所集成（OKX、Bybit、Lighter、EdgeX + CEX/Perp-DEX）
-- 项目结构重构（高内聚低耦合、SOLID原则）
-- 安全性增强（API密钥AES-256加密、RBAC、2FA改进）
-- 用户体验改进（移动端响应式、TradingView图表、告警系统）
-
-📖 **详细路线图和时间表，请参阅：**
-- **中文:** [路线图文档](../../roadmap/README.zh-CN.md)
-- **English:** [Roadmap Documentation](../../roadmap/README.md)
-
----
-
-## 🏗️ 技术架构
-
-NOFX 采用现代化的模块化架构：
-
-- **后端：** Go + Gin 框架，SQLite 数据库
-- **前端：** React 18 + TypeScript + Vite + TailwindCSS
-- **多交易所支持：** Binance、Hyperliquid、Aster DEX
-- **AI 集成：** DeepSeek、Qwen 及自定义 OpenAI 兼容 API
-- **状态管理：** 前端 Zustand，后端数据库驱动
-- **实时更新：** SWR，5-10 秒轮询间隔
-
-**核心特性：**
-- 🗄️ 数据库驱动的配置（无需编辑 JSON）
-- 🔐 JWT 认证，支持可选的 2FA
-- 📊 实时性能跟踪和分析
-- 🤖 多 AI 竞赛模式，实时对比
-- 🔌 RESTful API，完整的配置和监控
-
-📖 **详细架构文档，请查看：**
-- **中文版：** [架构文档](../../architecture/README.zh-CN.md)
-- **English:** [Architecture Documentation](../../architecture/README.md)
-
----
-
-## 🚀 快速开始
-
-### 🐳 方式A：Docker 一键部署（最简单 - 新手推荐！）
-
-**⚡ 使用Docker只需3步即可开始交易 - 无需安装任何环境！**
-
-Docker会自动处理所有依赖（Go、Node.js、TA-Lib）和环境配置，完美适合新手！
-
-#### 步骤1：准备配置文件
```bash
-# 复制配置文件模板
-cp config.json.example config.json
+# 克隆仓库
+git clone https://github.com/NoFxAiOS/nofx.git
+cd nofx
-# 编辑并填入你的API密钥
-nano config.json # 或使用其他编辑器
+# 使用 Docker 启动
+chmod +x ./start.sh
+./start.sh start --build
```
-⚠️ **注意**: 基础config.json仍需要一些设置，但~~交易员配置~~现在通过Web界面进行。
+访问 Web 界面: **http://localhost:3000**
-#### 步骤2：一键启动
```bash
-# 方式1：使用便捷脚本（推荐）
-chmod +x scripts/start.sh
-./scripts/start.sh start --build
-
-
-# 方式2：直接使用docker compose
-# 如果您还在使用旧的独立 `docker-compose`，请升级到 Docker Desktop 或 Docker 20.10+
-docker compose up -d --build
+# 管理命令
+./start.sh logs # 查看日志
+./start.sh status # 检查状态
+./start.sh stop # 停止服务
+./start.sh restart # 重启服务
```
-#### 步骤3：访问控制台
-在浏览器中打开：**http://localhost:3000**
+### 方式二: 手动安装
-**就是这么简单！🎉** 你的AI交易系统已经运行起来了！
-
-#### 管理你的系统
-```bash
-./scripts/start.sh logs # 查看日志
-./scripts/start.sh status # 检查状态
-./scripts/start.sh stop # 停止服务
-./scripts/start.sh restart # 重启服务
-```
-
-**📖 详细的Docker部署教程、故障排查和高级配置：**
-- **中文**: 查看 [DOCKER_DEPLOY.md](DOCKER_DEPLOY.md)
-- **English**: See [DOCKER_DEPLOY.en.md](DOCKER_DEPLOY.en.md)
-- **日本語**: [DOCKER_DEPLOY.ja.md](DOCKER_DEPLOY.ja.md)を参照
-
----
-
-### 📦 方式B：手动安装（开发者）
-
-**注意**：如果你使用了上面的Docker部署，请跳过本节。手动安装仅在你需要修改代码或不想使用Docker时需要。
-
-### 1. 环境要求
+#### 前置条件
- **Go 1.21+**
- **Node.js 18+**
-- **TA-Lib** 库（技术指标计算）
+- **TA-Lib** (技术指标库)
-#### 安装 TA-Lib
-
-**macOS:**
```bash
+# 安装 TA-Lib
+# macOS
brew install ta-lib
-```
-**Ubuntu/Debian:**
-```bash
+# Ubuntu/Debian
sudo apt-get install libta-lib0-dev
```
-**其他系统**: 参考 [TA-Lib官方文档](https://github.com/markcheno/go-talib)
-
-### 2. 克隆项目
+#### 安装步骤
```bash
-git clone
+# 1. 克隆仓库
+git clone https://github.com/NoFxAiOS/nofx.git
cd nofx
-```
-### 3. 安装依赖
-
-**后端:**
-```bash
+# 2. 安装后端依赖
go mod download
-```
-**前端:**
-```bash
+# 3. 安装前端依赖
cd web
npm install
cd ..
-```
-### 4. 获取AI API密钥
-
-在配置系统之前，您需要获取AI API密钥。请选择以下AI提供商之一：
-
-#### 选项1：DeepSeek（推荐新手）
-
-**为什么选择DeepSeek？**
-- 💰 比GPT-4便宜（约1/10成本）
-- 🚀 响应速度快
-- 🎯 交易决策质量优秀
-- 🌍 全球可用无需VPN
-
-**如何获取DeepSeek API密钥：**
-
-1. **访问**：[https://platform.deepseek.com](https://platform.deepseek.com)
-2. **注册**：使用邮箱/手机号注册
-3. **验证**：完成邮箱/手机验证
-4. **充值**：向账户添加余额
- - 最低：约$5美元
- - 推荐：$20-50美元用于测试
-5. **创建API密钥**：
- - 进入API Keys部分
- - 点击"创建新密钥"
- - 复制并保存密钥（以`sk-`开头）
- - ⚠️ **重要**：立即保存 - 之后无法再查看！
-
-**价格**：每百万tokens约$0.14（非常便宜！）
-
-#### 选项2：Qwen（阿里云通义千问）
-
-**如何获取Qwen API密钥：**
-
-1. **访问**：[https://dashscope.console.aliyun.com](https://dashscope.console.aliyun.com)
-2. **注册**：使用阿里云账户注册
-3. **开通服务**：激活DashScope服务
-4. **创建API密钥**：
- - 进入API密钥管理
- - 创建新密钥
- - 复制并保存（以`sk-`开头）
-
-**注意**：可能需要中国手机号注册
-
----
-
-### 5. 系统配置
-
-**两种配置模式可选：**
-- **🌟 新手模式**：单trader + 默认币种（推荐！）
-- **⚔️ 专家模式**：多trader竞赛
-
-#### 🌟 新手模式配置（推荐）
-
-~~**步骤1**：复制并重命名示例配置文件~~
-
-```bash
-cp config.json.example config.json
-```
-
-~~**步骤2**：编辑`config.json`填入您的API密钥~~
-
-*现在通过Web界面配置，无需编辑JSON文件*
-
-```json
-{
- "traders": [
- {
- "id": "my_trader",
- "name": "我的AI交易员",
- "ai_model": "deepseek",
- "binance_api_key": "YOUR_BINANCE_API_KEY",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY",
- "use_qwen": false,
- "deepseek_key": "sk-xxxxxxxxxxxxx",
- "qwen_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
- },
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**步骤3**：用您的实际密钥替换占位符
-
-| 占位符 | 替换为 | 哪里获取 |
-|-------|--------|---------|
-| `YOUR_BINANCE_API_KEY` | 您的币安API密钥 | 币安 → 账户 → API管理 |
-| `YOUR_BINANCE_SECRET_KEY` | 您的币安Secret密钥 | 同上 |
-| `sk-xxxxxxxxxxxxx` | 您的DeepSeek API密钥 | [platform.deepseek.com](https://platform.deepseek.com) |
-
-**步骤4**：调整初始余额（可选）
-
-- `initial_balance`：设置为您实际的币安合约账户余额
-- 用于计算盈亏百分比
-- 例如：如果您有500 USDT，设置`"initial_balance": 500.0`
-
-**✅ 配置检查清单：**
-
-- [ ] 币安API密钥已填写（无引号问题）
-- [ ] 币安Secret密钥已填写（无引号问题）
-- [ ] DeepSeek API密钥已填写（以`sk-`开头）
-- [ ] `use_default_coins`设为`true`（新手）
-- [ ] `initial_balance`与您的账户余额匹配
-- [ ] 文件保存为`config.json`（不是`.example`）
-
----
-
-#### ⚔️ 专家模式：多Trader竞赛
-
-用于运行多个AI trader相互竞争：
-
-```json
-{
- "traders": [
- {
- "id": "qwen_trader",
- "name": "Qwen AI Trader",
- "ai_model": "qwen",
- "binance_api_key": "YOUR_BINANCE_API_KEY_1",
- "binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
- "use_qwen": true,
- "qwen_key": "sk-xxxxx",
- "deepseek_key": "",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- },
- {
- "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,
- "qwen_key": "",
- "deepseek_key": "sk-xxxxx",
- "initial_balance": 1000.0,
- "scan_interval_minutes": 3
- }
- ],
- "use_default_coins": true,
- "coin_pool_api_url": "",
- "oi_top_api_url": "",
- "api_server_port": 8080
-}
-```
-
-**竞赛模式要求：**
-- 2个独立的币安合约账户（不同的API密钥）
-- 两种AI API密钥（Qwen + DeepSeek）
-- 更多测试资金（推荐：每个账户500+ USDT）
-
----
-
-#### 📚 配置字段详解
-
-| 字段 | 说明 | 示例值 | 是否必填？ |
-|-----|------|--------|-----------|
-| `id` | 此trader的唯一标识符 | `"my_trader"` | ✅ 是 |
-| `name` | 显示名称 | `"我的AI交易员"` | ✅ 是 |
-| `enabled` | 是否启用此trader
设为`false`可跳过启动 | `true` 或 `false` | ✅ 是 |
-| `ai_model` | 使用的AI提供商 | `"deepseek"` 或 `"qwen"` 或 `"custom"` | ✅ 是 |
-| `exchange` | 使用的交易所 | `"binance"` 或 `"hyperliquid"` 或 `"aster"` | ✅ 是 |
-| `binance_api_key` | 币安API密钥 | `"abc123..."` | 使用Binance时必填 |
-| `binance_secret_key` | 币安Secret密钥 | `"xyz789..."` | 使用Binance时必填 |
-| `hyperliquid_private_key` | Hyperliquid私钥
⚠️ 去掉`0x`前缀 | `"your_key..."` | 使用Hyperliquid时必填 |
-| `hyperliquid_wallet_addr` | Hyperliquid钱包地址 | `"0xabc..."` | 使用Hyperliquid时必填 |
-| `hyperliquid_testnet` | 是否使用测试网 | `true` 或 `false` | ❌ 否（默认false） |
-| `use_qwen` | 是否使用Qwen | `true` 或 `false` | ✅ 是 |
-| `deepseek_key` | DeepSeek API密钥 | `"sk-xxx"` | 使用DeepSeek时必填 |
-| `qwen_key` | Qwen API密钥 | `"sk-xxx"` | 使用Qwen时必填 |
-| `initial_balance` | 用于P/L计算的起始余额 | `1000.0` | ✅ 是 |
-| `scan_interval_minutes` | 决策频率（分钟） | `3`（建议3-5） | ✅ 是 |
-| **`leverage`** | **杠杆配置 (v2.0.3+)** | 见下文 | ✅ 是 |
-| `btc_eth_leverage` | BTC/ETH最大杠杆
⚠️ 子账户：≤5倍 | `5`（默认，安全）
`50`（主账户最大） | ✅ 是 |
-| `altcoin_leverage` | 山寨币最大杠杆
⚠️ 子账户：≤5倍 | `5`（默认，安全）
`20`（主账户最大） | ✅ 是 |
-| `use_default_coins` | 使用内置币种列表
**✨ 智能默认：`true`** (v2.0.2+)
未提供API时自动启用 | `true` 或省略 | ❌ 否
(可选，自动默认) |
-| `coin_pool_api_url` | 自定义币种池API
*仅当`use_default_coins: false`时需要* | `""`（空） | ❌ 否 |
-| `oi_top_api_url` | 持仓量API
*可选补充数据* | `""`（空） | ❌ 否 |
-| `api_server_port` | Web仪表板端口 | `8080` | ✅ 是 |
-
-**默认交易币种**（当 `use_default_coins: true` 时）：
-- BTC、ETH、SOL、BNB、XRP、DOGE、ADA、HYPE
-
----
-
-#### ⚙️ 杠杆配置 (v2.0.3+)
-
-**什么是杠杆配置？**
-
-杠杆设置控制AI每次交易可以使用的最大杠杆。这对于风险管理至关重要，特别是对于有杠杆限制的币安子账户。
-
-**配置格式：**
-
-```json
-"leverage": {
- "btc_eth_leverage": 5, // BTC和ETH的最大杠杆
- "altcoin_leverage": 5 // 所有其他币种的最大杠杆
-}
-```
-
-**⚠️ 重要：币安子账户限制**
-
-- **子账户**：币安限制为**≤5倍杠杆**
-- **主账户**：可使用最高20倍（山寨币）或50倍（BTC/ETH）
-- 如果您使用子账户并设置杠杆>5倍，交易将**失败**，错误信息：`Subaccounts are restricted from using leverage greater than 5x`
-
-**推荐设置：**
-
-| 账户类型 | BTC/ETH杠杆 | 山寨币杠杆 | 风险级别 |
-|---------|------------|-----------|---------|
-| **子账户** | `5` | `5` | ✅ 安全（默认） |
-| **主账户（保守）** | `10` | `10` | 🟡 中等 |
-| **主账户（激进）** | `20` | `15` | 🔴 高 |
-| **主账户（最大）** | `50` | `20` | 🔴🔴 非常高 |
-
-**示例：**
-
-**安全配置（子账户或保守）：**
-```json
-"leverage": {
- "btc_eth_leverage": 5,
- "altcoin_leverage": 5
-}
-```
-
-**激进配置（仅主账户）：**
-```json
-"leverage": {
- "btc_eth_leverage": 20,
- "altcoin_leverage": 15
-}
-```
-
-**AI如何使用杠杆：**
-
-- AI可以选择**从1倍到您配置的最大值之间的任何杠杆**
-- 例如，当`altcoin_leverage: 20`时，AI可能根据市场情况决定使用5倍、10倍或20倍
-- 配置设置的是**上限**，而不是固定值
-- AI在选择杠杆时会考虑波动性、风险回报比和账户余额
-
----
-
-#### ⚠️ 重要：`use_default_coins` 字段
-
-**智能默认行为（v2.0.2+）：**
-
-系统现在会自动默认为`use_default_coins: true`，如果：
-- 您在config.json中未包含此字段，或
-- 您将其设为`false`但未提供`coin_pool_api_url`
-
-这让新手更友好！您甚至可以完全省略此字段。
-
-**配置示例：**
-
-✅ **选项1：显式设置（推荐以保持清晰）**
-```json
-"use_default_coins": true,
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-✅ **选项2：省略字段（自动使用默认币种）**
-```json
-// 完全不包含"use_default_coins"
-"coin_pool_api_url": "",
-"oi_top_api_url": ""
-```
-
-⚙️ **高级：使用外部API**
-```json
-"use_default_coins": false,
-"coin_pool_api_url": "http://your-api.com/coins",
-"oi_top_api_url": "http://your-api.com/oi"
-```
-
----
-
-### 6. 运行系统
-
-#### 🚀 启动系统（2个步骤）
-
-系统有**2个部分**需要分别运行：
-1. **后端**（AI交易大脑 + API）
-2. **前端**（Web监控仪表板）
-
----
-
-#### **步骤1：启动后端**
-
-打开终端并运行：
-
-```bash
-# 构建程序（首次运行或代码更改后）
+# 4. 构建并启动后端
go build -o nofx
-
-# 启动后端
./nofx
-```
-**您应该看到：**
-
-```
-🚀 启动自动交易系统...
-✓ Trader [my_trader] 已初始化
-✓ API服务器启动在端口 8080
-📊 开始交易监控...
-```
-
-**⚠️ 如果看到错误：**
-
-| 错误信息 | 解决方案 |
-|---------|---------|
-| `invalid API key` | ~~检查config.json中的币安API密钥~~ *检查Web界面中的API密钥* |
-| `TA-Lib not found` | 运行`brew install ta-lib`（macOS） |
-| `port 8080 already in use` | ~~修改config.json中的`api_server_port`~~ *修改.env文件中的`API_PORT`* |
-| `DeepSeek API error` | 验证DeepSeek API密钥和余额 |
-
-**✅ 后端运行正常的标志：**
-- 无错误信息
-- 出现"开始交易监控..."
-- 系统显示账户余额
-- 保持此终端窗口打开！
-
----
-
-#### **步骤2：启动前端**
-
-打开**新的终端窗口**（保持第一个运行！），然后：
-
-```bash
+# 5. 启动前端 (新终端)
cd web
npm run dev
```
-**您应该看到：**
+访问 Web 界面: **http://localhost:3000**
+---
+
+## 初始配置 (Web 界面)
+
+启动系统后，通过 Web 界面进行配置:
+
+1. **配置 AI 模型** - 添加你的 AI API 密钥 (DeepSeek, OpenAI 等)
+2. **配置交易所** - 设置交易所 API 凭证
+3. **创建策略** - 在策略工作室配置交易策略
+4. **创建交易员** - 组合 AI 模型 + 交易所 + 策略
+5. **开始交易** - 启动你配置的交易员
+
+所有配置都通过 Web 界面完成 - 无需编辑 JSON 文件。
+
+---
+
+## Web 界面功能
+
+### 竞赛页面
+- 实时 ROI 排行榜
+- 多 AI 性能对比图表
+- 实时盈亏追踪和排名
+
+### 仪表板
+- TradingView 风格 K 线图
+- 实时持仓管理
+- AI 决策日志与思维链推理
+- 权益曲线追踪
+
+### 策略工作室
+- 币种来源配置 (静态列表、AI500 池、OI Top)
+- 技术指标 (EMA, MACD, RSI, ATR, 成交量, OI, 资金费率)
+- 风控设置 (杠杆、仓位限制、保证金使用率)
+- AI 测试与实时提示词预览
+
+---
+
+## API 接口
+
+### 交易员管理
```
-VITE v5.x.x ready in xxx ms
-
-➜ Local: http://localhost:3000/
-➜ Network: use --host to expose
+GET /api/traders # 列出所有交易员
+POST /api/traders # 创建新交易员
+DELETE /api/traders/:id # 删除交易员
+POST /api/traders/:id/start # 启动交易员
+POST /api/traders/:id/stop # 停止交易员
```
-**✅ 前端运行正常的标志：**
-- "Local: http://localhost:3000/"消息
-- 无错误信息
-- 也保持此终端窗口打开！
-
----
-
-#### **步骤3：访问仪表板**
-
-在Web浏览器中访问：
-
-**🌐 http://localhost:3000**
-
-**您将看到：**
-- 📊 实时账户余额
-- 📈 持仓（如果有）
-- 🤖 AI决策日志
-- 📉 净值曲线图
-
-**首次使用提示：**
-- 首次AI决策可能需要3-5分钟
-- 初始决策可能显示"观望"- 这是正常的
-- AI需要先分析市场状况
-
----
-
-### 7. 监控系统
-
-**需要关注的内容：**
-
-✅ **健康系统标志：**
-- 后端终端每3-5分钟显示决策周期
-- 无持续错误信息
-- 账户余额更新
-- Web仪表板自动刷新
-
-⚠️ **警告标志：**
-- 重复的API错误
-- 10分钟以上无决策
-- 余额快速下降
-
-**检查系统状态：**
-
-```bash
-# 在新终端窗口中
-curl http://localhost:8080/api/health
+### 策略管理
+```
+GET /api/strategies # 列出所有策略
+POST /api/strategies # 创建新策略
+PUT /api/strategies/:id # 更新策略
+DELETE /api/strategies/:id # 删除策略
```
-应返回：`{"status":"ok"}`
-
----
-
-### 8. 停止系统
-
-**优雅关闭（推荐）：**
-
-1. 转到**后端终端**（第一个）
-2. 按`Ctrl+C`
-3. 等待"系统已停止"消息
-4. 转到**前端终端**（第二个）
-5. 按`Ctrl+C`
-
-**⚠️ 重要：**
-- 始终先停止后端
-- 关闭终端前等待确认
-- 不要强制退出（不要直接关闭终端）
-
----
-
-## 📖 AI决策流程
-
-每个决策周期（默认3分钟），系统按以下流程运行：
-
-### 步骤1: 📊 分析历史表现（最近20个周期）
-- ✓ 计算整体胜率、平均盈利、盈亏比
-- ✓ 统计各币种表现（胜率、平均USDT盈亏）
-- ✓ 识别最佳/最差币种
-- ✓ 列出最近5笔交易详情（含准确盈亏金额）
-- ✓ 计算夏普比率衡量风险调整后收益
-- 📌 **新增 (v2.0.2)**: 考虑杠杆的准确USDT盈亏计算
-
-**↓**
-
-### 步骤2: 💰 获取账户状态
-- 账户净值、可用余额、未实现盈亏
-- 持仓数量、总盈亏（已实现+未实现）
-- 保证金使用率（current/maximum）
-- 风险评估指标
-
-**↓**
-
-### 步骤3: 🔍 分析现有持仓（如果有）
-- 获取每个持仓的市场数据（3分钟+4小时K线）
-- 计算技术指标（RSI、MACD、EMA）
-- 显示持仓时长（例如"持仓时长2小时15分钟"）
-- AI判断是否需要平仓（止盈、止损或调整）
-- 📌 **新增 (v2.0.2)**: 追踪持仓时长帮助AI决策
-
-**↓**
-
-### 步骤4: 🎯 评估新机会（候选币种池）
-- 获取币种池（2种模式）：
- - 🌟 **默认模式**: BTC、ETH、SOL、BNB、XRP等
- - ⚙️ **高级模式**: AI500（前20） + OI Top（前20）
-- 合并去重，过滤低流动性币种（持仓量<15M USD）
-- 批量获取市场数据和技术指标
-- 为每个候选币种准备完整的原始数据序列
-
-**↓**
-
-### 步骤5: 🧠 AI综合决策
-- 查看历史反馈（胜率、盈亏比、最佳/最差币种）
-- 接收所有原始序列数据（K线、指标、持仓量）
-- Chain of Thought 思维链分析
-- 输出决策：平仓/开仓/持有/观望
-- 包含杠杆、仓位、止损、止盈参数
-- 📌 **新增 (v2.0.2)**: AI可自由分析原始序列，不受预定义指标限制
-
-**↓**
-
-### 步骤6: ⚡ 执行交易
-- 优先级排序：先平仓，再开仓
-- 精度自动适配（LOT_SIZE规则）
-- 防止仓位叠加（同币种同方向拒绝开仓）
-- 平仓后自动取消所有挂单
-- 记录开仓时间用于持仓时长追踪
-- 📌 追踪持仓开仓时间
-
-**↓**
-
-### 步骤7: 📝 记录日志
-- 保存完整决策记录到 `decision_logs/`
-- 包含思维链、决策JSON、账户快照、执行结果
-- 存储完整持仓数据（数量、杠杆、开/平仓时间）
-- 使用 `symbol_side` 键值防止多空冲突
-- 📌 **新增 (v2.0.2)**: 防止多空持仓冲突，考虑数量+杠杆
-
-**↓**
-
-**🔄 （每3-5分钟重复一次）**
-
-### v2.0.2的核心改进
-
-**📌 持仓时长追踪：**
-- 系统现在追踪每个持仓已持有多长时间
-- 在用户提示中显示："持仓时长2小时15分钟"
-- 帮助AI更好地判断何时退出仓位
-
-**📌 准确的盈亏计算：**
-- 之前：只显示百分比（100U@5% = 1000U@5% = 都显示"5.0"）
-- 现在：真实USDT盈亏 = 仓位价值 × 价格变化% × 杠杆倍数
-- 示例：1000 USDT × 5% × 20倍 = 1000 USDT实际盈利
-
-**📌 增强的AI自由度：**
-- AI可以自由分析所有原始序列数据
-- 不再局限于预定义的指标组合
-- 可以执行自己的趋势分析、支撑位/阻力位计算
-
-**📌 改进的持仓追踪：**
-- 使用`symbol_side`键值（例如"BTCUSDT_long"）
-- 防止同时持有多空仓时的冲突
-- 存储完整数据：数量、杠杆、开/平仓时间
-
----
-
-## 🧠 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 /api/health # 健康检查
-GET /api/config # 系统配置
+GET /api/status?trader_id=xxx # 系统状态
+GET /api/account?trader_id=xxx # 账户信息
+GET /api/positions?trader_id=xxx # 持仓列表
+GET /api/decisions/latest?trader_id=xxx # 最新决策
```
---
-## 📝 决策日志格式
+## 风险提示
-每次AI决策都会生成详细的JSON日志：
+1. **加密货币市场波动剧烈** - AI 决策不保证盈利
+2. **期货交易使用杠杆** - 亏损可能超过本金
+3. **极端行情** 可能导致爆仓风险
-### 日志文件路径
-```
-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
-}
-```
+**建议:**
+- 仅使用可承受损失的资金
+- 从小额开始 (100-500 USDT)
+- 定期监控系统运行状态
+- 不要长时间无人值守运行
---
-## 🔧 风险控制详解
+## 常见问题
-### 单币种仓位限制
-
-| 币种类型 | 仓位价值上限 | 杠杆 | 保证金占用 | 示例（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库
+### TA-Lib 未找到
```bash
# macOS
brew install ta-lib
@@ -1051,145 +251,56 @@ brew install ta-lib
sudo apt-get install libta-lib0-dev
```
-### 2. 精度错误：Precision is over the maximum
+### AI API 超时
+- 检查 API 密钥是否正确
+- 检查网络连接
+- 系统超时时间为 120 秒
-**解决**: 系统已自动处理精度，从Binance获取LOT_SIZE。如仍报错，检查网络连接。
-
-### 3. AI API超时
-
-**解决**:
-- 检查API密钥是否正确
-- 检查网络连接（可能需要代理）
-- 系统超时时间已设置为120秒
-
-### 4. 前端无法连接后端
-
-**解决**:
-- 确保后端正在运行（http://localhost:8080）
-- 检查端口8080是否被占用
-- 查看浏览器控制台错误信息
-
-### 5. 币种池API失败
-
-**解决**:
-- 币种池API是可选的
-- 如果API失败，系统会使用默认主流币种（BTC、ETH等）
-- ~~检查config.json中的API URL和auth参数~~ *检查Web界面中的配置*
+### 前端无法连接后端
+- 确保后端运行在 http://localhost:8080
+- 检查端口是否被占用
---
-## 📈 性能优化建议
+## 许可证
-1. **合理设置决策周期**: 建议3-5分钟，避免过度交易
-2. **控制候选币种数量**: 系统默认分析AI500前20 + OI Top前20
-3. **定期清理日志**: 避免占用过多磁盘空间
-4. **监控API调用次数**: 避免触发Binance限流（权重限制）
-5. **小额资金测试**: 先用100-500 USDT测试策略有效性
+本项目采用 **GNU Affero General Public License v3.0 (AGPL-3.0)** 许可 - 详见 [LICENSE](../../../LICENSE) 文件。
---
-## 🔄 更新日志
+## 贡献
-📖 **详细的版本历史和更新，请查看：**
-
-- **中文版：** [CHANGELOG.zh-CN.md](../../../CHANGELOG.zh-CN.md)
-- **English:** [CHANGELOG.md](../../../CHANGELOG.md)
-
-**最新版本：** v3.0.0 (2025-10-30) - 重大架构变革
-
-**近期亮点：**
-- 🚀 完整系统重新设计，基于Web的配置平台
-- 🗄️ 数据库驱动架构（SQLite）
-- 🎨 无需编辑JSON - 全部通过Web界面配置
-- 🔧 AI模型与交易所任意组合
-- 📊 增强的API层，提供全面的端点
+欢迎贡献！查看:
+- **[贡献指南](../../../CONTRIBUTING.md)** - 开发流程和 PR 流程
+- **[行为准则](../../../CODE_OF_CONDUCT.md)** - 社区准则
+- **[安全政策](../../../SECURITY.md)** - 报告漏洞
---
-## 📄 开源协议
+## 贡献者空投计划
-本项目采用 **GNU Affero 通用公共许可证 v3.0 (AGPL-3.0)** - 详见 [LICENSE](LICENSE) 文件
+所有贡献都在 GitHub 上追踪。当 NOFX 产生收入时，贡献者将根据其贡献获得空投。
-**这意味着什么：**
-- ✅ 你可以使用、修改和分发此软件
-- ✅ 你必须公开你修改版本的源代码
-- ✅ 如果你在服务器上运行修改版本，必须向用户提供源代码
-- ✅ 所有衍生作品也必须使用 AGPL-3.0 许可证
+**解决 [置顶 Issue](https://github.com/NoFxAiOS/nofx/issues) 的 PR 获得最高奖励！**
-如需商业许可或有疑问,请联系维护者。
+| 贡献类型 | 权重 |
+|------------------|:------:|
+| **置顶 Issue PR** | ⭐⭐⭐⭐⭐⭐ |
+| **代码提交** (合并的 PR) | ⭐⭐⭐⭐⭐ |
+| **Bug 修复** | ⭐⭐⭐⭐ |
+| **功能建议** | ⭐⭐⭐ |
+| **Bug 报告** | ⭐⭐ |
+| **文档** | ⭐⭐ |
---
-## 🤝 贡献
+## 联系方式
-欢迎提交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 Issues**: [提交 Issue](https://github.com/NoFxAiOS/nofx/issues)
+- **开发者社区**: [Telegram 群组](https://t.me/nofx_dev_community)
---
-## 🎁 贡献者空投计划
+## Star 历史
-所有贡献都会在 GitHub 上记录。当 NOFX 产生收益时，贡献者将根据贡献获得空投。
-
-### 🔥 重点奖励：置顶Issue
-
-**解决 [置顶Issue](https://github.com/NoFxAiOS/nofx/issues) 的PR将获得最高奖励！**
-
-查看我们的置顶Issue，了解高优先级功能和Bug - 这些都有额外奖励加成。
-
-### 贡献权重
-
-| 贡献类型 | 权重 | 说明 |
-|---------|:----:|------|
-| **🔥 置顶Issue PR** | ⭐⭐⭐⭐⭐⭐ | 解决置顶/优先Issue的PR（最高奖励） |
-| **代码提交** (合并的PR) | ⭐⭐⭐⭐⭐ | 核心功能、优化、新集成 |
-| **Bug修复** | ⭐⭐⭐⭐ | 修复已确认的Bug |
-| **功能建议** (被采纳的Issue) | ⭐⭐⭐ | 被实现的想法和建议 |
-| **Bug反馈** (已确认) | ⭐⭐ | 提交可复现的有效Bug |
-| **文档贡献** | ⭐⭐ | 翻译、指南、教程 |
-
-### 运作方式
-
-1. **查看置顶Issue** - 高优先级任务，额外奖励
-2. **贡献** - 提交PR、报告Bug、建议功能
-3. **记录** - 所有贡献通过GitHub活动记录
-4. **获得** - 按贡献权重比例获得空投
-
-> 💡 从 [置顶Issue](https://github.com/NoFxAiOS/nofx/issues) 开始，获得最高奖励！
-
----
-
-## 📬 联系方式
-
-### 🐛 技术支持
-- **GitHub Issues**: [提交Issue](https://github.com/tinkle-community/nofx/issues)
-- **开发者社区**: [Telegram群组](https://t.me/nofx_dev_community)
-
----
-
-## 🙏 致谢
-
-- [Binance API](https://binance-docs.github.io/apidocs/futures/cn/) - 币安合约API
-- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API
-- [Qwen](https://dashscope.console.aliyun.com/) - 阿里云通义千问
-- [TA-Lib](https://ta-lib.org/) - 技术指标库
-- [Recharts](https://recharts.org/) - React图表库
-
----
-
-**最后更新**: 2025-10-29 (v2.0.2)
-
-**⚡ 用AI的力量，探索量化交易的可能性！**
-
----
-
-## ⭐ Star History
-
-[](https://star-history.com/#tinkle-community/nofx&Date)
+[](https://star-history.com/#NoFxAiOS/nofx&Date)