open-git/nofx

Fork 0

mirror of https://github.com/NoFxAiOS/nofx.git synced 2025-12-06 13:54:41 +08:00

Files

tinkle-community 84acce9b77 update disclaimer

2025-11-25 20:18:29 +08:00

29 KiB

Raw Blame History

🤖 NOFX - Agentic Trading OS

언어 / Languages: English | 中文 | Українська | Русский | 日本語 | 한국어 | Tiếng Việt

📚 문서: 문서 홈 | 시작 가이드 | 커뮤니티 | 변경 로그 | ⚠️ 면책 조항

📑 목차

🚀 범용 AI 트레이딩 운영 체제
👥 개발자 커뮤니티
🆕 최신 업데이트
📸 시스템 스크린샷
✨ 현재 구현
🔮 로드맵
🏗️ 기술 아키텍처
💰 바이낸스 계정 등록
🔷 Hyperliquid 계정 등록
🔶 Aster DEX 계정 등록
🚀 빠른 시작
📖 AI 의사결정 흐름
🧠 AI 자가학습 예시
📊 웹 인터페이스 기능
⚠️ 중요한 위험 경고
🛠️ 일반적인 문제
📈 성능 최적화 팁
🔄 변경 로그
📄 라이선스
🤝 기여하기

🚀 범용 AI 트레이딩 운영 체제

NOFX는 통합 아키텍처를 기반으로 구축된 범용 Agentic Trading OS입니다. 암호화폐 시장에서 "멀티 에이전트 의사결정 → 통합 리스크 관리 → 저지연 실행 → 실제/모의 계정 백테스팅" 루프를 성공적으로 완성했으며, 현재 이 기술 스택을 주식, 선물, 옵션, 외환 및 모든 금융 시장으로 확장하고 있습니다.

🎯 핵심 기능

범용 데이터 및 백테스팅 레이어: 크로스 마켓, 크로스 타임프레임, 크로스 거래소 통합 표현 및 팩터 라이브러리, 전이 가능한 "전략 메모리" 축적
멀티 에이전트 자가 대전 및 자가 진화: 전략이 자동으로 경쟁하고 최고를 선택하며, 계정 수준 PnL과 리스크 제약을 기반으로 지속적으로 반복
통합 실행 및 리스크 관리: 저지연 라우팅, 슬리피지/리스크 관리 샌드박스, 계정 수준 제한, 원클릭 마켓 전환

🏢 Amber.ac 후원

👥 핵심 팀

Tinkle - @Web3Tinkle
유일한 공식 트위터 - @nofx_official

💼 시드 펀딩 라운드 진행 중

현재 시드 라운드 자금을 조달 중입니다.

투자 문의는 Twitter를 통해 Tinkle에게 DM을 보내주세요.

⚠️ 위험 경고: 이 시스템은 실험적입니다. AI 자동 거래는 상당한 위험을 수반합니다. 학습/연구 목적 또는 소액 테스트용으로만 사용할 것을 강력히 권장합니다!

👥 개발자 커뮤니티

텔레그램 개발자 커뮤니티에 가입하여 토론하고, 아이디어를 공유하고, 지원을 받으세요:

💬 NOFX 개발자 커뮤니티

🆕 최신 업데이트

🚀 다중 거래소 지원!

NOFX는 이제 세 개의 주요 거래소를 지원합니다: Binance, Hyperliquid, Aster DEX!

Hyperliquid 거래소

고성능 탈중앙화 무기한 선물 거래소!

주요 기능:

✅ 완전한 거래 지원 (롱/숏, 레버리지, 손절/익절)
✅ 자동 정밀도 처리 (주문 크기 및 가격)
✅ 통합 트레이더 인터페이스 (원활한 거래소 전환)
✅ 메인넷 및 테스트넷 모두 지원
✅ API 키 불필요 - 이더리움 개인키만 필요

왜 Hyperliquid인가?

🔥 중앙화 거래소보다 낮은 수수료
🔒 비수탁형 - 자산을 직접 관리
⚡ 온체인 결제로 빠른 실행
🌍 KYC 불필요

