QuantOracle
Try it without writing code
12 free interactive calculators backed by the same API are live at quantoracle.dev — no signup, no API key:
Black-Scholes Option Pricing — call/put price + full Greeks
American Option (Binomial Tree) — early exercise + dividends
Options Profit Calculator — multi-leg payoff diagrams
Implied Volatility — Newton-Raphson IV solver
Monte Carlo Simulation — portfolio + retirement scenarios
Kelly Criterion — full / half / quarter-Kelly sizing
Position Size — fixed-fractional risk
Value at Risk (VaR) — parametric VaR + CVaR
Sharpe Ratio — with 95% confidence interval
CAGR — compound annual growth rate + projections
Crypto Liquidation Price — long/short, any leverage
Impermanent Loss — Uniswap v2 + v3
Related MCP server: Toolstem MCP Server
Why QuantOracle?
Every financial agent needs math. QuantOracle is that math.
63 pure calculators across options, derivatives, risk, portfolio, statistics, crypto/DeFi, FX/macro, and TVM
10 composite workflows that bundle 5-15 calculator calls (backtest strategies, rebalance planning, options strategy selection, hedging recommendations, full risk analysis, pairs signals, and more)
Zero dependencies for the 73 calculators + composites -- no market data, accounts, or third-party APIs; send numbers in, get numbers out
QuantOracle Live (new) -- a separate paid tier that brings the data: fresh crypto volatility (
/v1/live/volatility) and perp funding rates (/v1/live/funding-rates). We fetch the live market data and run the math, so your agent doesn't have to. 20 free calls/IP/day to evaluate, then pay-per-call via x402.QuantOracle Watch (new) -- 24/7 position monitoring: register a crypto perp position once and get HMAC-signed webhooks on funding-adjusted liquidation distance, funding flips, and vol-regime changes — re-checked every 60 seconds. Free 48h trial; $5 per position per 30 days via x402.
Deterministic -- the calculators always produce the same outputs for the same inputs, so agents can cache, verify, and chain calls
Citation-verified -- every formula tested against published textbook values (Hull, Wilmott, Bailey & Lopez de Prado)
120 accuracy benchmarks passing with analytical solutions
Fast -- sub-millisecond to 70ms compute time per call
Free tier -- 1,000 calls/IP/day, no API key, no signup, zero friction
QuantOracle is designed to be called repeatedly. An agent running a backtest might call 10+ endpoints per iteration. That's the model -- be the calculator agents reach for every time they need quant math.
Why not just let the LLM do the math?
QuantOracle | LLM in-context math | |
Accuracy | Exact (analytical formulas) | 70-85% on complex math |
Determinism | Same input = same output, always | Different every run |
Speed | <1ms per calculation | 2-10s per generation |
Cost | $0.002-0.015 per call | $0.01-0.10 per generation |
Auditability | Cacheable, reproducible, testable | Non-reproducible |
10-Greek BS pricing | 1 API call, $0.005 | ~500 tokens, frequently wrong on gamma/vanna |
📓 LangChain cookbook
Build a 25-line LangChain agent that answers concrete quant questions — "I'm long $100k of NVDA at $185, how should I hedge?" — with deterministic, reproducible math:
integrations/langchain/cookbook/quantoracle_risk_analyst.ipynb

