NoFxAiOS/nofx

Frontier · 시작하기 · 문서 · 커뮤니티

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

NOFX는 자신의 컴퓨터에서 실행하는 오픈 소스 트레이딩 시스템입니다. Frontier에서 AI와 거래 아이디어를 검토하고, 차트에서 진입 방식을 비교한 뒤 직접 주문을 승인하세요. Autopilot으로는 전략을 지속적으로 실행할 수 있습니다. 두 기능은 설정한 모델과 거래소 계정을 함께 사용합니다.

Vergex와 함께 개발하며, AI와 데이터는 Claw402를 통해 이용합니다.

로컬에서 실행하기

한 줄 설치 — Linux / macOS

Compose가 포함된 Docker를 설치하고 실행한 뒤 다음 명령을 입력하세요.

curl -fsSL https://raw.githubusercontent.com/NoFxAiOS/nofx/main/install.sh | bash

데스크톱 브라우저에서 http://127.0.0.1:3000을 여세요.

설치 프로그램이 누락된 환경 설정 키를 생성하고, 배포된 Docker 이미지로 NOFX를 실행합니다. Go나 Node.js를 별도로 설치할 필요가 없습니다. 처음 사용하기로 이동하거나 소스 빌드 및 다른 설치 방법을 확인하세요.

Frontier

차트와 대화를 통해, 주문하기 전에 내용을 확인할 수 있는 거래 계획을 만듭니다.

1. 시장을 선택하세요. 거래량 상위 종목, 거래소의 종목 코드 검색, Binance AI500 목록을 이용할 수 있습니다. 거래소가 지원하는 경우 주식 연계 종목도 표시됩니다.
2. 진입 방식을 비교하세요. 시장가, 지정가, 가중 분할 주문, TWAP 계획을 요청하세요. 진입가, 손절가, 목표가, 레버리지, 포지션 가치, 예상 증거금을 함께 볼 수 있습니다.
3. 검토하고 주문하세요. 계획을 선택하면 차트가 해당 계획에 초점을 맞춥니다. 현재 계정과 주문 내용을 확인한 뒤 실행을 명시적으로 승인하세요.
4. 포지션을 관리하세요. 차트 아래에서 실시간 포지션과 거래소 주문을 확인하고, 수동으로 진입하거나 포지션을 청산할 수 있습니다.

Frontier는 Binance USDT 무기한 선물, Hyperliquid, OKX, Bitget을 지원합니다. 거래 계정을 연결하기 전에도 공개 시장 데이터를 볼 수 있지만, 주문하려면 해당 거래소 계정이 필요합니다. 계획 생성만으로 주문이 제출되지는 않습니다.

지정가 주문과 예약된 분할 주문은 체결되지 않을 수 있습니다. 실행 및 복구 안내를 참고하세요.

Autopilot

전략을 지속적으로 실행하려면 모델, 거래소 계정, 전략을 지정해 트레이더를 설정하세요. Autopilot은 시장을 읽고 판단한 뒤 NOFX의 거래소 실행 모듈을 통해 주문합니다. Dashboard에서 포지션, 성과, 의사결정 기록을 확인할 수 있습니다.

Frontier는 거래마다 승인이 필요합니다. Autopilot은 실행 중 자동으로 주문할 수 있습니다. Autopilot의 시작과 중지는 별도의 작업입니다.

처음 사용하기

1. 로컬 계정을 만드세요. 방금 실행한 NOFX에 로그인합니다.
2. Config에서 AI를 설정하세요. 모델을 선택합니다. Claw402를 사용한다면 AI 이용료 지갑을 생성하거나 가져오고, 개인 키를 보관한 뒤 해당 주소로 Base 네트워크의 USDC를 보내세요. 이 잔액은 모델 및 유료 데이터 요청에 사용됩니다.
3. 거래 계정을 추가하세요. 사용할 거래소를 연결하고 계정 자산과 사용 가능 잔액을 확인합니다. 거래 자금은 AI 이용료 지갑과 별도로 관리됩니다.
4. Frontier를 여세요. 거래소, 계정, 종목을 선택합니다. 계획을 생성하고 차트에서 비교한 다음 준비가 되면 주문을 검토하세요.

지속적인 자동 거래를 하려면 Autopilot을 별도로 설정하고 시작하세요.

설치 프로그램으로 설치한 환경 업데이트

실행 중인 Autopilot을 중지하고 진행 중인 Frontier 거래를 확인한 뒤, 설치 디렉터리(기본값 ~/nofx)에서 다음 명령을 실행하세요.

docker compose pull
docker compose up -d

업데이트할 때 .env와 data/ 디렉터리를 보존하세요. 설정, 암호화에 필요한 자료, 저장된 애플리케이션 상태가 포함되어 있습니다.

재시작 후 거래소에서 포지션과 주문을 확인하고, 확인이 필요한 실행 기록을 대조한 뒤 다음 거래를 진행하세요. 프로세스를 중지해도 포지션이 청산되지는 않습니다.

소스 빌드 및 다른 설치 방법

