企業検索API

企業名、ティッカー、または10桁の CIK で、対応する SEC 発行体を検索します。

エンドポイントとリクエスト

Narwhal APIキーで利用できます。

REST エンドポイント

GET /v1/companies

リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCPの使用 companies_search 以下の対応する引数を使用します。REST と MCP は同じレスポンススキーマを返し、クォータ計算を共有します。

パラメータ

名前	必須	種別	意味
`query`	はい	クエリ · 文字列、1～200文字	企業名、ティッカー、または10桁のCIK。名前とティッカーの照合では大文字小文字を区別しません。
`limit`	いいえ	クエリ · 整数、1～100	返す企業の最大数。デフォルトは20です。
`cursor`	いいえ	クエリ · 不透明な文字列	前ページの継続トークン。元のクエリとフィルターに束縛されています。

レスポンス

{
  "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"
}

フィールド	種別	必須	意味
`query`	文字列	はい	正規化された検索テキスト。
`companies`	配列	はい	CIK と現在の上場別名を備えた安定した企業識別情報。
`next_cursor`	文字列または null	はい	不透明な継続トークン、またはページが完了した場合は null。
`as_of`	UTC タイムスタンプ	はい	ページ内のすべての結果で共有されるスナップショット時刻。

エラーとクォータ

400 invalid_query — クエリ、日付、フォーム、上限、カーソルが無効です。
401 invalid_api_key — Bearer キーがないか拒否されました。
429 rate_limit_exceeded または quota_exhausted — 共有の短時間枠または月間枠を使い切りました。
503 companies_unavailable — Companies が無効、権利が非アクティブ、または完全な受け入れ済み公開データを提供できません。

認証失敗と拒否されたスロットリング対象リクエストは月間クォータを消費しません。成功したRESTおよびMCP呼び出しは同じアカウント許容量を使用します。

初回リリースの対象範囲

ローンチ対象は、受け入れ済みの SEC ティッカーと CIK の関連付けスナップショットから導出されます。返されるティッカーは別名であり、有効な上場の証明ではありません。

カバレッジは受け入れ済み発行体コホートに限定されます。利用可能なスナップショットについて、レスポンスのas_of時刻とカバレッジページを確認してください。