모든 API

SEC 신고서 API

SEC 공시 메타데이터와 원문 링크를 찾으세요.

첫 요청

YOUR_COMPANY_ID를 기업 검색에서 반환된 ID로 바꾸세요. 기업 검색 API →

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/YOUR_COMPANY_ID/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

{
  "company": {
    "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
    "name": "Apple Inc.",
    "cik": "0000320193"
  },
  "filings": [
    {
      "accession_number": "0000320193-24-000123",
      "form": "10-K",
      "filed_on": "2024-11-01",
      "accepted_at": "2024-11-01T10:01:36Z",
      "report_period": "2024-09-28",
      "is_amendment": false,
      "items": [],
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
      "primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

엔드포인트

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

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