feat: add signal score detail to bot logs for HOLD reason debugging

get_signal() now returns (signal, detail) tuple with long/short scores,
ADX value, volume surge status, and HOLD reason for easier diagnosis.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
21in7
2026-03-07 02:20:44 +09:00
parent c577019793
commit 0a8748913e
5 changed files with 46 additions and 19 deletions

View File

@@ -139,7 +139,7 @@ class TradingBot:
ind = Indicators(df)
df_with_indicators = ind.calculate_all()
raw_signal = ind.get_signal(
raw_signal, signal_detail = ind.get_signal(
df_with_indicators,
signal_threshold=self.config.signal_threshold,
adx_threshold=self.config.adx_threshold,
@@ -147,7 +147,13 @@ class TradingBot:
)
current_price = df_with_indicators["close"].iloc[-1]
logger.info(f"[{self.symbol}] 신호: {raw_signal} | 현재가: {current_price:.4f} USDT")
adx_str = f"ADX={signal_detail['adx']:.1f}" if signal_detail['adx'] is not None else "ADX=N/A"
vol_str = "Vol급증" if signal_detail['vol_surge'] else "Vol정상"
score_str = f"L={signal_detail['long']} S={signal_detail['short']}"
if raw_signal == "HOLD" and signal_detail['hold_reason']:
logger.info(f"[{self.symbol}] 신호: HOLD | {score_str} | {adx_str} | {vol_str} | 사유: {signal_detail['hold_reason']} | 현재가: {current_price:.4f}")
else:
logger.info(f"[{self.symbol}] 신호: {raw_signal} | {score_str} | {adx_str} | {vol_str} | 현재가: {current_price:.4f}")
position = await self.exchange.get_position()

View File

@@ -58,23 +58,29 @@ class Indicators:
signal_threshold: int = 3,
adx_threshold: float = 25,
volume_multiplier: float = 2.5,
) -> str:
) -> tuple[str, dict]:
"""
복합 지표 기반 매매 신호 생성.
signal_threshold: 최소 가중치 합계 (기본 3)
adx_threshold: ADX 최소값 필터 (0=비활성화, 25=ADX<25이면 HOLD)
volume_multiplier: 거래량 급증 배수 (기본 1.5)
Returns:
(signal, detail) — signal은 "LONG"/"SHORT"/"HOLD",
detail은 {"long": int, "short": int, "vol_surge": bool, "adx": float|None, "hold_reason": str}
"""
last = df.iloc[-1]
prev = df.iloc[-2]
# ADX 필터
adx = last.get("adx", None)
if adx is not None and not pd.isna(adx):
logger.debug(f"ADX: {adx:.1f}")
if adx_threshold > 0 and adx < adx_threshold:
return "HOLD"
adx_val = adx if adx is not None and not pd.isna(adx) else None
if adx_val is not None:
logger.debug(f"ADX: {adx_val:.1f}")
if adx_threshold > 0 and adx_val < adx_threshold:
detail = {"long": 0, "short": 0, "vol_surge": False, "adx": adx_val, "hold_reason": f"ADX({adx_val:.1f}) < {adx_threshold}"}
return "HOLD", detail
long_signals = 0
short_signals = 0
@@ -112,11 +118,23 @@ class Indicators:
# 6. 거래량 확인 (신호 강화)
vol_surge = last["volume"] > last["vol_ma20"] * volume_multiplier
detail = {"long": long_signals, "short": short_signals, "vol_surge": vol_surge, "adx": adx_val, "hold_reason": ""}
if long_signals >= signal_threshold and (vol_surge or long_signals >= signal_threshold + 1):
return "LONG"
return "LONG", detail
elif short_signals >= signal_threshold and (vol_surge or short_signals >= signal_threshold + 1):
return "SHORT"
return "HOLD"
return "SHORT", detail
# HOLD 사유 구성
best_side = "LONG" if long_signals >= short_signals else "SHORT"
best_score = max(long_signals, short_signals)
reasons = []
if best_score < signal_threshold:
reasons.append(f"{best_side} 점수({best_score}) < 임계값({signal_threshold})")
elif not vol_surge and best_score < signal_threshold + 1:
reasons.append(f"거래량 미급증 & {best_side} 점수({best_score}) < {signal_threshold + 1}")
detail["hold_reason"] = ", ".join(reasons) if reasons else "점수 부족"
return "HOLD", detail
def get_atr_stop(
self, df: pd.DataFrame, side: str, entry_price: float,