mirror of https://github.com/laoxong/nofx.git synced 2026-06-04 09:58:22 +08:00

Files

T

tinkle-community 94ef009bb5 refactor: remove all Debate Arena feature code

Remove the entire AI Debate Arena module (~5,300 lines) to simplify
the codebase. This removes the multi-AI debate trading decision system
including backend engine, API handlers, database store, frontend page,
navigation, translations, and documentation references.

2026-03-11 17:32:41 +08:00

6.7 KiB

Raw Blame History

NOFX Architecture Documentation

Language: English | 中文

Technical documentation for developers who want to understand NOFX internals.

Overview

NOFX is a full-stack AI trading platform for cryptocurrency and US stock markets:

Backend: Go (Gin framework, SQLite)
Frontend: React/TypeScript (Vite, TailwindCSS)
AI Models: DeepSeek, Qwen, OpenAI (GPT-5.2), Claude, Gemini, Grok, Kimi
Exchanges: Binance, Bybit, OKX, Hyperliquid, Aster, Lighter

System Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                              NOFX Platform                                  │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐│
│  │  Strategy   │  │  Backtest   │  │   Live Trading      ││
│  │   Studio    │  │   Engine    │  │   (Auto Trader)     ││
│  └──────┬──────┘  └──────┬──────┘  └──────────┬──────────┘│
│         │                │                    │           │
│         └────────────────┴────────────────────┘           │
│                                    │                                        │
│                          ┌─────────▼─────────┐                              │
│                          │   Core Services   │                              │
│                          │  - Market Data    │                              │
│                          │  - AI Providers   │                              │
│                          │  - Risk Control   │                              │
│                          └─────────┬─────────┘                              │
│                                    │                                        │
│         ┌──────────────────────────┼──────────────────────────┐            │
│         │                          │                          │            │
│  ┌──────▼──────┐         ┌─────────▼─────────┐      ┌────────▼────────┐   │
│  │  Exchanges  │         │     Database      │      │   Frontend UI   │   │
│  │  (CEX/DEX)  │         │    (SQLite)       │      │   (React SPA)   │   │
│  └─────────────┘         └───────────────────┘      └─────────────────┘   │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

Module Documentation

Core Modules

Module	Description	Documentation
Strategy Studio	Strategy configuration, coin selection, data assembly, AI prompts	STRATEGY_MODULE.md
Backtest Engine	Historical simulation, performance metrics, AI decision replay	BACKTEST_MODULE.md

Module Overview

Strategy Module

Complete strategy configuration system including:

Coin source selection (static list, AI500 pool, OI ranking)
Market data indicators (K-lines, EMA, MACD, RSI, ATR)
Prompt construction (system prompt, user prompt, sections)
AI response parsing and decision execution
Risk control enforcement

Read Full Documentation →

Backtest Module

Historical trading simulation engine:

Multi-symbol, multi-timeframe backtesting
AI decision replay with caching
Performance metrics (Sharpe, drawdown, win rate)
Real-time progress streaming via SSE
Checkpoint and resume support

Read Full Documentation →

Project Structure

nofx/
├── main.go                    # Entry point
├── api/                       # HTTP API (Gin framework)
├── trader/                    # Trading execution layer
├── strategy/                  # Strategy engine
├── backtest/                  # Backtest simulation engine
├── market/                    # Market data service
├── mcp/                       # AI model clients
├── store/                     # Database operations
├── auth/                      # JWT authentication
├── manager/                   # Multi-trader management
└── web/                       # React frontend
    ├── src/pages/             # Page components
    ├── src/components/        # Shared components
    └── src/lib/api.ts         # API client

Core Dependencies

Backend (Go)

Package	Purpose
`gin-gonic/gin`	HTTP API framework
`adshao/go-binance`	Binance API client
`markcheno/go-talib`	Technical indicators
`golang-jwt/jwt`	JWT authentication

Frontend (React)

Package	Purpose
`react`	UI framework
`recharts`	Charts and visualizations
`swr`	Data fetching
`zustand`	State management
`tailwindcss`	CSS framework

Quick Links

Strategy Module - How strategies work
Backtest Module - How backtesting works
Getting Started - Setup guide
FAQ - Frequently asked questions

For Developers

Want to contribute?

Read the module documentation above
Check Open Issues
Join our community

Repository: https://github.com/NoFxAiOS/nofx

← Back to Documentation

6.7 KiB Raw Blame History