모든 API

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

회사 공시에서 표준화된 매출, 비용, 이익을 읽습니다. 비용은 양수이고, 계산 값은 표시되며, 모회사 순이익과 연결 순이익이 별도로 제공됩니다.

정상 운영 중97.81% uptime, last 30일295 ms 일반 응답 시간

첫 요청

손익계산서 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=income" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "gross_profit": "225465000000",
      "operating_income": "155237000000",
      "net_income": "133749000000"
    }
  ]
}

엔드포인트

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

응답 필드

  • revenue필드

    반품과 매출 할인을 차감한 매출 총액이며, 은행과 보험사는 비어 있습니다.

  • cost_of_revenue필드

    해당 기간에 판매한 상품과 서비스의 원가입니다.

  • gross_profit필드

    보고된 매출에서 매출원가를 뺀 금액이며, 은행과 보험사는 비어 있습니다.

  • research_and_development필드

    제품, 서비스 또는 공정을 연구하고 개발하는 데 드는 비용입니다.

  • selling_general_administrative필드

    제품과 서비스 판매, 사업 운영, 일반 관리에 드는 비용입니다.

  • selling_marketing필드

    판매 및 마케팅 활동에 드는 비용으로, 양수의 비용으로 기록됩니다.

  • general_administrative필드

    일반 관리 활동에 드는 비용으로, 양수의 비용으로 기록됩니다.

  • operating_expenses필드

    영업비용으로 보고된 총비용입니다.

  • operating_income필드

    영업활동에서 발생한 손익입니다.

  • ebit필드

    영업이익에서 도출하며, 영업이익이 없으면 세전이익에 이자비용을 더해 구합니다. 은행과 보험사는 제공되지 않습니다.

  • ebitda필드

    EBIT에 감가상각비와 무형자산상각비를 더해 계산하며, 파생 값으로 표시됩니다.

  • interest_income필드

    이자로 얻은 수익입니다. 은행의 경우 이자수익과 배당수익의 합계입니다.

  • interest_expense필드

    차입금과 기타 이자부 채무의 이자 비용으로, 양수로 표시됩니다.

  • net_interest_income필드

    은행의 이자수익에서 이자비용을 뺀 금액입니다.

  • noninterest_income필드

    이자 이외의 원천에서 발생한 은행의 총수익입니다.

  • noninterest_expense필드

    이자비용을 제외한 은행의 총비용입니다.

  • provision_for_credit_losses필드

    은행의 신용손실 비용으로, 비용인 경우 양수로 표시됩니다.

  • premiums_earned필드

    보험사가 해당 기간에 수익으로 인식한 보험료에서 출재 보험료를 뺀 금액입니다.

  • policy_benefits필드

    보험사가 해당 기간에 발생한 보험금 및 보험계약자 급부로 지출한 비용입니다.

  • pretax_income필드

    법인세 차감 전 계속영업 손익입니다.

  • income_tax필드

    법인세 비용 또는 수익이며, 비용일 때는 양수로 표시됩니다.

  • net_income필드

    비지배지분을 제외한 모회사 귀속 법인세 차감 후 당기순이익입니다.

  • net_income_parent필드

    모회사 소유주 귀속 당기순이익

  • net_income_to_common필드

    우선주 배당금을 차감한 후 보통주주에게 돌아가는 당기순이익입니다.

  • discontinued_ops_income필드

    세금을 차감한 중단영업 손익입니다.

  • net_income_including_nci필드

    비지배지분 몫을 포함한 법인세 차감 후 연결 당기순이익입니다.

  • net_income_noncontrolling필드

    모회사 외 자회사 소유주에게 귀속되는 손익입니다.

  • comprehensive_income필드

    비지배지분을 포함한 총포괄이익(그렇게 보고된 경우)

  • jp_ordinary_income필드

    영업손익과 영업외손익을 포함하고 특별손익과 세금을 차감하기 전의 일본 고유 이익 항목으로, US GAAP나 IFRS에 직접 대응하는 항목은 없습니다.


전체 레퍼런스 →

활용 사례

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

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

가이드 읽기 →

일정에 따라 새로 고침

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

가이드 읽기 →

한도 내에서 사용하기

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

가이드 읽기 →

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

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

가이드 읽기 →

데이터 범위

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

출처

관련 API

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

자산, 부채, 자본과 파생 재무상태표 항목

API 탐색 →

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

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

API 탐색 →

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

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

API 탐색 →

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

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

API 탐색 →

자주 묻는 질문

은행과 보험사는 어떻게 표시되나요?

은행과 보험사는 매출과 매출총이익이 비어 있습니다. 대신 이자수익이나 보험료를 보고합니다.

EBIT는 어떻게 계산되나요?

EBIT는 영업이익이 있으면 영업이익을 사용하고, 없으면 세전이익에 이자비용을 더해 계산합니다. 파생 값이며 은행과 보험사에는 제공되지 않습니다.

세 가지 순이익 항목은 각각 무엇을 나타내나요?

net_income은 비지배지분을 제외한 모회사 지분입니다. net_income_including_nci는 비지배지분을 포함한 연결 합계입니다. net_income_parent는 모회사 소유주에게 귀속되는 순이익을 위한 별도 항목입니다.

양수 비용

손익계산서의 비용은 양수로 표시됩니다.

모회사 순이익

net_income은 모회사 지분이고, net_income_including_nci는 비지배지분을 포함합니다.

표시된 계산

계산된 EBIT와 EBITDA를 포함해 파생 항목은 구분하여 표시됩니다.