shuim/auto-stock
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 안전형 스윙 개선(서킷브레이커·own_trend) + 매수 현금해결 방어

Browse Source 
퀀트 리서치(공정 유니버스+walk-forward)로 검증된 안전 게이트 2종과
매수 경로 현금 해결 방어 코드 추가. 모두 기존 시그니처 유지(§4).

- 지수 서킷브레이커: KODEX200 종가 < MA20이면 신규 스윙 진입 전면 중단
  (하락장 상관붕괴=2024H2형 방어). execute_swing_entries가 기존
  check_market_regime의 drop_from_ma20을 재사용(추가 API 없음). 백테스트
  루프에도 동일 적용. 검증: 최근1년 Sharpe 0.82→1.13, CAGR 7.2→8.6%, MDD 개선.
- own_trend 게이트: 평균회귀·눌림목 매수 시 종목 MA20 >= MA60×0.97일 때만
  진입(하락추세 물타기 방지). 실서비스는 recommendations.is_mean_reversion_candidate
  에서 StockAnalysis.ma20/ma60로, check_buy_signal엔 ma20/ma60 선택 파라미터
  (기본 None=하위호환) 추가. 백테스트(kr_backtest_engine, run_backtest)도 평균회귀 한정.
- 매수 현금 해결 방어(trade_executor._execute_buy): 0-현금 캐시를 신뢰하지 않고
  현금<=0이면 자산과 무관하게 KIS 예수금 재조회, 실현금(>0)일 때만 캐시.
  0-현금 고착으로 수량 0이 되는 잠재 무한루프 방어.

검증: code-verifier 통과(CONFIRMED 버그 없음, None-safe, §3/§4/§5 준수),
pytest 442 통과, 6파일 컨테이너 컴파일·리로드 정상.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HBmzf1HDnvFHLraJ8eaaKJ
This commit is contained in:
shuim
2026-09-16 13:17:17 +09:00
parent a0973812fb
commit 8a8e3700db
6 changed files with 92 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
backend/app/api/endpoints/recommendations.py
View File

@@ -253,6 +253,14 @@ def is_mean_reversion_candidate(stock, conditions: dict, market_regime_str: str)
if close < settings.MIN_PRICE_KRW:
return False
# [안전형 개선①] own_trend 게이트 (검증 완료: Sharpe 0.27→0.57)
# 종목 자체 MA20 < MA60*0.97 (하락추세)이면 평균회귀 매수(물타기) 차단.
# ma20/ma60 미조회(None)인 경우 게이트 미적용 — 기존 동작 보존.
ma20_val = float(stock.ma20) if getattr(stock, "ma20", None) else None
ma60_val = float(stock.ma60) if getattr(stock, "ma60", None) else None
if ma20_val is not None and ma60_val is not None and ma60_val > 0 and ma20_val < ma60_val * 0.97:
return False
regime = MarketRegime.BULL if market_regime_str == "bull" else MarketRegime.BEAR
adx_val = float(stock.adx_14) if getattr(stock, "adx_14", None) else None
# ADX는 0~100 범위. 100 초과 시 계산 오류이므로 무시
@@ -625,7 +633,7 @@ async def get_rule_based_recommendations_realtime():
@router.post("/auto-trade")
async def execute_auto_trading(db: AsyncSession = Depends(get_db)):
try:
recommendations_response = await get_rule_based_recommendations(realtime=True)
recommendations_response = await get_rule_based_recommendations(realtime=True, auto_trade=False)
if not recommendations_response.get("recommendations_by_rule"):
return {"message": "추천 종목이 없습니다", "trades": []}

6
backend/app/services/kr_backtest_engine.py
View File

