官方SEC meta数据
来源是美国证券交易委员会。Narwhal 使用公司关联、提交元数据和 EDGAR 申报索引。
阅读方法说明 →所有 API
SEC 申报文件 API
查找 SEC 申报元数据及原始文件链接。
首次请求
快速入门 →请将 YOUR_COMPANY_ID 替换为公司搜索返回的 ID。 公司搜索 API →
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/YOUR_COMPANY_ID/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
--header "Authorization: Bearer $NARWHAL_API_KEY"响应示例 示例响应 · 并非实时请求
{
"company": {
"id": "cmp_a1b2c3d4e5f678901234567890abcdef",
"name": "Apple Inc.",
"cik": "0000320193"
},
"filings": [
{
"accession_number": "0000320193-24-000123",
"form": "10-K",
"filed_on": "2024-11-01",
"accepted_at": "2024-11-01T10:01:36Z",
"report_period": "2024-09-28",
"is_amendment": false,
"items": [],
"filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
"primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
}
],
"next_cursor": null,
"as_of": "2026-08-29T12:00:00Z"
}端点
GET列出公司申报文件/v1/companies/{company_id}/filings
company_id- 公司搜索返回的稳定公司身份。股票代码和 CIK 仍是别名，不是永久路由身份。
forms- 表格标记区分大小写。基础表格也会匹配其 /A 修订版本，除非排除了修订文件。
filed_from- 包含的提交日期下限。
filed_to- 不包含的提交日期上限，必须晚于 filed_from。
include_amendments- 请求基础表格时包含修订件。默认为 true。
limit- 返回申报文件的最大数量。默认为 50。
cursor- 来自上一页的续接令牌。它绑定到原始查询和筛选条件。
MCP · companies_list_filings
来源与方法论
稳定 身份
公司名称或股票代码变化时，公司 ID 仍保持稳定。
申报文件元数据
表格、日期、修订和 SEC 链接均明确保留。
覆盖范围
查看覆盖范围 →常见问题
响应包含哪些内容？
按公司列出 SEC 备案元数据，包括 10-K、10-Q、8-K、Form 4 和 13F-HR。
支持哪些数据范围？
第一个版本仅返回元数据和规范 SEC 文档链接。不包含申报正文、附件、XBRL 事实、内部交易、财务报表或 13F 持仓。
是否包含申报文件正文或 XBRL 数据？
不是。本合约仅涵盖公司身份和备案元数据。