모든 API

SEC 신고서 API

회사명, 티커 또는 CIK로 기업을 검색하고 SEC 신고서 메타데이터 찾기

첫 요청

회사명, 티커 또는 10자리 CIK로 지원되는 SEC 발행자를 찾습니다.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

응답 예시 예시 응답 · 라이브 요청 아님

{
  "query": "AAPL",
  "companies": [
    {
      "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
      "name": "Apple Inc.",
      "cik": "0000320193",
      "listings": [
        {
          "ticker": "AAPL",
          "exchange": "Nasdaq"
        }
      ]
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

엔드포인트

GET기업 검색/v1/companies

회사명, 티커 또는 10자리 CIK로 지원되는 SEC 발행자를 찾습니다.

query: 회사명, 티커 또는 10자리 CIK입니다. 회사명과 티커 매칭은 대소문자를 구분하지 않습니다.
limit: 반환할 최대 기업 수입니다. 기본값은 20입니다.
cursor: 이전 페이지의 연속 토큰입니다. 원래 쿼리와 필터에 연결되어 있습니다.

MCP · companies_search

기업 검색 API →API 레퍼런스 →

GET기업 식별 정보 받기/v1/companies/{company_id}

안정적인 Narwhal 기업 ID 하나를 SEC 식별 정보, 상장 정보, 업종 코드 및 이전 이름으로 확인합니다.

company_id: 기업 검색이 반환하는 안정적인 기업 식별 정보입니다. 티커와 CIK는 별칭으로 유지되며 영구적인 경로 식별자가 아닙니다.

MCP · companies_get

기업 식별 API →API 레퍼런스 →

GET기업 신고서 나열/v1/companies/{company_id}/filings

10-K, 10-Q, 8-K, Form 4 및 13F-HR을 포함한 SEC 신고서 메타데이터를 기업별로 나열합니다.

company_id: 기업 검색이 반환하는 안정적인 기업 식별 정보입니다. 티커와 CIK는 별칭으로 유지되며 영구적인 경로 식별자가 아닙니다.
forms: 대소문자를 구분하는 정확한 서식 토큰입니다. 수정 신고서가 제외되지 않는 한 기본 서식은 /A 수정 신고서에도 일치합니다.
filed_from: 신고일의 포함 하한입니다.
filed_to: 신고일의 배타적 상한입니다. filed_from보다 늦어야 합니다.
include_amendments: 기본 서식을 요청하면 수정 신고서를 포함합니다. 기본값은 true입니다.
limit: 반환할 최대 신고서 수입니다. 기본값은 50입니다.
cursor: 이전 페이지의 연속 토큰입니다. 원래 쿼리와 필터에 연결되어 있습니다.