# 🤖 NOFX - Agentic Trading OS

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

| 🎁 **기여자 에어드롭 프로그램** |
|:----------------------------------:|
| 코드 · 버그 수정 · 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)

---

## 📑 목차

- [🚀 범용 AI 트레이딩 운영 체제](#-범용-ai-트레이딩-운영-체제)
- [👥 개발자 커뮤니티](#-개발자-커뮤니티)
- [📸 시스템 스크린샷](#-시스템-스크린샷)
- [🏦 지원 거래소 (DEX/CEX 튜토리얼)](#-지원-거래소-dexcex-튜토리얼)
- [🤖 지원 AI 모델](#-지원-ai-모델)
- [✨ 현재 구현](#-현재-구현---암호화폐-시장)
- [🔮 로드맵](#-로드맵---범용-시장-확장)
- [🏗️ 기술 아키텍처](#️-기술-아키텍처)
- [🚀 빠른 시작](#-빠른-시작)
- [📖 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)**

---

## 📸 시스템 스크린샷

### 🏆 경쟁 모드 - 실시간 AI 배틀
![경쟁 페이지](../../../screenshots/competition-page.png)
*Qwen vs DeepSeek 실시간 거래 배틀을 보여주는 멀티 AI 리더보드와 실시간 성능 비교 차트*

### 📊 트레이더 상세 - 완전한 거래 대시보드
![상세 페이지](../../../screenshots/details-page.png)
*자본 곡선, 실시간 포지션, 확장 가능한 입력 프롬프트와 사고 연쇄 추론이 포함된 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. 프로젝트 클론

```bash
git clone https://github.com/tinkle-community/nofx.git
cd nofx
```

### 3. 종속성 설치

**백엔드:**
```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단계**: 예제 구성 파일 복사 및 이름 변경

```bash
cp config.json.example config.json
```

**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에서 추적됩니다. 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

[![Star History Chart](https://api.star-history.com/svg?repos=tinkle-community/nofx&type=Date)](https://star-history.com/#tinkle-community/nofx&Date)
