← 콩시스트 도구함 미국공시 수집기

미국공시 수집기 문제 해결

SEC frames(전종목 단면)로 받았는데 회사 수가 적고 기준일이 제각각일 때

작성

SEC 의 frames API(data.sec.gov/api/xbrl/frames)는 「2024년 1분기 말 유동자산」 처럼 한 계정·한 시점을 여러 회사에 대해 한 번에 줍니다. 업종 비교에 편하지만 두 가지를 모르고 쓰면 결과가 틀어집니다.

실제로 받아 보니

2026년 9월 17일, 미국공시 수집기의 전종목 단면 비교에서 us-gaap / AssetsCurrent / USD / CY2024Q1I 를 조회했습니다.

전종목 단면 비교 조회 화면. 기간 CY2024Q1I 입력칸, 완료 안내의 발행인 4,605곳과 기준일 32가지에 붉은 원 표시가 있다.
발행인 4,605곳, 기준일(end) 32가지.

① 전수가 아닙니다

같은 날 프로그램이 받아 둔 SEC 의 티커 보유 회사 목록은 10,422곳이었습니다. 유동자산을 신고한 회사는 그중 4,605곳만 들어왔습니다. 금융회사처럼 유동·비유동을 나누지 않는 회사는 이 태그를 아예 쓰지 않고, 같은 계정을 다른 태그(회사 자체 확장 태그 등)로 신고한 회사도 빠집니다. 「시장 전체 평균」 이라고 부르기 전에 모집단부터 확인해야 합니다.

② 기준일이 회사마다 다릅니다

CY2024Q1I 는 「2024년 1분기 말에 가까운 시점」 이라는 뜻입니다. SEC 가 캘린더에 근사해 맞추므로 결산월이 다른 회사는 다른 날짜의 값이 들어옵니다. 애플은 9월 결산이라 2024-03-30 값이 들어 있습니다.

전종목 단면 결과를 Apple 로 걸러 본 화면. Apple Inc 와 end 2024-03-30, 요청 로그의 4,605 행과 회사 10,422곳에 붉은 원 표시가 있다.
애플의 기준일은 2024-03-31 이 아니라 2024-03-30. 로그에는 받은 4,605행과 회사 목록 10,422곳이 함께 남아 있습니다.

쓰기 전에 할 일

  • end 열을 꼭 함께 보세요. 비교하려는 회사들의 기준일이 몇 달씩 벌어져 있지 않은지 확인합니다.
  • 빠진 회사를 확인하세요. 관심 회사가 없으면 그 회사의 재무 시계열(companyconcept)로 어떤 태그를 쓰는지 봅니다.
  • 기간 값(매출 같은 것)은 CY2024Q1 처럼 끝에 I 를 빼고, 시점 값(자산 같은 것)은 I 를 붙입니다.