公司搜尋 API

按公司名稱、股票代碼或十位 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 個字元	公司名稱、股票代碼或十位 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 時間和覆蓋範圍頁面，以瞭解可用快照。