암호화폐 자동거래 시스템 사용자 가이드
📋 목차
시스템 개요
이 시스템은 Upbit 거래소를 통한 암호화폐 자동거래를 지원하는 플랫폼입니다. 다단계 매수/매도 전략을 통해 사용자가 설정한 포지션에서 자동으로 거래를 실행합니다.
주요 특징
- 🔐 Google 소셜 로그인 지원
- 📊 다단계 매수/매도 전략
- 🎯 실시간 가격 모니터링
- 📈 거래 내역 추적
- 🛡️ 역할 기반 권한 관리
회원가입 및 계정 활성화
회원가입 프로세스
단계별 설명
- 초기 로그인: Google 계정으로 소셜 로그인
- 게스트 상태: 시스템에 읽기 전용으로 접근 가능
- 권한 요청: 관리자에게 USER 권한 요청
- 관리자 승인: 관리자가 권한을 USER로 변경
- API 키 등록: Upbit API 키 등록 및 검증
- 거래 시작: 자동거래 설정 및 실행 가능
사용자 권한 체계
| 권한 | 코드 | 설명 | 가능한 작업 |
|---|---|---|---|
| 관리자 | ROLE_ADMIN |
시스템 전체 관리 | • 모든 사용자 관리 • 시스템 설정 변경 • 모든 거래 내역 조회 • 사용자 권한 변경 |
| 매니저 | ROLE_MANAGER |
운영 관리 | • 사용자 지원 • 거래 모니터링 • 시스템 상태 확인 • 제한적 사용자 관리 |
| 일반사용자 | ROLE_USER |
거래 사용자 | • 자동거래 설정 • API 키 관리 • 거래 내역 조회 • 개인 설정 변경 |
| 게스트 | ROLE_GUEST |
제한적 접근 | • 시스템 둘러보기 • 읽기 전용 접근 • 거래 기능 사용 불가 |
권한별 접근 제한
거래 설정 페이지: USER 이상
API 키 관리: USER 이상
거래 실행: USER 이상
사용자 관리: MANAGER 이상
시스템 설정: ADMIN만
Upbit API 키 등록
1. Upbit에서 API 키 발급
- Upbit 거래소 로그인
마이페이지→Open API 관리이동API 키 발급클릭- 다음 권한 선택:
- ✅ 자산 조회: 계좌 잔고 확인
- ✅ 주문 조회: 거래 내역 확인
- ✅ 주문하기: 매수/매도 실행
- ❌ 출금하기: 보안상 체크 해제 권장 - 접속 가능 IP 설정:
-접속 가능 IP항목에222.108.161.194입력
- 이 IP는 자동거래 시스템 서버 주소입니다
2. 시스템에 API 키 등록
- 상단 메뉴에서
사용자→사용자설정→Upbit API 키 관리이동 새 API 키 등록클릭- Upbit에서 발급받은 키 정보 입력:
- Access Key: 공개 키
- Secret Key: 비밀 키 등록하기클릭- 등록 완료 후
API 키 업데이트버튼 클릭 연결테스트버튼을 클릭하여 본인 계좌의 잔액 조회 확인
3. API 키 보안
- API 키는 AES-256 암호화되어 안전하게 저장
- 시스템에서 키 원본은 표시되지 않음
- 키 삭제 시 즉시 시스템에서 제거
페이지별 기능 설명
🏠 대시보드 (/)
메인 화면 - 시스템 현황 한눈에 보기
- 거래 설정 카드: 자동거래 활성화/비활성화, 가격 체크 주기 설정
- 활성 종목 테이블: 현재 거래 중인 암호화폐 목록과 현재가
- API 키 관리: Upbit API 키 등록/삭제
- 빠른 종목 추가: 새로운 거래 종목 추가
📊 거래 설정 (/trading_config)
종목별 상세 거래 전략 설정
- 종목 관리: 거래할 암호화폐 추가/제거
- 차수별 설정: 다단계 매수/매도 포지션 설정
- 자동거래 모드: 종목별 자동매수/매도 활성화
- 전략 백테스팅: 설정한 전략의 예상 수익률 확인
📈 거래 모니터링 (/trading_monitor)
실시간 거래 상황 모니터링
- 실시간 가격: 10초마다 현재가 업데이트
- 포지션 현황: 각 차수별 매수/매도 완료 상태
- 실현수익: 완료된 거래의 수익/손실 현황
- 거래설정 바로가기: 각 종목별 설정 페이지 직접 이동
📋 거래 내역 (/trading_history)
과거 거래 기록 조회
- 기간별 조회: 날짜 범위 선택하여 조회
- 종목별 필터: 특정 암호화폐 거래만 확인
- 수익 분석: 기간별 총 수익/손실 통계
- 상세 내역: 각 거래의 체결가, 수수료 등 상세 정보
❓ Q&A (/qna)
사용자 지원 및 커뮤니티
- 질문 등록: 시스템 사용 중 궁금한 점 질문
- 답변 확인: 관리자 및 다른 사용자의 답변
- FAQ 검색: 자주 묻는 질문 빠른 검색
- 커뮤니티: 사용자 간 정보 공유
자동거래 설정
자동거래 활성화 vs 자동매수/매도
자동거래 활성화 (전역 설정)
├── ON: 시스템이 주기적으로 가격 체크
├── OFF: 모든 자동거래 중단
└── 가격 체크 주기: 10초~3600초 설정 가능
자동매수/매도 (종목별 설정)
├── 자동매수: 설정된 포지션에서 자동 매수 실행
├── 자동매도: 매수 완료 후 목표가 도달 시 자동 매도
└── 독립적 제어: 매수만 또는 매도만 활성화 가능
다단계 거래 전략
1차 거래
- 매수 포지션: 사용자가 직접 설정한 기준가
- 거래 금액: 1차 매수에 사용할 금액
- 매도 조건: 목표 수익률 도달 시 매도
2차 이상 거래
- 매수 포지션: 이전 차수 대비 일정 비율 하락
- 거래 금액: 차수별로 다른 금액 설정 가능
- 매도 조건: 개별 차수별 목표 수익률
거래 실행 흐름
🔍 가격 체크
설정된 주기마다 현재가 확인
⚙️ 자동거래 확인
전역 자동거래 활성화 상태 확인
📈 매수 조건
종목별 자동매수 ON 시
포지션 가격 도달 여부 확인
💰 매수 실행
설정된 금액으로 시장가 매수
완료 후 상태 업데이트
📉 매도 조건
종목별 자동매도 ON 시
목표 수익률 도달 여부 확인
💎 수익 실현
목표 수익률 도달 시
자동 매도로 수익 확정
거래 모니터링
실시간 정보 확인
- 현재가 업데이트: 10초마다 자동 갱신
- 포지션 상태:
- 🔄 대기: 아직 매수하지 않은 차수
- ✅ 완료: 매수가 완료된 차수 - 실현수익: 매도 완료된 거래의 실제 수익
거래 알림
- 매수 완료: 설정한 포지션에서 매수 성공
- 매도 완료: 목표 수익률 달성하여 매도 성공
- 오류 발생: API 오류 또는 잔고 부족 등
FAQ
💰 거래 관련
Q: 최소 거래 금액은 얼마인가요?
A: Upbit 기준 최소 5,000원부터 거래 가능합니다.
Q: 여러 종목을 동시에 거래할 수 있나요?
A: 네, 계정 잔고 범위 내에서 여러 종목 동시 거래 가능합니다.
Q: 거래 수수료는 어떻게 되나요?
A: Upbit 거래 수수료(0.05%)가 적용되며, 시스템 이용료는 별도 없습니다.
🔑 API 키 관련
Q: API 키가 안전한가요?
A: AES-256 암호화로 저장되며, 시스템에서도 원본을 확인할 수 없습니다.
Q: API 키를 변경하고 싶어요.
A: 기존 키를 삭제하고 새로운 키를 등록하시면 됩니다.
⚙️ 시스템 관련
Q: 자동거래가 실행되지 않아요.
A: 다음을 확인해주세요:
- 전역 자동거래 활성화 상태
- 종목별 자동매수/매도 활성화 상태
- API 키 유효성
- 계좌 잔고 충분성
Q: 설정한 가격에 정확히 거래되나요?
A: 시장가 주문을 사용하므로 시장 상황에 따라 약간의 차이가 있을 수 있습니다.
Q: 시스템이 중단되면 어떻게 되나요?
A: 자동거래는 중단되지만, 이미 체결된 거래는 영향받지 않습니다.
📞 지원 문의
- Q&A 게시판: 시스템 내 Q&A 페이지 이용
- 긴급 문의: 관리자에게 직접 연락
- 시스템 오류: 상세한 오류 내용과 함께 문의
⚠️ 주의사항: 암호화폐 거래는 고위험 투자입니다. 투자 손실의 책임은 투자자 본인에게 있으며, 충분한 검토 후 신중하게 투자하시기 바랍니다.