すべてのAPI

企業の年次報告を扱うESEF API

約3,200社の年次財務諸表を取得できます。

稼働中97.81% uptime, last 30日295 ms 標準応答

最初のリクエスト

年次財務情報を取得する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/nld:724500Y6DUVHQD6OXN27/financials?period=annual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "id": "nld:724500Y6DUVHQD6OXN27",
  "currency": "EUR",
  "annual": [
    {
      "fy": 2025,
      "end": "2025-12-31",
      "derived": [],
      "revenue": "32667300000",
      "net_income": "10213000000",
      "total_assets": "55576800000"
    }
  ],
  "as_of": "2026-02-25"
}

エンドポイント

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

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

パラメータ

  • q任意

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


リファレンス全文 →
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 のように、項目名をカンマで区切ります。


リファレンス全文 →

ユースケース

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

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

ガイドを読む →

スケジュールで更新する

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

ガイドを読む →

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

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

ガイドを読む →

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

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

ガイドを読む →

カバレッジ

  • EUおよびEEA26か国の約3,200社。年次のみ。

ソース

関連 API

Companies House APIで英国企業の財務報告

英国の規制市場の発行体による年次報告書

APIを見る →

台湾の開示書類を扱うMOPS API

data.gov.tw の TWSE OpenAPI と TPEx オープンデータによる台湾の企業財務データ

APIを見る →

NarwhalでSEC EDGAR APIを使う

SEC EDGAR による米国の開示書類と標準化された XBRL 財務データ、公開中

APIを見る →

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

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

APIを見る →

よくある質問

ESEF の会社 ID はどのような仕組みですか。

会社 ID は、国コードと会社の LEI を組み合わせたものです。例: nld:<LEI>。2つの国に上場している会社は、それぞれの国の下に表示されることがあります。

四半期または半期の財務諸表は含まれますか。

いいえ。対象は年次報告書のみで、四半期や半期の財務諸表はありません。

5%以上の保有者は含まれますか。

いいえ。これらの企業の5%以上の保有者は含まれません。

財務諸表の項目を選ぶ

fields=revenue,net_income,total_assets で財務諸表の項目を選択できます。

年次報告書のみ

period=annual で、年次の財務諸表をリクエストできます。

提出時の通貨

金額は、各社が報告する通貨のまま、提出されたとおりに保持されます。