APIとMCPのドキュメント

最初の呼び出しを行う

APIはHTTPS経由でJSONをやり取りします。この呼び出しはAppleの直近5年分の年次損益計算書を返します。キーは不要です。

curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"

財務諸表はincome_statement、balance_sheet、cash_flow、supplementalのいずれかです。期間タイプはannual、quarterly、ltm、ytdのいずれかです。

企業を指定する

すべての企業ルートはcompanyパラメータを受け取ります。

• ticker:AAPL、または取引所も指定する場合はticker:AAPL.XNAS
• cik:320193：SECの企業番号
• fmd_<id>：FinancialMDが企業に付与するID

接頭辞のないAAPLはティッカーとして、数字のみの場合はCIKとして解釈されます。レスポンスのmeta.company.matched_byには、何に一致したかが示されます。

値を読み取る

成功時のレスポンスは{ data, meta }です。data内の数値は、数値単体では返されません。次のような値オブジェクトです：

{
  "value": 391035000000,
  "unit": "USD",
  "currency": "USD",
  "decimals": -6,
  "period": { "start": "2023-10-01", "end": "2024-09-28", "type": "annual", "fiscal_year": 2024, "fiscal_period": "FY" },
  "known": { "from": "YYYY-MM-DDThh:mm:ssZ", "to": null },
  "restated": false,
  "method": "as_filed",
  "calc_type": "as_filed",
  "proof": { "id": "p_...", "accession": "0000320193-24-000123", "form": "10-K", "filed": "2024-11-01", "taxonomy": "us-gaap", "tag": "...", "source_url": "https://www.sec.gov/..." }
}

knownは、その数値が提出済みの最新数値だった期間です。restatedは、後の提出書類によって数値が変更された場合にのみtrueとなり、その場合はrestatement_kindが変更の種類を示します。proof.idはGET /proof/{id}で解決され、その値の根拠となる提出書類と元のファクトを取得できます。

当時判明していた過去のデータを読み取る

• どの読み取りルートでも、as_of=2024-06-30を指定すると、その時点で判明していたデータが返されます。
• original=trueは、各期間について最初に報告されたバージョンを返します。
• history=trueは、各期間のすべてのバージョンを古い順に返します。
• GET /v1/changes?since=<timestamp>は、指定時点以降に判明したファクトを一覧で返します。

ルート

OpenAPIドキュメントには、すべてのパラメータとレスポンススキーマが記載されています。llms.txt、llms-full.txt、スキルファイルには、エージェント向けに同じ情報が記載されています。https://api.financial.md/docsは対話型リファレンスで、https://api.financial.md/changelogには変更履歴が記載されています。

数値の検証

curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
  -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'

レスポンスには、matches、differs、unknownのいずれかを示すverdict、提出書類の値とその根拠、差額、および入力値が10の累乗分ずれている場合のscale_hintが含まれます。

利用制限

キーなしの呼び出しは、IPアドレスごとに1日当たりの回数が制限されます。

• 従量制の呼び出し25回：財務比率、スクリーニング、検証
• 提出書類層の読み取り1,000回：財務諸表、報告値のファクト、提出書類、保有情報、価格
• メタデータの読み取り1,000回：ディレクトリ、プロフィール、指標、根拠、変更情報

すべてのレスポンスにRateLimit-Limit、RateLimit-Remaining、RateLimit-Resetが含まれます。429にはRetry-Afterが含まれます。

上限の高いAPIキーはまだ発行していません。APIキーをご覧ください。api.financial.mdでの呼び出しは無料です。エージェントはagent.financial.mdで呼び出しごとに支払うことができます。料金をご覧ください。

対象範囲

対象は、SECに書類を提出し、現在米国の取引所に上場している企業です。

• US GAAPに基づいて報告する提出者には、標準化された財務諸表があります。
• Form 20-Fまたは40-Fを提出する多くの外国企業など、IFRSに基づいて報告する提出者には提出書類がありますが、標準化された財務諸表はまだありません。
• 上場廃止となった企業も、財務諸表および提出書類とともにディレクトリに収録されています。CIKで検索してください。ティッカーによる検索には対応せず、価格データもないため、価格履歴の対象は現在上場している企業のみです。
• 保有情報はJuly 1, 2026以降に提出された提出書類に基づき、EDGARの日次インデックスから毎日13:00 UTCに更新されます。対象企業のForm 3、Form 4、Form 5によるインサイダー取引と、すべてのForm 13F-HRが対象であるため、新しい四半期の13F報告書は運用者が提出するたびに追加されます。13Fの保有ポジションが企業に紐づけられるのは、Schedule 13Dまたは13Gの表紙にその証券が記載されている場合のみです。June 30, 2026に終了した四半期では、報告された保有額の80 percentがこれにより紐づけられています。その他のポジションは、提出書類に記載された発行体名で運用者のポートフォリオに表示されます。
• コンセンサス予想と決算説明会の書き起こしは提供していません。どちらもライセンス契約が必要なデータです。セグメント情報は報告されたとおりに提供し、ニュースは8-K提出書類のフィードです。

企業が登録されていてもデータセットがない場合、APIはnot_coveredを返し、利用可能なデータセットを一覧表示します。

MCPサーバー

MCPサーバーは、同じAPIを50個の読み取り専用ツールとして提供します。MCP Streamable HTTPに対応し、アカウントは不要です。

https://mcp.financial.md/mcp

MCPガイドにはツールの一覧が記載されています。サーバーカードはレジストリ向けです。

エラー

エラーの形式は { "error": { code, message, docs, request_id, remedies } } です。remedies リストには次に取るべき対応が示されます。エラーリファレンスでは各コードを説明しています。