# Known Issues — 과거 실패 기록

> 이 파일은 에이전트가 같은 실수를 반복하지 않도록 실패를 기록합니다.
> 세션 종료 시 자동으로 새 이슈를 추가합니다.

---

### 2026-03-11 pykrx — get_market_ticker_list 항상 0 반환
- **증상**: `stock.get_market_ticker_list(date, market="KOSPI")`가 모든 날짜에 0 반환
- **원인**: pykrx 1.2.4 버전에서 ticker_list API가 정상 동작하지 않음 (2026년 환경)
- **해결**: DART `corp_codes`로 종목 목록 확보 + per-ticker `get_market_ohlcv`는 정상 동작
- **주의**: `get_market_ticker_list` 의존하지 말 것. DART corp_codes를 종목 마스터로 사용

### 2026-03-11 pykrx — get_market_cap 단일일자 조회 시 시총=0
- **증상**: `stock.get_market_cap(date, date, ticker)` 호출 시 시가총액이 0 반환
- **원인**: 단일일자 조회 문법 이슈 (pykrx 내부 처리 문제)
- **해결**: `stock.get_market_cap_by_date(start, end, ticker)`로 15일 범위 조회 후 마지막 값 사용
- **주의**: 단일일자 `get_market_cap` 사용 금지. 반드시 date range + `_by_date` 변형 사용

### 2026-03-11 DART — corp_codes 순서에 소형/비활성 종목 우선
- **증상**: DART `corp_codes` 순서대로 수집 시 처음 10~20개가 전부 에러 (비활성/상폐 종목)
- **원인**: corp_codes 정렬이 코드 순이라 소형/비활성사가 앞에 위치
- **해결**: KRX에서 주가 확인된 종목(volatility 테이블)만 DART 수집 대상으로 필터링
- **주의**: DART 수집 시 반드시 KRX 활성 필터 적용. `finstate(stock_code, year)` 형태로 직접 조회 가능

### 2026-03-11 PowerShell — 인라인 Python f-string 이스케이핑 불가
- **증상**: `python -c "...f'{var}'..."` 형태 인라인 코드가 PowerShell에서 파싱 오류
- **원인**: PowerShell의 `'`, `"`, `{}` 이스케이핑이 Python f-string과 충돌
- **해결**: 항상 별도 `.py` 파일로 작성하여 실행
- **주의**: PowerShell에서 복잡한 Python 코드를 `-c` 옵션으로 실행하지 말 것