@@ -0,0 +1,753 @@
# 🤖 NOFX - Agentic Trading OS
[](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 ) | [한국어 ](README.md )
* * 📚 문서:** [문서 홈 ](../../README.md ) | [시작 가이드 ](../../getting-started/README.md ) | [커뮤니티 ](../../community/README.md ) | [변경 로그 ](../../../CHANGELOG.md )
---
## 📑 목차
- [🚀 범용 AI 트레이딩 운영 체제 ](#-범용-ai-트레이딩-운영-체제 )
- [👥 개발자 커뮤니티 ](#-개발자-커뮤니티 )
- [🆕 최신 업데이트 ](#-최신-업데이트 )
- [📸 시스템 스크린샷 ](#-시스템-스크린샷 )
- [✨ 현재 구현 ](#-현재-구현---암호화폐-시장 )
- [🔮 로드맵 ](#-로드맵---범용-시장-확장 )
- [🏗️ 기술 아키텍처 ](#️ )
- [💰 바이낸스 계정 등록 ](#-바이낸스-계정-등록-수수료-절약 )
- [🔷 Hyperliquid 계정 등록 ](#-hyperliquid-거래소-사용 )
- [🔶 Aster DEX 계정 등록 ](#-aster-dex-거래소-사용 )
- [🚀 빠른 시작 ](#-빠른-시작 )
- [📖 AI 의사결정 흐름 ](#-ai-의사결정-흐름 )
- [🧠 AI 자가학습 예시 ](#-ai-자가학습-예시 )
- [📊 웹 인터페이스 기능 ](#-웹-인터페이스-기능 )
- [⚠️ 중요한 위험 경고 ](#️ )
- [🛠️ 일반적인 문제 ](#️ )
- [📈 성능 최적화 팁 ](#-성능-최적화-팁 )
- [🔄 변경 로그 ](#-변경-로그 )
- [📄 라이선스 ](#-라이선스 )
- [🤝 기여하기 ](#-기여하기 )
---
## 🚀 범용 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 )**
---
## 🆕 최신 업데이트
### 🚀 다중 거래소 지원!
NOFX는 이제 **세 개의 주요 거래소**를 지원합니다: Binance, Hyperliquid, Aster DEX!
#### **Hyperliquid 거래소**
고성능 탈중앙화 무기한 선물 거래소!
**주요 기능: **
- ✅ 완전한 거래 지원 (롱/숏, 레버리지, 손절/익절)
- ✅ 자동 정밀도 처리 (주문 크기 및 가격)
- ✅ 통합 트레이더 인터페이스 (원활한 거래소 전환)
- ✅ 메인넷 및 테스트넷 모두 지원
- ✅ API 키 불필요 - 이더리움 개인키만 필요
**왜 Hyperliquid인가? **
- 🔥 중앙화 거래소보다 낮은 수수료
- 🔒 비수탁형 - 자산을 직접 관리
- ⚡ 온체인 결제로 빠른 실행
- 🌍 KYC 불필요
**빠른 시작: **
1. MetaMask 개인키 가져오기 (`0x` 접두사 제거)
2. ~~config.json에서 `"exchange": "hyperliquid"` 설정~~ * 웹 인터페이스를 통해 구성 *
3. `"hyperliquid_private_key": "your_key"` 추가
4. 거래 시작!
자세한 내용은 [구성 가이드 ](#-hyperliquid-거래소-사용 )를 참조하세요.
#### **Aster DEX 거래소** (신규! v2.0.2)
바이낸스 호환 탈중앙화 무기한 선물 거래소!
**주요 기능: **
- ✅ 바이낸스 스타일 API (바이낸스에서 쉽게 마이그레이션)
- ✅ Web3 지갑 인증 (안전하고 탈중앙화)
- ✅ 자동 정밀도 처리와 완전한 거래 지원
- ✅ CEX보다 낮은 거래 수수료
- ✅ EVM 호환 (이더리움, BSC, 폴리곤 등)
**왜 Aster인가? **
- 🎯 **바이낸스 호환 API ** - 최소한의 코드 변경 필요
- 🔐 **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. config.json에서 `"exchange": "aster"` 설정
6. `"aster_user"` , `"aster_signer"` , `"aster_private_key"` 추가
---
## 📸 시스템 스크린샷
### 🏆 경쟁 모드 - 실시간 AI 배틀
경쟁 페이지 ](../../../screenshots/competition-page.png )
* Qwen vs DeepSeek 실시간 거래 배틀을 보여주는 멀티 AI 리더보드와 실시간 성능 비교 차트 *
### 📊 트레이더 상세 - 완전한 거래 대시보드
상세 페이지 ](../../../screenshots/details-page.png )
* 자본 곡선, 실시간 포지션, 확장 가능한 입력 프롬프트와 사고 연쇄 추론이 포함된 AI 의사결정 로그가 있는 전문 거래 인터페이스 *
---
> 📘 **참고**: 이것은 간소화된 한국어 버전 README입니다. 시스템 아키텍처, API 인터페이스 및 고급 구성을 포함한 전체 기술 문서는 [영문 버전](../../../README.md) 또는 [중문 버전](../zh-CN/README.md)을 참조하세요.
---
## ✨ 현재 구현 - 암호화폐 시장
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 )
---
## 💰 바이낸스 계정 등록 (수수료 절약!)
이 시스템을 사용하기 전에 바이낸스 선물 계정이 필요합니다. **추천 링크를 사용하여 거래 수수료를 절약하세요: **
* * 🎁 [바이낸스 등록 - 수수료 할인 받기 ](https://www.binance.com/join?ref=TINKLEVIP )**
### 등록 단계:
1. **위 링크를 클릭**하여 바이낸스 등록 페이지 방문
2. 이메일/전화번호로 **등록 완료 **
3. **KYC 인증 완료 ** (선물 거래 필수)
4. **선물 계정 활성화 ** :
- 바이낸스 홈페이지 → 파생상품 → USD-M 선물로 이동
- "지금 개설"을 클릭하여 선물 거래 활성화
5. **API 키 생성 ** :
- 계정 → API 관리로 이동
- 새 API 키 생성, * * "선물" 권한 활성화**
- API Key와 Secret Key 저장 (웹 인터페이스에 필요)
- **중요**: 보안을 위해 IP 주소를 화이트리스트에 추가
### 수수료 할인 혜택:
- ✅ **현물 거래 ** : 최대 30% 수수료 할인
- ✅ **선물 거래 ** : 최대 30% 수수료 할인
- ✅ **평생 유효 ** : 모든 거래에 대한 영구 할인
---
## 🚀 빠른 시작
### 🐳 옵션 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 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
```
**Ubuntu/Debian: **
``` bash
```
**다른 시스템 ** : [TA-Lib 공식 문서 ](https://github.com/markcheno/go-talib ) 참조
### 2. 프로젝트 클론
``` bash
cd nofx
```
### 3. 종속성 설치
**백엔드: **
``` bash
```
**프론트엔드: **
``` 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단계 ** : 예제 구성 파일 복사 및 이름 변경
``` bash
```
**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
brew install ta-lib
# Ubuntu
sudo apt-get install libta-lib0-dev
```
### 2. 정밀도 오류: 정밀도가 최대값을 초과
**해결책 ** : 시스템이 바이낸스 LOT_SIZE에서 정밀도를 자동 처리합니다. 오류가 지속되면 네트워크 연결을 확인하세요.
### 3. AI API 시간 초과
**해결책 ** :
- API 키가 올바른지 확인
- 네트워크 연결 확인 (프록시가 필요할 수 있음)
- 시스템 시간 초과는 120초로 설정됨
### 4. 프론트엔드가 백엔드에 연결할 수 없음
**해결책 ** :
- 백엔드가 실행 중인지 확인 (http://localhost:8080)
- 포트 8080이 사용 중인지 확인
- 브라우저 콘솔에서 오류 확인
### 5. 코인 풀 API 실패
**해결책 ** :
- 코인 풀 API는 선택 사항입니다
- API가 실패하면 시스템은 기본 주류 코인을 사용합니다 (BTC, ETH 등)
- 웹 인터페이스에서 구성 확인
---
## 📈 성능 최적화 팁
1. **합리적인 의사결정 주기 설정 ** : 3-5분 권장, 과도한 거래 회피
2. **후보 코인 수 제어 ** : 시스템 기본값은 AI500 상위 20 + OI Top 상위 20
3. **로그 정기적으로 정리 ** : 과도한 디스크 사용 회피
4. **API 호출 수 모니터링 ** : 바이낸스 속도 제한 트리거 회피
5. **소액 자본으로 테스트 ** : 전략 검증을 위해 먼저 100-500 USDT로 테스트
---
## 🔄 변경 로그
📖 **자세한 버전 기록 및 업데이트는 다음을 참조하세요: **
- **한국어:** [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 일반 공중 라이선스 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 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)
tinkle-community