로그인 API 키 받기

모든 API

Narwhal로 쓰는 SEC EDGAR API

Narwhal을 통해 미국 공시 레코드와 표준화된 XBRL 재무 정보를 JSON으로 받으세요. EDGAR 원본 데이터를 직접 다룰 필요가 없습니다.

무료 API 키 받기

문서 읽기 →

정상 운영 중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"

응답 예시

{
  "id": "usa:0000789019",
  "filings": [
    {
      "id": "usa:0000789019:0001193125-26-323660",
      "date": "2026-07-29",
      "type": "annual",
      "title": "10-K"
    }
  ]
}

엔드포인트

GET회사 목록 조회/v1/companies

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

매개변수

q선택
기업 이름 같은 검색어.

전체 레퍼런스 →

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년부터의 이력.

출처

미국SEC EDGAR

관련 API

EDINET API 지원 시작

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

DART API 지원 시작

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

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

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

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

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

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

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

기업 연간 공시를 위한 ESEF API

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

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

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

자주 묻는 질문

Narwhal은 SEC EDGAR에서 무엇을 반환하나요?

Narwhal은 회사 공시 레코드, 표준화된 재무제표, Schedule 13D와 13G에 보고된 5% 이상 보유자를 반환합니다.

SEC 회사 식별자는 어떻게 구성되나요?

미국 회사 ID는 usa:와 SEC Central Index Key를 결합한 형태입니다(예: usa:0000789019). usa:MSFT 같은 티커 별칭도 사용할 수 있습니다.

표준화가 공식 공시를 대체하나요?

SEC 공시가 기준이 되는 원본입니다. Narwhal은 애플리케이션에서 쓸 수 있도록 JSON 레코드와 표준화된 수치를 제공합니다.

공시 메타데이터

Narwhal은 공시 ID, 날짜, 유형, 제목, 공식 링크를 반환합니다.

표준 재무제표 항목

XBRL 재무 정보는 모든 계정에서 이용할 수 있는 77개 항목으로 표준화됩니다.

하나의 API 키

REST와 MCP로 Narwhal의 Filings API를 이용하세요.