SEC 신고서 API 레퍼런스
기업 검색, 안정적인 식별 정보 및 신고서 메타데이터입니다. Narwhal API 키로 이용할 수 있습니다
기본 URL 및 식별자
REST 기본 경로
https://api.narwhalapi.com/v1/companies- 검색은 회사명, 티커 또는 앞을 0으로 채운 10자리 CIK를 허용합니다.
- 반환되는 각 기업에는 하나의 안정적인 불투명 식별자가 있습니다
company_idTicker와 CIK는 계속 별칭으로 사용됩니다. - REST와 MCP는 동일한 입력 및 출력 스키마를 사용합니다.
요청
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
--header "Authorization: Bearer $NARWHAL_API_KEY"세 가지 최초 발표 작업
각 작업에는 동일한 입력 및 출력 스키마를 사용하는 REST 경로 하나와 MCP 도구 하나가 있습니다.
| 작업 | REST 경로 | MCP 도구 |
|---|---|---|
| 기업 검색 | /v1/companies | companies_search |
| 기업 식별 정보 받기 | /v1/companies/{company_id} | companies_get |
| 기업 신고서 나열 | /v1/companies/{company_id}/filings | companies_list_filings |
공유 동작
- 수집 결과는 오프셋이나 페이지 번호 대신 결정론적 정렬과 불투명 커서를 사용합니다.
- 커서는 정규화된 쿼리, 회사 ID, limit 및 모든 신고서 필터에 연결됩니다.
- 검색 및 신고서 페이지에는 하나의 UTC가 포함됩니다
as_of완전한 발표 스냅샷의 시각입니다. - 알 수 없는 기업 ID는 다음을 반환합니다:
404 company_not_found알려진 기업에 일치하는 제출 자료가 없으면 빈 배열을 반환합니다. - 잘못된 서식, 날짜, 커서 또는 페이지 매김 입력은 다음을 반환합니다
400 invalid_query. - 성공한 REST 및 MCP 응답은 공유 Narwhal 할당량을 사용합니다.
최초 발표 범위
첫 번째 릴리스는 메타데이터와 표준 SEC 링크만 제공합니다. 신고서 본문, 첨부 자료, XBRL 팩트, 전문 검색, CUSIP 데이터, 재무제표, 정규화된 내부자 거래, 기관 보유 내역, 알림 또는 거래 신호는 포함하지 않습니다.
데이터 범위는 승인된 발행자 집합으로 제한됩니다. 응답에는 발표 as_of 시각이 포함됩니다. 다음을 확인하세요 기업 방법론 식별 정보, 수정 및 스냅샷 규칙에 대해.