# 🤖 NOFX - Hệ Điều Hành Giao Dịch Tự Động

[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/)
[![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
[![Backed by Amber.ac](https://img.shields.io/badge/Backed%20by-Amber.ac-orange.svg)](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)

---

## 📑 Mục lục

- [🚀 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)

---

## 🚀 Hệ Điều Hành Giao Dịch AI Toàn Diện

**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í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
![Trang Cạnh Tranh](screenshots/competition-page.png)
*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
![Trang Chi Tiết](screenshots/details-page.png)
*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ị)
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**

**Xong! 🎉** Nền tảng giao dịch AI của bạn đã chạy!

#### 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ụ
```

**📖 Để 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
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
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

# Khởi động backend
./nofx
```

**Đ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

**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

---

### 📝 Hướng Dẫn Đăng Ký & Thiết Lập

**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`)

---

Cấu hình qua giao diện web

```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.

---

#### 🔶 Sử Dụng Sàn Aster DEX

**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!**
