문제 해결

미국공시 수집기를 쓰다 막히는 곳과 헷갈리는 점을 한 가지씩 풀어 둔 글입니다.

• SEC frames(전종목 단면)로 받았는데 회사 수가 적고 기준일이 제각각일 때2026-09-17frames API 는 한 계정을 모든 회사에 대해 한 번에 주지만 전수가 아니고, 회사마다 기준일이 다릅니다. 유동자산 CY2024Q1I 를 실제로 받아 4,605곳 · 기준일 32가지를 확인했습니다.
• SEC XBRL 의 fy · fp 로 기간을 거르면 틀리는 이유2026-09-17fy 와 fp 는 값의 기간이 아니라 그 값이 실린 보고서의 회계연도·분기입니다. 애플의 2025년 3분기 매출에 fy=2026 이 붙어 오는 실제 사례로 확인했습니다.
• SEC XBRL 재무 데이터를 더했더니 합계가 두 배가 될 때 — 중복 신고분2026-09-17companyconcept API 로 받은 값을 그대로 더하면 같은 기간이 두 번 들어가 합계가 부풀어 오릅니다. 애플 매출로 실제 117행 중 60행이 중복인 것을 확인했습니다.
• EDGAR 일별 인덱스 master · form · company 는 무엇이 다른가2026-09-17같은 날의 제출 기록인데 파일이 세 가지입니다. 2026년 9월 3일 인덱스 원본을 받아 열 순서와 구분 방식이 어떻게 다른지, 코드로 읽을 때 무엇을 조심해야 하는지 확인했습니다.
• SEC EDGAR 자료를 받으려는데 403 이 날 때2026-09-17파이썬이나 curl 로 data.sec.gov 를 부르면 403 이 돌아오는 경우가 많습니다. 실제로 요청을 보내 어떤 값이 막히고 통과하는지 확인한 결과와 고치는 법입니다.