모든 API

EDINET API 지원 시작

EDINET의 일본 공시와 표준화된 재무제표를 3,800개 이상의 회사에 대해 제공 중이며, 엔화 금액은 공시된 그대로이고 기간은 연간과 반기입니다.

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

가이드 읽기 →

데이터 범위

  • 일본3,800개 이상의 기업, 연간 및 반기.

출처

  • 일본EDINET, 금융청

관련 API

Narwhal로 쓰는 SEC EDGAR API

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

API 탐색 →

DART API 지원 시작

한국 공시와 재무제표, 실시간 제공

API 탐색 →

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

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

API 탐색 →

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

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

API 탐색 →

기업 연간 공시를 위한 ESEF API

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

API 탐색 →

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

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

API 탐색 →

자주 묻는 질문

지금 Narwhal에서 일본 공시를 이용할 수 있나요?

일본 공시와 재무제표를 3,800개 이상의 회사에 대해 제공 중입니다.

일본에도 분기 재무제표가 있나요?

일본 재무제표는 연간과 반기만 제공됩니다.

일본 대량보유 보고서도 포함되나요?

네. EDINET 대량보유 보고서가 포함됩니다.

EDINET 소스

일본 금융청의 EDINET을 사용합니다.

연간 및 반기

일본 재무제표 기간은 연간과 반기만 있습니다.

공시된 엔화

재무 금액은 환산이나 백만 단위 조정 없이 엔화 값을 유지합니다.