官方SEC meta数据
Narwhal 保留公司别名、备案时间戳、修订状态和规范 SEC 链接。它不会将备案元数据转化为分析。
阅读方法说明 →所有 API
SEC 申报 API
按名称、ticker或 CIK 搜索公司并查找 SEC 申报元数据
首次请求
快速入门 →按公司名称、股票代码或十位 CIK 查找覆盖范围内的 SEC 发行人。
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
--header "Authorization: Bearer $NARWHAL_API_KEY"响应示例 示例响应 · 并非实时请求
{
"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"
}端点
GET搜索公司/v1/companies
按公司名称、股票代码或十位 CIK 查找覆盖范围内的 SEC 发行人。
query- 公司名称、股票代码或十位 CIK。名称和股票代码匹配不区分大小写。
limit- 返回公司的最大数量。默认为 20。
cursor- 来自上一页的续接令牌。它绑定到原始查询和筛选条件。
MCP · companies_search
GET获取公司身份/v1/companies/{company_id}
将一个稳定的 Narwhal 公司 ID 解析为其 SEC 身份、上市信息、行业代码和曾用名。
company_id- 公司搜索返回的稳定公司身份。股票代码和 CIK 仍是别名，不是永久路由身份。
MCP · companies_get
GET列出公司申报文件/v1/companies/{company_id}/filings
按公司列出 SEC 备案元数据，包括 10-K、10-Q、8-K、Form 4 和 13F-HR。
company_id- 公司搜索返回的稳定公司身份。股票代码和 CIK 仍是别名，不是永久路由身份。
forms- 表格标记区分大小写。基础表格也会匹配其 /A 修订版本，除非排除了修订文件。
filed_from- 包含的提交日期下限。
filed_to- 不包含的提交日期上限，必须晚于 filed_from。
include_amendments- 请求基础表格时包含修订件。默认为 true。
limit- 返回申报文件的最大数量。默认为 50。
cursor- 来自上一页的续接令牌。它绑定到原始查询和筛选条件。
MCP · companies_list_filings
来源与方法论
稳定 身份
公司名称或股票代码变化时，公司 ID 仍保持稳定。
申报文件元数据
表格、日期、修订和 SEC 链接均明确保留。
覆盖范围
查看覆盖范围 →常见问题
我可以按股票代码或 CIK 搜索吗？
是。搜索接受公司名称、股票代码或十位 CIK。
申报结果包含什么？
表格、提交日期、接受时间、修订状态、报告期和规范 SEC 链接。
可以筛选哪些 SEC 表格？
已覆盖申报历史中的任意精确表格，包括 10-K、10-Q、8-K、20-F、Form 4、13F-HR 及其修订文件。
是否包含申报文件正文或 XBRL 数据？
不是。本合约仅涵盖公司身份和备案元数据。