SEC EDGAR API 財務データ取得ガイド

概要

上場企業の財務データをAPIで取得する方法を、SEC（米国証券取引委員会）のEDGAR（Electronic Data Gathering, Analysis, and Retrieval）システムについてまとめる。

関連ドキュメント: 決算書分析ウォーターフォール機能 要件定義

SEC EDGAR API

エンドポイント

認証

• 認証不要（無料）
• 必須: User-Agentヘッダーに連絡先を含める

HEADERS = {
    "User-Agent": "MyApp/1.0 ([email protected])",
    "Accept": "application/json"
}

CIK（Central Index Key）

企業を識別する10桁の番号（ゼロパディング必要）

レスポンス構造

{
  "cik": 1045810,
  "entityName": "NVIDIA CORP",
  "facts": {
    "us-gaap": {
      "Revenues": {
        "label": "Revenues",
        "description": "...",
        "units": {
          "USD": [
            {
              "val": 130497000000,
              "end": "2025-01-26",
              "fy": 2025,
              "fp": "FY",
              "form": "10-K"
            }
          ]
        }
      }
    }
  }
}

5社メトリック比較

NVIDIA, Apple, Microsoft, Tesla, Amazon の5社で検証した結果、22/31メトリック（71%）が全社共通で使用されている。

検証対象企業

PL（損益計算書）

売上高メトリックの変遷（ASC 606対応）

ASC 606（新収益認識基準）が2018年頃に導入されたことにより、売上高のメトリック名が変更されている：

実装時の注意: 最新データを取得する際は両方のメトリックを確認し、より新しい日付のデータを使用する。

PL注意点:

BS（貸借対照表）

BS注意点:

CF（キャッシュフロー計算書）

CF注意点:

SS（株主資本等変動計算書）

NVIDIA 10-Q vs EDGAR 検証結果

Statements of Income

10-Q (FY2026 Q3: Oct 26, 2025) との比較

Statements of Comprehensive Income

Balance Sheet

Cash Flow Statement

制限事項

1. セグメント情報が取得できない

セグメント別データは取得不可なのがCompany Facts APIの制限である。

取得可能:

• NumberOfReportableSegments: セグメント数（例: NVIDIAは2）

取得不可:

• セグメント別売上高（Gaming、Data Center等）
• セグメント別利益
• 地域別売上高

理由: XBRL原本には次元情報（StatementBusinessSegmentsAxis → GamingMember等）があるが、Company Facts APIは集約値のみ返す。

セグメント情報が必要な場合の選択肢:

→ 基本財務データ（PL/BS/CF総額）はEDGAR無料APIで十分。セグメント情報は有料データソース推奨。

2. 株主資本等変動計算書の列内訳がない

変動項目が各列（Common Stock, Additional Paid-in Capital, Retained Earnings等）に分かれている10-Qとは異なり、EDGARでは総額のみ提供。

例: 「Shares repurchased」

• 10-Q: Additional Paid-in Capital (-228) + Retained Earnings (-36,505) = Total (-36,733)
• EDGAR: PaymentsForRepurchaseOfCommonStock = 36,271（総額のみ）

2. 期間集計の違い

一部メトリックは四半期単独の値のみで、9ヶ月累計（YTD）がない場合がある。

3. Interest Income の取得

InterestIncomeOther または InvestmentIncomeInterest など、企業によりメトリック名が異なる。

4. Cash flow hedges の内訳

Comprehensive Income の Cash flow hedges 詳細（Change in unrealized, Reclassification）は、EDGARで直近データがない場合がある。

実装サンプル

Python

import requests
import json

HEADERS = {
    "User-Agent": "MyApp/1.0 ([email protected])",
    "Accept": "application/json"
}

def get_company_facts(cik: str) -> dict:
    url = f"https://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json"
    response = requests.get(url, headers=HEADERS)
    response.raise_for_status()
    return response.json()

# NVIDIA
facts = get_company_facts("0001045810")
us_gaap = facts['facts']['us-gaap']

# 売上高を取得
revenues = us_gaap['Revenues']['units']['USD']
# 最新の10-Kデータ
annual = [v for v in revenues if v['form'] == '10-K']
latest = sorted(annual, key=lambda x: x['end'])[-1]
print(f"Revenues: ${latest['val'] / 1e9:.2f}B ({latest['end']})")

TypeScript

interface EdgarMetricValue {
  val: number;
  end: string;
  start?: string;
  fy: number;
  fp: string;
  form: string;
  filed: string;
}

interface EdgarFacts {
  cik: number;
  entityName: string;
  facts: {
    'us-gaap': Record<string, {
      label: string;
      description: string;
      units: Record<string, EdgarMetricValue[]>;
    }>;
  };
}

async function getCompanyFacts(cik: string): Promise<EdgarFacts> {
  const res = await fetch(
    `https://data.sec.gov/api/xbrl/companyfacts/CIK${cik}.json`,
    {
      headers: {
        'User-Agent': 'MyApp/1.0 ([email protected])',
      },
    }
  );
  return res.json();
}

関連リソース

• SEC EDGAR API ドキュメント
• US-GAAP Taxonomy
• 決算書分析ウォーターフォール機能 要件定義

テストスクリプト

検証用スクリプトは test-edgar/ ディレクトリに格納：