edf/.agents/references/known-issues.md

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 옵션으로 실행하지 말 것