nofx/CHANGELOG.md

Changelog

All notable changes to the NOFX project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Languages: English | 中文

---

[Unreleased]

Added

• Documentation system with multi-language support (EN/CN/RU/UK)
• Complete getting-started guides (Docker, Custom API)
• Architecture documentation with system design details
• User guides with FAQ and troubleshooting
• Community documentation with bounty programs

Changed

• Reorganized documentation structure into logical categories
• Updated all README files with proper navigation links

---

[3.0.0] - 2025-10-30

Added - Major Architecture Transformation 🚀

Complete System Redesign - Web-Based Configuration Platform

This is a major breaking update that completely transforms NOFX from a static config-based system to a modern web-based trading platform.

Database-Driven Architecture

• SQLite integration replacing static JSON config
• Persistent storage with automatic timestamps
• Foreign key relationships and triggers for data consistency
• Separate tables for AI models, exchanges, traders, and system config

Web-Based Configuration Interface

• Complete web-based configuration management (no more JSON editing)
• AI Model setup through web interface (DeepSeek/Qwen API keys)
• Exchange management (Binance/Hyperliquid credentials)
• Dynamic trader creation (combine any AI model with any exchange)
• Real-time control (start/stop traders without system restart)

Flexible Architecture

• Separation of concerns (AI models and exchanges independent)
• Mix & match capability (unlimited combinations)
• Scalable design (support for unlimited traders)
• Clean slate approach (no default traders)

Enhanced API Layer

• RESTful design with complete CRUD operations
• New endpoints:
  • GET/PUT /api/models - AI model configuration
  • GET/PUT /api/exchanges - Exchange configuration
  • POST/DELETE /api/traders - Trader management
  • POST /api/traders/:id/start|stop - Trader control
• Updated documentation for all API endpoints

Modernized Codebase

• Type safety with proper separation of configuration types
• Database abstraction with prepared statements
• Comprehensive error handling and validation
• Better code organization (database, API, business logic)

Changed

• BREAKING: Old config.json files no longer used
• Configuration must be done through web interface
• Much easier setup and better UX
• No more server restarts for configuration changes

Why This Matters

• 🎯 User Experience: Much easier to configure and manage
• 🔧 Flexibility: Create any combination of AI models and exchanges
• 📊 Scalability: Support for complex multi-trader setups
• 🔒 Reliability: Database ensures data persistence and consistency
• 🚀 Future-Proof: Foundation for advanced features

---

[2.0.2] - 2025-10-29

Fixed - Critical Bug Fixes: Trade History & Performance Analysis

PnL Calculation - Major Error Fixed

• Fixed: PnL now calculated as actual USDT amount instead of percentage only
• Previously ignored position size and leverage (e.g., 100 USDT @ 5% = 1000 USDT @ 5%)
• Now: PnL (USDT) = Position Value × Price Change % × Leverage
• Impact: Win rate, profit factor, and Sharpe ratio now accurate

Position Tracking - Missing Critical Data

• Fixed: Open position records now store quantity and leverage
• Previously only stored price and time
• Essential for accurate PnL calculations

Position Key Logic - Long/Short Conflict

• Fixed: Changed from symbol to symbol_side format
• Now properly distinguishes between long and short positions
• Example: BTCUSDT_long vs BTCUSDT_short

Sharpe Ratio Calculation - Code Optimization

• Changed: Replaced custom Newton's method with math.Sqrt
• More reliable, maintainable, and efficient

Why This Matters

• Historical trade statistics now show real USDT profit/loss
• Performance comparison between different leverage trades is accurate
• AI self-learning mechanism receives correct feedback
• Multi-position tracking (long + short simultaneously) works correctly

---

[2.0.2] - 2025-10-29

Fixed - Aster Exchange Precision Error

• Fixed Aster exchange precision error (code -1111)
• Improved price and quantity formatting to match exchange requirements
• Added detailed precision processing logs for debugging
• Enhanced all order functions with proper precision handling

Technical Details

• Added formatFloatWithPrecision function
• Price and quantity formatted according to exchange specifications
• Trailing zeros removed to optimize API requests

---

[2.0.1] - 2025-10-29

Fixed - ComparisonChart Data Processing

• Fixed ComparisonChart data processing logic
• Switched from cycle_number to timestamp grouping
• Resolved chart freezing issue when backend restarts
• Improved chart data display (shows all historical data chronologically)
• Enhanced debugging logs

---

[2.0.0] - 2025-10-28

Added - Major Updates

• AI self-learning mechanism (historical feedback, performance analysis)
• Multi-trader competition mode (Qwen vs DeepSeek)
• Binance-style UI (complete interface imitation)
• Performance comparison charts (real-time ROI comparison)
• Risk control optimization (per-coin position limit adjustment)

Fixed

• Fixed hardcoded initial balance issue
• Fixed multi-trader data sync issue
• Optimized chart data alignment (using cycle_number)

---

[1.0.0] - 2025-10-27

Added - Initial Release

• Basic AI trading functionality
• Decision logging system
• Simple Web interface
• Support for Binance Futures
• DeepSeek and Qwen AI model integration

---

How to Use This Changelog

For Users

• Check the [Unreleased] section for upcoming features
• Review version sections to understand what changed
• Follow migration guides for breaking changes

For Contributors

When making changes, add them to the [Unreleased] section under appropriate categories:

• Added - New features
• Changed - Changes to existing functionality
• Deprecated - Features that will be removed
• Removed - Features that were removed
• Fixed - Bug fixes
• Security - Security fixes

When releasing a new version, move [Unreleased] items to a new version section with date.

---

Links

• Documentation
• Contributing Guidelines
• Security Policy
• GitHub Repository

---

Last Updated: 2025-11-01