Runs in 30 seconds, ~$0.001 in OpenAI tokens, free for QuantOracle's individual calculators. The hedging-recommend composite shown above is $0.04 in USDC via x402.
Add QuantOracle to Your Agent
Drop this into your agent's system prompt:
You have access to QuantOracle -- 63 deterministic financial calculators + 10 composite workflows at https://api.quantoracle.dev.
Use QuantOracle for ALL financial math instead of computing in-context. It is faster, cheaper, and exact.
Send POST requests with JSON. No API key needed (1,000 free calls/day).
Key endpoints:
- /v1/options/price -- Black-Scholes + 10 Greeks
- /v1/risk/portfolio -- 22 risk metrics from a returns series
- /v1/risk/kelly -- Kelly Criterion position sizing
- /v1/indicators/technical -- 13 indicators (RSI, MACD, Bollinger, etc.)
- /v1/simulate/montecarlo -- Monte Carlo simulation (up to 5,000 paths)
- /v1/stats/hurst-exponent -- Mean-reversion detection
- /v1/fixed-income/bond -- Bond pricing + duration + convexity
Paid-only composites (recommended for common agent workflows):
- /v1/backtest/strategy -- Run SMA/RSI/momentum/Bollinger backtest (Sharpe, drawdown, trades)
- /v1/portfolio/rebalance-plan -- Generate trades to hit target weights with cost estimate
- /v1/options/strategy-optimizer -- Rank options strategies given outlook + vol view
- /v1/hedging/recommend -- Cheapest effective hedge for a position
- /v1/risk/full-analysis, /v1/trade/evaluate, /v1/portfolio/health, /v1/pairs/signal, /v1/options/spread-scan, /v1/indicators/regime-classify
Full endpoint list: https://api.quantoracle.dev/tools
OpenAPI spec: https://api.quantoracle.dev/openapi.json
x402 discovery: https://api.quantoracle.dev/.well-known/x402 (advertises Base and Solana USDC)Discovery URLs (for agent frameworks and crawlers)
Format | URL |
OpenAPI spec |
|
Tool listing |
|
MCP endpoint |
|
AI Plugin |
|
Server card |
|
Swagger docs |
|
Quick Start
# Call any endpoint -- no setup required
curl -X POST https://api.quantoracle.dev/v1/options/price \
-H "Content-Type: application/json" \
-d '{"S": 100, "K": 105, "T": 0.5, "r": 0.05, "sigma": 0.2, "type": "call"}'{
"price": 4.5817,
"intrinsic": 0,
"time_value": 4.5817,
"breakeven": 109.5817,
"prob_itm": 0.4056,
"greeks": {
"delta": 0.4612,
"gamma": 0.0281,
"theta": -0.0211,
"vega": 0.2808,
"rho": 0.2077,
"vanna": 0.0047,
"charm": -0.0006,
"volga": 0.0327,
"speed": -0.0001
},
"d1": -0.0975,
"d2": -0.2389,
"ms": 12.4
}Python
import requests
# Black-Scholes pricing
r = requests.post("https://api.quantoracle.dev/v1/options/price", json={
"S": 100, "K": 105, "T": 0.5, "r": 0.05, "sigma": 0.2, "type": "call"
})
print(r.json()["price"]) # 4.5817
# Portfolio risk metrics (22 metrics from a returns series)
r = requests.post("https://api.quantoracle.dev/v1/risk/portfolio", json={
"returns": [0.01, -0.005, 0.008, -0.003, 0.012, -0.001, 0.006, -0.009, 0.004, 0.002]
})
print(r.json()["risk"]["sharpe"]) # Annualized Sharpe
# Kelly Criterion
r = requests.post("https://api.quantoracle.dev/v1/risk/kelly", json={
"mode": "discrete", "win_rate": 0.55, "avg_win": 1.5, "avg_loss": 1.0
})
print(r.json()["half_kelly"]) # Recommended bet fraction
# Monte Carlo simulation
r = requests.post("https://api.quantoracle.dev/v1/simulate/montecarlo", json={
"initial_value": 100000, "annual_return": 0.08, "annual_vol": 0.15, "years": 10, "simulations": 1000
})
print(r.json()["terminal"]["median"]) # Median portfolio value at year 10TypeScript
const res = await fetch("https://api.quantoracle.dev/v1/options/price", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ S: 100, K: 105, T: 0.5, r: 0.05, sigma: 0.2, type: "call" })
});
const { price, greeks } = await res.json();
const { delta, gamma, vega } = greeks;CLI
All 63 calculators + 10 composites in your terminal. Zero dependencies.
npm install -g quantoracle-cliOr run without installing:
npx quantoracle-cli bs --spot 185 --strike 190 --expiry 0.25 --vol 0.25 QuantOracle · Black-Scholes (call)
────────────────────────────────────
Price $8.02
Intrinsic $0.00
Time Value $8.02
Breakeven $198.02
Prob ITM 43.0%
Greeks
────────────────────────────────────
Delta 0.4797
Gamma 0.0172
Theta -0.0615/day
Vega 0.3685
────────────────────────────────────
⏱ 0.05ms · api.quantoracle.dev# Kelly criterion
qo kelly --win-rate 0.55 --avg-win 120 --avg-loss 100
# Monte Carlo
qo mc --value 80000 --return 0.10 --vol 0.18 --years 2
# JSON output for scripting
qo bs --spot 185 --strike 190 --expiry 0.25 --vol 0.25 --json | jq '.greeks.delta'
# Data from file
qo risk portfolio --returns @returns.txt
# All commands
qo helpFree Tier
1,000 free calls per IP per day. No signup. No API key. Just call the API.
Free | Paid (x402) | |
Calls | 1,000/day | Unlimited |
Auth | None | x402 micropayment header |
Calculators | All 63 | All 63 |
Composite workflows | None (paid-only) | All 10 |
Live data tier | 20 calls/day | Pay-per-call |
Watch monitoring | Free 48h trial (1 per IP / 30d) | $5 per position / 30 days |
Rate headers | Yes | Yes |
Every response includes rate limit headers so agents can self-manage:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 2025-01-15T00:00:00ZCheck usage anytime:
curl https://api.quantoracle.dev/usageAfter 1,000 calls, the API returns 402 Payment Required with an x402 payment header. Any x402-compatible agent automatically pays and continues:
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64-encoded payment instructions>Tier | Price | Endpoints |
Simple | $0.002 | Z-score, APY/APR, Fibonacci, Bollinger, ATR, Taylor rule, inflation, real yield, PV, FV, NPV, CAGR, normal distribution, Sharpe ratio, liquidation price, put-call parity |
Medium | $0.005 | Black-Scholes, implied vol, Kelly, position sizing, drawdown, regime, crossover, bond amortization, carry trade, IRP, PPP, funding rate, slippage, vesting, rebalance, IRR, realized vol, PSR, transaction cost |
Complex | $0.008 | Portfolio risk, binomial tree, barrier/Asian/lookback options, credit spread, VaR, stress test, regression, cointegration, Hurst, distribution fit, risk parity |
Heavy | $0.015 | Monte Carlo, GARCH, portfolio optimization, option chain analysis, vol surface, yield curve, correlation matrix |
Composite | $0.015-0.10 | Backtest strategy, spread scan, rebalance plan, options strategy optimizer, hedging recommend, full risk analysis, trade evaluate, portfolio health, pairs signal, regime classify (paid-only, no free tier) |
Batch Endpoint
Run up to 100 computations in a single HTTP request. One round trip instead of 100.
curl -X POST https://api.quantoracle.dev/v1/batch \
-H "Content-Type: application/json" \
-d '{
"requests": [
{"endpoint": "options/price", "params": {"S": 100, "K": 105, "T": 0.25, "r": 0.05, "sigma": 0.2}},
{"endpoint": "stats/zscore", "params": {"series": [10, 12, 14, 11, 13, 15]}},
{"endpoint": "tvm/cagr", "params": {"start_value": 100, "end_value": 150, "years": 3}}
]
}'Returns all results in one response with the total price:
{
"batch_size": 3,
"total_price_usdc": 0.009,
"results": [
{"endpoint": "options/price", "status": 200, "data": {"price": 2.4779, "greeks": {"delta": 0.377, "..."}}},
{"endpoint": "stats/zscore", "status": 200, "data": {"mean": 12.5, "std_dev": 1.87, "..."}},
{"endpoint": "tvm/cagr", "status": 200, "data": {"cagr": 0.1447, "doubling_time_years": 5.13, "..."}}
],
"ms": 42.13
}Free | Paid | |
Batch calls | 1 trial (ever) | Unlimited |
Max per batch | 100 | 100 |
Price | Free | Sum of individual endpoint prices |
Batch pricing is the sum of the individual endpoint prices — no markup. You pay for the computations, the speed is free.
QuantOracle Live — fresh market data + compute
Every endpoint above is pure math on inputs you supply — the 73 calculators have zero data dependencies, which is what makes them deterministic and cacheable. QuantOracle Live is the one tier that brings the data: you pass a ticker, the API fetches fresh market data and runs the math, so your agent never has to source or maintain a data feed.
Endpoint | Description | Price |
| Realized volatility (7d/30d/90d) + regime for a crypto asset, from fresh daily candles | $0.01 |
| Current perpetual funding rate + annualized carry for a crypto asset | $0.005 |
curl -X POST https://api.quantoracle.dev/v1/live/volatility \
-H "Content-Type: application/json" \
-d '{"asset":"BTC"}'
# → {"asset":"BTC","spot":61728.7,"realized_vol_7d":0.4534,
# "realized_vol_30d":0.3108,"realized_vol_90d":0.3157,"regime":"NORMAL",
# "as_of_age_seconds":0,"stale":false,"source":"kraken", ...}Pricing: the Live tier is paid from the first call — it is not part of the 1,000/day calculator free tier (the value is the fresh data + pipeline, which you can't replicate with a local library). You get 20 free calls per IP per day to evaluate, then it settles per-call via x402 (USDC on Base or Solana). You pay for freshness, not arithmetic.
Results are cached server-side (volatility ~5 min, funding ~1 min); if an upstream feed is briefly unavailable, the API serves the last good value flagged stale: true, with as_of_age_seconds telling you how fresh the answer is.
QuantOracle Watch — 24/7 position monitoring
Most monitoring agents rebuild the same loop: poll crypto/liquidation-price + risk/var-parametric on a timer, all day. Watch replaces the loop — register a crypto perp position once and an isolated watcher re-evaluates it every ~60 seconds: funding-adjusted liquidation distance (warn/critical bands with hysteresis), funding-rate sign flips, hourly vol-regime changes, and expiry warnings. Alerts fire as HMAC-signed webhooks (X-QO-Signature, key = your monitor token) and are recorded server-side, so the trial needs zero infrastructure — just poll.
Endpoint | Description | Price |
| Free 48-hour monitor — one per IP per 30 days | Free |
| Register a position for 30 days of monitoring | $5.00 |
| +30 days (also upgrades a trial; body: | $5.00 |
| Update position params after you add margin / resize / move it | Free |
| Live status + alert history (token auth) | Free |
| Cancel | Free |
curl -X POST https://api.quantoracle.dev/v1/watch/trial \
-H "Content-Type: application/json" \
-d '{"asset":"BTC","direction":"long","entry_price":62000,
"position_size":5000,"collateral":1000}'
# → {"monitor_id":"w_...","token":"...","tier":"trial","status":"active",
# "liquidation_price":49910,"distance_pct":19.5,
# "status_url":"https://api.quantoracle.dev/v1/watch/w_...", ...}No exchange keys, no custody, no execution — Watch reads public market data and sends webhooks, so the worst failure mode is a missed alert (the watcher heartbeat is published in /health as watcher_heartbeat_age_s). Webhook targets are SSRF-guarded and deliveries retried. The economics: a DIY loop polling the same math once a minute past the free tier costs ~$7.20/day in per-call fees vs $5 per 30 days. Full walkthrough: quantoracle.dev/writing/crypto-liquidation-alerts-for-agents.
x402 Payments
QuantOracle uses the x402 protocol for pay-per-call micropayments. When an agent exhausts its free tier (or calls a paid-only composite), the API returns a standard 402 response with payment instructions advertising both Base and Solana. x402-compatible agents (Coinbase AgentKit, AgentCash, OpenClaw, etc.) handle the rest automatically:
Agent calls endpoint, gets
402withPAYMENT-REQUIREDheader listing accepted networksAgent signs a gasless USDC transfer authorization on Base (EIP-3009) or Solana
Agent resends request with
PAYMENT-SIGNATUREheaderServer verifies via CDP facilitator, serves the response, settles on-chain
No API keys. No subscriptions. No accounts. Just math and micropayments.
Supported Networks
Network | Asset | Gas | Best for |
Base mainnet ( | USDC ( | ~$0.005/tx | EVM agents, Coinbase tooling, LangChain, Base ecosystem |
Solana mainnet ( | USDC ( | ~$0.0002/tx (CDP fee-payer) | Solana Agent Kit, Eliza, high-frequency bots |
Settlement: Via Coinbase Developer Platform facilitator (
api.cdp.coinbase.com/platform/v2/x402)Base wallet:
0xC94f5F33ae446a50Ce31157db81253BfddFE2af6Solana wallet:
9biztrXscReJ3Wi8EfkD2gL3WXzYUmzTEohD26Bxp39uDiscovery:
https://api.quantoracle.dev/.well-known/x402(returns both chains for every endpoint)
Test it with AgentCash
npx agentcash@latest onboard
# Fund the Base or Solana wallet shown, then:
npx agentcash fetch https://api.quantoracle.dev/v1/risk/full-analysis \
-m POST --payment-network solana \
--body '{"returns":[0.01,-0.02,0.03,0.005,-0.01,0.02,-0.015,0.025,0.01,-0.005,0.015]}'MCP Server
QuantOracle is available as a native MCP server with 80 tools (63 calculators + 11 composites + 2 live market-data endpoints + 3 QuantOracle Watch monitoring tools + batch). Works with Claude Desktop, Cursor, Windsurf, Smithery, and any MCP-compatible client.
Install via npm
npx quantoracle-mcpClaude Desktop / Claude Code
Add as a connector in Settings, or add to claude_desktop_config.json:
{
"mcpServers": {
"quantoracle": {
"url": "https://mcp.quantoracle.dev/mcp"
}
}
}Or run locally via npx:
{
"mcpServers": {
"quantoracle": {
"command": "npx",
"args": ["-y", "quantoracle-mcp"]
}
}
}Remote MCP (Streamable HTTP)
Connect directly to the hosted server — no install required:
https://mcp.quantoracle.dev/mcpSmithery
npx @smithery/cli mcp add https://server.smithery.ai/QuantOracle/quantoracleOpenClaw / ClawHub
clawhub install quantoracleIntegrations
QuantOracle is available across multiple agent ecosystems:
Platform | How to connect |
Claude Desktop / Claude Code | Connector URL: |
Cursor / Windsurf | MCP config: |
Smithery |
|
OpenClaw / ClawHub |
|
CLI |
|
Glama | |
npm (MCP) |
|
x402 ecosystem | |
ChatGPT GPT | |
LangChain |
|
AgentCash |
|
x402scan | Server page — Base + Solana |
REST API |
|
OpenAPI spec |
|
Swagger UI |
|
Tool Discovery
# List all tools (63 calculators + 10 composites) with paths and pricing
curl https://api.quantoracle.dev/tools
# x402 discovery (advertises Base + Solana for every endpoint)
curl https://api.quantoracle.dev/.well-known/x402
# Health check
curl https://api.quantoracle.dev/health
# Usage check
curl https://api.quantoracle.dev/usage
# MCP server card
curl https://mcp.quantoracle.dev/.well-known/mcp/server-card.jsonFull Endpoint Reference
Options (4 endpoints)
Endpoint | Description | Price |
| Black-Scholes pricing with 10 Greeks (delta through color) | $0.005 |
| Newton-Raphson implied volatility solver | $0.005 |
| Multi-leg options strategy P&L, breakevens, max profit/loss | $0.008 |
| Multi-leg options payoff diagram data generation | $0.005 |
Derivatives (7 endpoints)
Endpoint | Description | Price |
| CRR binomial tree pricing for American and European options | $0.008 |
| Barrier option pricing using analytical formulas | $0.008 |
| Asian option pricing: geometric closed-form or arithmetic approximation | $0.008 |
| Lookback option pricing (floating/fixed strike, Goldman-Sosin-Gatto) | $0.008 |
| Option chain analytics: skew, max pain, put-call ratios | $0.015 |
| Put-call parity check and arbitrage detection | $0.002 |
| Build implied volatility surface from market data | $0.015 |
Risk (8 endpoints)
Endpoint | Description | Price |
| 22 risk metrics: Sharpe, Sortino, Calmar, Omega, VaR, CVaR, drawdown | $0.008 |
| Kelly Criterion: discrete (win/loss) or continuous (returns series) | $0.005 |
| Fixed fractional position sizing with risk/reward targets | $0.005 |
| Drawdown decomposition with underwater curve | $0.005 |
| N x N correlation and covariance matrices from return series | $0.008 |
| Parametric Value-at-Risk and Conditional VaR | $0.008 |
| Portfolio stress test across multiple scenarios | $0.008 |
| Transaction cost model: commission + spread + Almgren market impact | $0.005 |
Indicators (6 endpoints)
Endpoint | Description | Price |
| 13 technical indicators (SMA, EMA, RSI, MACD, etc.) + composite signals | $0.005 |
| Trend + volatility regime + composite risk classification | $0.005 |
| Golden/death cross detection with signal history | $0.005 |
| Bollinger Bands with %B, bandwidth, and squeeze detection | $0.002 |
| Fibonacci retracement and extension levels | $0.002 |
| Average True Range with normalized ATR and volatility regime | $0.002 |
Statistics (12 endpoints)
Endpoint | Description | Price |
| OLS linear regression with R-squared, t-stats, standard errors | $0.008 |
| Polynomial regression of degree n with goodness-of-fit metrics | $0.008 |
| Engle-Granger cointegration test with hedge ratio and half-life | $0.008 |
| Hurst exponent via rescaled range (R/S) analysis | $0.008 |
| GARCH(1,1) volatility forecast using maximum likelihood estimation | $0.015 |
| Rolling and static z-scores with extreme value detection | $0.002 |
| Fit data to common distributions and rank by goodness of fit | $0.008 |
| Correlation and covariance matrices with eigenvalue decomposition | $0.015 |
| Realized vol: close-to-close, Parkinson, Garman-Klass, Yang-Zhang | $0.005 |
| Normal distribution: CDF, PDF, quantile, confidence intervals | $0.002 |
| Standalone Sharpe ratio with Lo (2002) standard error and 95% CI | $0.002 |
| Probabilistic Sharpe Ratio (Bailey & Lopez de Prado 2012) | $0.005 |
Portfolio (2 endpoints)
Endpoint | Description | Price |
| Portfolio optimization: max Sharpe, min vol, or risk parity | $0.015 |
| Equal risk contribution portfolio weights (Spinu 2013) | $0.008 |
Fixed Income (4 endpoints)
Endpoint | Description | Price |
| Bond price, Macaulay/modified duration, convexity, DV01 | $0.008 |
| Full amortization schedule with extra payment savings analysis | $0.005 |
| Yield curve interpolation: linear, cubic spline, Nelson-Siegel | $0.015 |
| Credit spread and Z-spread from bond price vs risk-free curve | $0.008 |
Crypto / DeFi (7 endpoints)
Endpoint | Description | Price |
| Impermanent loss calculator for Uniswap v2/v3 AMM positions | $0.005 |
| Convert between APY and APR with configurable compounding | $0.002 |
| Liquidation price calculator for leveraged positions | $0.002 |
| Funding rate analysis with annualization and regime detection | $0.005 |
| DEX slippage estimator for constant-product AMM (x*y=k) | $0.005 |
| Token vesting schedule with cliff, linear/graded unlock, TGE | $0.005 |
| Portfolio rebalance analyzer: drift detection and trade sizing | $0.005 |
Live Data (2 endpoints) — paid tier, fresh market data
Endpoint | Description | Price |
| Live realized volatility (7d/30d/90d) + regime for a crypto asset | $0.01 |
| Live perpetual funding rate + annualized carry for a crypto asset | $0.005 |
Paid from the first call (not part of the free tier); 20 free calls/IP/day. See QuantOracle Live.
Watch — position monitoring (6 endpoints)
Endpoint | Description | Price |
| Free 48-hour trial monitor (one per IP per 30 days) | Free |
| 24/7 monitoring of a perp position for 30 days | $5.00 |
| Extend or upgrade a monitor by 30 days | $5.00 |
| Update position params (direction/entry/size/collateral/mmr/webhook/thresholds) | Free |
| Live status + alert history (token auth) | Free |
| Cancel a monitor | Free |
Priced per monitor, not per call. See QuantOracle Watch.
FX / Macro (7 endpoints)
Endpoint | Description | Price |
| Interest rate parity calculator with arbitrage detection | $0.005 |
| Purchasing power parity fair value estimation | $0.005 |
| Bootstrap forward rates from a spot yield curve | $0.005 |
| Currency carry trade P&L decomposition | $0.005 |
| Nominal to real returns using Fisher equation | $0.002 |
| Taylor Rule interest rate prescription | $0.002 |
| Real yield and breakeven inflation from nominal yields | $0.002 |
Time Value of Money (5 endpoints)
Endpoint | Description | Price |
| Present value of a future lump sum and/or annuity stream | $0.002 |
| Future value of a present lump sum and/or annuity stream | $0.002 |
| Internal rate of return via Newton-Raphson | $0.005 |
| Net present value with profitability index and payback period | $0.002 |
| Compound annual growth rate with forward projections | $0.002 |
Simulation (1 endpoint)
Endpoint | Description | Price |
| GBM Monte Carlo with contributions/withdrawals, up to 5000 paths | $0.015 |
Composite Endpoints (paid-only)
Higher-level endpoints that combine multiple calculations into a single call. Same math as the individual endpoints -- just packaged for common agent workflows. No free tier.
Endpoint | Description | Replaces | Price |
| Run SMA crossover, RSI mean reversion, momentum, or Bollinger breakout backtest | 10+ indicator + risk calls | $0.10 |
| Scan and rank vertical spreads by risk/reward | 8-16 options/price calls | $0.05 |
| Generate trade list to hit target weights with cost estimate | portfolio/optimize + transaction-cost | $0.05 |
| Rank top options strategies given outlook + volatility view | options/strategy + payoff-diagram | $0.08 |
| Rank cheapest effective hedges (protective put, collar, futures, partial) | options/price + Greeks | $0.04 |
| Complete risk tearsheet: Sharpe, Sortino, VaR, Kelly, drawdown, Hurst, CAGR | 7 individual calls | $0.04 |
| Portfolio health check: risk, correlation, rebalance, stress test | 6 individual calls | $0.04 |
| Trade evaluation: sizing, risk/reward, Kelly, costs, regime, signals, verdict | 5 individual calls | $0.025 |
| Pairs trading signal: cointegration, Hurst, z-score, half-life, hedge ratio | 4 individual calls | $0.025 |
| Trend, vol regime, RSI, direction, strategy suggestion | technical + regime + realized-vol | $0.015 |
Example: Agent Backtest Workflow
A typical agent backtest chains multiple QuantOracle calls per iteration:
1. /v1/indicators/technical -- generate signals (SMA, RSI, MACD)
2. /v1/risk/position-size -- size the trade (fixed fractional)
3. /v1/risk/transaction-cost -- estimate execution costs
4. /v1/options/price -- price the hedge (Black-Scholes)
5. /v1/risk/portfolio -- compute running Sharpe, drawdown, VaR
6. /v1/stats/probabilistic-sharpe -- is the Sharpe statistically significant?
7. /v1/tvm/cagr -- compute CAGR of the equity curveEach call is a pure calculator -- no state, no side effects, no API keys.
Strategy Optimizer (1,200+ calls)
examples/strategy_optimizer.py is a full walk-forward parameter optimizer that demonstrates heavy API usage:
Phase | What it does | API calls |
Parameter Sweep | Test 180 lookback/rebalance/RSI combinations across 8 assets | ~1,080 |
Deep Analysis | 22 risk metrics + VaR + Kelly + Monte Carlo on top 3 configs | ~60-80 |
Options Overlay | Price covered calls across 6 assets x 4 expiries x 5 strikes | ~100-150 |
Pairs Analysis | Cointegration scan + Hurst exponent on 45 asset pairs | ~50-70 |
pip install requests
python examples/strategy_optimizer.pyA single run makes ~1,200-1,500 API calls. At paid rates that's ~$6-8 USDC. The same calculations done by an LLM in-context would cost $12-60 in tokens (Sonnet to Opus), take 4x longer, and get 15-30% of the complex math wrong.
Self-Hosting
# Clone and run locally
git clone https://github.com/QuantOracledev/quantoracle.git
cd quantoracle
pip install fastapi uvicorn
uvicorn api.quantoracle:app --host 0.0.0.0 --port 8000
# Docker
docker compose up -d
# Docs at http://localhost:8000/docsAccuracy
Every endpoint is tested against published analytical solutions:
120 citation-backed benchmarks (Hull, Wilmott, Bailey & Lopez de Prado, Goldman-Sosin-Gatto, Taylor, Fisher, Markowitz)
65+ integration tests covering all 63 calculators
Pure Python math -- no numpy/scipy, zero native dependencies
Deterministic: same inputs always produce the same outputs
Run the verification suite yourself:
python tests/accuracy_benchmarks.py https://api.quantoracle.devArchitecture
quantoracle/
api/quantoracle.py -- FastAPI app, 63 calculators + 11 composites, pure Python math
worker/src/index.ts -- Cloudflare Worker: rate limiting + x402 payments (Base + Solana)
mcp-server/src/index.ts -- MCP server: 80 tools (incl. live data + Watch) over Streamable HTTP
cli/ -- quantoracle-cli: all endpoints in the terminal (npm)
tests/
test_integration.py -- 65 integration tests (all endpoints, live API)
accuracy_benchmarks.py -- 120 citation-backed accuracy testsStack: FastAPI + Pydantic | Cloudflare Workers + KV | MCP (Streamable HTTP) | x402 + CDP Facilitator | USDC on Base and Solana
License
MIT -- use QuantOracle however you want.
Available Tools
74 toolsbacktest_strategyARead-onlyIdempotent
Deterministic backtest of SMA crossover, RSI mean reversion, momentum, or Bollinger breakout. Replaces 10+ individual calls.
Use when backtesting a trading strategy on price history. Strategies: sma_crossover (params: fast, slow), rsi_mean_reversion (params: period, oversold, overbought), momentum (params: lookback), bollinger_breakout (params: period, std). Provide prices, strategy name, params, initial_capital, commission_bps. Returns: total return, Sharpe, Calmar, max drawdown, number of trades, win rate, equity curve, vs buy-and-hold. PAID ONLY — no free tier.
Inputs: prices (required), params, strategy, slippage_bps, +2 more.
batchARead-onlyIdempotent
Execute multiple computations in a single request. Max 100 per batch.
Use when you need to execute multiple computations efficiently. Bundle up to 100 individual endpoint calls into a single request for ~6x throughput improvement. Provide an array of {endpoint, params} objects. Price equals the sum of individual endpoint prices. Ideal for backtests, parameter sweeps, and portfolio-wide calculations.
Inputs: requests (required).
crypto_apy-apr-convertARead-onlyIdempotent
Convert between APY and APR with configurable compounding frequency.
Use when converting between APY and APR with different compounding frequencies. Provide rate and compounding periods. Returns: equivalent APY, APR, daily/weekly/monthly rates, and effective annual rate.
Inputs: rate (required), from_type, compounding.
crypto_dex-slippageARead-onlyIdempotent
DEX slippage estimator for constant-product AMM (x*y=k).
Use when estimating slippage on a DEX trade using constant-product AMM math. Provide trade size and pool reserves. Returns: effective price, price impact percentage, and output amount after slippage.
Inputs: reserve_a (required), reserve_b (required), trade_amount (required), fee_bps, +1 more.
crypto_funding-rateARead-onlyIdempotent
Funding rate analysis with annualization and regime detection.
Use when analyzing perpetual futures funding rates. Provide funding rate, position size, and holding period. Returns: annualized funding cost, projected payments, and carry trade opportunity estimate.
Inputs: funding_rates (required), position_size, payment_interval_hours.
crypto_impermanent-lossARead-onlyIdempotent
Impermanent loss calculator for Uniswap v2/v3 AMM positions.
Use when calculating impermanent loss for a liquidity provider position. Provide initial prices and current prices for two tokens. Returns: impermanent loss percentage, hold value vs LP value, and breakeven price ratios.
Inputs: current_price_ratio (required), amm_type, lower_tick, upper_tick, +2 more.
crypto_liquidation-priceARead-onlyIdempotent
Liquidation price calculator for leveraged positions.
Use when computing the liquidation price for a leveraged position. Provide entry price, leverage, position side, and maintenance margin. Returns: liquidation price, distance to liquidation, and margin call price.
Inputs: leverage (required), direction (required), collateral (required), entry_price (required), +3 more.
crypto_rebalance-thresholdARead-onlyIdempotent
Portfolio rebalance analyzer: drift detection and trade computation.
Use when checking if a crypto portfolio needs rebalancing. Provide target weights and current weights. Returns: whether rebalancing is needed, drift per asset, and trade list to restore targets.
Inputs: holdings (required), min_trade_usd, threshold_pct.
crypto_vesting-scheduleARead-onlyIdempotent
Token vesting schedule with cliff, linear/graded unlock, and TGE.
Use when computing a token vesting schedule with cliff and linear vesting. Provide total tokens, cliff period, vesting duration, and TGE unlock percentage. Returns: period-by-period unlock schedule with cumulative totals.
Inputs: total_tokens (required), tge_pct, start_date, cliff_months, +2 more.
derivatives_asian-optionARead-onlyIdempotent
Asian option pricing: geometric closed-form or arithmetic approximation.
Use when pricing Asian (average-price) options. Provide spot, strike, time, rate, volatility, and averaging type. Returns: option price via geometric closed-form or Turnbull-Wakeman approximation.
Inputs: K (required), S (required), T (required), sigma (required), +5 more.
derivatives_barrier-optionARead-onlyIdempotent
Barrier option pricing using analytical formulas.
Use when pricing knock-in or knock-out barrier options. Provide spot, strike, barrier level, barrier type, and standard option parameters. Returns: barrier option price, vanilla equivalent, and barrier adjustment factors.
Inputs: H (required), K (required), S (required), T (required), +6 more.
derivatives_binomial-treeARead-onlyIdempotent
CRR binomial tree pricing for American and European options.
Use when pricing American or European options via the CRR binomial lattice. Provide spot, strike, time, rate, volatility, steps, and exercise style. Returns: option price, early exercise boundary, and tree node values.
Inputs: K (required), S (required), T (required), sigma (required), +5 more.
derivatives_lookback-optionARead-onlyIdempotent
Lookback option pricing (floating/fixed strike).
Use when pricing lookback options (floating or fixed strike). Provide spot, strike, min/max price, time, rate, and volatility. Returns: lookback option price via Goldman-Sosin-Gatto formulas.
Inputs: S (required), T (required), sigma (required), K, +6 more.
derivatives_option-chain-analysisARead-onlyIdempotent
Option chain analytics: skew, max pain, put-call ratios.
Use when analyzing an options chain for skew, max pain, and put-call ratios. Provide arrays of strikes, calls, puts, and open interest. Returns: max pain strike, put-call ratio, skew metrics, and implied volatility smile data.
Inputs: spot (required), chain (required), T, r.
derivatives_put-call-parityARead-onlyIdempotent
Put-call parity check and arbitrage detection.
Use when checking put-call parity or detecting arbitrage opportunities. Provide call price, put price, spot, strike, rate, and time. Returns: parity check, theoretical values, and any arbitrage amount.
Inputs: K (required), S (required), T (required), put_price (required), +3 more.
derivatives_volatility-surfaceARead-onlyIdempotent
Build implied volatility surface from market data.
Use when constructing an implied volatility surface from market data. Provide arrays of strikes, expiries, and IV values. Returns: interpolated IV surface, skew metrics, term structure, and smile parameters.
Inputs: spot (required), market_data (required), interpolation.
fi_credit-spreadARead-onlyIdempotent
Credit spread and Z-spread from bond price vs risk-free curve.
Use when computing Z-spread and implied default probability from a corporate bond price. Provide bond price, coupon, maturity, and risk-free curve. Returns: Z-spread, option-adjusted spread, implied default probability, and loss-given-default.
Inputs: bond_price (required), coupon_rate (required), maturity_years (required), risk_free_curve (required), +2 more.
fixed-income_amortizationARead-onlyIdempotent
Full amortization schedule with extra payment savings analysis.
Use when generating a loan amortization schedule. Provide principal, annual rate, and term in months. Returns: monthly payment, total interest, and a period-by-period schedule of principal, interest, and remaining balance.
Inputs: years (required), principal (required), annual_rate (required), extra_payment.
fixed-income_bondARead-onlyIdempotent
Bond price, Macaulay/modified duration, convexity, DV01.
Use when pricing a bond or computing yield, duration, and convexity. Provide face value, coupon rate, maturity, and yield or price. Returns: bond price (or yield), Macaulay duration, modified duration, convexity, and accrued interest.
Inputs: ytm (required), years (required), coupon_rate (required), face, +1 more.
fi_yield-curve-interpolateARead-onlyIdempotent
Yield curve interpolation: linear, cubic spline, or Nelson-Siegel.
Use when interpolating a yield curve at arbitrary maturities. Provide observed maturities and yields, plus query maturities. Returns: interpolated yields via linear, cubic spline, or Nelson-Siegel models.
Inputs: rates (required), tenors (required), target_tenors (required), method.
fx_carry-tradeARead-onlyIdempotent
Currency carry trade P&L decomposition.
Use when analyzing carry trade P&L decomposition. Provide high-yield and low-yield rates, entry spot rate, and exit spot rate. Returns: carry return, spot return, total return, and annualized P&L breakdown.
Inputs: spot_exit (required), spot_entry (required), holding_period_days (required), borrow_currency_rate (required), +3 more.
fx_forward-rateARead-onlyIdempotent
Bootstrap forward rates from a spot yield curve.
Use when bootstrapping forward rates from a yield curve. Provide spot rates at various tenors. Returns: implied forward rates between each tenor pair.
Inputs: forward_end (required), yield_curve (required), forward_start (required), compounding.
fx_interest-rate-parityARead-onlyIdempotent
Interest rate parity calculator with arbitrage detection.
Use when computing covered/uncovered interest rate parity for FX pairs. Provide domestic rate, foreign rate, and spot rate. Returns: theoretical forward rate, parity-implied rate, and arbitrage opportunity if any.
Inputs: spot_rate (required), foreign_rate (required), domestic_rate (required), time_years, +2 more.
fx_purchasing-power-parityARead-onlyIdempotent
Purchasing power parity fair value estimation.
Use when estimating fair value of an FX rate using PPP. Provide domestic and foreign price indices and base-period exchange rate. Returns: PPP-implied fair value rate and over/undervaluation percentage.
Inputs: base_spot_rate (required), foreign_inflation (required), domestic_inflation (required), time_years.
hedging_recommendARead-onlyIdempotent
Rank cheapest effective hedges for a given position. Compares protective puts, collars, inverse hedges.
Use when agents need to hedge an existing position. Provide position_type (long_stock/short_stock/long_crypto/long_options), position_value, asset_price, volatility, time_horizon_days, max_hedge_cost_pct. Returns: ranked hedges (protective put, collar, futures short, partial hedge) each with cost, protection level, affordability flag, and max loss after hedge. PAID ONLY — no free tier.
Inputs: volatility (required), asset_price (required), position_type (required), position_value (required), +3 more.
indicators_atrARead-onlyIdempotent
Average True Range with normalized ATR and volatility regime.
Use when measuring volatility via Average True Range. Provide an array of prices. Returns: current ATR, normalized ATR (as % of price), ATR history, and volatility regime classification.
Inputs: low (required), high (required), close (required), period.
indicators_bollinger-bandsARead-onlyIdempotent
Bollinger Bands with %B, bandwidth, and squeeze detection.
Use when computing Bollinger Bands with squeeze detection. Provide prices and optional period/multiplier. Returns: upper/mid/lower bands, %B, bandwidth, squeeze flag, and current position relative to bands.
Inputs: prices (required), window, num_std.
indicators_crossoverARead-onlyIdempotent
Golden/death cross detection with signal history.
Use when detecting moving average crossovers (golden cross, death cross). Provide prices and two MA periods. Returns: current MA values, crossover signals, crossover history, and signal strength.
Inputs: prices (required), fast_period, slow_period.
indicators_fibonacci-retracementARead-onlyIdempotent
Fibonacci retracement and extension levels.
Use when computing Fibonacci retracement and extension levels. Provide a high price and low price. Returns: retracement levels (23.6%, 38.2%, 50%, 61.8%, 78.6%) and extension levels (127.2%, 161.8%, 261.8%).
Inputs: swing_low (required), swing_high (required), direction.
indicators_regimeARead-onlyIdempotent
Trend + volatility regime + composite risk classification.
Use when classifying market regime (trending vs ranging, high vs low volatility). Provide a price series. Returns: trend regime (bullish/bearish/neutral), volatility regime (high/low/normal), and regime change signals.
Inputs: prices (required), sma_period, vol_window.
indicators_regime-classifyARead-onlyIdempotent
Combined regime classification: trend, vol, RSI, direction, strategy suggestion. Replaces technical + regime + realized-vol.
Use when you need a complete market regime assessment combining trend, volatility, RSI, and directional signals. Instead of calling technical + regime + realized-vol separately, this returns everything in one call. Provide closing prices (min 30). Returns: trend direction, volatility regime, RSI, SMA, strategy suggestion (momentum/mean-reversion/risk-off). PAID ONLY — no free tier.
Inputs: closes (required), lows, highs, opens, +3 more.
indicators_technicalARead-onlyIdempotent
13 technical indicators + composite signals.
Use when you need multiple technical indicators computed from a price series. Provide an array of prices and optional volumes. Returns: SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic %K, ATR, ROC, composite signals (overbought/oversold), and trend classification.
Inputs: prices (required), period, volumes.
macro_inflation-adjustedARead-onlyIdempotent
Convert nominal returns to real returns using Fisher equation.
Use when converting nominal returns to real returns using the Fisher equation. Provide nominal rate and inflation rate. Returns: real return, purchasing power change, and cumulative real growth over a period.
Inputs: inflation_rate_pct (required), nominal_return_pct (required), periods, initial_value.
macro_real-yieldARead-onlyIdempotent
Real yield and breakeven inflation from nominal yields.
Use when computing real yield and breakeven inflation. Provide nominal yield and inflation expectation (or TIPS yield). Returns: real yield, breakeven inflation rate, and inflation risk premium estimate.
Inputs: nominal_yield (required), tips_yield, tenor_years, inflation_expectation.
macro_taylor-ruleARead-onlyIdempotent
Taylor Rule interest rate prescription.
Use when estimating the appropriate policy interest rate via the Taylor Rule. Provide inflation, target inflation, output gap, and neutral rate. Returns: Taylor Rule implied rate and deviation from current policy rate.
Inputs: current_inflation (required), output_weight, output_gap_pct, inflation_weight, +3 more.
options_implied-volARead-onlyIdempotent
Newton-Raphson implied volatility solver. Converges in 5-8 iterations.
Use when you know the market price of an option and need to back out the implied volatility. Uses Newton-Raphson iteration. Provide spot, strike, time to expiry, risk-free rate, market price, and option type. Returns: implied volatility, convergence info, and Greeks at that IV.
Inputs: K (required), S (required), T (required), market_price (required), +3 more.
options_payoff-diagramARead-onlyIdempotent
Multi-leg options payoff diagram data generation.
Use when you need payoff/P&L data points for plotting an options strategy. Provide legs with strike, premium, quantity, and type. Returns: array of price/payoff pairs for charting, plus key metrics (breakevens, max profit/loss).
Inputs: legs (required), spot (required), points, price_range_pct.
options_priceARead-onlyIdempotent
Black-Scholes pricing with 10 Greeks (delta through color).
Use when you need to price a European option or compute Greeks (delta, gamma, theta, vega, rho, etc.) using the Black-Scholes model. Provide spot price, strike, time to expiry, risk-free rate, and volatility. Returns: option price, 10 Greeks, and intrinsic/time value breakdown.
Inputs: K (required), S (required), T (required), sigma (required), +3 more.
options_spread-scanARead-onlyIdempotent
Scan and rank vertical spreads by risk/reward. Replaces 8-16 individual options/price calls.
Use when you need to evaluate and rank multiple vertical spread candidates at once. Instead of calling options/price 8-16 times, this scans all strike combinations in one call. Provide spot price, volatility, DTE, and strategy type (bull_call_spread, bear_put_spread, etc.). Returns: ranked candidates with risk/reward ratios, breakevens, and full Greeks for each leg. PAID ONLY — no free tier.
Inputs: vol (required), spot (required), dte_years (required), q, +4 more.
options_strategyARead-onlyIdempotent
Multi-leg options strategy P&L, breakevens, max profit/loss, risk/reward.
Use when analyzing a multi-leg options strategy (spreads, straddles, iron condors, etc.). Provide an array of legs with strike, premium, quantity, and type. Returns: net premium, max profit/loss, breakeven points, P&L at various prices, and payoff data.
Inputs: legs (required), points, S_range.
options_strategy-optimizerARead-onlyIdempotent
Rank top options strategies given market outlook + volatility view. Returns P&L, breakevens, max profit/loss for each.
Use when agents need to pick the best options strategy given a market outlook. Provide spot price, outlook (bullish/bearish/neutral), vol_view (rising/falling/stable), T, sigma, r. Returns: ranked list of strategies (Long Call, Bull Call Spread, Iron Condor, Long Straddle, etc.) each with legs, max profit/loss, breakevens, net debit/credit, and score. PAID ONLY — no free tier.
Inputs: S (required), T (required), sigma (required), outlook (required), +4 more.
pairs_signalARead-onlyIdempotent
Complete pairs trading signal: cointegration, Hurst, z-score, half-life, hedge ratio. Replaces 4 individual calls.
Use when analyzing a pairs trading opportunity. Combines cointegration testing, Hurst exponent, z-score analysis, half-life estimation, and trade signal generation in one call. Provide two price series. Returns: cointegration result, hedge ratio, spread z-score, Hurst, and actionable signal (LONG/SHORT/WAIT/CLOSE/NO_TRADE). PAID ONLY — no free tier.
Inputs: series_a (required), series_b (required), name_a, name_b, +1 more.
portfolio_healthARead-onlyIdempotent
Full portfolio health check: risk metrics, correlation, drawdown, rebalance, stress test. Replaces 6 individual calls.
Use when you need a complete portfolio health check. Combines risk metrics, correlation matrix, drawdown analysis, rebalance detection, and stress testing (2008 Crisis, Rate Hike, Flash Crash) in one call. Provide holdings with values, target weights, and return series. Returns: Sharpe, VaR, drawdown, correlation matrix, rebalance trades, and stress test P&L. PAID ONLY — no free tier.
Inputs: holdings (required), min_trade_usd, risk_free_rate, rebalance_threshold_pct.
portfolio_optimizeARead-onlyIdempotent
Portfolio optimization: max Sharpe, min vol, or risk parity weights.
Use when optimizing portfolio weights for max Sharpe, min volatility, or risk parity. Provide expected returns and a covariance matrix. Returns: optimal weights, expected return, volatility, Sharpe ratio, and efficient frontier points.
Inputs: returns (required), mode, risk_free_rate.
portfolio_rebalance-planARead-onlyIdempotent
Generate trade list to rebalance from current holdings to target weights with transaction cost estimate.
Use when generating the exact trades needed to rebalance a portfolio from current holdings to target weights. Provide current_holdings (asset -> USD value), target_weights (asset -> weight, sum to 1), transaction_cost_bps. Returns: list of trades (buy/sell with amounts), total cost, drift before/after, and post-rebalance weights. PAID ONLY — no free tier.
Inputs: target_weights (required), current_holdings (required), min_trade_usd, transaction_cost_bps.
portfolio_risk-parity-weightsBRead-onlyIdempotent
Equal risk contribution portfolio weights.
Use when computing equal risk contribution (risk parity) portfolio weights. Provide a covariance matrix. Returns: risk parity weights and each asset's contribution to total portfolio risk.
Inputs: volatilities (required), correlation_matrix (required), asset_names, risk_budget.
risk_correlationARead-onlyIdempotent
N x N correlation and covariance matrices from return series.
Use when computing an N×N correlation matrix for multiple assets. Provide a 2D array of return series. Returns: Pearson correlation matrix, covariance matrix, and eigenvalues for PCA analysis.
Inputs: series (required).
risk_drawdownARead-onlyIdempotent
Drawdown decomposition with underwater curve.
Use when analyzing drawdown characteristics of a return series. Provide an array of returns. Returns: max drawdown, drawdown duration, recovery time, current drawdown, and all drawdown periods with start/end indices.
Inputs: equity_curve (required).
risk_full-analysisARead-onlyIdempotent
Complete risk tearsheet: Sharpe, Sortino, VaR, Kelly, drawdown, Hurst, CAGR. Replaces 7 individual calls.
Use when you need a complete risk tearsheet for a return series. Instead of calling 7 individual risk/stats endpoints, this returns Sharpe, Sortino, Calmar, VaR, CVaR, Kelly, max drawdown, Hurst exponent, CAGR, and win rate in one call. Provide daily returns. Returns: comprehensive risk profile with portfolio values. PAID ONLY — no free tier.
Inputs: returns (required), equity_curve, risk_free_rate, portfolio_value.
risk_kellyARead-onlyIdempotent
Kelly Criterion: discrete (win/loss) or continuous (returns series) mode.
Use when determining optimal bet/position sizing using the Kelly Criterion. Provide win probability and win/loss ratio. Returns: full Kelly fraction, half-Kelly, quarter-Kelly, and expected growth rate.
Inputs: mode, avg_win, returns, avg_loss, +1 more.
risk_portfolioARead-onlyIdempotent
22 risk metrics: Sharpe, Sortino, Calmar, Omega, VaR, CVaR, drawdown, skew, kurtosis.
Use when you have a series of portfolio returns and need comprehensive risk analytics. Provide an array of periodic returns (e.g. daily). Returns: 22 metrics including Sharpe, Sortino, Calmar, Omega, VaR (95/99), CVaR, max drawdown, skewness, kurtosis, win rate, profit factor. Optionally provide benchmark returns for alpha, beta, tracking error, and information ratio.
Inputs: returns (required), risk_free_rate, benchmark_returns.
risk_position-sizeARead-onlyIdempotent
Fixed fractional position sizing with risk/reward targets.
Use when calculating how many shares/contracts to buy given account size and risk tolerance. Provide account value, risk percentage, entry price, and stop-loss price. Returns: position size, dollar risk, and shares to trade.
Inputs: stop_loss (required), entry_price (required), account_size (required), risk_per_trade.
risk_stress-testARead-onlyIdempotent
Portfolio stress test across multiple scenarios.
Use when stress-testing a portfolio against multiple scenarios. Provide portfolio weights, asset returns, and scenario definitions (e.g. market crash, rate hike). Returns: portfolio P&L under each scenario with component-level breakdown.
Inputs: positions (required), scenarios (required).
risk_transaction-costARead-onlyIdempotent
Transaction cost model: commission + spread + market impact estimation.
Use when estimating total transaction costs including commissions, spread, and market impact. Provide trade size, price, spread, and commission structure. Returns: total cost, cost breakdown, and cost as percentage of trade value.
Inputs: trade_value (required), adv, shares, spread_bps, +5 more.
risk_var-parametricARead-onlyIdempotent
Parametric Value-at-Risk and Conditional VaR.
Use when computing Value-at-Risk and Conditional VaR using parametric methods. Provide returns and confidence level. Returns: VaR, CVaR, and distribution parameters under normal or Student-t assumptions.
Inputs: returns (required), portfolio_value, confidence_levels, holding_period_days.
simulate_montecarloARead-onlyIdempotent
GBM Monte Carlo with contributions/withdrawals. Up to 5000 paths.
Use when running a Monte Carlo simulation for asset price paths. Provide starting price, drift, volatility, time horizon, and number of simulations. Returns: simulated terminal prices, percentile distribution (5th/25th/50th/75th/95th), expected value, probability of profit, and path statistics. NOTE: Via MCP, keep simulations ≤ 1000 and years ≤ 30 for fastest response. For larger simulations (up to 5000 paths, 100 years), call the REST API directly at https://api.quantoracle.dev/v1/simulate/montecarlo.
Inputs: years, annual_vol, simulations, annual_return, +3 more.
stats_cointegrationARead-onlyIdempotent
Engle-Granger cointegration test with hedge ratio and half-life.
Use when testing if two time series are cointegrated (mean-reverting pair). Provide two price series. Returns: Engle-Granger test statistic, p-value, critical values, hedge ratio, and spread series.
Inputs: series_x (required), series_y (required), significance.
stats_correlation-matrixARead-onlyIdempotent
Correlation and covariance matrices with optional eigenvalue decomposition.
Use when computing a correlation matrix with eigenvalue decomposition for multiple assets. Provide a 2D array of return series. Returns: Pearson and Spearman correlation matrices, eigenvalues, eigenvectors, and explained variance ratios.
Inputs: series (required), method, include_eigenvalues.
stats_distribution-fitARead-onlyIdempotent
Fit data to common distributions and rank by goodness of fit.
Use when fitting data to standard distributions (normal, lognormal, uniform). Provide a data array. Returns: best-fit distribution, parameters (mean, std, etc.), goodness-of-fit statistics (KS test, chi-squared), and Q-Q plot data.
Inputs: data (required).
stats_garch-forecastARead-onlyIdempotent
GARCH(1,1) volatility forecast using maximum likelihood estimation.
Use when forecasting future volatility using a GARCH(1,1) model. Provide a return series. Returns: GARCH parameters (omega, alpha, beta), current conditional volatility, and multi-step ahead volatility forecasts.
Inputs: returns (required), mean_model, forecast_periods.
stats_hurst-exponentARead-onlyIdempotent
Hurst exponent via rescaled range (R/S) analysis.
Use when determining if a time series is mean-reverting (H<0.5), random walk (H=0.5), or trending (H>0.5). Provide a price or return series. Returns: Hurst exponent via R/S analysis, classification, and confidence.
Inputs: series (required), max_window, min_window.
stats_linear-regressionARead-onlyIdempotent
OLS linear regression with R-squared, t-stats, and standard errors.
Use when fitting a linear regression (OLS). Provide x and y arrays. Returns: slope, intercept, R², adjusted R², t-statistics, p-values, standard errors, confidence intervals, and residuals.
Inputs: x (required), y (required), confidence_level.
stats_normal-distributionARead-onlyIdempotent
Normal distribution: CDF, PDF, quantile, and confidence intervals.
Use when computing normal distribution CDF, PDF, quantiles, or confidence intervals. Provide x (for CDF/PDF), p (for quantile), or confidence_level (for interval), with optional mean and std. Returns: CDF probability, PDF density, z-score, quantile value, and/or confidence interval bounds.
Inputs: p, x, std, mean, +1 more.
stats_polynomial-regressionARead-onlyIdempotent
Polynomial regression of degree n with goodness-of-fit metrics.
Use when fitting a polynomial of degree n to data. Provide x, y arrays, and degree. Returns: coefficients, R², fitted values, and residuals.
Inputs: x (required), y (required), degree.
stats_probabilistic-sharpeARead-onlyIdempotent
Probabilistic Sharpe Ratio — is the observed Sharpe statistically significant? Based on Bailey & Lopez de Prado (2012).
Use when testing whether a Sharpe ratio is statistically significant. Provide returns and a benchmark Sharpe. Returns: probabilistic Sharpe ratio (probability observed Sharpe exceeds benchmark), p-value, and required track record length.
Inputs: returns (required), risk_free_rate, benchmark_sharpe, annualization_factor.
stats_realized-volatilityARead-onlyIdempotent
Realized volatility: close-to-close, Parkinson, Garman-Klass, Yang-Zhang from OHLC.
Use when computing historical/realized volatility from a return series. Provide returns and optional annualization factor. Returns: realized volatility (close-to-close), annualized vol, and rolling vol series.
Inputs: close (required), low, high, open, +1 more.
stats_sharpe-ratioARead-onlyIdempotent
Standalone Sharpe ratio from a returns series.
Use when computing the Sharpe ratio from a return series. Provide returns and risk-free rate. Returns: annualized Sharpe ratio, annualized return, annualized volatility, and risk-adjusted metrics.
Inputs: returns (required), risk_free_rate, annualization_factor.
stats_zscoreARead-onlyIdempotent
Rolling and static z-scores with extreme value detection.
Use when computing z-scores for statistical analysis or detecting extremes. Provide a value or array and reference statistics. Returns: z-scores, mean, standard deviation, and flags for values beyond 2σ or 3σ.
Inputs: series (required), window, threshold.
trade_evaluateARead-onlyIdempotent
Complete trade evaluation: sizing, risk/reward, Kelly, costs, regime, signals. Replaces 5 individual calls.
Use when evaluating whether to take a specific trade. Combines position sizing, risk/reward analysis, transaction cost estimation, regime detection, and technical signals into a single go/no-go verdict. Provide entry/stop/target prices, account size, and recent price history. Returns: position size, costs, signals, regime, Kelly sizing, and FAVORABLE/CAUTION/UNFAVORABLE verdict. PAID ONLY — no free tier.
Inputs: prices (required), stop_loss (required), entry_price (required), take_profit (required), +6 more.
tvm_cagrARead-onlyIdempotent
Compound Annual Growth Rate with optional forward projections.
Use when computing compound annual growth rate. Provide beginning value, ending value, and number of years. Returns: CAGR (decimal), total return, and equivalent annual return.
Inputs: years (required), end_value (required), start_value (required), include_projections.
tvm_future-valueARead-onlyIdempotent
Future value of a present lump sum and/or annuity stream.
Use when computing the future value of a present sum. Provide present value, interest rate, and number of periods. Returns: future value, total interest earned, and growth factor.
Inputs: rate (required), periods (required), payment, present_value, +1 more.
tvm_irrARead-onlyIdempotent
Internal rate of return via Newton-Raphson. First cash flow is typically negative (investment).
Use when computing the internal rate of return for a cash flow series. Provide an array of cash flows. Returns: IRR (decimal), annualized IRR, and NPV at the computed IRR (should be ~0).
Inputs: cash_flows (required).
tvm_npvARead-onlyIdempotent
Net present value of a cash flow series at a given discount rate.
Use when computing net present value of a series of cash flows. Provide discount rate and an array of cash flows (first is typically negative for initial investment). Returns: NPV, profitability index, and discounted cash flow breakdown.
Inputs: cash_flows (required), discount_rate (required).
tvm_present-valueARead-onlyIdempotent
Present value of a future lump sum and/or annuity stream.
Use when computing the present value of a future cash flow. Provide future value, discount rate, and number of periods. Returns: present value and discount factor.
Inputs: rate (required), periods (required), payment, future_value, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 74 tools
The tools are grouped by domain but some have overlapping functionalities, such as indicators_regime and indicators_regime-classify, and risk_portfolio vs risk_full-analysis. The presence of consolidated 'replaces' tools alongside individual ones can confuse an agent about which to use.
Tool names follow a domain_prefix_descriptive pattern, but there is some inconsistency with hyphens vs underscores (e.g., crypto_apy-apr-convert, options_implied-vol) and varied lengths. Overall, the pattern is clear and predictable.
With 74 tools, the count is very high for an MCP server. While each tool serves a distinct purpose in quantitative finance, the sheer number makes it difficult for an agent to efficiently navigate and select the right tool.
The server covers a comprehensive range of quantitative finance computations including options, risk, portfolio, technical indicators, fixed income, FX, crypto, and statistics. It addresses common and advanced needs, with few obvious gaps for the intended domain.
Maintenance
Related MCP Connectors
443 finance tools, 60 prompts: quant, SEC and EU filings, fact checks, rates, odds, DeFi, macro.
Deterministic options, forex, risk, on-chain & futures math. Not AI estimates. Tools: tradingcalc.io
53 tools: token prices, wallet and contract risk, liquidity pools, FX. 10 free calls.
Crypto market signals and portfolio telemetry. 6 tools pay-per-call in USDC, no API key.
Related MCP Servers
- AlicenseAqualityDmaintenanceFinancial intelligence for AI agents. 31 tools across 8 data sources — regime, derivatives, stablecoin flows, momentum, volatility, macro, DeFi, weather patterns, political cycles, seasonality. The context layer between your agent and a bad trade.319 npm9MIT
- AlicenseAqualityDmaintenanceAgent-ready financial intelligence tools for AI agents. Two curated tools — get_stock_snapshot and get_company_metrics — that combine multiple data sources, derive signals (UNDERVALUED, STRONG, ACCELERATING), and pre-compute the math. One call, one agent-friendly response.3140 npm1MIT
- AlicenseAqualityCmaintenanceEnables AI agents to call deterministic finance and quant APIs (e.g., DCF, Black-Scholes, bond pricing) with per-call payments over x402, no API keys required.52MIT
- AlicenseNot gradedqualityDmaintenanceThe verifiable risk engine for autonomous agents: deterministic, self-verifying financial calculations that an agent can delegate and prove. It covers liquidation and funding, position sizing and risk of ruin, options Greeks and margin, LP divergence, treasury concentration and depeg, execution quality checks, plus intelligence on options, DeFi, prediction markets, and transaction safety analysis.2MIT