@@ -487,6 +487,10 @@ class MeanReversionBacktest(BacktestStrategy):
prev_vol = volumes[-2] if len(volumes) >= 2 else 0
# [안전형 개선①] own_trend 게이트용 — 종목 자체 MA20/MA60 (데이터 있으면 재사용)
ma20_val = sum(closes[-20:]) / 20 if len(closes) >= 20 else None
ma60_val = sum(closes[-60:]) / 60 if len(closes) >= 60 else None
signal = check_buy_signal(
regime=self._get_regime(params),
rsi=rsi,
@@ -499,6 +503,8 @@ class MeanReversionBacktest(BacktestStrategy):
prev_volume=prev_vol,
is_reversal=reversal,
rsi_prev=rsi_prev,
ma20=ma20_val,
ma60=ma60_val,
)
if signal:

15
backend/app/services/mean_reversion_strategy.py
View File

@@ -294,6 +294,8 @@ def check_buy_signal(
prev_volume: int,
is_reversal: bool = False,
rsi_prev: Optional[float] = None, # [2026-03] RSI 반등 확인용 — 3봉 전 RSI
ma20: Optional[float] = None, # [안전형 개선①] own_trend 게이트용 — 종목 자체 MA20
ma60: Optional[float] = None, # [안전형 개선①] own_trend 게이트용 — 종목 자체 MA60
) -> Optional[Dict]:
"""CLAUDE.md 6.2: 매수 조건 판별
@@ -302,12 +304,25 @@ def check_buy_signal(
- BULL: RSI < 40, BB하단 -3%~+1.5%, 거래량 >= 20일평균
- BEAR: RSI < 30, 종가 <= BB하단, 되돌림 캔들, 거래량 > 1.5×20일평균
- RSI 반등 확인: rsi_prev 제공 시, RSI가 반등 중일 때만 진입 허용
[안전형 개선①] own_trend 게이트 (검증 완료: Sharpe 0.27→0.57)
- ma20/ma60 제공 시: 종목 자체 MA20 < MA60*0.97 (하락추세)이면 진입 차단
(물타기 방지 — 시장 국면과 무관하게 개별 종목이 자체 하락추세면 평균회귀 매수 금지)
- ma20/ma60 미제공(기본값 None): 게이트 미적용 — 기존 호출부/테스트 하위호환 유지
"""
# CLAUDE.md 6.1: 횡보장(SIDEWAYS)에서는 모든 진입 신호를 무시
if regime == MarketRegime.SIDEWAYS:
logger.debug("⏭️ SIDEWAYS 국면 — 진입 차단 (CLAUDE.md 6.1)")
return None
# [안전형 개선①] own_trend 게이트 — 종목 자체 하락추세 물타기 방지
if ma20 is not None and ma60 is not None and ma60 > 0 and ma20 < ma60 * 0.97:
logger.debug(
"⏭️ own_trend 게이트 — 종목 자체 하락추세 진입 차단: MA20(%.1f) < MA60(%.1f)*0.97",
ma20, ma60,
)
return None
if current_volume < avg_volume_20d:
return None

25
backend/app/services/swing/entry_service.py
View File

