Narwhal 文档
简体中文
API 参考网站
浏览全部文档

SEC 申报 API 参考

公司搜索、稳定身份和申报元数据。使用 Narwhal API 密钥即可获得

基础 URL 和身份

REST 基础路径
https://api.narwhalapi.com/v1/companies
  • 搜索支持公司名称、ticker或补零的十位 CIK。
  • 每个返回的公司都有一个稳定的不透明 company_id。股票代码和 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/companiescompanies_search
获取公司身份/v1/companies/{company_id}companies_get
列出公司申报文件/v1/companies/{company_id}/filingscompanies_list_filings

共享行为

  • 集合结果使用确定性排序和不透明游标，而不是偏移量或页码。
  • 游标绑定到规范化查询、公司 ID、limit 以及每个申报筛选条件。
  • 搜索和申报页面带有一个 UTC as_of 完整发布快照的时间。
  • 未知公司 ID 会返回 404 company_not_found。已知公司没有匹配的申报文件时，会返回空数组。
  • 无效的表格、日期、游标或分页输入会返回 400 invalid_query.
  • 成功的 REST 和 MCP 响应使用共享的 Narwhal 配额。

首版发布范围

第一个版本仅包含元数据和规范 SEC 链接。不包含申报正文、附件、XBRL 事实、全文搜索、CUSIP 数据、财务报表、标准化内部交易、机构持仓、提醒或交易信号。

覆盖范围仅限于已接受的发行方群体。响应包含发布的 as_of 时间。请读取 公司方法 适用于身份、修订和快照规则。