quantoracle

QuantOracle 是面向自主金融智能体的量化计算 API，其定位是“金融智能体所需要的数学”。它提供 63 个确定性、带引用验证的计算器，以及 10 个组合工作流，全部为纯计算，不依赖市场数据、账户或第三方 API，输入数字、输出数字。

主要能力

计算器覆盖：期权（4 个端点）、衍生品（7 个）、风险（8 个）、技术指标（6 个）、统计（12 个）、组合（2 个）、固定收益（4 个）、加密/DeFi（7 个）、宏观/外汇（7 个）、货币时间价值（5 个）、模拟（1 个）。
组合工作流（付费）：将 5 至 15 个计算器调用打包，用于回测策略、再平衡规划、期权策略选择、对冲建议、完整风险分析、配对信号等。
示例计算器包括：Black-Scholes 期权定价（含完整希腊字母）、美式期权（二叉树，含提前行权与股息）、期权利润计算器（多腿收益图）、隐含波动率（Newton-Raphson 求解器）、蒙特卡洛模拟（组合与退休场景）、凯利公式（全/半/四分之一凯利）、头寸规模（固定分数风险）、VaR（参数化 VaR + CVaR）、夏普比率（含 95% 置信区间）、CAGR、加密清算价格（多空、任意杠杆）、无常损失（Uniswap v2 + v3）。

使用方式

免费层：每 IP 每天 1,000 次调用，无需 API 密钥、无需注册，直接调用 API；响应包含速率限制头，便于智能体自行管理。可通过 /usage 端点随时查看用量。
批处理：单次 HTTP 请求最多运行 100 个计算，一次往返返回所有结果与总价，批处理定价为各端点价格之和，无加价。
CLI：可在终端使用全部 63 个计算器与 10 个组合，零依赖；也可不安装直接运行。
MCP 服务器：提供 80 个工具的 MCP 服务器（63 个计算器 + 11 个组合 + 2 个实时市场数据端点 + 3 个 QuantOracle Watch 监控工具 + 批处理），兼容 Claude Desktop、Cursor、Windsurf、Smithery 及任何 MCP 客户端；可通过 npm 安装、Claude Desktop 连接器配置、npx 本地运行，或连接托管的远程 Streamable HTTP 服务器。
支付：使用 x402 协议按次微支付。免费额度用尽或调用仅付费组合时，API 返回 402 Payment Required 及支付指令，支持 Base（EIP-3009 无 gas USDC 授权）与 Solana；x402 兼容智能体（Coinbase AgentKit、AgentCash、OpenClaw 等）可自动完成支付并重试。结算通过 Coinbase Developer Platform facilitator 完成。

实时数据与监控层级

QuantOracle Live（付费）：在用户传入数字的基础上，接受 ticker 并获取新鲜市场数据后运行计算，例如加密波动率（/v1/live/volatility）与永续合约资金费率（/v1/live/funding-rates）。该层从首次调用起计费，不属于每日 1,000 次免费计算器层；每 IP 每天有 20 次免费调用用于评估，之后通过 x402 按次结算。结果服务端缓存（波动率约 5 分钟，资金费率约 1 分钟），上游数据源短暂不可用时返回最后一次有效值并标记 stale: true 与 as_of_age_seconds。
QuantOracle Watch（付费）：24/7 仓位监控。注册一次加密永续合约仓位后，隔离的监视器每约 60 秒重新评估：经资金费率调整的清算距离（警告/严重带，带滞回）、资金费率符号翻转、每小时波动率状态变化与到期警告。告警通过 HMAC 签名的 Webhook 发送（X-QO-Signature，密钥为监视令牌）并记录在服务端。免费 48 小时试用；之后每个仓位每 30 天 5 美元，通过 x402 支付。不涉及交易所密钥、托管或执行，仅读取公开市场数据并发送 Webhook。

确定性与验证

确定性：相同输入始终产生相同输出，便于智能体缓存、验证与链式调用。
引用验证：每个公式均针对已发表教科书数值测试（Hull、Wilmott、Bailey & Lopez de Prado 等），120 个准确性基准全部通过，另有 65+ 集成测试覆盖全部 63 个计算器。
技术栈：FastAPI + Pydantic、Cloudflare Workers + KV、MCP（Streamable HTTP）、x402 + CDP Facilitator、Base 与 Solana 上的 USDC。纯 Python 数学，无 numpy/scipy，零原生依赖。代码采用 MIT 许可。

适用场景

为金融智能体提供可重复、可验证的量化数学计算。
智能体回测：单次迭代中链式调用多个端点；仓库中的 examples/strategy_optimizer.py 是完整的走查参数优化器，一次运行约 1,200 至 1,500 次 API 调用。
LangChain 集成：仓库中提供 cookbook，构建约 25 行的 LangChain 智能体，用确定性、可复现的数学回答具体量化问题。

限制与注意事项

工具介绍