Skip to main content
Glama

Try it without writing code

12 free interactive calculators backed by the same API are live at quantoracle.dev — no signup, no API key:


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:

Open in Colab integrations/langchain/cookbook/quantoracle_risk_analyst.ipynb

QuantOracle × LangChain hedging composite

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

https://api.quantoracle.dev/openapi.json

Tool listing

https://api.quantoracle.dev/tools

MCP endpoint

npx quantoracle-mcp

AI Plugin

https://api.quantoracle.dev/.well-known/ai-plugin.json

Server card

https://mcp.quantoracle.dev/.well-known/mcp/server-card.json

Swagger docs

https://api.quantoracle.dev/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 10

TypeScript

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-cli

Or 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 help

Free 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:00Z

Check usage anytime:

curl https://api.quantoracle.dev/usage

After 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

POST /v1/live/volatility

Realized volatility (7d/30d/90d) + regime for a crypto asset, from fresh daily candles

$0.01

POST /v1/live/funding-rates

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

POST /v1/watch/trial

Free 48-hour monitor — one per IP per 30 days

Free

POST /v1/watch/position

Register a position for 30 days of monitoring

$5.00

POST /v1/watch/extend

+30 days (also upgrades a trial; body: {monitor_id, token})

$5.00

PATCH /v1/watch/{id}

Update position params after you add margin / resize / move it

Free

GET /v1/watch/{id}

Live status + alert history (token auth)

Free

DELETE /v1/watch/{id}

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:

  1. Agent calls endpoint, gets 402 with PAYMENT-REQUIRED header listing accepted networks

  2. Agent signs a gasless USDC transfer authorization on Base (EIP-3009) or Solana

  3. Agent resends request with PAYMENT-SIGNATURE header

  4. Server 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 (eip155:8453)

USDC (0x8335...)

~$0.005/tx

EVM agents, Coinbase tooling, LangChain, Base ecosystem

Solana mainnet (solana:5eykt4...)

USDC (EPjFWdd5...)

~$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: 0xC94f5F33ae446a50Ce31157db81253BfddFE2af6

  • Solana wallet: 9biztrXscReJ3Wi8EfkD2gL3WXzYUmzTEohD26Bxp39u

  • Discovery: 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-mcp

Claude 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/mcp

Smithery

npx @smithery/cli mcp add https://server.smithery.ai/QuantOracle/quantoracle

OpenClaw / ClawHub

clawhub install quantoracle

Integrations

QuantOracle is available across multiple agent ecosystems:

Platform

How to connect

Claude Desktop / Claude Code

Connector URL: https://mcp.quantoracle.dev/mcp

Cursor / Windsurf

MCP config: npx quantoracle-mcp

Smithery

npx @smithery/cli mcp add QuantOracle/quantoracle

OpenClaw / ClawHub

clawhub install quantoracle

CLI

npm install -g quantoracle-cli or npx quantoracle-cli

Glama

glama.ai/mcp/servers/QuantOracledev/quantoracle

npm (MCP)

npx quantoracle-mcp

x402 ecosystem

x402.org/ecosystem

ChatGPT GPT

QuantOracle GPT

LangChain

pip install langchain-quantoracle

AgentCash

npx agentcash fetch https://api.quantoracle.dev/v1/...

x402scan

Server page — Base + Solana

REST API

https://api.quantoracle.dev/v1/...

OpenAPI spec

https://api.quantoracle.dev/openapi.json

Swagger UI

https://api.quantoracle.dev/docs

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.json

Full Endpoint Reference

Options (4 endpoints)

Endpoint

Description

Price

POST /v1/options/price

Black-Scholes pricing with 10 Greeks (delta through color)

$0.005

POST /v1/options/implied-vol

Newton-Raphson implied volatility solver

$0.005

POST /v1/options/strategy

Multi-leg options strategy P&L, breakevens, max profit/loss

$0.008

POST /v1/options/payoff-diagram

Multi-leg options payoff diagram data generation

$0.005

Derivatives (7 endpoints)

Endpoint

Description

Price

POST /v1/derivatives/binomial-tree

CRR binomial tree pricing for American and European options

$0.008

POST /v1/derivatives/barrier-option

Barrier option pricing using analytical formulas

$0.008

POST /v1/derivatives/asian-option

Asian option pricing: geometric closed-form or arithmetic approximation

$0.008

POST /v1/derivatives/lookback-option

Lookback option pricing (floating/fixed strike, Goldman-Sosin-Gatto)

$0.008

POST /v1/derivatives/option-chain-analysis

Option chain analytics: skew, max pain, put-call ratios

$0.015

POST /v1/derivatives/put-call-parity

Put-call parity check and arbitrage detection

$0.002

POST /v1/derivatives/volatility-surface

Build implied volatility surface from market data

$0.015

Risk (8 endpoints)

Endpoint

Description

Price

POST /v1/risk/portfolio

22 risk metrics: Sharpe, Sortino, Calmar, Omega, VaR, CVaR, drawdown

$0.008

POST /v1/risk/kelly

Kelly Criterion: discrete (win/loss) or continuous (returns series)

