모든 API

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

회사의 주력 보통주 종류에 대한 주당 순이익, 주당 배당금, 발행주식수를 가져옵니다.

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

첫 요청

주당 수치 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=per_share" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "eps_basic": "18.00",
      "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처럼 쉼표로 구분한 항목 이름.

응답 필드

  • eps_basic필드

    기본 가중평균 주식수로 계산한, 주된 보통주 종류의 주당 손익입니다.

  • eps_diluted필드

    희석 효과가 있는 잠재적 보통주를 고려한 후, 주된 보통주 종류의 주당 손익입니다.

  • dividend_per_share필드

    주된 보통주 종류의 주당 선언 배당금입니다.

  • shares_outstanding필드

    자기주식을 제외한 주된 보통주 종류의 발행 주식수입니다.

  • weighted_shares_basic필드

    기본 주당순이익을 계산하는 데 쓰이는, 해당 기간의 보통주 가중평균 발행 주식수입니다.

  • weighted_shares_diluted필드

    희석 주당순이익을 계산하는 데 쓰이는, 희석 효과가 있는 잠재적 보통주를 포함한 보통주 가중평균 주식수입니다.


전체 레퍼런스 →

활용 사례

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

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

가이드 읽기 →

일정에 따라 새로 고침

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

가이드 읽기 →

한도 내에서 사용하기

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

가이드 읽기 →

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

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

가이드 읽기 →

데이터 범위

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

출처

관련 API

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

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

API 탐색 →

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

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

API 탐색 →

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

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

API 탐색 →

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

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

API 탐색 →

자주 묻는 질문

이 수치는 모든 주식 종류를 포함하나요?

EPS, 주당 배당금, 발행주식수는 주력 보통주 종류를 기준으로 합니다.

배당 수치가 없으면 0을 뜻하나요?

배당 항목이 없으면 0으로 채우지 않고 생략됩니다. 보고된 0은 0으로 반환됩니다.

주당 항목도 무료인가요?

1,000건당 $10인 Companies 가격으로, 주당 및 주식 수 항목을 포함한 표준 항목 77개를 모든 계정에서 이용할 수 있습니다.

주당 순이익

EPS 수치는 주력 보통주 종류를 기준으로 합니다.

주당 배당금

배당 금액도 회사의 주력 보통주 종류를 기준으로 합니다.

발행주식수

주식 수도 같은 주력 보통주 종류 기준을 따릅니다.