企業ファンダメンタルズ API:金融エージェントのための貸借対照表・キャッシュフロー・インサイダー取引

価格は市場がどう考えているかを教える。ファンダメンタルズはそれが正しいかどうかを教える。AI エージェント向けに整形されたファンダメンタルズ API — 財務諸表、配当、インサイダー取引を 1 つのエンドポイントで — と、生の SEC EDGAR や財務諸表 API ベンダーとの比較を示す。
要点
- •ファンダメンタルズ=「事業は実際に健全か」のレイヤー:貸借対照表、損益計算書、キャッシュフロー、配当、インサイダー取引。
- •SEC EDGAR(XBRL)から無料でパースできるが、提出者や会計期間をまたいで XBRL を正規化するのは継続的で本物のエンジニアリングだ — しかも米国限定で、クエリ形ではなく提出ペースだ。
- •API Pick Financials Search は米国企業のファンダメンタルズ 5 種すべてを 1 つの POST エンドポイントの裏側で返す — 1 回 200 credits、成功時のみ — LLM の推論向けに整形済みだ。
- •インサイダー取引(Form 4)と配当履歴は使われ足りないシグナルだ:ここでは取得が安いが、EDGAR から組み立てるのは骨が折れる。
- •Financials を SEC Filings(定性的な 10-K・10-Q 本文)と Markets(価格)と組み合わせれば、完全な根拠あるビューが得られる。
価格は意見、ファンダメンタルズは証拠
マーケットデータの呼び出しは、株価がいくらかをエージェントに教える。だがその背後の事業が成長しているか、債務に溺れているか、あるいは経営陣自身に静かに売られているかは教えてくれない。それがファンダメンタルズのレイヤーであり — リサーチエージェントが「価格を引用する」から「見解を形成する」へと移る場所だ。
5 つのデータセットがシグナルの大半を担う:貸借対照表、損益計算書、キャッシュフロー計算書、配当履歴、インサイダー取引だ。
EDGAR 税
これらすべては SEC EDGAR で公開され無料だ。落とし穴は XBRL だ。company-facts JSON は巨大で一貫性がない:同じ概念が提出者によって異なるタグ付けをされ、修正再表示が履歴を濁らせ、下流の何かが使う前に広大な分類体系をクリーンなスキーマにマッピングしなければならない。インサイダーデータ(Form 4)と配当は、それぞれ別個にパースする別の提出書類タイプだ。これを 1 つのティッカーで一度やるのは週末仕事だが、任意の企業を問い合わせるエージェントのために確実にやるとなれば、保守されるパイプラインになる。
1 つのツールとしてのファンダメンタルズ
Financials Search は、米国上場企業の貸借対照表、損益計算書、キャッシュフロー、配当、インサイダー取引を 1 つの POST エンドポイントの裏側で返す — 1 回 200 credits、成功時のみ、LLM 向けに整形済みだ。
import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}
def fundamentals(query: str):
return httpx.post(f"{API}/search/financials", headers=HEADERS,
json={"query": query}).json()["results"]
fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")EDGAR vs ベンダー vs スイート
| SEC EDGAR をパース | 財務諸表 API ベンダー | API Pick Financials | |
|---|---|---|---|
| コスト | 無料 + エンジニアリング | サブスク | 1 回 200 credits、成功時のみ |
| セットアップ | XBRL 正規化パイプライン | 型付きエンドポイントを統合 | エンドポイント 1 つ、形状 1 つ |
| カバレッジ | 米国、提出書類で整理 | 深く、長い履歴 | 米国ファンダメンタルズ + インサイダー + 配当 |
| クエリスタイル | 提出書類/概念単位 | 型付きパラメータ | 自然言語 |
| 適する用途 | 単発/完全な制御 | 製品としてのファンダメンタルズ | 金融エージェント(多くの中の 1 ツール) |
完全な全体像
ファンダメンタルズは、定性的な側面(リスクファクター、MD&A、決算説明会の言葉)の SEC Filings Search と、価格の Markets Search と自然に組み合わさる。これらを合わせると、投資リサーチエージェントの背骨になる。キー 1 つ、JSON で一貫し、成功時のみ。100 credits(カード不要)で無料で始めよう。
よくある質問
ファンダメンタルズは SEC EDGAR から無料で取れるのでは?
取れる — EDGAR の company-facts と XBRL データは無料で権威がある。コストはエンジニアリングだ:XBRL タグは提出者や会計期間をまたいでぶれ、修正再表示が履歴を複雑にし、モデル(やチャート)が使う前に何千もの分類概念をクリーンなスキーマにマッピングしなければならない。しかも米国限定で、問いではなく提出書類で整理されている。たまに 1 社だけならば EDGAR で十分だ。多数の企業を自然言語で問い合わせるエージェントには、正規化された API が数週間を節約する。
何がカバーされ、米国限定か?
米国上場企業の貸借対照表、損益計算書、キャッシュフロー計算書、配当履歴、インサイダー取引だ。米国のファンダメンタルズであり、米国外の発行体には別のソースを使うことになる。提出書類の本文そのもの(10-K のリスクファクター、10-Q の MD&A、決算説明会)には、別の SEC Filings Search エンドポイントを使うこと。
なぜインサイダー取引と配当を強調するのか?
高シグナルで、自前で組み立てるのが面倒だからだ。インサイダーの買い/売り(SEC Form 4)は注視される行動シグナルであり、配当履歴はインカムや質のスクリーニングに重要だ。どちらも EDGAR から特定の提出書類タイプをパースする必要がある。ここでは、財務諸表と同じエンドポイント内のファーストクラスのフィールドになっている。
財務諸表 API ベンダーとどう比較されるか?
専門ベンダー(例:財務諸表 API)は深く型付けされたエンドポイントと長い履歴を提供する — ファンダメンタルズが製品のすべてなら最適だ。API Pick の切り口は異なる:ファンダメンタルズをスイート(markets、SEC、economic、news)の中の 1 ツールとしてキー 1 つの裏側に置き、エージェント向けにクエリ形にし、成功時のみ課金する。ファンダメンタルズ製品ではなく金融エージェントを作っているなら、単一形状のスイートがより速い道だ。
これは投資助言か?
いいえ。リサーチとエージェントの根拠づけのための構造化された公開財務データだ。資格を持つ人間や監督下のエージェントによる分析に資するものであって、助言ではなく、人間の責任とリスク管理なしに自動売買を駆動してはならない。
この記事で使われている API
API Pick の CEO。AI エージェントと LLM ワークフロー向けの本番運用可能な API について執筆。