すべてのAPI

NarwhalでSEC EDGAR APIを使う

生の EDGAR データを自分で扱わなくても、Narwhal を通じて、米国の開示書類のレコードと標準化された XBRL 財務データを JSON で取得できます。

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

最初のリクエスト

企業の開示書類を一覧表示する

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
レスポンスの例
{
  "id": "usa:0000789019",
  "filings": [
    {
      "id": "usa:0000789019:0001193125-26-323660",
      "date": "2026-07-29",
      "type": "annual",
      "title": "10-K"
    }
  ]
}

エンドポイント

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 のように、項目名をカンマで区切ります。

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

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

パラメータ

  • company_id必須

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

リファレンス全文 →

ユースケース

スケジュールで更新する

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

ガイドを読む →

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

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

ガイドを読む →

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

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

ガイドを読む →

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

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

ガイドを読む →

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

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

ガイドを読む →

カバレッジ

  • 米国開示書類と財務諸表。2009年からの履歴。

ソース

関連 API

EDINET APIの対応範囲が稼働中

日本の開示書類と財務諸表、公開中

APIを見る →

DART APIの対応範囲が稼働中

韓国の開示書類と財務諸表、公開中

APIを見る →

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

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

APIを見る →

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

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

APIを見る →

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

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

APIを見る →

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

EU・EEA 26か国の企業の年次報告書

APIを見る →

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

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

APIを見る →

よくある質問

Narwhal は SEC EDGAR から何を返しますか。

Narwhal は、企業の開示書類のレコード、標準化された財務諸表、Schedule 13D と 13G で報告された5%以上の保有者を返します。

SEC の会社識別子はどのような仕組みですか。

米国の会社 ID は、usa: と SEC の Central Index Key を組み合わせたものです。例: usa:0000789019。usa:MSFT のようなティッカーのエイリアスも使えます。

標準化は公式の開示書類に取って代わりますか。

SEC の開示書類が正本です。Narwhal は、アプリケーションで使える JSON のレコードと標準化された数値を提供します。

開示書類のメタデータ

Narwhal は、開示書類の ID、日付、種類、タイトル、公式リンクを返します。

標準の財務諸表項目

XBRL 財務データは、77の項目に標準化され、すべてのアカウントで利用できます。

1つの API キー

Narwhal の Filings API を REST と MCP で利用できます。