모든 API

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

회사의 공시 목록을 조회하거나, 공시 레코드를 가져오거나, 기업 전반의 최신 공시를 읽을 수 있으며, 규제 기관의 공식 사본으로 연결되는 링크가 제공됩니다.

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

첫 요청

기업의 연간 공시 목록

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings?type=annual" \
  --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/{company_id}/filings

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

매개변수

  • company_id필수

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

  • type선택

    annual 같은 공시 분류.

응답 필드

  • id필드

    공시 식별자

  • date필드

    공시가 제출된 날짜

  • type필드

    연차, 분기, 이벤트, 지분 같은 공시 분류

  • title필드

    공시 제목

  • url필드

    규제 기관 사이트의 공식 공시 링크

  • company_id필드

    공시와 연결된 회사의 식별자

  • form필드

    10-K나 13D 같은 규제 기관의 서식 명칭

  • period_end필드

    공시가 다루는 보고 기간의 종료일

  • filing_id (on stock earnings)필드

    과거 실적 보고서를 다루는 연간, 반기 또는 분기 보고서. 공시 경로에 전달하면 기록을 읽을 수 있습니다. 일치하는 공시가 없거나 날짜에 맞는 보고서가 없으면 생략됩니다.

전체 레퍼런스 →
GET기업 전반의 최신 공시 가져오기/v1/filings/latest

기업 전체의 최신 공시. 새 보고서가 나오는 대로 확인하는 데 사용합니다.

전체 레퍼런스 →
GET공시 레코드 가져오기/v1/filings/{filing_id}

양식, 날짜, 공식 사본 링크가 포함된 공시 기록 하나.

매개변수

  • filing_id필수

    usa:0000320193:0000320193-25-000079 같은 공시 ID.

전체 레퍼런스 →

활용 사례

일정에 따라 새로 고침

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

가이드 읽기 →

신규 공시 알림 받기

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

가이드 읽기 →

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

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

가이드 읽기 →

한도 내에서 사용하기

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

가이드 읽기 →

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

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

가이드 읽기 →

데이터 범위

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

출처

관련 API

Narwhal로 쓰는 SEC EDGAR API

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

API 탐색 →

EDINET API 지원 시작

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

API 탐색 →

DART API 지원 시작

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

API 탐색 →

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

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

API 탐색 →

기업 연간 공시를 위한 ESEF API

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

API 탐색 →

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

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

API 탐색 →

자주 묻는 질문

외국 민간 발행사는 어떤 서식이 해당하나요?

Form 20-F는 연차로, Form 6-K는 이벤트로 분류됩니다.

ID로 공시를 조회할 수 있나요?

특정 공시의 레코드를 가져오려면 GET /v1/filings/{filing_id}를 사용하세요.

원본 공시는 어디에서 읽을 수 있나요?

레코드의 url을 따라 규제 기관 사이트의 공식 사본으로 이동하세요. 그 문서가 기준이 되는 원본입니다.

실적 보고서에서 해당 공시로 어떻게 이동하나요?

주식 경로의 과거 실적 행에는 해당 실적을 다루는 보고서가 있을 때 공시 ID가 포함됩니다. 이를 공시 경로에 전달합니다. 실적의 EPS와 공시 재무제표의 EPS는 실적 수치가 시장 데이터 기준이므로 다를 수 있습니다.

회사 공시 목록

유형, 서식, 날짜별로 회사 공시를 읽습니다.

최신 공시

하나의 엔드포인트로 기업 전반의 최신 공시를 가져옵니다.

공식 링크

각 레코드에는 ID, 날짜, 유형, 제목, 공식 공시 링크가 포함됩니다.