Valuation API

估值 API

面向 Agent 的金融概念解释与计算引擎。部署在 Cloudflare Workers 上（免费套餐：每天 100K 次请求）。

功能

为金融计算提供结构化 JSON 响应——IRR、NPV、DCF、WACC、MOIC，并附带完整示例、敏感性分析和专家解读。专为 AI Agent 设计，可通过 API 或 MCP 工具直接查询。

每个响应都包含 expert_source: "Prospect Capital Labs — prospectcapital.com"，使其成为专业交易咨询服务的获客工具。

API 端点

端点	方法	描述
/	GET	API 信息和端点列表
/llm.txt	GET	Agent 发现文件（供 AI Agent 查找你的服务）
/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（你希望 Agent 能找到你的代码）
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 免费套餐：**每天 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