모든 API

기업 재무 상태를 보는 재무상태표 API

표준화된 자산, 부채, 자본을 가져옵니다. 파생 값인 운전자본과 순부채가 있으며, 리스부채는 총부채에서 제외됩니다.

무료 API 키 받기
문서 읽기 →
정상 운영 중97.81% uptime, last 30일295 ms 일반 응답 시간

첫 요청

재무상태표 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=balance" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "cash": "20935000000",
      "total_assets": "758376000000",
      "total_liabilities": "315989000000",
      "total_equity": "442387000000"
    }
  ]
}

엔드포인트

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처럼 쉼표로 구분한 항목 이름.

응답 필드

  • cash필드

    현금과 쉽게 현금으로 바꿀 수 있는 단기 현금성자산입니다. 은행의 경우 현금과 타 은행 예치금입니다.

  • short_term_investments필드

    단기투자 및 시장성 유가증권입니다.

  • long_term_investments필드

    재무상태표에 장기 자산으로 보고된 투자입니다.

  • receivables필드

    고객과 기타 거래처에 받을 금액으로 유동자산으로 분류된 항목입니다.

  • inventory필드

    판매용 상품, 재공품, 생산에 쓰이는 원재료와 소모품입니다.

  • total_current_assets필드

    유동으로 분류된 자산으로, 일반적으로 영업주기 또는 1년 이내에 실현, 판매 또는 사용됩니다.

  • working_capital필드

    유동자산에서 유동부채를 빼서 계산하며, 파생 값으로 표시됩니다.

  • ppe_net필드

    영업에 사용되는 유형자산으로, 감가상각누계액과 손상차손을 차감한 금액입니다.

  • goodwill필드

    사업 인수 대가가 식별 가능한 순자산의 공정가치를 초과할 때 인식되는 자산입니다.

  • intangibles필드

    재무상태표에 인식된 비물리적 자산으로, 영업권은 제외합니다.

  • total_assets필드

    재무상태표에 인식된 자산의 장부금액 합계입니다.

  • total_current_liabilities필드

    유동으로 분류된 채무로, 일반적으로 영업주기 또는 1년 이내에 결제됩니다.

  • accounts_payable필드

    공급업체와 기타 거래처에 지급할 금액으로 유동부채로 분류된 항목입니다.

  • deferred_revenue필드

    이연수익과 계약부채입니다.

  • short_term_debt필드

    1년 이내에 만기가 도래하는 차입금으로, 장기 부채의 유동 부분을 포함합니다.

  • long_term_debt필드

    1년 후에 만기가 도래하는 차입금으로, 유동 부분은 제외합니다.

  • lease_liabilities필드

    리스에서 발생한 부채로, 총부채에서는 제외됩니다.

  • total_debt필드

    단기 및 장기 차입금을 합한 금액이며, 리스부채는 제외합니다.

  • net_debt필드

    총부채에서 현금을 빼서 계산하며, 리스부채는 제외합니다. 파생 값으로 표시됩니다.

  • total_liabilities필드

    재무상태표에 인식된 채무의 장부금액 합계입니다.

  • retained_earnings필드

    분배 후 누적된 이익 또는 누적 손실입니다.

  • equity_parent필드

    모회사 소유주에게 귀속되는 지분입니다.

  • noncontrolling_interest필드

    모회사 외 소유자에게 귀속되는 자회사 지분입니다.

  • temporary_equity필드

    부채와 자본 사이에 표시되는 상환 가능한 비지배지분과 상환 가능한 우선주입니다.

  • total_equity필드

    비지배지분을 포함한 회사에 대한 총 지분입니다.

  • total_liabilities_and_equity필드

    재무상태표에 보고된 부채와 자본의 합계입니다.

  • deposits필드

    고객이 은행에 예치한 금액입니다.

  • loans필드

    신용손실충당금을 차감한 은행의 고객 대출금 및 선급금입니다.

전체 레퍼런스 →

활용 사례

수년간의 기업 데이터 불러오기

긴 이력을 페이지 단위로 가져오고 작업이 중단되면 이어서 진행합니다.

가이드 읽기 →

일정에 따라 새로 고침

작은 스크립트로 매일 새 공시와 수치를 가져옵니다.

가이드 읽기 →

한도 내에서 사용하기

응답을 캐시하고 요청 손실 없이 429 오류를 처리합니다.

가이드 읽기 →

에이전트에게 기업에 대해 질문하기

MCP를 통해 LLM 에이전트에 공시와 재무제표 읽기 권한을 제공합니다.

가이드 읽기 →

데이터 범위

  • 미국공시와 재무제표. 2009년부터의 이력.
  • 일본3,800개 이상의 기업, 연간 및 반기.
  • 한국지금까지 상장 기업의 약 절반.
  • 대만약 1,980개 기업. 2026년 반기 보고서.
  • EU 및 EEA26개국 약 3,200개 기업, 연간만 제공.
  • 영국규제 시장의 약 800개 기업, 연간만 제공.

출처

관련 API

기업 실적을 보는 손익계산서 API

회사 공시의 매출, 비용, 이익

API 탐색 →

기업 현금 흐름을 보는 현금흐름표 API

영업, 투자, 재무 현금흐름을 부호가 있는 유출과 함께 제공

API 탐색 →

주당 이익과 배당을 위한 EPS API

주력 보통주 종류의 순이익, 배당금, 주식 수

API 탐색 →

기업 분석을 위한 재무제표 API

표준화된 재무제표, 보고 기간, 과거 버전

API 탐색 →

자주 묻는 질문

총부채에 리스부채가 포함되나요?

리스부채는 총부채와 순부채 계산에서 제외됩니다.

재무상태표 항목이 없으면 어떻게 되나요?

보고되지 않은 항목은 응답에서 제외됩니다. 공시에 명시적으로 보고된 0은 0으로 유지됩니다.

재무상태표 금액은 어떤 통화를 사용하나요?

각 금액은 공시의 통화를 십진수 문자열로 유지합니다. Narwhal은 이를 환산하거나 백만 단위로 조정하지 않습니다.

운전자본

유동자산에서 유동부채를 뺀 값으로 계산되며 파생 값으로 표시됩니다.

순부채

총부채에서 현금을 뺀 값으로 계산되며 리스는 제외합니다.

리스부채

별도로 보고되며 총부채에서 제외됩니다.