git clone --recurse-submodules https://github.com/NoFxAiOS/nofx.git
cd nofx
./start.sh start --build

git pull --ff-only
git submodule update --init web/vendor/charting
./start.sh start --build

# 백엔드
go build -o nofx .
./nofx

# 프런트엔드: 다른 터미널에서 실행
cd web
npm ci
npm run dev

모델과 데이터

Frontier와 Autopilot은 NOFX에 설정된 모델을 함께 사용합니다. Claw402는 여러 모델을 제공하며 Base 네트워크의 USDC로 사용량에 따라 정산합니다. Config에서 모델을 선택하고 작업 공간에서 전환할 수 있습니다.

가격과 캔들 데이터는 선택한 거래소에서 가져옵니다. AI500과 지원되는 보유자 분석은 Claw402 유료 경로를 이용합니다. 데이터 제공 여부는 시장과 제공업체에 따라 달라집니다. Hyperliquid 보유자 데이터를 Binance, OKX, Bitget 데이터로 대신 사용하지 않습니다. 활동 스트림에서 데이터 조회와 계획 생성 진행 상황을 확인할 수 있습니다.

AI 이용료, 유료 데이터 요금, 거래소 자금은 별개입니다. 거래가 실행되지 않아도 모델 요청에는 요금이 발생할 수 있습니다.

거래소

현재 Frontier에서 선택할 수 있는 거래소는 Binance, Hyperliquid, OKX, Bitget입니다. NOFX의 전체 실행 모듈에는 Bybit, Gate, KuCoin, Aster, Lighter도 포함됩니다. 이용 가능한 상품, 주문 유형, 계정 권한은 거래소마다 다릅니다.

아래는 개발을 지원하는 파트너 가입 링크입니다. 수수료 혜택은 각 거래소가 정합니다.

거래소	지원	파트너 링크
Binance	✅	가입
Bybit	✅	가입
OKX	✅	가입
Hyperliquid	✅	가입
Bitget	✅	가입
KuCoin	✅	가입
Gate	✅	가입
Aster	✅	가입
Lighter	✅	가입

주문 실행 방식

계획과 전략의 결정은 기존 NOFX 거래소 어댑터를 통해 실행됩니다. 모델 프롬프트에는 지갑 개인 키나 거래소 인증 정보가 포함되지 않습니다.

• 승인 전 검토. Frontier는 계정, 주문 규모, 진입 및 청산 정보를 표시합니다. Autopilot은 설정한 전략과 실행 제한을 따릅니다.
• 계정에 맞춘 주문 규모. Frontier는 선택한 레버리지와 현재 사용 가능한 증거금을 기준으로 계산하며 실행 비용을 남겨 둡니다. 수량 정밀도, 호가 단위, 거래소 제한도 적용됩니다.
• 거래소에 제출하는 보호 주문. 체결을 확인하면 지원되는 손절 및 익절 주문을 제출합니다. 진입과 보호 주문은 하나의 원자적 작업이 아니므로 보호 주문에 실패하면 거래소에서 확인하세요.
• 주문 상태 대조. 제출 결과가 불확실하면 무조건 재전송하지 않고 거래소에서 확인합니다. 해결되지 않은 실행 상태가 있으면 추가 진입이 일시 중지될 수 있습니다.
• 로컬 설정. 거래소 인증 정보는 NOFX 서버에 암호화되어 저장됩니다. 설치 환경에는 서명에 필요한 자료도 있으므로 파일과 백업을 보호하세요.

아키텍처

데스크톱 브라우저
  Frontier · Config · Dashboard · Strategy
    → NOFX API
      → Frontier: 계획, 검토, 승인
      → Autopilot: 전략 반복 실행
    → 공통 실행 모듈 → 거래소 어댑터 → 사용자 거래 계정

모델과 유료 데이터: NOFX 공급자 클라이언트 · Claw402
저장: 로컬 설정, 계획, 실행 기록

브랜드 자료

• 로고 심벌 — SVG
• GitHub 아바타 — PNG, 512 × 512
• GitHub 아바타 — SVG 원본
• README 배너 — SVG

문서

커뮤니티

Telegram · Twitter/X · Issues · vergex.trade · 라이브 대시보드

기여

코드, 문서, 번역, 버그 리포트 모두 환영합니다 — 기여 가이드, 행동 강령, 보안 정책을 참고하세요.

NOFX는 의미 있는 기여를 기록하며, 생태계가 성장함에 따라 기여자에게 보상할 계획입니다. 우선순위 이슈에는 더 높은 가중치가 부여됩니다.

스폰서

스폰서 되기

NOFX가 도움이 되었다면, 스타 하나가 다른 트레이더들이 이 프로젝트를 발견하는 데 큰 힘이 됩니다.

라이선스

AGPL-3.0

_{자동매매에는 상당한 위험이 따릅니다. AI 기반 전략은 실험적이며 손실이 발생할 수 있습니다. 포지션 규모를 적절히 관리하고, 각 거래소의 구조를 이해하며, 잃어도 감당할 수 있는 자금으로만 거래하세요. 전체 면책 조항을 확인하세요.}