QuantOracle API

73 deterministic quant finance endpoints plus a /batch endpoint that bundles up to 100 of them in a single HTTP roundtrip. The same engine that powers the calculators on this site is available as a JSON API for your own applications.

Quick start

No signup, no API key for the first 1,000 calls per IP per day. Just POST JSON.

curl -X POST https://api.quantoracle.dev/v1/options/price \
  -H "Content-Type: application/json" \
  -d '{"S":100,"K":100,"T":0.25,"r":0.05,"sigma":0.2,"type":"call"}'

# → {"price":4.615,"breakeven":104.615,"prob_itm":0.5299,
#    "greeks":{"delta":0.569,"gamma":0.039,"vega":0.196,
#              "theta":-0.029,"rho":0.131}, ...}

Endpoint catalog

See the full machine-readable spec at /openapi.json or the human-readable docs at /tools. Categories include:

• Options pricing — Black-Scholes, implied vol, payoff diagrams, multi-leg strategies
• Derivatives — binomial trees, barrier, Asian, lookback, volatility surface
• Risk metrics — Sharpe, Sortino, VaR, CVaR, drawdown, Kelly, position sizing
• Portfolio — mean-variance optimization, risk parity, rebalancing, health scoring
• Statistics — regression, cointegration, Hurst, GARCH, distribution fits
• Crypto / DeFi — impermanent loss, liquidation price, funding rate, DEX slippage
• FX — interest rate parity, PPP, carry trade, forwards
• Macro / TVM — Taylor Rule, real yield, NPV, IRR, CAGR
• Composite workflows — backtest, hedging recommendations, full risk analysis, rebalance planning
• Batch — /v1/batch wraps up to 100 sub-requests (any mix of the above) into a single HTTP call, returning all results in one response. Charged as the sum of the component endpoint prices, but settled in one x402 transaction with one round trip.
• QuantOracle Live (new) — /v1/live/volatility and /v1/live/funding-rates are the one tier that brings the data: we fetch fresh crypto market data and run the math, so your agent gets a computed answer (realized vol across 7/30/90d + regime; annualized funding carry) without sourcing or maintaining a data feed itself. A separate paid tier — 20 free calls/IP/day, then pay-per-call via x402.
• QuantOracle Watch (new) — 24/7 position monitoring: register a crypto perp position once (/v1/watch/position) and an isolated watcher re-evaluates it every 60s — funding-adjusted liquidation distance, funding flips, vol-regime changes — firing HMAC-signed webhooks. Free 48h trial (/v1/watch/trial) works by polling alone; $5 per position per 30 days via x402.

Pricing

• Free tier: 1,000 calls per IP per day across the 63 calculator endpoints, no signup, no API key. Composite workflows and /v1/batch are paid-only.
• Pay-per-call (x402): $0.002–$0.10 per individual endpoint depending on complexity. Settled in USDC on Base or Solana via the x402 protocol — your client wallet pays automatically when you exceed the free tier.
• Batch: /v1/batch sums the prices of the included sub-requests. A batch of 50 Black-Scholes calls ($0.005 × 50 = $0.25) costs the same as 50 individual calls, but you save 49 HTTP roundtrips and settle in one x402 transaction. Designed for agents that need many computations at once.
• QuantOracle Live: /v1/live/* is paid (it fetches fresh market data, not part of the 1,000/day calculator tier). 20 free calls per IP per day, then $0.005–$0.01/call via x402. You pay for the freshness, not the math.
• QuantOracle Watch: 24/7 position monitoring is priced per monitor, not per call — $5 per position per 30 days via x402, with a free 48-hour trial (one per IP per 30 days). Status and cancel endpoints are free.
• High-volume / enterprise: for flat-rate billing, an API key, an SLA, or a higher rate limit, open an issue at github.com/QuantOracledev/quantoracle with your expected volume and we'll size a plan.

SDKs and integrations

• Python (LangChain): pip install langchain-quantoracle
• MCP server: npx quantoracle-mcp
• A2A AgentCard: /.well-known/agent-card.json — 73 skills, schema v0.2
• OpenAPI spec: /openapi.json