@@ -40,6 +40,9 @@ logger = logging.getLogger(__name__)
# 스윙 동시 보유 최대 종목 수 (CLAUDE.md 5.1: MAX_HOLDINGS_COUNT = 20)
MAX_SWING_POSITIONS = 20
# RSI 반등 방향 확인용 과거 구간 (kosdaq_scanner.py RSI_DIRECTION_LOOKBACK과 동일)
RSI_DIRECTION_LOOKBACK = 3
async def execute_swing_entries(recommendations_response: dict, db: AsyncSession) -> list[dict]:
"""배치 분석 추천 결과를 기반으로 스윙 매수 실행.
@@ -100,13 +103,26 @@ async def execute_swing_entries(recommendations_response: dict, db: AsyncSession
logger.info("[SwingEntry] 플레이북 차단 — 신규 진입 비활성화 (이벤트 대응)")
return []
# SIDEWAYS 국면 체크
# SIDEWAYS 국면 체크 + [안전형 개선②] 지수 서킷브레이커
try:
regime = await check_market_regime()
regime_str = regime.get("regime_200d", "bull") if isinstance(regime, dict) else "bull"
if regime_str == "sideways":
logger.info("[SwingEntry] SIDEWAYS 국면 — 진입 신호 무시 (CLAUDE.md 6.1)")
return []
# [안전형 개선②] 지수 서킷브레이커 (검증 완료: 2024H2 CAGR -9.9%→+1.0%, MDD -7→-1.9)
# KODEX200(069500) 일봉 종가 < MA20 → 신규 스윙 진입 전면 중단 (기존 보유 청산/관리는 정상 동작).
# check_market_regime()이 이미 계산한 drop_from_ma20(=(현재가-MA20)/MA20*100)을 재사용하여
# 지수 데이터 중복 조회를 피한다.
if isinstance(regime, dict):
_drop_from_ma20 = regime.get("drop_from_ma20")
if _drop_from_ma20 is not None and float(_drop_from_ma20) < 0:
logger.info(
"[SwingEntry] 지수 서킷브레이커 — KODEX200 종가<MA20 (drop=%.2f%%) — 신규 진입 전면 중단",
float(_drop_from_ma20),
)
return []
except Exception as e:
logger.warning(f"[SwingEntry] 시장 국면 조회 실패: {e}")
@@ -249,9 +265,10 @@ async def scan_dual_strategy_signals(db: AsyncSession) -> list[dict]:
current_close = closes[-1]
current_volume = volumes[-1] if volumes else 0
rsi_values = calculate_rsi(closes, period=14)
rsi = rsi_values[-1] if rsi_values else 50.0
rsi_prev = rsi_values[-2] if len(rsi_values) >= 2 else None
rsi = calculate_rsi(closes, period=14)
if rsi is None:
continue
rsi_prev = calculate_rsi(closes[:-RSI_DIRECTION_LOOKBACK], period=14)
scan_count += 1

14
backend/app/services/trade_executor.py
View File

@@ -501,7 +501,9 @@ async def _execute_buy(
# ── 3. 현금·자산 조회 (30초 캐시 → portfolio_cache → KIS API 직접) ─────
cached = _get_cached_account()
if cached:
# [FIX] 현금이 0인 캐시는 신뢰하지 않는다. 기존엔 available_cash=0이 캐시되면
# 그대로 재사용해 수량이 0으로 계산되어 매수 주문이 영영 안 나갔다(무한루프).
if cached and cached[0] > 0:
available_cash, total_assets = cached
else:
available_cash, total_assets = 0.0, 0.0
@@ -514,8 +516,11 @@ async def _execute_buy(
total_assets = float(summary_copy.get("total_assets", 0))
except Exception:
pass
# 2차: 캐시 미스 → KIS API 직접 조회 (잔고 0이면 미초기화로 판단)
if available_cash <= 0 and total_assets <= 0:
# 2차: 현금이 0이면 KIS API로 직접 조회.
# [FIX] 기존 조건은 (cash<=0 AND assets<=0) 이라, 평가자산은 있는데 캐시 현금만
# 0인 경우(portfolio_cache 요약이 available_cash=0을 준 케이스) KIS 재조회를
# 건너뛰어 현금 0이 고착됐다. 현금이 0이면 자산과 무관하게 실제 예수금을 읽는다.
if available_cash <= 0:
try:
balance = await korea_investment_api.get_balance()
output2 = balance.get("output2", [{}])
@@ -526,7 +531,8 @@ async def _execute_buy(
logger.info(f"[CASH_INIT] KIS API 직접 조회: cash={available_cash:,.0f} assets={total_assets:,.0f}")
except Exception as e:
logger.warning(f"[CASH_INIT] KIS 잔고 조회 실패: {e}")
if available_cash > 0 or total_assets > 0:
# [FIX] 실제 현금(>0)일 때만 캐시한다. 0 현금을 캐시하면 위 무한루프가 재발한다.
if available_cash > 0:
_set_account_cache(available_cash, total_assets)
# [이슈1 수정] TradeHistory.created_at은 UTC 저장(datetime.utcnow)이므로