빠른 시작:

MetaMask 개인키 가져오기 (0x 접두사 제거)
~~config.json에서 "exchange": "hyperliquid" 설정~~ 웹 인터페이스를 통해 구성
"hyperliquid_private_key": "your_key" 추가
거래 시작!

자세한 내용은 구성 가이드를 참조하세요.

Aster DEX 거래소 (신규! v2.0.2)

바이낸스 호환 탈중앙화 무기한 선물 거래소!

주요 기능:

✅ 바이낸스 스타일 API (바이낸스에서 쉽게 마이그레이션)
✅ Web3 지갑 인증 (안전하고 탈중앙화)
✅ 자동 정밀도 처리와 완전한 거래 지원
✅ CEX보다 낮은 거래 수수료
✅ EVM 호환 (이더리움, BSC, 폴리곤 등)

왜 Aster인가?

🎯 바이낸스 호환 API - 최소한의 코드 변경 필요
🔐 API 지갑 시스템 - 보안을 위한 별도 거래 지갑
💰 경쟁력 있는 수수료 - 대부분의 중앙화 거래소보다 낮음
🌐 멀티체인 지원 - 선호하는 EVM 체인에서 거래

빠른 시작:

Aster 추천 링크를 통해 등록 (수수료 할인 혜택!)
Aster API Wallet 방문
메인 지갑 연결 및 API 지갑 생성
API Signer 주소와 개인키 복사
config.json에서 "exchange": "aster" 설정
"aster_user", "aster_signer", "aster_private_key" 추가

📸 시스템 스크린샷

🏆 경쟁 모드 - 실시간 AI 배틀

Qwen vs DeepSeek 실시간 거래 배틀을 보여주는 멀티 AI 리더보드와 실시간 성능 비교 차트

📊 트레이더 상세 - 완전한 거래 대시보드

자본 곡선, 실시간 포지션, 확장 가능한 입력 프롬프트와 사고 연쇄 추론이 포함된 AI 의사결정 로그가 있는 전문 거래 인터페이스

📘 참고: 이것은 간소화된 한국어 버전 README입니다. 시스템 아키텍처, API 인터페이스 및 고급 구성을 포함한 전체 기술 문서는 영문 버전 또는 중문 버전을 참조하세요.

✨ 현재 구현 - 암호화폐 시장

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
中文: 路线图文档

🏗️ 기술 아키텍처

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
中文: 架构文档

💰 바이낸스 계정 등록 (수수료 절약!)

이 시스템을 사용하기 전에 바이낸스 선물 계정이 필요합니다. 추천 링크를 사용하여 거래 수수료를 절약하세요:

🎁 바이낸스 등록 - 수수료 할인 받기

등록 단계:

위 링크를 클릭하여 바이낸스 등록 페이지 방문
이메일/전화번호로 등록 완료
KYC 인증 완료 (선물 거래 필수)
선물 계정 활성화:
- 바이낸스 홈페이지 → 파생상품 → USD-M 선물로 이동
- "지금 개설"을 클릭하여 선물 거래 활성화
API 키 생성:
- 계정 → API 관리로 이동
- 새 API 키 생성, "선물" 권한 활성화
- API Key와 Secret Key 저장 (웹 인터페이스에 필요)
- 중요: 보안을 위해 IP 주소를 화이트리스트에 추가

수수료 할인 혜택:

✅ 현물 거래: 최대 30% 수수료 할인
✅ 선물 거래: 최대 30% 수수료 할인
✅ 평생 유효: 모든 거래에 대한 영구 할인

🚀 빠른 시작

🐳 옵션 A: Docker 원클릭 배포 (가장 쉬움 - 초보자 권장!)

⚡ Docker로 3가지 간단한 단계로 거래 시작 - 설치 불필요!

Docker는 모든 종속성 (Go, Node.js, TA-Lib)과 환경 설정을 자동으로 처리합니다. 초보자에게 완벽합니다!

