The-Ouroboros/docs/issues/ISSUE-2026-02-17-no-trades-zero-candidates.md

Issue: Realtime 모드에서 거래가 지속적으로 0건

Summary

realtime 실행 중 주문 단계까지 진입하지 못하고, 스캐너 단계에서 후보가 0건으로 반복 종료된다.

Observed

• 로그에서 반복적으로 Smart Scanner: No candidates ... — no trades 출력
• 해외 시장에서 Overseas ranking endpoint unavailable (404) 다수 발생
• fallback 심볼 스캔도 0 candidates로 종료
• data/trade_logs.db 기준 최근 구간에 BUY/SELL 없음

Impact

• 매매 전략 품질과 무관하게 주문 경로가 실행되지 않아 실질 거래 불가
• 장애 원인을 로그만으로 즉시 분해하기 어려움

Root-Cause Hypothesis

• 스캐너 필터(가격/변동성) 단계에서 대부분 탈락
• 해외 랭킹 API 불가 시 입력 유니버스가 빈 상태가 되어 후보 생성 실패
• 기존 로그는 최종 결과(0 candidates)만 보여 원인별 분해가 어려움

Acceptance Criteria

• 스캔 1회마다 탈락 사유가 구조화되어 로그에 남아야 함
• 국내/해외(랭킹/폴백) 경로 모두 동일한 진단 지표를 제공해야 함
• 운영자가 로그만 보고 왜 0 candidates인지를 즉시 판단 가능해야 함

Scope

• 이번 이슈는 진단 가능성 개선(Observability) 에 한정
• 후보 생성 전략 변경(기본 유니버스 강제 추가 등)은 별도 이슈로 분리