公式 SEC メタデータ
ソースは米国証券取引委員会です。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ファクトは含まれますか？
いいえ。この契約の対象は企業の識別情報と提出メタデータだけです。