$0.005

POST /v1/risk/position-size

Fixed fractional position sizing with risk/reward targets

$0.005

POST /v1/risk/drawdown

Drawdown decomposition with underwater curve

$0.005

POST /v1/risk/correlation

N x N correlation and covariance matrices from return series

$0.008

POST /v1/risk/var-parametric

Parametric Value-at-Risk and Conditional VaR

$0.008

POST /v1/risk/stress-test

Portfolio stress test across multiple scenarios

$0.008

POST /v1/risk/transaction-cost

Transaction cost model: commission + spread + Almgren market impact

$0.005

Indicators (6 endpoints)

Endpoint

Description

Price

POST /v1/indicators/technical

13 technical indicators (SMA, EMA, RSI, MACD, etc.) + composite signals

$0.005

POST /v1/indicators/regime

Trend + volatility regime + composite risk classification

$0.005

POST /v1/indicators/crossover

Golden/death cross detection with signal history

$0.005

POST /v1/indicators/bollinger-bands

Bollinger Bands with %B, bandwidth, and squeeze detection

$0.002

POST /v1/indicators/fibonacci-retracement

Fibonacci retracement and extension levels

$0.002

POST /v1/indicators/atr

Average True Range with normalized ATR and volatility regime

$0.002

Statistics (12 endpoints)

Endpoint

Description

Price

POST /v1/stats/linear-regression

OLS linear regression with R-squared, t-stats, standard errors

$0.008

POST /v1/stats/polynomial-regression

Polynomial regression of degree n with goodness-of-fit metrics

$0.008

POST /v1/stats/cointegration

Engle-Granger cointegration test with hedge ratio and half-life

$0.008

POST /v1/stats/hurst-exponent

Hurst exponent via rescaled range (R/S) analysis

$0.008

POST /v1/stats/garch-forecast

GARCH(1,1) volatility forecast using maximum likelihood estimation

$0.015

POST /v1/stats/zscore

Rolling and static z-scores with extreme value detection

$0.002

POST /v1/stats/distribution-fit

Fit data to common distributions and rank by goodness of fit

$0.008

POST /v1/stats/correlation-matrix

Correlation and covariance matrices with eigenvalue decomposition

$0.015

POST /v1/stats/realized-volatility

Realized vol: close-to-close, Parkinson, Garman-Klass, Yang-Zhang

$0.005

POST /v1/stats/normal-distribution

Normal distribution: CDF, PDF, quantile, confidence intervals

$0.002

POST /v1/stats/sharpe-ratio

Standalone Sharpe ratio with Lo (2002) standard error and 95% CI

$0.002

POST /v1/stats/probabilistic-sharpe

Probabilistic Sharpe Ratio (Bailey & Lopez de Prado 2012)

$0.005

Portfolio (2 endpoints)

Endpoint

Description

Price

POST /v1/portfolio/optimize

Portfolio optimization: max Sharpe, min vol, or risk parity

$0.015

POST /v1/portfolio/risk-parity-weights

Equal risk contribution portfolio weights (Spinu 2013)

$0.008

Fixed Income (4 endpoints)

Endpoint

Description

Price

POST /v1/fixed-income/bond

Bond price, Macaulay/modified duration, convexity, DV01

$0.008

POST /v1/fixed-income/amortization

Full amortization schedule with extra payment savings analysis

$0.005

POST /v1/fi/yield-curve-interpolate

Yield curve interpolation: linear, cubic spline, Nelson-Siegel

$0.015

POST /v1/fi/credit-spread

Credit spread and Z-spread from bond price vs risk-free curve

$0.008

Crypto / DeFi (7 endpoints)

Endpoint

Description

Price

POST /v1/crypto/impermanent-loss

Impermanent loss calculator for Uniswap v2/v3 AMM positions

$0.005

POST /v1/crypto/apy-apr-convert

Convert between APY and APR with configurable compounding

$0.002

POST /v1/crypto/liquidation-price

Liquidation price calculator for leveraged positions

$0.002

POST /v1/crypto/funding-rate

Funding rate analysis with annualization and regime detection

$0.005

POST /v1/crypto/dex-slippage

DEX slippage estimator for constant-product AMM (x*y=k)

$0.005

POST /v1/crypto/vesting-schedule

Token vesting schedule with cliff, linear/graded unlock, TGE

$0.005

POST /v1/crypto/rebalance-threshold

Portfolio rebalance analyzer: drift detection and trade sizing

$0.005

Live Data (2 endpoints) — paid tier, fresh market data

Endpoint

Description

Price

POST /v1/live/volatility

Live realized volatility (7d/30d/90d) + regime for a crypto asset

$0.01

POST /v1/live/funding-rates

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

POST /v1/watch/trial

Free 48-hour trial monitor (one per IP per 30 days)

Free

POST /v1/watch/position

24/7 monitoring of a perp position for 30 days

$5.00

POST /v1/watch/extend

Extend or upgrade a monitor by 30 days

$5.00

PATCH /v1/watch/{id}

Update position params (direction/entry/size/collateral/mmr/webhook/thresholds)

