公式 SEC メタデータ
Narwhalは企業別名、提出タイムスタンプ、修正状態、正規SECリンクを保持します。提出書類メタデータを分析に変えることはありません。
方法論を読む →すべてのAPI
SEC 提出 API
企業を検索し、名前、ティッカー、CIK で SEC 提出メタデータを検索
初回リクエスト
クイックスタート →企業名、ティッカー、または10桁の 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
企業名、ティッカー、または10桁の CIK で、対応する SEC 発行体を検索します。
query- 企業名、ティッカー、または10桁の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で検索できますか？
はい。検索では企業名、ティッカー、10桁の CIK を指定できます。
提出結果には何が含まれますか？
フォーム、提出日、受付時刻、修正状態、報告期間、正規 SEC リンク。
どの SEC フォームで絞り込めますか？
対象となる提出履歴内の正確なフォーム。10-K、10-Q、8-K、20-F、Form 4、13F-HR、修正を含みます。
提出書類の本文やXBRLファクトは含まれますか？
いいえ。この契約の対象は企業の識別情報と提出メタデータだけです。