로그인 API 키 받기

모든 API

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

영업, 투자, 재무 현금흐름을 부호가 있는 십진수 문자열로 읽습니다. 인수, 이자 지급, 세금 납부의 음수 유출도 포함됩니다.

무료 API 키 받기

문서 읽기 →

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

첫 요청

현금흐름표 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=cash_flow" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

응답 예시

{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "operating_cash_flow": "182935000000",
      "capex": "-115948000000"
    }
  ]
}

엔드포인트

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

응답 필드

operating_cash_flow필드
영업활동으로 발생하거나 사용된 순현금입니다.
investing_cash_flow필드
투자활동으로 발생하거나 사용된 순현금입니다.
financing_cash_flow필드
재무활동으로 발생하거나 사용된 순현금입니다.
capex필드
유형자산을 취득하는 데 쓴 현금으로, 음수의 유출로 기록됩니다.
acquisitions필드
인수 대가로 지급한 현금에서 취득한 현금을 뺀 금액으로, 음수의 유출로 기록됩니다.
free_cash_flow필드
항상 영업활동 현금흐름에 자본적 지출을 더해 계산되며, 자본적 지출은 음수 현금 유출로 기록됩니다.
depreciation_amortization필드
이익을 영업활동 현금흐름으로 조정할 때 다시 더하는 감가상각비와 무형자산상각비입니다.
stock_based_compensation필드
이익을 영업활동 현금흐름으로 조정할 때 다시 더하는 주식기준보상비용입니다.
dividends_paid필드
지급한 현금배당금으로, 음수의 유출로 기록됩니다.
share_repurchases필드
자기주식을 매입하는 데 지급한 현금으로, 음수의 유출로 기록됩니다.
fx_effect_on_cash필드
환율 변동으로 인한 현금의 증감입니다.
interest_paid필드
이자로 지급한 현금으로, 음수의 유출로 기록됩니다.
taxes_paid필드
환급액을 뺀 법인세 등 세금으로 지급한 현금으로, 음수의 유출로 기록됩니다.
net_change_in_cash필드
환율 변동 효과를 포함한 현금의 순증감입니다.

전체 레퍼런스 →

활용 사례

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

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

가이드 읽기 →

일정에 따라 새로 고침

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

가이드 읽기 →

한도 내에서 사용하기

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

가이드 읽기 →

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

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

가이드 읽기 →

데이터 범위

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

출처

미국SEC EDGAR
일본EDINET, 금융청
한국DART, 금융감독원
대만TWSE 및 TPEx 상장 기업
EU 및 EEAESEF 연차 보고서
영국영국 규제 시장 발행사

관련 API

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

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

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

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

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

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

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

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

자주 묻는 질문

이자 지급액은 음수인가요?

네. interest_paid는 현금 유출을 나타내며 음수 부호가 붙습니다.

인수 항목은 인수한 현금을 어떻게 처리하나요?

인수 항목은 인수 대금에서 인수한 현금을 차감하고, 그 지급액을 음수 유출로 기록합니다.

현금흐름 금액은 백만 단위로 표시되나요?

백만 단위 조정은 적용되지 않습니다. 응답은 원래 공시 통화의 십진수 문자열을 사용합니다.

음수 유출

회사에서 나가는 현금은 음수로 기록됩니다.

인수 대금

인수는 인수한 현금을 뺀 순지급액으로 표시됩니다.

납부 세금

세금 납부액은 환급액을 차감한 순액이며 음수 유출로 기록됩니다.