모든 API

기업 공시 API: 재무제표와 대주주 정보

하나의 API 키로 REST와 MCP를 통해 Narwhal에서 회사 공시, 표준화된 재무제표, 5% 이상 보유자를 가져오세요.

무료 API 키 받기
문서 읽기 →
확인 중97.84% uptime, last 30일295 ms 일반 응답 시간

첫 요청

기업 찾기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?q=microsoft" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "results": [
    {
      "id": "usa:0000789019",
      "name": "Microsoft Corp",
      "country": "USA",
      "registry": "usa",
      "status": "active",
      "exchange": "XNAS",
      "code": "MSFT",
      "matched": "name"
    }
  ]
}

엔드포인트

GET회사 목록 조회/v1/companies

이름으로 기업을 검색하고 ID를 확인합니다. 다른 모든 호출에서 이 ID를 사용합니다.

매개변수

  • q선택

    기업 이름 같은 검색어.

응답 필드

  • listings (on a company)필드

    기업에 연결된 주식 상장 ID로, XNAS:MSFT 같은 형식이며 주식 경로에서 사용합니다. 상장은 현재 활성 상태인 거래소와 티커가 정확히 일치할 때만 연결되며, 이름으로는 연결하지 않습니다. 목록이 비어 있으면 연결된 상장이 없다는 뜻입니다.

전체 레퍼런스 →
GET기업의 공시 목록/v1/companies/{company_id}/filings

기업의 공시를 최신순으로 제공하며, 각 공시의 공식 사본 링크가 포함됩니다.

매개변수

  • company_id필수

    usa:0000789019 같은 기업 ID 또는 usa:MSFT 같은 티커 별칭.

  • type선택

    annual 같은 공시 분류.

전체 레퍼런스 →
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처럼 쉼표로 구분한 항목 이름.

전체 레퍼런스 →
GET5% 이상 보유자 가져오기/v1/companies/{company_id}/holders

5% 이상 보유자와 보고된 비율, 주식 수, 이를 보고한 공시.

매개변수

  • company_id필수

    usa:0000789019 같은 기업 ID 또는 usa:MSFT 같은 티커 별칭.

전체 레퍼런스 →

활용 사례

일정에 따라 새로 고침

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

가이드 읽기 →

신규 공시 알림 받기

공시가 게시되면 웹훅을 받고 검증합니다.

가이드 읽기 →

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

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

가이드 읽기 →

한도 내에서 사용하기

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

가이드 읽기 →

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

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

가이드 읽기 →

데이터 범위

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

출처

관련 API

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

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

API 탐색 →

공시 목록과 개별 기록을 위한 기업 공시 API

기업 전반의 공시 목록, 개별 레코드, 최신 공시

API 탐색 →

기업 대주주 API

지분 공시의 5% 이상 보유자

API 탐색 →

자주 묻는 질문

회사 ID 대신 티커를 사용할 수 있나요?

네. usa:0000789019 같은 식별자나 usa:MSFT 같은 허용된 티커 별칭을 사용하세요.

공시가 게시되면 알림을 받을 수 있나요?

모든 계정에서 공시가 게시될 때 알려 주는 웹훅을 설정할 수 있습니다.

재무 금액은 환산되거나 단위 조정되나요?

금액은 공시에 기재된 통화 그대로의 십진수 문자열이며, 환산이나 백만 단위 조정이 없습니다. 없는 항목은 생략되고, 보고된 0은 0으로 유지됩니다.

기업에서 주식 상장 정보로 어떻게 이동하나요?

기업에는 주식 상장 ID 목록이 있습니다. 주가, 이력, 배당, 주식 분할, 밸류에이션을 제공하는 주식 경로에서 ID 하나를 사용합니다. 주식 상장 정보에도 기업 ID가 포함되어 있어 양방향으로 이동할 수 있습니다.

공시 레코드

공시 날짜, 유형, 제목을 읽고 공식 사본으로 연결되는 링크를 이용하세요.

표준화된 재무 정보

손익계산서, 재무상태표, 현금흐름, 주당, 주식 수 전반에 걸친 표준 항목 77개를 사용하세요.

대량 보유자

미국, 일본, 한국의 5% 이상 보유자를 가져옵니다.