公司身份 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 时间和覆盖范围页面，以了解可用快照。