1단계: 구성 준비

# 구성 템플릿 복사
cp config.json.example config.json

# API 키를 입력하여 편집
nano config.json  # 또는 원하는 편집기 사용

2단계: 원클릭 시작

# 옵션 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 트레이딩 시스템이 실행 중입니다!

시스템 관리

./scripts/start.sh logs      # 로그 보기
./scripts/start.sh status    # 상태 확인
./scripts/start.sh stop      # 서비스 중지
./scripts/start.sh restart   # 서비스 재시작

📖 자세한 Docker 배포 가이드, 문제 해결 및 고급 구성:

한국어: Docker 문서 참조 (곧 제공 예정)
English: See DOCKER_DEPLOY.en.md
中文: 查看 DOCKER_DEPLOY.md

📦 옵션 B: 수동 설치 (개발자용)

참고: 위의 Docker 배포를 사용한 경우 이 섹션을 건너뛰세요. 수동 설치는 코드를 수정하거나 Docker 없이 실행하려는 경우에만 필요합니다.

1. 환경 요구 사항

Go 1.21+
Node.js 18+
TA-Lib 라이브러리 (기술적 지표 계산)

TA-Lib 설치

macOS:

brew install ta-lib

Ubuntu/Debian:

sudo apt-get install libta-lib0-dev

다른 시스템: TA-Lib 공식 문서 참조

2. 프로젝트 클론

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

3. 종속성 설치

백엔드:

go mod download

프론트엔드:

cd web
npm install
cd ..

4. AI API 키 가져오기

시스템을 구성하기 전에 AI API 키를 가져와야 합니다. 다음 AI 제공업체 중 하나를 선택하세요:

옵션 1: DeepSeek (초보자 권장)

왜 DeepSeek인가?

💰 GPT-4보다 저렴 (약 1/10 비용)
🚀 빠른 응답 시간
🎯 우수한 거래 결정 품질
🌍 VPN 없이 전 세계에서 작동

DeepSeek API 키 가져오는 방법:

방문: https://platform.deepseek.com
등록: 이메일/전화번호로 가입
인증: 이메일/전화 인증 완료
충전: 계정에 크레딧 추가
- 최소: ~$5 USD
- 권장: 테스트용 $20-50 USD
API 키 생성:
- API Keys 섹션으로 이동
- "새 키 생성" 클릭
- 키 복사 및 저장 (sk-로 시작)
- ⚠️ 중요: 즉시 저장하세요 - 다시 볼 수 없습니다!

가격: 약 100만 토큰당 $0.14 (매우 저렴!)

옵션 2: Qwen (Alibaba Cloud)

Qwen API 키 가져오는 방법:

방문: https://dashscope.console.aliyun.com
등록: Alibaba Cloud 계정으로 가입
서비스 활성화: DashScope 서비스 활성화
API 키 생성:
- API 키 관리로 이동
- 새 키 생성
- 복사 및 저장 (sk-로 시작)

참고: 등록을 위해 중국 전화번호가 필요할 수 있습니다

5. 시스템 구성

두 가지 구성 모드 사용 가능:

🌟 초보자 모드: 단일 트레이더 + 기본 코인 (권장!)
⚔️ 전문가 모드: 다중 트레이더 경쟁

🌟 초보자 모드 구성 (권장)

1단계: 예제 구성 파일 복사 및 이름 변경

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 자가학습 예시

과거 피드백 (프롬프트에 자동 추가)

## 📊 과거 성능 피드백

### 전체 성능
- **총 거래**: 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가 피드백을 사용하는 방법

연속 손실 회피: SOLUSDT에서 3번 연속 손절을 보고 AI가 회피하거나 더 신중해짐
성공적인 전략 강화: BTC 돌파 롱이 75% 승률로 AI가 이 패턴을 계속함
동적 스타일 조정: 승률 <40% → 보수적; 손익비 >2 → 공격적 유지
시장 상황 식별: 연속 손실은 변동성 높은 시장을 나타낼 수 있으며 거래 빈도 감소

