SEC 提出 API リファレンス
企業検索、安定した識別情報、提出書類メタデータ。Narwhal APIキーで利用できます
ベースURLと識別情報
REST ベースパス
https://api.narwhalapi.com/v1/companies- 検索では企業名、ティッカー、またはゼロ埋めした10桁の CIK を指定できます。
- 返されるすべての企業には、1つの安定した不透明な識別子があります：
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"最初のリリースの3操作
各オペレーションには、同じ入力・出力スキーマを持つRESTパス1つとMCPツール1つがあります。
| 操作 | REST パス | MCPツール |
|---|---|---|
| 企業を検索 | /v1/companies | companies_search |
| 企業の識別情報を取得 | /v1/companies/{company_id} | companies_get |
| 企業の提出書類を一覧表示 | /v1/companies/{company_id}/filings | companies_list_filings |
共有動作
- コレクション結果は、オフセットやページ番号ではなく、決定的な順序と不透明カーソルを使用します。
- カーソルは正規化されたクエリ、企業ID、limit、すべての提出書類フィルターに束縛されます。
- 検索ページと提出ページには1つの UTC を付けます：
as_of完全な公開スナップショットの時刻。 - 未知の企業IDは
404 company_not_found。一致する提出書類がない既知の企業の場合、空の配列が返されます。 - 無効なフォーム、日付、カーソル、ページネーション入力は次を返します：
400 invalid_query. - 成功した REST と MCP のレスポンスは、Narwhal の共有クォータを使用します。
初回リリースの対象範囲
最初のリリースに含まれるのはメタデータと正規 SEC リンクだけです。提出書類本文、添付資料、XBRL ファクト、全文検索、CUSIP データ、財務諸表、正規化されたインサイダー取引、機関投資家の保有、アラート、取引シグナルは含まれません。
カバレッジは受け入れ済み発行体コホートに限定されます。レスポンスには公開時点のas_of時刻が含まれます。次を確認してください： 企業の方法論 識別情報、修正版、スナップショットの規則向け。