수년간의 기업 데이터 불러오기
긴 이력을 페이지 단위로 가져오고 작업이 중단되면 이어서 진행합니다.
가이드 읽기 →모든 API
기업 분석을 위한 재무제표 API
연간 및 분기 기간의 표준화된 재무제표를 가져옵니다. 가능한 경우 반기 보고서도 제공되며, 이력과 전달 시점은 플랜에 따라 달라집니다.
첫 요청
기업 재무제표 가져오기
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials" \
--header "Authorization: Bearer $NARWHAL_API_KEY"응답 예시
{
"id": "usa:0000789019",
"currency": "USD",
"annual": [
{
"fy": 2026,
"end": "2026-06-30",
"revenue": "331839000000",
"net_income": "133749000000",
"total_assets": "758376000000",
"operating_cash_flow": "182935000000",
"eps_diluted": "17.95"
}
]
}엔드포인트
GET표준화된 회사 재무제표 가져오기/v1/companies/{company_id}/financials
기업의 표준화된 재무제표로, 기간별 한 행이며 공시 통화 기준입니다.
매개변수
company_id필수usa:0000789019 같은 기업 ID 또는 usa:MSFT 같은 티커 별칭.
period선택등록 기관에 따라 annual 또는 semiannual.
statement선택income, balance, cash_flow 또는 per_share.
fields선택revenue,net_income처럼 쉼표로 구분한 항목 이름.
응답 필드
fy필드보고 기간과 연결된 회계 연도
fq필드해당하는 경우 회계 분기
fh필드해당하는 경우 회계 반기
end필드보고 기간의 종료일
derived필드보고된 값에서 계산한 수치임을 표시합니다.
currency필드환산 없이 공시에 사용된 통화
전체 레퍼런스 →
GET공시에 보고된 그대로의 재무 정보 가져오기/v1/filings/{filing_id}/financials/as-reported
활용 사례
데이터 범위
- 미국공시와 재무제표. 2009년부터의 이력.
- 일본3,800개 이상의 기업, 연간 및 반기.
- 한국지금까지 상장 기업의 약 절반.
- 대만약 1,980개 기업. 2026년 반기 보고서.
- EU 및 EEA26개국 약 3,200개 기업, 연간만 제공.
- 영국규제 시장의 약 800개 기업, 연간만 제공.
출처
- 미국SEC EDGAR
- 일본EDINET, 금융청
- 한국DART, 금융감독원
- 대만TWSE 및 TPEx 상장 기업
- EU 및 EEAESEF 연차 보고서
- 영국영국 규제 시장 발행사
관련 API
자주 묻는 질문
표준 항목 77개를 모든 계정에서 이용할 수 있나요?
표준 항목 77개는 모든 계정에서 제공됩니다. 공시에 없는 항목은 응답에서 생략됩니다.
최초 보고 수치와 기준일 조회는 무엇을 뜻하나요?
최초 보고 수치는 재작성 이전에 제출된 그대로의 숫자를 보존합니다. 기준일 조회는 과거 특정 날짜에 알려져 있던 숫자를 반환합니다. 둘 다 모든 계정에서 이용할 수 있습니다.
하나의 시계열에 연결 재무제표와 별도 재무제표가 섞일 수 있나요?
아니요. Narwhal은 가능한 경우 연결 수치를 사용하며, 하나의 시계열 안에서 연결과 별도 수치를 섞지 않습니다. 파생 항목은 표시됩니다.
전체 이력
공시 기관이 게시하는 모든 연도의 연간 및 분기 데이터를 실시간으로 제공합니다.
최초 보고
재작성 이전, 최초로 제출된 그대로의 수치입니다.
기준일 조회
과거 특정 날짜에 알려져 있던 숫자입니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.