📊 웹 인터페이스 기능

1. 경쟁 페이지

🏆 리더보드: 실시간 ROI 순위, 리더 강조 표시용 골드 테두리
📈 성능 비교: 듀얼 AI ROI 곡선 비교 (보라색 vs 파란색)
⚔️ 1:1 대결: 리드 마진을 보여주는 직접 비교
실시간 데이터: 총 자본, 손익%, 포지션 수, 마진 사용

2. 상세 페이지

자본 곡선: 과거 추세 차트 (USD/백분율 전환)
통계: 총 주기, 성공/실패, 개설/청산 통계
포지션 테이블: 모든 포지션 세부 정보 (진입 가격, 현재 가격, 손익%, 청산 가격)
AI 의사결정 로그: 최근 의사결정 기록 (확장 가능한 CoT)

3. 실시간 업데이트

시스템 상태, 계정 정보, 포지션 목록: 5초마다 새로고침
의사결정 로그, 통계: 10초마다 새로고침
자본 차트: 10초마다 새로고침

⚠️ 중요한 위험 경고

거래 위험

암호화폐 시장은 극도로 변동성이 높습니다, AI 의사결정이 수익을 보장하지 않습니다
선물 거래는 레버리지를 사용합니다, 손실이 원금을 초과할 수 있습니다
극단적인 시장 상황은 청산 위험으로 이어질 수 있습니다
펀딩 비율은 보유 비용에 영향을 줄 수 있습니다
유동성 위험: 일부 코인은 슬리피지를 경험할 수 있습니다

기술적 위험

네트워크 지연은 가격 슬리피지를 유발할 수 있습니다
API 속도 제한은 거래 실행에 영향을 줄 수 있습니다
AI API 시간 초과는 의사결정 실패를 유발할 수 있습니다
시스템 버그는 예기치 않은 동작을 유발할 수 있습니다

사용 권장 사항

✅ 권장

테스트를 위해 손실을 감당할 수 있는 자금만 사용
소액으로 시작 (100-500 USDT 권장)
시스템 작동 상태를 정기적으로 확인
계정 잔액 변화 모니터링
AI 의사결정 로그를 분석하여 전략 이해

❌ 권장하지 않음

모든 자금 또는 빌린 돈 투자
장기간 감독 없이 실행
AI 의사결정을 맹목적으로 신뢰
시스템을 이해하지 않고 사용
극단적인 시장 변동성 중 실행

🛠️ 일반적인 문제

1. 컴파일 오류: TA-Lib을 찾을 수 없음

해결책: TA-Lib 라이브러리 설치

# 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 등)
웹 인터페이스에서 구성 확인

📈 성능 최적화 팁

합리적인 의사결정 주기 설정: 3-5분 권장, 과도한 거래 회피
후보 코인 수 제어: 시스템 기본값은 AI500 상위 20 + OI Top 상위 20
로그 정기적으로 정리: 과도한 디스크 사용 회피
API 호출 수 모니터링: 바이낸스 속도 제한 트리거 회피
소액 자본으로 테스트: 전략 검증을 위해 먼저 100-500 USDT로 테스트

🔄 변경 로그

📖 자세한 버전 기록 및 업데이트는 다음을 참조하세요:

한국어: CHANGELOG.zh-CN.md
English: 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 파일을 참조하세요.

이것이 의미하는 바:

✅ 이 소프트웨어를 사용, 수정 및 배포할 수 있습니다
✅ 수정 버전의 소스 코드를 공개해야 합니다
✅ 서버에서 수정 버전을 실행하는 경우 사용자에게 소스 코드를 제공해야 합니다
✅ 모든 파생물도 AGPL-3.0 하에 라이선스가 부여되어야 합니다

상업적 라이선스 또는 질문이 있는 경우 유지 관리자에게 문의하세요.

🤝 기여하기

Issue 및 Pull Request를 환영합니다!

개발 가이드

