公司身份 API

將一個穩定的 Narwhal 公司 ID 解析為其 SEC 身份、上市資訊、行業代碼和曾用名。

端点與請求

使用 Narwhal API 密鑰即可獲得。

REST 端點

GET /v1/companies/{company_id}

請求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/cmp_a1b2c3d4e5f678901234567890abcdef" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 使用 companies_get 使用下面對應的參數。REST 和 MCP 返回相同的回應架構，並共享額度計數。

參數

名稱	必填	類型	含義
`company_id`	是	路徑·Narwhal 不透明 ID	公司搜尋返回的穩定公司身份。股票代碼和 CIK 仍是別名，不是永久路由身份。

回應

{
  "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
  "name": "Apple Inc.",
  "cik": "0000320193",
  "entity_type": "operating",
  "sic": {
    "code": "3571",
    "description": "Electronic Computers"
  },
  "listings": [
    {
      "ticker": "AAPL",
      "exchange": "Nasdaq"
    }
  ],
  "former_names": [
    {
      "name": "APPLE COMPUTER INC",
      "from": "1994-01-26T05:00:00Z",
      "to": "2007-01-04T05:00:00Z"
    }
  ],
  "as_of": "2026-08-29T12:00:00Z"
}

欄位	類型	必填	含義
`id`	字串	是	穩定且不透明的 Narwhal 公司 ID。
`name / cik`	字串	是	當前公司名稱和補零至十位的 SEC CIK。
`entity_type / sic`	字串、對象或 null	是	來源提供的實體分類和 SIC 詳情（如有）。
`listings`	陣列	是	當前股票代碼別名和可為空的交易所名稱。
`former_names`	陣列	是	來源發布的曾用名稱和可為空的有效期時間戳記。
`as_of`	UTC時間戳記	是	返回身份的快照時間。

錯誤與配額

400 invalid_query — 查詢、日期、表格、限制或游標無效。
401 invalid_api_key — Bearer 密鑰缺失或被拒絕。
404 company_not_found — 已接受發布版本中不存在該公司 ID。
429 rate_limit_exceeded 或 quota_exhausted — 共享短窗口或月度額度已耗盡。
503 companies_unavailable — Companies 已禁用、權限未啓用，或無法提供完整的已接受發布版本。

認證失敗和被拒絕的限流請求不會消耗月度額度。成功的 REST 和 MCP 呼叫使用同一帳戶限額。

首版發布範圍

來源中的可空欄位保持為 null。Narwhal 不會推斷缺失的交易所、實體類型或行業分類。

覆蓋範圍僅限於已接受的發行方群體。請讀取回應中的 as_of 時間和覆蓋範圍頁面，以瞭解可用快照。