모든 API

DART API 지원 시작

DART의 한국 회사 공시와 재무제표를 제공 중이며, 금액은 공시된 원화 그대로 유지됩니다.

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

첫 요청

기업의 공시 목록

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

엔드포인트

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 에이전트에 공시와 재무제표 읽기 권한을 제공합니다.

가이드 읽기 →

데이터 범위

  • 한국지금까지 상장 기업의 약 절반.

출처

관련 API

Narwhal로 쓰는 SEC EDGAR API

SEC EDGAR의 미국 실시간 공시와 표준화된 XBRL 재무 정보

API 탐색 →

EDINET API 지원 시작

일본 공시와 재무제표, 실시간 제공

API 탐색 →

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

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

API 탐색 →

대만 공시와 재무제표용 MOPS API

data.gov.tw의 TWSE OpenAPI 및 TPEx 오픈 데이터에서 가져온 대만 회사 재무 정보

API 탐색 →

기업 연간 공시를 위한 ESEF API

EU 및 EEA 26개국 회사의 연차 보고서

API 탐색 →

규제 시장 기업을 위한 영국 공시 API

영국 규제 시장 발행사의 연차 보고서

API 탐색 →

자주 묻는 질문

한국 공시 데이터를 이용할 수 있나요?

네. 상장 회사의 약 절반이 적재되어 있으며 계속 추가되고 있습니다.

한국은 어떤 보고 기간을 사용하나요?

한국 재무제표는 연간과 분기만 제공됩니다.

한국 대량보유 보고서도 포함되나요?

네. DART 5% 보고서가 포함됩니다.

DART 소스

DART는 한국 금융감독원의 공시 시스템입니다.

원화 금액

재무 금액은 공시에 보고된 원화 그대로 유지됩니다.

일부 적재

상장 회사의 약 절반이 적재되어 있습니다.