APIリファレンス

概要

MiniValuatorはREST APIを提供しており、プログラムから株式のファンダメンタルデータを取得できます。Web版と同じクレジット課金ルールが適用されます——新しいティッカーの初回照会は10クレジット、7日以内の再照会は無料です。

Base URL: https://minivaluator.com

認証: Authorization: Bearer sk-... ヘッダーによるAPIキー

APIキーの取得

MiniValuatorアカウントにログインします
Settings → API Keys に移動します
Add API Key をクリックして名前を付け、生成されたキー（sk-...）をコピーします

APIキーは秘密にしてください。キーを持っている人は誰でもあなたのクレジットを消費できます。

エンドポイント

GET /api/stock/fundamentals

指定したティッカーのファンダメンタルデータを返します。

リクエスト

curl "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL" \
  -H "Authorization: Bearer sk-your-api-key-here"

クエリパラメータ

パラメータ	型	必須	説明
`symbol`	string	はい	ティッカーシンボル（例：`AAPL`、`MSFT`、`GOOGL`）

レスポンス

{
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "fcfPerShare": 7.43,
    "currentPrice": 211.45,
    "currentPFCF": 28,
    "eps": 6.42,
    "currentPE": 33,
    "growthEstimate": {
      "rates": [0.062, 0.091, 0.08, 0.08, 0.08],
      "cagr": 0.082,
      "quality": "ok",
      "flags": []
    },
    "earningsGrowthEstimate": {
      "rates": [0.11, 0.13, 0.12, 0.12, 0.12],
      "cagr": 0.12,
      "quality": "ok",
      "flags": []
    },
    "dataSource": "Financial Modeling Prep"
  }
}

レスポンスフィールド

フィールド	型	説明
`symbol`	string	大文字のティッカーシンボル
`name`	string	企業名
`fcfPerShare`	number	1株あたりFCF（TTM、米ドル）
`currentPrice`	number	現在の株価（米ドル）
`currentPFCF`	number	Price-to-FCF倍率（TTM）
`eps`	number	1株あたり利益（TTM、米ドル）
`currentPE`	number	PER（株価収益率、TTM）
`growthEstimate`	object \| null	売上高ベースの5年成長率予測
`earningsGrowthEstimate`	object \| null	EPSベースの5年成長率予測
`dataSource`	string	データプロバイダー名

growthEstimateのフィールド

フィールド	型	説明
`rates`	number[]	5年分の前年比成長率（小数表記、例：`0.08` = 8%）
`cagr`	number	期間全体のCAGR（年平均成長率）
`quality`	`"ok"` \| `"partial"` \| `"insufficient"`	データ信頼度
`flags`	string[]	補完値やクランプ値に関する注記

エラーレスポンス

HTTPステータス	メッセージ	原因
`400`	`"Symbol required"`	`symbol` パラメータが欠落
`400`	`"Invalid symbol format"`	シンボルに不正な文字が含まれている
`400`	`"Insufficient credits"`	アカウントのクレジットが10未満
`400`	`"Rate limit exceeded"`	同一IPからのリクエストが多すぎる
`400`	`"Stock not found"`	データプロバイダーがティッカーを認識できない

すべてのエラーは次の形式に従います：

{ "error": "Insufficient credits" }

クレジット消費

シナリオ	消費クレジット
新しいティッカーの初回照会	10クレジット
7日以内の再照会	無料（キャッシュから配信）
7日経過後の再照会	10クレジット

コード例

Python

import requests

API_KEY = "sk-your-api-key-here"

response = requests.get(
    "https://minivaluator.com/api/stock/fundamentals",
    params={"symbol": "AAPL"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = response.json()
print(data["data"]["fcfPerShare"])  # 7.43

JavaScript / Node.js

const API_KEY = "sk-your-api-key-here";

const res = await fetch(
  "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { data } = await res.json();
console.log(data.fcfPerShare); // 7.43