Free

GET /v1/watch/{id}

Live status + alert history (token auth)

Free

DELETE /v1/watch/{id}

Cancel a monitor

Free

Priced per monitor, not per call. See QuantOracle Watch.

FX / Macro (7 endpoints)

Endpoint

Description

Price

POST /v1/fx/interest-rate-parity

Interest rate parity calculator with arbitrage detection

$0.005

POST /v1/fx/purchasing-power-parity

Purchasing power parity fair value estimation

$0.005

POST /v1/fx/forward-rate

Bootstrap forward rates from a spot yield curve

$0.005

POST /v1/fx/carry-trade

Currency carry trade P&L decomposition

$0.005

POST /v1/macro/inflation-adjusted

Nominal to real returns using Fisher equation

$0.002

POST /v1/macro/taylor-rule

Taylor Rule interest rate prescription

$0.002

POST /v1/macro/real-yield

Real yield and breakeven inflation from nominal yields

$0.002

Time Value of Money (5 endpoints)

Endpoint

Description

Price

POST /v1/tvm/present-value

Present value of a future lump sum and/or annuity stream

$0.002

POST /v1/tvm/future-value

Future value of a present lump sum and/or annuity stream

$0.002

POST /v1/tvm/irr

Internal rate of return via Newton-Raphson

$0.005

POST /v1/tvm/npv

Net present value with profitability index and payback period

$0.002

POST /v1/tvm/cagr

Compound annual growth rate with forward projections

$0.002

Simulation (1 endpoint)

Endpoint

Description

Price

POST /v1/simulate/montecarlo

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

POST /v1/backtest/strategy

Run SMA crossover, RSI mean reversion, momentum, or Bollinger breakout backtest

10+ indicator + risk calls

$0.10

POST /v1/options/spread-scan

Scan and rank vertical spreads by risk/reward

8-16 options/price calls

$0.05

POST /v1/portfolio/rebalance-plan

Generate trade list to hit target weights with cost estimate

portfolio/optimize + transaction-cost

$0.05

POST /v1/options/strategy-optimizer

Rank top options strategies given outlook + volatility view

options/strategy + payoff-diagram

$0.08

POST /v1/hedging/recommend

Rank cheapest effective hedges (protective put, collar, futures, partial)

options/price + Greeks

$0.04

POST /v1/risk/full-analysis

Complete risk tearsheet: Sharpe, Sortino, VaR, Kelly, drawdown, Hurst, CAGR

7 individual calls

$0.04

POST /v1/portfolio/health

Portfolio health check: risk, correlation, rebalance, stress test

6 individual calls

$0.04

POST /v1/trade/evaluate

Trade evaluation: sizing, risk/reward, Kelly, costs, regime, signals, verdict

5 individual calls

$0.025

POST /v1/pairs/signal

Pairs trading signal: cointegration, Hurst, z-score, half-life, hedge ratio

4 individual calls

$0.025

POST /v1/indicators/regime-classify

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 curve

Each 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.py

A 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/docs

Accuracy

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.dev

Architecture

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 tests

Stack: 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 tools
backtest_strategyA
Read-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.

batchA
Read-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-convertA
Read-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-slippageA
Read-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-rateA
Read-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-lossA
Read-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-priceA
Read-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-thresholdA
Read-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-scheduleA
Read-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-optionA
Read-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-optionA
Read-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-treeA
Read-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-optionA
Read-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-analysisA
Read-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-parityA
Read-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-surfaceA
Read-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-spreadA
Read-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_amortizationA
Read-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_bondA
Read-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-interpolateA
Read-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-tradeA
Read-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-rateA
Read-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-parityA
Read-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-parityA
Read-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_recommendA
Read-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_atrA
Read-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-bandsA
Read-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_crossoverA
Read-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-retracementA
Read-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_regimeA
Read-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-classifyA
Read-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_technicalA
Read-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-adjustedA
Read-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-yieldA
Read-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-ruleA
Read-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-volA
Read-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-diagramA
Read-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_priceA
Read-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-scanA
Read-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_strategyA
Read-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-optimizerA
Read-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_signalA
Read-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_healthA
Read-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_optimizeA
Read-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-planA
Read-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-weightsB
Read-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_correlationA
Read-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_drawdownA
Read-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-analysisA
Read-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_kellyA
Read-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_portfolioA
Read-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-sizeA
Read-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-testA
Read-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-costA
Read-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-parametricA
Read-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_montecarloA
Read-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_cointegrationA
Read-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-matrixA
Read-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-fitA
Read-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-forecastA
Read-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-exponentA
Read-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-regressionA
Read-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-distributionA
Read-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-regressionA
Read-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-sharpeA
Read-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-volatilityA
Read-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-ratioA
Read-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_zscoreA
Read-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_evaluateA
Read-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_cagrA
Read-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-valueA
Read-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_irrA
Read-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_npvA
Read-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-valueA
Read-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

    A3.7/5.0

    Scored across 74 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessUsually handled

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Financial 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.
      31
      9 npm
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Agent-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.
      3
      140 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      The 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.
      2
      MIT