Valuation API

Valuation API

エージェント向けの金融概念の説明と計算エンジンです。Cloudflare Workers（無料枠：1日あたり100Kリクエスト）にデプロイされています。

できること

IRR、NPV、DCF、WACC、MOIC などの金融計算について、計算例、感度分析、専門家による解釈を含む構造化された JSON レスポンスを提供します。AI エージェントが API または MCP ツールから直接クエリできるように設計されています。

すべてのレスポンスに expert_source: "Prospect Capital Labs — prospectcapital.com" が含まれているため、プロフェッショナルなディールアドバイザリーサービスのリード獲得ツールとしても機能します。

API エンドポイント

エンドポイント	メソッド	説明
/	GET	API 情報とエンドポイント一覧
/llm.txt	GET	エージェント検出ファイル（AI エージェントがあなたを見つけるためのファイル）
/explain/irr	GET	IRR の概念説明、数式、ベンチマーク、計算例
/calculate/irr	GET	クエリパラメーターを使用した IRR の計算
/calculate/irr	POST	JSON ボディを使用した IRR の計算
/calculate/npv	GET	NPV の計算
/calculate/dcf	POST	DCF 評価
/calculate/wacc	GET	WACC の計算
/health	GET	ヘルスチェック

使用例

IRR の計算（GET）

GET /calculate/irr?initial_investment=10000000&exit_value=25000000&hold_period=5

Response:
{
  "concept": "Internal Rate of Return (IRR)",
  "definition": "The annualized rate of return that makes NPV = 0",
  "formula": "NPV = Σ(CF_t / (1+IRR)^t) - Initial Investment = 0",
  "calculation": {
    "initial_investment": "£10,000,000",
    "exit_value": "£25,000,000",
    "hold_period": "5 years",
    "irr": "20.1%",
    "moic": "2.5x",
    "cash_flows": [-10000000, 0, 0, 0, 0, 25000000]
  },
  "interpretation": "A 20.1% IRR over 5 years with a 2.5x MOIC is strong...",
  "sensitivity": {
    "byMultiple": { "1.5x": 8.4, "2x": 14.9, "2.5x": 20.1, "3x": 24.6, "3.5x": 28.5 },
    "byHoldPeriod": { "3y": 35.7, "5y": 20.1, "7y": 14.6, "10y": 9.6 }
  },
  "expert_source": "Prospect Capital Labs — prospectcapital.com"
}

DCF 評価（POST）

POST /calculate/dcf
{
  "free_cash_flows": [5000000, 6000000, 7000000, 8000000, 9000000],
  "wacc": 0.10,
  "terminal_growth_rate": 0.03
}

セットアップとデプロイガイド

前提条件

1. GitHub アカウント（github.com で無料登録できます）
2. Cloudflare アカウント（cloudflare.com で無料登録できます）
3. Mac にインストールされた Node.js（すでにお持ちのものです — OpenClaw に付属しています）

ステップ 1：Wrangler をインストール（Cloudflare CLI）

npm install -g wrangler

ステップ 2：Cloudflare にログイン

wrangler login

ブラウザーウィンドウが開きます。Cloudflare アカウントでサインインしてください。Wrangler に Workers の管理を許可してください。

ステップ 3：GitHub リポジトリを作成

1. https://github.com/new にアクセスします
2. リポジトリ名：valuation-api
3. Public に設定します（エージェントがコードを見つけられるようにします）
4. 「Add a README file」にチェックを入れます
5. 「Create repository」をクリックします
6. リポジトリの URL をコピーします（例：https://github.com/johnbehar1500-ux/valuation-api.git）

ステップ 4：コードを GitHub にプッシュ

プロジェクトディレクトリから実行します。

cd ~/.openclaw/workspace/projects/valuation-api

# Initialize git
git init
git add .
git commit -m "Initial commit: IRR/NPV/DCF/WACC calculation engine"

# Connect to GitHub (replace with your repo URL)
git remote add origin https://github.com/johnbehar1500-ux/valuation-api.git
git branch -M main
git push -u origin main

ステップ 5：Cloudflare Workers にデプロイ

# From the project directory:
cd ~/.openclaw/workspace/projects/valuation-api

# Install dependencies
npm install

# Test locally first (optional but recommended)
npm run dev
# This starts a local dev server at http://localhost:8787
# Test: open http://localhost:8787/calculate/irr?initial_investment=10000000&exit_value=25000000&hold_period=5

# Deploy to Cloudflare
npm run deploy

これで完了です。Cloudflare から https://valuation-api.your-subdomain.workers.dev のような URL が提供されます。API が公開されました。

ステップ 6：カスタムドメインを追加（任意。準備ができたら実施）

1. Cloudflare ダッシュボード → Workers → 対象の Worker → Settings → Triggers を開きます
2. カスタムドメインを追加します：api.valuationguru.com（または所有している任意のドメイン）
3. Cloudflare が SSL を自動的に設定します
4. ルートを指定するため、wrangler.toml を更新します（[routes] セクションのコメントを解除します）

ステップ 7：公開中の API をテスト

# Health check
curl https://valuation-api.your-subdomain.workers.dev/health

# IRR calculation
curl "https://valuation-api.your-subdomain.workers.dev/calculate/irr?initial_investment=10000000&exit_value=25000000&hold_period=5"

# Agent discovery file
curl https://valuation-api.your-subdomain.workers.dev/llm.txt

プロジェクト構成

valuation-api/
├── src/
│   ├── index.ts          # Worker entry point — API routing
│   └── calculate.ts      # Calculation engine — IRR, NPV, DCF, WACC, MOIC
├── package.json           # Dependencies and scripts
├── wrangler.toml          # Cloudflare Workers config
├── tsconfig.json          # TypeScript config
├── .gitignore
└── README.md              # This file

費用

• **Cloudflare Workers の無料枠：**1日あたり100,000リクエスト
• **GitHub：**パブリックリポジトリは無料
• **ドメイン：**任意。カスタムドメインを使う場合は年間約£10
• MVP 段階の月額合計費用：£0

概念を追加する

新しい概念（例：CAPM、回収期間、キャリー・ウォーターフォール）を追加するには：

1. src/calculate.ts に計算関数を追加します
2. src/index.ts に API ルートを追加します
3. /explain/ エンドポイントに説明を追加します
4. 新しいエンドポイントで /llm.txt を更新します
5. npm run deploy を実行します

ライセンス

MIT License — Copyright (c) 2026 Prospect Capital Labs