すべてのAPI

財務諸表APIで企業の開示書類と大量保有者を取得

企業の開示書類、標準化された財務諸表、5%以上の保有者を、REST と MCP の両方で使える1つの API キーで、Narwhal から取得できます。

無料のAPIキーを取得
ドキュメントを読む →
確認中97.84% uptime, last 30日295 ms 標準応答

最初のリクエスト

企業を探す

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?q=microsoft" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "results": [
    {
      "id": "usa:0000789019",
      "name": "Microsoft Corp",
      "country": "USA",
      "registry": "usa",
      "status": "active",
      "exchange": "XNAS",
      "code": "MSFT",
      "matched": "name"
    }
  ]
}

エンドポイント

GET企業を一覧する/v1/companies

企業名で検索してIDを取得します。そのIDを、ほかのすべての呼び出しで使います。

パラメータ

  • q任意

    企業名などの検索テキスト。

レスポンスフィールド

  • listings (on a company)フィールド

    企業に紐づく株式のリスティングID(XNAS:MSFT など)。株式ルートで使います。リスティングは、現在有効な取引所とティッカーの完全一致でのみ紐づけられ、名前では紐づけません。一覧が空の場合は、該当なしを意味します。

リファレンス全文 →
GET企業の開示書類を一覧表示する/v1/companies/{company_id}/filings

企業の開示書類を新しい順に並べたもので、各書類の公式コピーへのリンク付きです。

パラメータ

  • company_id必須

    usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。

  • type任意

    annual などの開示書類のカテゴリ。

リファレンス全文 →
GET標準化された企業の財務諸表を取得/v1/companies/{company_id}/financials

企業の標準化された財務諸表。期間ごとに1行で、提出時の通貨で表示されます。

パラメータ

  • company_id必須

    usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。

  • period任意

    レジストリに応じて annual または semiannual。

  • statement任意

    income、balance、cash_flow、per_share のいずれか。

  • fields任意

    revenue,net_income のように、項目名をカンマで区切ります。

リファレンス全文 →
GET5%以上の保有者を取得する/v1/companies/{company_id}/holders

5%以上の保有者。報告された保有割合、株数、それを報告した開示書類付き。

パラメータ

  • company_id必須

    usa:0000789019 のような企業ID、または usa:MSFT のようなティッカーのエイリアス。

リファレンス全文 →

ユースケース

スケジュールで更新する

小さなスクリプトで、新しい開示書類と数値を毎日取得します。

ガイドを読む →

新しい開示書類の通知を受け取る

開示書類の公開時にウェブフックを受け取り、検証します。

ガイドを読む →

企業データを数年分読み込む

長い履歴をページ送りで取得し、ジョブが止まっても再開します。

ガイドを読む →

利用上限を超えないようにする

レスポンスをキャッシュし、リクエストを失うことなく429エラーに対処します。

ガイドを読む →

企業についてエージェントに質問する

MCPを通じて、LLMエージェントに開示書類と財務情報の読み取りアクセスを与えます。

ガイドを読む →

カバレッジ

  • 米国開示書類と財務諸表。2009年からの履歴。
  • 日本3,800社超。年次と半期。
  • 韓国これまでのところ、上場企業の約半数。
  • 台湾約1,980社。2026年の半期報告書。
  • EUおよびEEA26か国の約3,200社。年次のみ。
  • 英国規制市場の約800社。年次のみ。

ソース

関連 API

企業分析に使う財務諸表API

標準化された財務諸表、報告期間、過去のバージョン

APIを見る →

企業開示書類APIで開示書類を取得

開示書類の一覧、個別のレコード、企業をまたいだ最新の開示書類

APIを見る →

企業の大株主を調べる大量保有報告書API

開示書類による5%以上の保有者

APIを見る →

よくある質問

会社 ID の代わりにティッカーを使えますか。

はい。usa:0000789019 のような識別子、または usa:MSFT のような受け付けられるティッカーのエイリアスを使えます。

開示書類が公表されたときに通知を受け取れますか。

すべてのアカウントで、開示書類が公表されたときに通知する Webhook を設定できます。

財務金額は換算や単位の調整が行われますか。

金額は、換算も百万単位への調整も行わず、開示書類の通貨のままの10進数の文字列です。欠けている項目は省略され、報告された0は0のまま返されます。

企業から、その株式のリスティングにはどうたどりますか。

企業は上場株式のリスティングIDの一覧を持っています。そのうち1つを株式ルートで使うと、価格、履歴、配当、分割、バリュエーションを取得できます。株式のリスティングには企業IDも含まれるため、どちらからでもたどれます。

開示書類のレコード

開示書類の日付、種類、タイトルを、公式の写しへのリンクとあわせて読み取れます。

標準化された財務データ

損益計算書、貸借対照表、キャッシュフロー、1株あたり、株式数にわたる77の標準項目を利用できます。

大量保有者

米国、日本、韓国の5%以上の保有者を取得できます。