프로젝트 포크
기능 브랜치 생성 (git checkout -b feature/AmazingFeature)
변경 사항 커밋 (git commit -m 'Add some AmazingFeature')
브랜치에 푸시 (git push origin feature/AmazingFeature)
Pull Request 열기

📬 연락처

🐛 기술 지원

GitHub Issues: Issue 제출
개발자 커뮤니티: 텔레그램 그룹

🙏 감사의 말

Binance API - 바이낸스 선물 API
DeepSeek - DeepSeek AI API
Qwen - Alibaba Cloud Qwen
TA-Lib - 기술적 지표 라이브러리
Recharts - React 차트 라이브러리

마지막 업데이트: 2025-10-30 (v3.0.0)

⚡ AI의 힘으로 정량적 거래의 가능성을 탐험하세요!

29 KiB Raw Blame History Unescape Escape

🤖 NOFX - Agentic Trading OS

📑 목차

🚀 범용 AI 트레이딩 운영 체제

🎯 핵심 기능

🏢 Amber.ac 후원

👥 핵심 팀

💼 시드 펀딩 라운드 진행 중

👥 개발자 커뮤니티

🆕 최신 업데이트

🚀 다중 거래소 지원!

Hyperliquid 거래소

Aster DEX 거래소 (신규! v2.0.2)

📸 시스템 스크린샷

🏆 경쟁 모드 - 실시간 AI 배틀

📊 트레이더 상세 - 완전한 거래 대시보드

✨ 현재 구현 - 암호화폐 시장

🏆 멀티 에이전트 경쟁 프레임워크

🧠 AI 자가학습 및 최적화

📊 범용 시장 데이터 레이어 (암호화폐 구현)

🎯 통합 리스크 관리 시스템

⚡ 저지연 실행 엔진

🎨 전문 모니터링 인터페이스

🔮 로드맵 - 범용 시장 확장

🏗️ 기술 아키텍처

💰 바이낸스 계정 등록 (수수료 절약!)

등록 단계:

수수료 할인 혜택:

🚀 빠른 시작

🐳 옵션 A: Docker 원클릭 배포 (가장 쉬움 - 초보자 권장!)

1단계: 구성 준비

2단계: 원클릭 시작

3단계: 대시보드 접속

시스템 관리

📦 옵션 B: 수동 설치 (개발자용)

1. 환경 요구 사항

TA-Lib 설치

2. 프로젝트 클론

3. 종속성 설치

4. AI API 키 가져오기

옵션 1: DeepSeek (초보자 권장)

옵션 2: Qwen (Alibaba Cloud)

5. 시스템 구성

🌟 초보자 모드 구성 (권장)

📖 AI 의사결정 흐름

1단계: 📊 과거 성능 분석 (최근 20주기)

2단계: 💰 계정 상태 가져오기

3단계: 🔍 기존 포지션 분석 (있는 경우)

4단계: 🎯 새로운 기회 평가 (후보 코인)

5단계: 🧠 AI 종합 의사결정 (DeepSeek/Qwen)

6단계: ⚡ 거래 실행

7단계: 📝 완전한 로그 기록 및 성능 업데이트

🧠 AI 자가학습 예시

과거 피드백 (프롬프트에 자동 추가)

AI가 피드백을 사용하는 방법

📊 웹 인터페이스 기능

1. 경쟁 페이지

2. 상세 페이지

3. 실시간 업데이트

⚠️ 중요한 위험 경고

거래 위험

기술적 위험

사용 권장 사항

🛠️ 일반적인 문제

1. 컴파일 오류: TA-Lib을 찾을 수 없음

2. 정밀도 오류: 정밀도가 최대값을 초과

3. AI API 시간 초과

4. 프론트엔드가 백엔드에 연결할 수 없음

5. 코인 풀 API 실패

📈 성능 최적화 팁

🔄 변경 로그

📄 라이선스

🤝 기여하기

개발 가이드

📬 연락처

🐛 기술 지원

🙏 감사의 말

⭐ Star History

29 KiB

Raw Blame History