기업 검색 API

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

엔드포인트 및 요청

Narwhal API 키로 사용할 수 있습니다.

REST 엔드포인트

GET /v1/companies

요청

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

MCP 사용 항목 companies_search 아래 대응 인수와 함께 사용합니다. REST와 MCP는 동일한 응답 스키마를 반환하고 할당량 계산을 공유합니다.

매개변수

이름	필수	유형	의미
`query`	예	쿼리 · 문자열, 1~200자	회사명, 티커 또는 10자리 CIK입니다. 회사명과 티커 매칭은 대소문자를 구분하지 않습니다.
`limit`	아니요	쿼리 · 정수, 1~100	반환할 최대 기업 수입니다. 기본값은 20입니다.
`cursor`	아니요	쿼리 · 불투명 문자열	이전 페이지의 연속 토큰입니다. 원래 쿼리와 필터에 연결되어 있습니다.

응답

{
  "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"
}

필드	유형	필수	의미
`query`	문자열	예	정규화된 검색 텍스트입니다.
`companies`	배열	예	CIK 및 현재 상장 별칭이 포함된 안정적인 기업 식별 정보입니다.
`next_cursor`	문자열 또는 null	예	불투명한 연속 토큰이며 페이지가 완료되면 null입니다.
`as_of`	UTC 타임스탬프	예	페이지의 모든 결과가 공유하는 스냅샷 시각입니다.

오류 및 할당량

400 invalid_query — 쿼리, 날짜, 서식, 제한 또는 커서가 잘못되었습니다.
401 invalid_api_key — Bearer 키가 누락되었거나 거부되었습니다.
429 rate_limit_exceeded 또는 quota_exhausted — 공유 단기 또는 월간 허용량이 소진되었습니다.
503 companies_unavailable — Companies가 비활성화되었거나 권리가 비활성 상태이거나 완전한 승인 발표를 제공할 수 없습니다.

인증 실패와 거부된 제한 요청은 월간 할당량을 사용하지 않습니다. 성공한 REST 및 MCP 호출은 동일한 계정 한도를 사용합니다.

최초 발표 범위

출시 대상은 승인된 SEC 티커-CIK 연결 스냅샷에서 도출됩니다. 반환된 티커는 별칭이며 활성 상장의 증거가 아닙니다.

데이터 범위는 승인된 발행자 집합으로 제한됩니다. 이용 가능한 스냅샷은 응답의 as_of 시각과 데이터 범위 페이지에서 확인하세요.