283 lines
8.4 KiB
Markdown
283 lines
8.4 KiB
Markdown
# 로그 개선 사항 문서
|
||
|
||
**작성일**: 2025-12-04
|
||
**대상**: AutoCoinTrader 프로젝트
|
||
**목표**: 업비트 차트와 직접 비교하여 매수/매도 로직 검증 가능하게 개선
|
||
|
||
---
|
||
|
||
## 📋 문제점 (개선 전)
|
||
|
||
로그 파일에 다음 정보가 누락되어 있었습니다:
|
||
|
||
### 매수 조건
|
||
```
|
||
2025-12-04 22:28:04,955 - INFO - 조건 미충족: 매수조건 없음
|
||
2025-12-04 22:28:04,955 - INFO - [조건1 미충족]
|
||
2025-12-04 22:28:04,955 - INFO - [조건2 미충족]
|
||
2025-12-04 22:28:04,955 - INFO - [조건3 미충족]
|
||
```
|
||
|
||
❌ **문제**: MACD값, Signal값, SMA5/SMA200, ADX값이 보이지 않아 실제 차트값과 비교 불가능
|
||
|
||
### 매도 조건
|
||
```
|
||
[현재 보유 정보로 매도 조건 확인하는 로그가 없음]
|
||
```
|
||
|
||
❌ **문제**:
|
||
- 매수가, 현재가, 손절가, 익절가 정보 부재
|
||
- 수익률, 최고수익률, 최고점대비 하락률 계산 값 미표시
|
||
- 왜 매도되었는지 정확한 판정 기준 불명확
|
||
|
||
---
|
||
|
||
## ✅ 해결 사항 (개선 후)
|
||
|
||
### 1️⃣ 매수 조건 상세 로그
|
||
|
||
#### 🔧 적용 파일
|
||
- **파일**: `src/signals.py`
|
||
- **함수**: `_process_symbol_core()` (line ~545)
|
||
- **함수**: `_evaluate_buy_conditions()` (line ~357)
|
||
|
||
#### 📝 개선된 로그 형식
|
||
|
||
```log
|
||
[지표값] MACD: -0.000534 | Signal: 0.000123 | SMA5: 65420.15 | SMA200: 64230.50 | ADX: 26.45 (기준: 25)
|
||
|
||
[조건1 충족] MACD: -0.000534->0.000215, Sig: 0.000123->0.000456 | SMA: 65420.15 > 64230.50 | ADX: 26.45 > 25
|
||
|
||
[조건2 미충족] SMA: 65100.00->65420.15 cross 64500.00->64230.50 | MACD: 0.000215 > Sig: 0.000456 | ADX: 26.45 > 25
|
||
|
||
[조건3 미충족] ADX: 24.50->26.45 cross 25 | SMA: 65420.15 > 64230.50 | MACD: 0.000215 > Sig: 0.000456
|
||
```
|
||
|
||
#### 🎯 표시 정보
|
||
- ✅ MACD 선값 (이전 → 현재)
|
||
- ✅ Signal 선값 (이전 → 현재)
|
||
- ✅ SMA5/SMA200 (이전 → 현재, 또는 현재값)
|
||
- ✅ ADX값 및 기준값(25)
|
||
- ✅ 상향 돌파 여부
|
||
- ✅ 각 조건의 충족/미충족 이유
|
||
|
||
---
|
||
|
||
### 2️⃣ 매도 조건 상세 로그
|
||
|
||
#### 🔧 적용 파일
|
||
- **파일**: `src/signals.py`
|
||
- **함수**: `evaluate_sell_conditions()` (line ~42)
|
||
- **함수**: `_check_sell_logic()` (line ~800)
|
||
|
||
#### 📝 개선된 로그 형식
|
||
|
||
```log
|
||
[KRW-BTC] stop_loss 검사
|
||
매수가: 50000.00 | 현재가: 47400.00 | 최고가: 51000.00
|
||
손절가(-5%): 47500.00 | 익절가(10%): 55000.00 | 익절가(30%): 65000.00
|
||
현재수익률: -5.20% | 최고수익률: 2.00% | 최고점대비: -7.06%
|
||
판정: stop_loss (매도비율: 100%)
|
||
```
|
||
|
||
#### 매도 사유별 상세 로그
|
||
|
||
**조건1: 무조건 손절**
|
||
```
|
||
[손절(조건1)] 매수가 50000.00 → 현재 47400.00 (수익률 -5.20% <= -5.00%)
|
||
```
|
||
|
||
**조건2: 저수익 트레일링**
|
||
```
|
||
[트레일링 익절(조건2)] 매수가 50000.00 → 최고 51000.00 → 현재 48100.00(최고점대비 5.39% 하락 >= 5.0% 기준)
|
||
```
|
||
|
||
**조건3: 부분 매도**
|
||
```
|
||
[부분 익절(조건3)] 매수가 50000.00 → 현재 55100.00 (수익률 10.20% >= 10.00%) 50% 매도
|
||
```
|
||
|
||
**조건4-2: 수익률 보호 (중간 수익)**
|
||
```
|
||
[수익률 보호(조건4-2)] 최고가 56000.00(최고수익 12.00%) → 현재 54800.00(현재수익 9.60% <= 10.00%)
|
||
```
|
||
|
||
**조건4-1: 트레일링 익절 (중간 수익)**
|
||
```
|
||
[트레일링 익절(조건4-1)] 최고가 56000.00(최고수익 12.00%) → 현재 52900.00(최고점대비 5.36% 하락 >= 5.0% 기준)
|
||
```
|
||
|
||
**조건5-2: 수익률 보호 (고수익)**
|
||
```
|
||
[수익률 보호(조건5-2)] 최고가 65000.00(최고수익 30.00%) → 현재 63600.00(현재수익 27.20% <= 30.00%)
|
||
```
|
||
|
||
**조건5-1: 트레일링 익절 (고수익)**
|
||
```
|
||
[트레일링 익절(조건5-1)] 최고가 65000.00(최고수익 30.00%) → 현재 55100.00(최고점대비 15.23% 하락 >= 15.00% 기준)
|
||
```
|
||
|
||
#### 🎯 표시 정보
|
||
- ✅ 매수가, 현재가, 최고가
|
||
- ✅ 손절가(-5%), 익절가(10%), 익절가(30%)
|
||
- ✅ 현재 수익률, 최고 수익률, 최고점 대비 하락률
|
||
- ✅ 매도 조건 판정 결과
|
||
- ✅ 매도 비율
|
||
- ✅ 상세한 판정 기준과 이유
|
||
|
||
---
|
||
|
||
## 🔍 업비트 차트와 비교하기
|
||
|
||
이제 다음과 같이 로그를 활용하여 검증할 수 있습니다:
|
||
|
||
### 매수 신호 검증 (4시간봉)
|
||
|
||
1. **업비트 차트 열기**: https://upbit.com/exchange
|
||
2. **원하는 코인 선택** (예: BTC)
|
||
3. **4시간 타임프레임으로 변경**
|
||
4. **로그에서 확인**:
|
||
```
|
||
[지표값] MACD: -0.000534 | Signal: 0.000123 | SMA5: 65420.15 | SMA200: 64230.50 | ADX: 26.45
|
||
```
|
||
5. **차트와 비교**:
|
||
- MACD 지표에서 -0.000534 값 확인
|
||
- Signal 선이 0.000123 값 확인
|
||
- 5이평선이 65420.15 값 확인
|
||
- 200이평선이 64230.50 값 확인
|
||
- ADX가 26.45 값 확인
|
||
|
||
### 매도 신호 검증
|
||
|
||
1. **보유 코인의 1시간/4시간 차트 열기**
|
||
2. **로그에서 확인**:
|
||
```
|
||
[KRW-BTC] stop_loss 검사
|
||
매수가: 50000.00 | 현재가: 47400.00 | 최고가: 51000.00
|
||
손절가(-5%): 47500.00 | 익절가(10%): 55000.00
|
||
현재수익률: -5.20% | 최고수익률: 2.00%
|
||
```
|
||
3. **차트와 비교**:
|
||
- 현재 캔들의 종가가 47400.00 인지 확인
|
||
- 매수 후 최고점이 51000.00 인지 확인
|
||
- 손절가 47500.00이 맞는지 확인 (-5%)
|
||
- 현재 수익률이 -5.20%인지 계산으로 확인 ((47400-50000)/50000*100 = -5.2%)
|
||
|
||
---
|
||
|
||
## 📊 설정값 확인
|
||
|
||
### 매수 조건 설정 (`config.json`)
|
||
```json
|
||
{
|
||
"adx_threshold": 25, // ADX > 25
|
||
"sma_short": 5, // 5이평선
|
||
"sma_long": 200, // 200이평선
|
||
"macd_fast": 12, // MACD 단기
|
||
"macd_slow": 26, // MACD 장기
|
||
"macd_signal": 9 // MACD 신호선
|
||
}
|
||
```
|
||
|
||
### 매도 조건 설정 (`config.json`)
|
||
```json
|
||
{
|
||
"loss_threshold": -5.0, // 조건1: -5% 손절
|
||
"profit_threshold_1": 10.0, // 조건3,4,5: 10% 기준
|
||
"profit_threshold_2": 30.0, // 조건5: 30% 기준
|
||
"drawdown_1": 5.0, // 조건2,4: 5% 트레일링
|
||
"drawdown_2": 15.0 // 조건5: 15% 트레일링
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 적용 효과
|
||
|
||
### ✨ 장점
|
||
1. **신뢰성 검증**: 업비트 차트와 직접 비교하여 로직 검증 가능
|
||
2. **디버깅 용이**: 조건 미충족 이유를 명확히 파악 가능
|
||
3. **성능 모니터링**: 각 지표값의 변화를 추적할 수 있음
|
||
4. **오류 예방**: 잘못된 신호 발생 시 원인을 빠르게 파악
|
||
5. **운영 투명성**: 자동 매수/매도 결정 과정을 명확히 기록
|
||
|
||
### 📈 사용 사례
|
||
- ✅ 매수 신호 발생했는데 차트를 보니 다른 경우 → 로그 확인으로 이유 파악
|
||
- ✅ 매도됐는데 왜 매도됐는지 모르는 경우 → 로그에서 정확한 사유 확인
|
||
- ✅ 설정값 변경 후 효과 측정 → 이전/현재 로그 비교
|
||
- ✅ 거래 기록 감사 (Audit) → 모든 결정 근거 추적 가능
|
||
|
||
---
|
||
|
||
## 📝 로그 레벨
|
||
|
||
- **매수 조건 상세**: `INFO` 레벨 (항상 표시)
|
||
- **매도 조건 상세**: `INFO` 레벨 (항상 표시)
|
||
- **지표값 상세**: 매수/매도 판정 시마다 기록
|
||
|
||
### 로그 파일 위치
|
||
```
|
||
c:\tae\python\AutoCoinTrader\logs\AutoCoinTrader.log
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 코드 변경 사항
|
||
|
||
### `src/signals.py` 수정 내용
|
||
|
||
1. **`evaluate_sell_conditions()` 함수**:
|
||
- `result` dict에 `debug_info` 추가
|
||
- 각 매도 조건에 상세한 가격 정보 포함
|
||
|
||
2. **`_evaluate_buy_conditions()` 함수**:
|
||
- 함수 docstring 확장
|
||
- 반환값에 지표값 명시
|
||
|
||
3. **`_process_symbol_core()` 함수**:
|
||
- 조건별 상세 로그 메시지 생성
|
||
- MACD, Signal, SMA, ADX 값 표시
|
||
|
||
4. **`_check_sell_logic()` 함수**:
|
||
- 매도 검사 로그를 DEBUG → INFO로 변경
|
||
- 상세한 가격 및 수익률 정보 표시
|
||
|
||
---
|
||
|
||
## ✅ 검증 완료
|
||
|
||
테스트 결과:
|
||
```
|
||
[매도 조건 평가 결과]
|
||
상태: profit_taking
|
||
매도비율: 100%
|
||
수익률: 4.00%
|
||
최고점대비: -5.45%
|
||
사유: 트레일링 익절(조건2): 매수가 50000.00 → 최고 55000.00 → 현재 52000.00(최고점대비 5.45% 하락 >= 5.0% 기준)
|
||
|
||
[디버그 정보]
|
||
매수가: 50000.00
|
||
현재가: 52000.00
|
||
최고가: 55000.00
|
||
손절가(-5%): 47500.00
|
||
익절가(10%): 55000.00
|
||
익절가(30%): 65000.00
|
||
최고수익률: 10.00%
|
||
```
|
||
|
||
✅ **모든 정보가 명확하게 표시됨!**
|
||
|
||
---
|
||
|
||
## 📌 다음 단계
|
||
|
||
1. **실제 운영**: `python main.py`로 프로그램 실행
|
||
2. **로그 모니터링**: 매도/매수 신호 발생 시 로그 확인
|
||
3. **업비트 검증**: 차트와 비교하여 정확성 확인
|
||
4. **지속적 개선**: 필요시 추가 정보 로깅
|
||
|
||
---
|
||
|
||
**작성자**: GitHub Copilot
|
||
**마지막 업데이트**: 2025-12-04
|