📘 Upbit-KingAuto 사용 설명서 v1.2.5

## 목차
1. [프로그램 개요](#프로그램-개요)
2. [주요 특징](#주요-특징)
3. [시스템 요구사항](#시스템-요구사항)
4. [초기 설정 가이드](#초기-설정-가이드)
5. [예약 시간 설정](#예약-시간-설정)
6. [사용 방법](#사용-방법)
7. [매매 전략 상세](#매매-전략-상세)
8. [매도 전략 상세](#매도-전략-상세)
9. [예약 동작 흐름](#예약-동작-흐름)
10. [로그 읽는 법](#로그-읽는-법)
11. [고급 설정](#고급-설정)
12. [안전 수칙](#안전-수칙)
13. [문제 해결 (FAQ)](#문제-해결-faq)
14. [실전 운영 팁](#실전-운영-팁)
15. [수익률 관리](#수익률-관리)
16. [업데이트 정보](#업데이트-정보)
17. [고객 지원](#고객-지원)
18. [면책 조항](#면책-조항)
19. [용어 정리](#용어-정리)

    

## 프로그램 개요

**UpbitKingAuto**는 업비트 거래소 전용 자동매매 프로그램으로, 기술적 지표(CCI, RSI, BB)를 활용한 **저점 돌파 매매 전략**을 구현한 예약형 자동매매 시스템입니다.

---

## 주요 특징

### 🕐 예약 자동매매 시스템
- **오전 세션**: 사용자 지정 시간에 자동 시작 및 종료
- **오후 세션**: 별도 시간대 설정으로 하루 2회 운영
- **자동 ON/OFF**: 설정 시간에 자동 시작, 종료 시간에 자동 중단

### 📊 기술적 분석 기반
- **CCI (Commodity Channel Index)**: 과매도/과매수 구간 판단
- **RSI (Relative Strength Index)**: 상대 강도 지수 분석
- **BB (Bollinger Bands)**: 볼린저 밴드 저점 돌파 감지

### 💰 리스크 관리
- **수동 손절률 설정**: 사용자가 직접 손실 한도 지정
- **트레일링 스톱**: 수익 구간에서 자동 추적 매도
- **안전 장치**: 급락 시 자동 보호 매도

---

## 시스템 요구사항

| 항목 | 요구사항 |
|------|---------|
| **운영체제** | Windows 10/11 (64bit) |
| **Python** | 3.8 이상 |
| **메모리** | 4GB 이상 권장 |
| **네트워크** | 안정적인 인터넷 연결 필수 |
| **거래소** | 업비트 API 키 필요 |
| **PC 상태** | 예약 시간 동안 전원 ON 및 절전 모드 해제 |

---

## 초기 설정 가이드

### 1️⃣ 프로그램 실행
1. UpbitKingAuto.exe 실행
2. 로그인 화면에서 인증 (초기 비밀번호: 관리자 문의)
3. 메인 화면 진입

### 2️⃣ API 키 등록
1. 메인 화면 우측 상단 [⚙️ 설정] 클릭
2. API 키 입력란에 업비트 ACCESS KEY 입력
3. SECRET KEY 입력
4. [🔑 저장] 버튼 클릭
5. "API 키 저장 및 로그인 성공" 메시지 확인

**⚠️ API 키 발급 방법:**
1. 업비트 웹사이트 로그인
2. 마이페이지 → Open API 관리
3. API 키 발급 (권한: 자산조회, 주문조회, 주문하기)
4. IP 주소 등록 (보안 강화)

### 3️⃣ 손절/트레일 설정
1. [⚙️ 설정] 화면에서 하단 설정
2. 손절률(%): 예) 3.5 (매수가 대비 -3.5% 시 손절)
3. 트레일 시작(%): 예) 1.2 (매수가 대비 +1.2% 도달 시 트레일 시작)
4. 트레일 간격(%): 예) 1.0 (최고가 대비 -1.0% 하락 시 익절)
5. [✓ 손절 ON] / [✓ 트레일 ON] 체크박스 확인
6. [적용] 버튼 클릭

---

## 예약 시간 설정

### 오전/오후 세션 설정

| 설정 항목 | 설명 | 권장값 |
|---------|------|--------|
| **오전 시작 시간** | 오전 세션 자동 시작 시간 | 09:00 |
| **오전 종료 시간** | 오전 세션 자동 종료 시간 | 12:00 |
| **오후 시작 시간** | 오후 세션 자동 시작 시간 | 14:00 |
| **오후 종료 시간** | 오후 세션 자동 종료 시간 | 17:00 |

### 예약 활성화
1. 메인 화면에서 [예약 설정] 버튼 클릭
2. 오전 세션 시간 입력
3. 오후 세션 시간 입력
4. [✓ 오전 세션 활성화] 체크
5. [✓ 오후 세션 활성화] 체크
6. [저장] 버튼 클릭

**💡 팁:**
- 변동성이 큰 시간대 선택 (장 시작 직후, 점심 시간 직후)
- 최소 2시간 이상 운영 권장
- 주말/공휴일 자동 건너뛰기 가능

---

## 사용 방법

### 📌 Step 1: 종목 선택
1. 좌측 [상승 종목] 리스트 확인
2. 원하는 종목 클릭 (예: KRW-BTC)
3. 하단 로그에 "📌 종목 선택: KRW-BTC" 표시 확인
4. 지표 미리보기 자동 표시

**종목 선택 기준:**
- ✅ 거래량이 많은 종목 (유동성 확보)
- ✅ 급등보다는 안정적인 상승세
- ✅ 24시간 변동폭 5~15% 내외
- ❌ 펌핑 의심 종목 제외
- ❌ 상장 폐지 예정 종목 제외

### 📌 Step 2: 매수 금액 설정
1. 중앙 [매수 금액 입력] 칸에 금액 입력 예) 50000 (5만원)
2. [💵 금액 확인] 버튼 클릭
3. "💰 매수 금액 설정: 50,000 KRW" 메시지 확인

**권장 금액:**
- **초보자**: 5만~10만원
- **중급자**: 10만~50만원
- **고급자**: 50만원 이상

**⚠️ 주의사항:**
- 보유 현금의 20~30% 이내 권장
- 한 종목에 전체 자산 투자 금지
- 손실 감당 가능한 금액만 투자

### 📌 Step 3: 예약 시작
1. 모든 설정 완료 확인
   - ✓ 종목 선택됨
   - ✓ 금액 설정됨
   - ✓ 예약 시간 설정됨
   - ✓ 손절/트레일 설정됨

2. [▶ 예약 시작] 버튼 클릭

3. 확인 메시지:
   "⏰ 예약 활성화
   • 오전: 09:00~12:00
   • 오후: 14:00~17:00
   PC를 켜놓으세요."

---

## 매매 전략 상세

### 🎯 저점 돌파 매수 조건 (3가지 모두 충족)

#### 1️⃣ CCI (Commodity Channel Index)
- **조건**: CCI ≤ -100 (과매도 구간)
- **의미**: 가격이 평균 대비 과도하게 하락한 상태
- **전략**: 반등 시작점 포착

#### 2️⃣ RSI (Relative Strength Index)
- **조건**: 37 ≤ RSI ≤ 40 AND RSI 상승 전환
- **의미**: 과매도 구간에서 반등 신호 감지
- **전략**: 저점 확인 후 상승 전환 시점 포착

#### 3️⃣ BB (Bollinger Bands)
- **조건**: 현재가가 볼린저 밴드 하단 근접 또는 돌파
- **의미**: 통계적 저점 도달
- **전략**: 평균 회귀 예상 구간 진입

### 💹 매수 신호 예시
```
[실시간 로그 예시]

[09:15:32] [KRW-BTC] [1회차 대기중]
RSI:38.2 (+0.00) → 38.2 (상승 전환 ✓)
CCI:-105.3 (+0.00) → -105.3 (과매도 ✓)
BB L:95,000 (+0.00) → 95,000 C:95,200 (하단 근접 ✓)
Core:3/3 신호감지 → ✅ 매수 조건 충족!

[09:15:35] [매수] 🟢 [1회차] KRW-BTC 체결 95,150원
```

---

## 매도 전략 상세

### 🔴 손절 매도 (손실 제한)
- **조건**: 매수가 대비 -3.5% 도달
- **예시**: 매수가: 100,000원 → 손절가: 96,500원 → 손실액: -3,500원 (-3.5%)
- **로그**: [매도] 💀 손절 매도 (PNL:-3.5%)

**손절 설정 가이드:**

| 투자 성향 | 손절률 | 설명 |
|---------|--------|------|
| 보수적 | 2~3% | 작은 손실로 빠른 손절 |
| 중립적 | 3~5% | 균형잡힌 손절 |
| 공격적 | 5~7% | 큰 변동성 허용 |

### 🚀 트레일링 스톱 (수익 확보)

#### 1단계: 트레일 시작 조건
- **조건**: 매수가 대비 +1.2% 수익 달성
- **예시**: 매수가: 100,000원 → 트레일 시작: 101,200원 (+1.2%)
- **로그**: [Info] 🟡 트레일 시작 (+1.2%)

#### 2단계: 최고가 추적
- 최고가 갱신마다 익절선 자동 상향 조정
- **예시**: 최고가: 103,000원 → 익절선: 102,000원 (최고가 -1.0%)
- 현재가가 102,000원 이하로 떨어지면 즉시 매도

#### 3단계: 익절 실행
- **조건**: 현재가 ≤ 최고가 - 1.0%
- **예시**: 최고가: 103,000원 → 현재가: 101,900원 (최고가 대비 -1.1%) → 매도 체결: 101,900원
- **로그**: [매도] 🚀 트레일 익절 (PNL:+1.9%) 수익: +1,900원

### 🚨 급락 보호 매도
- **조건**: 매수가 대비 -5% 급락
- **목적**: 예상치 못한 폭락으로부터 보호
- **우선순위**: 손절보다 먼저 발동
- **로그**: [매도] 🚨 급락 보호 매도 (PNL:-5.0%)

---

## 예약 동작 흐름

### 📅 일일 스케줄 예시
```
08:00 ━━ PC 켜놓기 (필수!)
  ↓
09:00 ━━ 🟢 오전 세션 자동 시작
  ↓     • 선택한 종목 매수 신호 탐색
  ↓     • 조건 충족 시 자동 매수
  ↓     • 손절/익절 자동 모니터링
  ↓
12:00 ━━ 🔴 오전 세션 자동 종료
  ↓     • 포지션 보유 중이면 즉시 매도
  ↓     • 대기 상태 전환
  ↓
14:00 ━━ 🟢 오후 세션 자동 시작
  ↓     • 동일한 종목 재탐색
  ↓     • 새로운 매수 기회 포착
  ↓
17:00 ━━ 🔴 오후 세션 자동 종료
  ↓     • 모든 포지션 정리
  ↓     • 일일 통계 리셋 대기
  ↓
익일 ━━ 자정 통계 초기화
```

### 🔄 세션 내 동작 흐름
```
[세션 시작]
    ↓
[1단계] 매수 신호 탐색 (10초마다 체크)
    ├─ CCI, RSI, BB 분석
    ├─ 3가지 조건 모두 충족?
    │   ├─ YES → 매수 체결
    │   └─ NO → 계속 대기
    ↓
[2단계] 매도 조건 모니터링 (5초마다 체크)
    ├─ 손절 조건 확인
    ├─ 트레일 조건 확인
    ├─ 급락 보호 확인
    │   ├─ 조건 충족 → 매도 체결 → 1단계 복귀
    │   └─ 조건 미충족 → 계속 모니터링
    ↓
[세션 종료 시간 도달]
    ├─ 포지션 있음 → 시장가 즉시 매도
    └─ 포지션 없음 → 세션 종료
```

---

## 로그 읽는 법

### 대기 중 로그
```
[09:15:32] [KRW-BTC] [1회차 대기중]
RSI:45.3 (+0.00) → 45.3 | 
CCI:-85.2 (+0.00) → -85.2 | 
BB L:95,000 (+0.00) → 95,000 C:96,500 | 
Core:2/3 신호대기중

해석:
- 시각: 09시 15분 32초
- 종목: 비트코인
- 상태: 1회차 매수 신호 대기 중
- RSI: 45.3 (조건 미충족 - 37~40 필요)
- CCI: -85.2 (조건 미충족 - -100 이하 필요)
- BB: 하단 95,000원, 현재가 96,500원 (조건 미충족)
- Core: 3개 중 2개만 충족 → 매수 안 함
```

### 매수 체결 로그
```
[09:20:15] [매수] 🟢 [1회차] KRW-BTC 체결 95,150원

해석: 09시 20분 15초에 매수 완료, 비트코인 95,150원에 체결
```

### 보유 중 로그
```
[09:25:40] [KRW-BTC] 현재:95,800 
최고:95,800 PNL:+0.68% 
SL:91,890 TR:OFF 트레일OFF

해석:
- 현재가: 95,800원
- 최고가: 95,800원 (아직 갱신 안 됨)
- 수익률: +0.68%
- 손절가: 91,890원 (-3.5% 위치)
- 트레일: 아직 시작 안 됨 (1.2% 수익 달성 필요)
```

### 트레일 시작 로그
```
[09:30:22] [Info] 🟡 트레일 시작 (+1.2%)
[09:30:23] [KRW-BTC] 현재:96,300 
최고:96,300 PNL:+1.21% 
SL:91,890 TR:95,340 트레일ON

해석:
- 수익률 1.2% 돌파로 트레일 활성화
- 트레일 익절선(TR): 95,340원 (최고가 96,300 × 99% = 95,340)
- 현재가가 95,340원 이하로 떨어지면 즉시 매도
```

### 익절 로그
```
[09:35:10] [매도] 🚀 트레일 익절 (PNL:+2.5%) [1회차 완료]
[09:35:10] 💰 이번 거래: +1,250원 | 
오늘 누적: +1,250원 | 거래 횟수: 1/2

해석:
- 트레일 조건 충족으로 익절 매도
- 수익률: +2.5%
- 실제 수익: 1,250원
- 오늘 첫 거래 완료 (1/2)
```

---

## 고급 설정

### 보정값 설정 (숙련자용)
```
[⚙️ 설정] → 보정 입력란

RSI 보정: 예) +2.0
→ 실제 RSI가 35일 때 37로 인식 (매수 조건 완화)

CCI 보정: 예) -10.0
→ 실제 CCI가 -90일 때 -100으로 인식 (매수 조건 완화)

LowerBB 보정: 예) +500
→ BB 하단을 500원 높게 인식 (매수 조건 강화)
```

**⚠️ 주의:**
- 보정값은 백테스팅 후 사용 권장
- 과도한 보정은 손실 유발 가능
- 기본값(0.0)으로 시작 추천

---

## 안전 수칙

### ✅ 반드시 지켜야 할 것

**1. PC 전원 유지**
- 예약 시간 동안 PC 절대 꺼지지 않게
- 절전 모드, 대기 모드 OFF
- 안정적인 전원 공급

**2. 인터넷 연결 안정성**
- 유선 랜 케이블 사용 권장
- Wi-Fi 사용 시 신호 강도 확인
- 네트워크 끊김 시 자동 중단됨

**3. API 키 보안**
- 절대 타인에게 공유 금지
- IP 주소 제한 설정
- 정기적으로 재발급

**4. 자금 관리**
- 전체 자산의 30% 이내만 투자
- 생활비는 절대 투자 금지
- 손실 감당 가능한 금액만

**5. 모니터링**
- 하루 1~2회 프로그램 상태 확인
- 로그 확인으로 이상 징후 파악
- 비정상 작동 시 즉시 중단

### ❌ 하지 말아야 할 것

**1. 무분별한 설정 변경**
- 검증되지 않은 보정값 사용
- 과도하게 공격적인 손절률 (1% 미만)
- 너무 느슨한 손절률 (10% 이상)

**2. 감정적 개입**
- 손실 시 바로 매수금액 증액
- 수익 시 지나친 자신감
- 프로그램 중단 후 수동 매매

**3. 과도한 운영**
- 24시간 연속 가동
- 여러 종목 동시 운영 (초보자)
- 휴일/변동성 큰 날 무리한 운영

---

## 문제 해결 (FAQ)

### Q1. 예약 시간인데 자동 시작이 안 돼요

**원인:** PC 시간이 정확하지 않음 / 프로그램이 꺼져있음 / 예약 활성화 안 됨

**해결:**
1. Windows 시간 설정 확인 → 설정 → 시간 및 언어 → 자동으로 시간 설정 ON
2. 프로그램 실행 확인 → 예약 시간 10분 전에는 프로그램 켜놓기
3. 예약 활성화 확인 → [예약 설정] → [✓ 오전/오후 세션 활성화] 체크

### Q2. 매수가 너무 안 돼요

**원인:** 조건이 너무 까다로움 / 변동성이 작은 시간대 / 잘못된 종목 선택

**해결:**
1. 손절/트레일 설정 완화 → 손절률: 3.5% → 4.5% / 트레일 시작: 1.2% → 1.0%
2. 변동성 큰 시간대 선택 → 오전: 09:00~12:00 (추천) / 오후: 13:00~16:00 (비추천 - 변동성 작음)
3. 종목 재선택 → 거래량 상위 10개 종목 위주

### Q3. 손실이 계속 나요

**원인:** 시장 상황이 좋지 않음 / 설정이 부적절함 / 종목 선택 오류

**해결:**
1. 운영 중단 고려 → 하락장에서는 쉬는 것도 전략 / 최소 3일 연속 손실 시 중단
2. 손절 설정 강화 → 손절률: 4% → 3% / 트레일 시작: 1.2% → 0.8%
3. 보수적 종목 선택 → BTC, ETH 같은 메이저 코인 / 변동성 5% 이내 종목

### Q4. 프로그램이 자꾸 꺼져요

**원인:** PC 절전 모드 진입 / Windows 업데이트 자동 재부팅 / 메모리 부족

**해결:**
1. 절전 모드 비활성화 → 설정 → 시스템 → 전원 및 절전 → 화면 끔: 안 함 / 절전 모드: 안 함
2. 자동 업데이트 비활성화 → 설정 → Windows 업데이트 → 고급 옵션 → 사용 시간 설정
3. 다른 프로그램 종료 → 작업 관리자에서 불필요한 프로그램 종료

### Q5. API 키 오류가 나요

**원인:** 잘못된 API 키 입력 / IP 주소 미등록 / 권한 설정 오류

**해결:**
1. API 키 재확인 → 업비트 → Open API 관리에서 재확인 / 복사할 때 앞뒤 공백 주의
2. IP 주소 등록 → 현재 IP 확인: https://ip.pe.kr / 업비트에 해당 IP 등록
3. 권한 재설정 → 업비트 API 권한: 자산 조회 ✓ / 주문 조회 ✓ / 주문하기 ✓

---

## 실전 운영 팁

### 💡 초보자 추천 설정
- **종목**: BTC (비트코인) 또는 ETH (이더리움)
- **금액**: 5만원~10만원
- **예약 시간**: 오전: 09:00~11:30 / 오후: 사용 안 함 (체크 해제)
- **손절/트레일**: 손절 ON: 3.0% / 트레일 ON: 1.0% 시작, 0.8% 간격
- **일일 손실 한계**: 30,000원

### 🔥 중급자 추천 설정
- **종목**: 거래량 상위 5~10위 알트코인
- **금액**: 10만원~30만원
- **예약 시간**: 오전: 09:00~12:00 / 오후: 14:00~16:30
- **손절/트레일**: 손절 ON: 3.5% / 트레일 ON: 1.2% 시작, 1.0% 간격
- **일일 손실 한계**: 50,000원

### ⚡ 고급자 추천 설정
- **종목**: 변동성 높은 신규 상장 코인
- **금액**: 30만원 이상
- **예약 시간**: 오전: 09:00~12:00 / 오후: 14:00~17:00
- **손절/트레일**: 손절 ON: 4.0% / 트레일 ON: 1.5% 시작, 1.2% 간격 / 보정값 활용
- **일일 손실 한계**: 100,000원

---

## 수익률 관리

### 목표 수익률 설정

| 기간 | 보수적 | 중립적 | 공격적 |
|-----|--------|--------|--------|
| **일일** | +0.5~1% | +1~2% | +2~5% |
| **주간** | +3~5% | +5~10% | +10~20% |
| **월간** | +10~15% | +15~30% | +30~50% |

**⚠️ 주의:** 목표는 참고용일 뿐, 달성 보장 불가 / 시장 상황에 따라 변동 폭 큼 / 손실 가능성 항상 존재

### 통계 관리

**[일일 종료 후 체크]**
1. 거래 횟수 확인
2. 승률 계산 (수익 거래 / 전체 거래)
3. 평균 수익/손실 비율
4. 최대 연속 손실 체크

**[주간 리뷰]**
1. 5일간 누적 수익률
2. 가장 수익/손실 큰 종목 분석
3. 설정 조정 필요 여부 판단

**[월간 정산]**
1. 한 달 총 수익률 계산
2. 다음 달 목표 재설정
3. 프로그램 업데이트 확인

---

## 업데이트 정보

### 최신 버전: v1.2.5 (2026.02.14)

**추가 기능:**
- ✅ 예약 시간 자동 시작/종료
- ✅ 오전/오후 2회 세션 운영
- ✅ 수동 손절/트레일 설정
- ✅ 실시간 지표 모니터링
- ✅ 자동 로그 저장

**버그 수정:**
- 🐛 세션 종료 시 포지션 미정리 문제 해결
- 🐛 예약 시간 초과 작동 방지
- 🐛 네트워크 끊김 시 자동 재연결

---

## 고객 지원

### 문의 방법
- 📺 유튜브: 쫑우코인
- 📧 이메일: daonet88@naver.com
- 💬 카카오톡: 채널 추가 "가입후 마이페이지 지원요청"
- ⏰ 지원 시간: 평일 09:00~18:00

### 자주 묻는 질문
**Q. 프로그램 사용료가 있나요?** A. 월 구매 후 평생 무료 업데이트
**Q. 수익 보장되나요?** A. 투자에는 항상 손실 위험이 있습니다. 보장 불가.
**Q. 여러 PC에서 사용 가능한가요?** A. 1 라이선스 = 1 PC (추가 IP는 별도 구매)
**Q. 환불 가능한가요?** A. 구매 후 7일 이내, 미사용 시 100% 환불

---

## 면책 조항

1. 본 프로그램은 투자 보조 도구일 뿐이며, 투자 수익을 보장하지 않습니다.
2. 모든 투자 결정과 그에 따른 손익은 사용자 본인의 책임입니다.
3. 암호화폐 시장의 높은 변동성으로 인해 원금 손실 가능성이 있습니다.
4. 프로그램 사용 전 충분한 테스트와 소액 투자를 권장합니다.
5. 본 설명서의 수익률 예시는 참고용이며, 실제 결과와 다를 수 있습니다.
6. 업비트 API 정책 변경 시 일부 기능이 제한될 수 있습니다.

---

## 용어 정리

| 용어 | 설명 |
|-----|------|
| **CCI** | 상품 채널 지수. -100 이하면 과매도 |
| **RSI** | 상대 강도 지수. 30 이하면 과매도 |
| **BB** | 볼린저 밴드. 가격 변동 범위 표시 |
| **손절** | 손실을 제한하기 위한 강제 매도 |
| **트레일** | 수익 구간에서 최고가 추적 익절 |
| **세션** | 프로그램이 작동하는 시간대 |
| **포지션** | 현재 보유 중인 코인 |
| **PNL** | 수익/손실률 (Profit and Loss) |

---

**🎉 Upbit-KingAuto와 함께 성공적인 투자하세요!**

📌 버전: v1.2.5 | 📅 최종 업데이트: 2026.02.14 | 🏢 제작사: Upbit-King Solutions | 💻 개발: 쫑우코인 팀