mirror of
https://github.com/laoxong/nofx.git
synced 2026-06-04 09:58:22 +08:00
docs: rewrite README with updated features and deployment guide
- Update project description to reflect current AI trading platform - Rewrite Core Features with 6 key capabilities - Add complete deployment guide (Docker + manual installation) - Update all i18n versions (zh-CN, ja, ko, ru, uk, vi) - Remove outdated JSON config examples
This commit is contained in:
tinkle-community
+58
-1204
File diff suppressed because it is too large
Load Diff
+57
-696
@@ -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)
|
||||
|
||||
+57
-1237
File diff suppressed because it is too large
Load Diff
+57
-1209
File diff suppressed because it is too large
Load Diff
+51
-633
@@ -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)
|
||||
|
||||
+176
-1065
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user