QuantOracle

63 ferramentas determinísticas de computação quant para agentes financeiros autônomos. Precificação de opções, derivativos, risco, otimização de portfólio, estatísticas, cripto/DeFi, macro/FX. 1.000 chamadas gratuitas/dia, sem cadastro.

Documentação

QuantOracle

A API de computação quantitativa para agentes financeiros autônomos

63 calculadoras determinísticas verificadas por citações + 10 fluxos de trabalho compostos. 1.000 chamadas gratuitas/dia. Pague por chamada na Base ou Solana.

npm Smithery ClawHub Glama CLI x402 MIT License

Calculadoras  |  CLI  |  Servidor MCP  |  Pagamentos x402  |  Plano Gratuito  |  Todos os Endpoints  |  Integrações


Experimente sem escrever código

12 calculadoras interativas gratuitas com suporte da mesma API estão disponíveis em quantoracle.dev — sem cadastro, sem chave de API:


Por que QuantOracle?

Todo agente financeiro precisa de matemática. QuantOracle é essa matemática.

  • 63 calculadoras puras em opções, derivativos, risco, portfólio, estatística, cripto/DeFi, FX/macroeconomia e TVM
  • 10 fluxos de trabalho compostos que agrupam 5-15 chamadas de calculadora (backtest de estratégias, planejamento de rebalanceamento, seleção de estratégia de opções, recomendações de hedge, análise de risco completa, sinais de pares e mais)
  • Zero dependências para as 73 calculadoras + compostos — sem dados de mercado, contas ou APIs de terceiros; envie números, receba números
  • QuantOracle Live (novo) — um plano pago separado que traz os dados: volatilidade cripto atualizada (/v1/live/volatility) e taxas de funding perpétuo (/v1/live/funding-rates). Nós buscamos os dados de mercado ao vivo e executamos a matemática, para que seu agente não precise. 20 chamadas gratuitas/IP/dia para avaliar, depois pague por chamada via x402.
  • QuantOracle Watch (novo) — monitoramento de posição 24/7: registre uma posição perpétua de cripto uma vez e receba webhooks assinados com HMAC sobre distância de liquidação ajustada por funding, inversões de funding e mudanças de regime de volatilidade — verificados a cada 60 segundos. Teste gratuito de 48h; $5 por posição a cada 30 dias via x402.
  • Determinístico — as calculadoras sempre produzem as mesmas saídas para as mesmas entradas, para que os agentes possam armazenar em cache, verificar e encadear chamadas
  • Verificado por citações — cada fórmula testada contra valores publicados em livros-texto (Hull, Wilmott, Bailey & Lopez de Prado)
  • 120 benchmarks de precisão passando com soluções analíticas
  • Rápido — tempo de computação de submilissegundo a 70ms por chamada
  • Plano gratuito — 1.000 chamadas/IP/dia, sem chave de API, sem cadastro, zero atrito

QuantOracle é projetado para ser chamado repetidamente. Um agente executando um backtest pode chamar 10+ endpoints por iteração. Esse é o modelo — seja a calculadora que os agentes procuram sempre que precisam de matemática quantitativa.

Por que não apenas deixar o LLM fazer a matemática?

QuantOracleMatemática em contexto do LLM
PrecisãoExata (fórmulas analíticas)70-85% em matemática complexa
DeterminismoMesma entrada = mesma saída, sempreDiferente a cada execução
Velocidade<1ms por cálculo2-10s por geração
Custo$0,002-0,015 por chamada$0,01-0,10 por geração
AuditabilidadeArmazenável em cache, reproduzível, testávelNão reproduzível
Precificação BS com 10 Gregas1 chamada de API, $0,005~500 tokens, frequentemente errado em gamma/vanna

📓 Livro de receitas LangChain

Construa um agente LangChain de 25 linhas que responde perguntas quantitativas concretas — "Estou comprado em $100k de NVDA a $185, como devo fazer hedge?" — com matemática determinística e reproduzível:

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

QuantOracle × LangChain hedging composite

Executa em 30 segundos, ~$0,001 em tokens OpenAI, gratuito para as calculadoras individuais do QuantOracle. O composto de recomendação de hedge mostrado acima custa $0,04 em USDC via x402.

Adicione QuantOracle ao Seu Agente

Cole isto no prompt de sistema do seu agente:

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)

URLs de descoberta (para frameworks de agentes e rastreadores)

FormatoURL
Especificação OpenAPIhttps://api.quantoracle.dev/openapi.json
Listagem de ferramentashttps://api.quantoracle.dev/tools
Endpoint MCPnpx quantoracle-mcp
Plugin de IAhttps://api.quantoracle.dev/.well-known/ai-plugin.json
Cartão do servidorhttps://mcp.quantoracle.dev/.well-known/mcp/server-card.json
Documentação Swaggerhttps://api.quantoracle.dev/docs

Início Rápido

# 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

Todas as 63 calculadoras + 10 compostos no seu terminal. Zero dependências.

npm install -g quantoracle-cli

Ou execute sem instalar:

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

Plano Gratuito

1.000 chamadas gratuitas por IP por dia. Sem cadastro. Sem chave de API. Basta chamar a API.

GratuitoPago (x402)
Chamadas1.000/diaIlimitado
AutenticaçãoNenhumaCabeçalho de micropagamento x402
CalculadorasTodas as 63Todas as 63
Fluxos de trabalho compostosNenhum (somente pago)Todos os 10
Plano de dados ao vivo20 chamadas/diaPague por chamada
Monitoramento WatchTeste gratuito de 48h (1 por IP / 30d)$5 por posição / 30 dias
Cabeçalhos de limiteSimSim

Cada resposta inclui cabeçalhos de limite de taxa para que os agentes possam se autogerenciar:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 2025-01-15T00:00:00Z

Verifique o uso a qualquer momento:

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

Após 1.000 chamadas, a API retorna 402 Payment Required com um cabeçalho de pagamento x402. Qualquer agente compatível com x402 paga automaticamente e continua:

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64-encoded payment instructions>
PlanoPreçoEndpoints
Simples$0,002Z-score, APY/APR, Fibonacci, Bollinger, ATR, regra de Taylor, inflação, rendimento real, VP, VF, VPL, CAGR, distribuição normal, índice de Sharpe, preço de liquidação, paridade put-call
Médio$0,005Black-Scholes, volatilidade implícita, Kelly, dimensionamento de posição, drawdown, regime, cruzamento, amortização de títulos, carry trade, IRP, PPP, taxa de funding, slippage, vesting, rebalanceamento, TIR, volatilidade realizada, PSR, custo de transação
Complexo$0,008Risco de portfólio, árvore binomial, opções de barreira/asiáticas/lookback, spread de crédito, VaR, teste de estresse, regressão, cointegração, Hurst, ajuste de distribuição, paridade de risco
Pesado$0,015Monte Carlo, GARCH, otimização de portfólio, análise de cadeia de opções, superfície de volatilidade, curva de rendimento, matriz de correlação
Composto$0,015-0,10Estratégia de backtest, varredura de spread, plano de rebalanceamento, otimizador de estratégia de opções, recomendação de hedge, análise de risco completa, avaliação de trade, saúde do portfólio, sinal de pares, classificação de regime (somente pago, sem plano gratuito)

Endpoint de Lote

Execute até 100 cálculos em uma única solicitação HTTP. Uma ida e volta em vez de 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}}
    ]
  }'

Retorna todos os resultados em uma única resposta com o preço total:

{
  "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
}
GratuitoPago
Chamadas em lote1 teste (por tempo de vida)Ilimitado
Máx. por lote100100
PreçoGratuitoSoma dos preços dos endpoints individuais

O preço do lote é a soma dos preços dos endpoints individuais — sem margem de lucro. Você paga pelos cálculos, a velocidade é gratuita.


QuantOracle Live — dados de mercado atualizados + computação

Cada endpoint acima é matemática pura sobre entradas que você fornece — as 73 calculadoras têm zero dependências de dados, o que as torna determinísticas e armazenáveis em cache. QuantOracle Live é o único plano que traz os dados: você passa um ticker, a API busca dados de mercado atualizados e executa a matemática, para que seu agente nunca precise obter ou manter um feed de dados.

EndpointDescriçãoPreço
POST /v1/live/volatilityVolatilidade realizada (7d/30d/90d) + regime para um ativo cripto, a partir de candles diários atualizados$0,01
POST /v1/live/funding-ratesTaxa de funding perpétuo atual + carry anualizado para um ativo cripto$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", ...}

Precificação: o plano Live é pago desde a primeira chamadanão faz parte do plano gratuito de 1.000/dia das calculadoras (o valor está nos dados atualizados + pipeline, que você não pode replicar com uma biblioteca local). Você recebe 20 chamadas gratuitas por IP por dia para avaliar, depois é liquidado por chamada via x402 (USDC na Base ou Solana). Você paga pela atualização, não pela aritmética.

Os resultados são armazenados em cache no servidor (volatilidade ~5 min, funding ~1 min); se um feed upstream estiver temporariamente indisponível, a API serve o último valor bom sinalizado stale: true, com as_of_age_seconds informando quão atualizada está a resposta.

QuantOracle Watch — monitoramento de posição 24/7

A maioria dos agentes de monitoramento reconstrói o mesmo loop: consultar crypto/liquidation-price + risk/var-parametric em um temporizador, o dia todo. Watch substitui o loop — registre uma posição perpétua de cripto uma vez e um watcher isolado a reavalia a cada ~60 segundos: distância de liquidação ajustada por funding (bandas de aviso/crítico com histerese), inversões de sinal da taxa de funding, mudanças de regime de volatilidade por hora e avisos de expiração. Alertas disparam como webhooks assinados com HMAC (X-QO-Signature, chave = seu token de monitoramento) e são registrados no servidor, então o teste precisa de zero infraestrutura — basta consultar.

EndpointDescriçãoPreço
POST /v1/watch/trialMonitor gratuito de 48 horas — um por IP a cada 30 diasGratuito
POST /v1/watch/positionRegistre uma posição para 30 dias de monitoramento$5,00
POST /v1/watch/extend+30 dias (também atualiza um teste; corpo: {monitor_id, token})$5,00
PATCH /v1/watch/{id}Atualize os parâmetros da posição após adicionar margem / redimensionar / moverGratuito
GET /v1/watch/{id}Status ao vivo + histórico de alertas (auth por token)Gratuito
DELETE /v1/watch/{id}CancelarGratuito
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_...", ...}

Sem chaves de exchange, sem custódia, sem execução — Watch lê dados de mercado públicos e envia webhooks, então o pior modo de falha é um alerta perdido (o heartbeat do watcher é publicado em /health como watcher_heartbeat_age_s). Os alvos de webhook são protegidos contra SSRF e as entregas são repetidas. A economia: um loop DIY consultando a mesma matemática uma vez por minuto além do plano gratuito custa ~$7,20/dia em taxas por chamada vs $5 por 30 dias. Tutorial completo: quantoracle.dev/writing/crypto-liquidation-alerts-for-agents.

Pagamentos x402

QuantOracle usa o protocolo x402 para micropagamentos por chamada. Quando um agente esgota seu plano gratuito (ou chama um composto somente pago), a API retorna uma resposta padrão 402 com instruções de pagamento anunciando tanto Base quanto Solana. Agentes compatíveis com x402 (Coinbase AgentKit, AgentCash, OpenClaw, etc.) lidam com o resto automaticamente:

  1. O agente chama o endpoint, recebe 402 com cabeçalho PAYMENT-REQUIRED listando as redes aceitas
  2. O agente assina uma autorização de transferência USDC sem gás na Base (EIP-3009) ou Solana
  3. O agente reenvia a solicitação com cabeçalho PAYMENT-SIGNATURE
  4. O servidor verifica via facilitador CDP, serve a resposta e liquida on-chain

Sem chaves de API. Sem assinaturas. Sem contas. Apenas matemática e micropagamentos.

Redes Suportadas

RedeAtivoGásMelhor para
Base mainnet (eip155:8453)USDC (0x8335...)~$0,005/txAgentes EVM, ferramentas Coinbase, LangChain, ecossistema Base
Solana mainnet (solana:5eykt4...)USDC (EPjFWdd5...)~$0,0002/tx (pagador de taxas CDP)Solana Agent Kit, Eliza, bots de alta frequência
  • Liquidação: Via facilitador da Coinbase Developer Platform (api.cdp.coinbase.com/platform/v2/x402)
  • Carteira Base: 0xC94f5F33ae446a50Ce31157db81253BfddFE2af6
  • Carteira Solana: 9biztrXscReJ3Wi8EfkD2gL3WXzYUmzTEohD26Bxp39u
  • Descoberta: https://api.quantoracle.dev/.well-known/x402 (retorna ambas as redes para cada endpoint)

Teste com 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]}'

Servidor MCP

QuantOracle está disponível como um servidor MCP nativo com 80 ferramentas (63 calculadoras + 11 compostas + 2 endpoints de dados de mercado ao vivo + 3 ferramentas de monitoramento QuantOracle Watch + lote). Funciona com Claude Desktop, Cursor, Windsurf, Smithery e qualquer cliente compatível com MCP.

Instalar via npm

npx quantoracle-mcp

Claude Desktop / Claude Code

Adicione como conector em Configurações, ou adicione a claude_desktop_config.json:

{
  "mcpServers": {
    "quantoracle": {
      "url": "https://mcp.quantoracle.dev/mcp"
    }
  }
}

Ou execute localmente via npx:

{
  "mcpServers": {
    "quantoracle": {
      "command": "npx",
      "args": ["-y", "quantoracle-mcp"]
    }
  }
}

MCP Remoto (HTTP Streamable)

Conecte-se diretamente ao servidor hospedado — sem necessidade de instalação:

https://mcp.quantoracle.dev/mcp

Smithery

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

OpenClaw / ClawHub

clawhub install quantoracle

Integrações

QuantOracle está disponível em múltiplos ecossistemas de agentes:

PlataformaComo conectar
Claude Desktop / Claude CodeURL do conector: https://mcp.quantoracle.dev/mcp
Cursor / WindsurfConfig MCP: npx quantoracle-mcp
Smitherynpx @smithery/cli mcp add QuantOracle/quantoracle
OpenClaw / ClawHubclawhub install quantoracle
CLInpm install -g quantoracle-cli ou npx quantoracle-cli
Glamaglama.ai/mcp/servers/QuantOracledev/quantoracle
npm (MCP)npx quantoracle-mcp
Ecossistema x402x402.org/ecosystem
ChatGPT GPTQuantOracle GPT
LangChainpip install langchain-quantoracle
AgentCashnpx agentcash fetch https://api.quantoracle.dev/v1/...
x402scanPágina do servidor — Base + Solana
API RESThttps://api.quantoracle.dev/v1/...
Especificação OpenAPIhttps://api.quantoracle.dev/openapi.json
Interface Swaggerhttps://api.quantoracle.dev/docs

Descoberta de Ferramentas

# 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

Referência Completa de Endpoints

Opções (4 endpoints)

EndpointDescriçãoPreço
POST /v1/options/pricePrecificação Black-Scholes com 10 Gregas (delta até color)$0,005
POST /v1/options/implied-volSolucionador de volatilidade implícita Newton-Raphson$0,005
POST /v1/options/strategyP&L de estratégias de opções multi-perna, pontos de equilíbrio, lucro/perda máximo$0,008
POST /v1/options/payoff-diagramGeração de dados de diagrama de payoff de opções multi-perna$0,005

Derivativos (7 endpoints)

EndpointDescriçãoPreço
POST /v1/derivatives/binomial-treePrecificação de árvore binomial CRR para opções americanas e europeias$0,008
POST /v1/derivatives/barrier-optionPrecificação de opções de barreira usando fórmulas analíticas$0,008
POST /v1/derivatives/asian-optionPrecificação de opções asiáticas: forma fechada geométrica ou aproximação aritmética$0,008
POST /v1/derivatives/lookback-optionPrecificação de opções lookback (strike flutuante/fixo, Goldman-Sosin-Gatto)$0,008
POST /v1/derivatives/option-chain-analysisAnálise de cadeia de opções: skew, max pain, razões put-call$0,015
POST /v1/derivatives/put-call-parityVerificação de paridade put-call e detecção de arbitragem$0,002
POST /v1/derivatives/volatility-surfaceConstrução de superfície de volatilidade implícita a partir de dados de mercado$0,015

Risco (8 endpoints)

EndpointDescriçãoPreço
POST /v1/risk/portfolio22 métricas de risco: Sharpe, Sortino, Calmar, Omega, VaR, CVaR, drawdown$0,008
POST /v1/risk/kellyCritério de Kelly: discreto (ganho/perda) ou contínuo (série de retornos)$0,005
POST /v1/risk/position-sizeDimensionamento de posição fracionária fixa com metas de risco/recompensa$0,005
POST /v1/risk/drawdownDecomposição de drawdown com curva submersa$0,005
POST /v1/risk/correlationMatrizes de correlação e covariância N x N a partir de séries de retornos$0,008
POST /v1/risk/var-parametricValue-at-Risk paramétrico e CVaR condicional$0,008
POST /v1/risk/stress-testTeste de estresse de portfólio em múltiplos cenários$0,008
POST /v1/risk/transaction-costModelo de custo de transação: comissão + spread + impacto de mercado Almgren$0,005

Indicadores (6 endpoints)

EndpointDescriçãoPreço
POST /v1/indicators/technical13 indicadores técnicos (SMA, EMA, RSI, MACD, etc.) + sinais compostos$0,005
POST /v1/indicators/regimeClassificação de tendência + regime de volatilidade + risco composto$0,005
POST /v1/indicators/crossoverDetecção de cruzamento dourado/da morte com histórico de sinais$0,005
POST /v1/indicators/bollinger-bandsBandas de Bollinger com %B, largura de banda e detecção de squeeze$0,002
POST /v1/indicators/fibonacci-retracementNíveis de retração e extensão de Fibonacci$0,002
POST /v1/indicators/atrAverage True Range com ATR normalizado e regime de volatilidade$0,002

Estatísticas (12 endpoints)

EndpointDescriçãoPreço
POST /v1/stats/linear-regressionRegressão linear OLS com R-quadrado, estatísticas t, erros padrão$0,008
POST /v1/stats/polynomial-regressionRegressão polinomial de grau n com métricas de qualidade de ajuste$0,008
POST /v1/stats/cointegrationTeste de cointegração Engle-Granger com razão de hedge e meia-vida$0,008
POST /v1/stats/hurst-exponentExpoente de Hurst via análise de amplitude reescalonada (R/S)$0,008
POST /v1/stats/garch-forecastPrevisão de volatilidade GARCH(1,1) usando estimativa de máxima verossimilhança$0,015
POST /v1/stats/zscoreZ-scores móveis e estáticos com detecção de valores extremos$0,002
POST /v1/stats/distribution-fitAjuste de dados a distribuições comuns e classificação por qualidade de ajuste$0,008
POST /v1/stats/correlation-matrixMatrizes de correlação e covariância com decomposição de autovalores$0,015
POST /v1/stats/realized-volatilityVolatilidade realizada: close-to-close, Parkinson, Garman-Klass, Yang-Zhang$0,005
POST /v1/stats/normal-distributionDistribuição normal: CDF, PDF, quantil, intervalos de confiança$0,002
POST /v1/stats/sharpe-ratioÍndice de Sharpe autônomo com erro padrão Lo (2002) e IC de 95%$0,002
POST /v1/stats/probabilistic-sharpeÍndice de Sharpe Probabilístico (Bailey & Lopez de Prado 2012)$0,005

Portfólio (2 endpoints)

EndpointDescriçãoPreço
POST /v1/portfolio/optimizeOtimização de portfólio: Sharpe máximo, vol mínima ou paridade de risco$0,015
POST /v1/portfolio/risk-parity-weightsPesos de portfólio de contribuição de risco igual (Spinu 2013)$0,008

Renda Fixa (4 endpoints)

EndpointDescriçãoPreço
POST /v1/fixed-income/bondPreço de título, duração Macaulay/modificada, convexidade, DV01$0,008
POST /v1/fixed-income/amortizationCronograma completo de amortização com análise de economia de pagamentos extras$0,005
POST /v1/fi/yield-curve-interpolateInterpolação de curva de rendimento: linear, spline cúbico, Nelson-Siegel$0,015
POST /v1/fi/credit-spreadSpread de crédito e Z-spread a partir do preço do título vs curva livre de risco$0,008

Cripto / DeFi (7 endpoints)

EndpointDescriçãoPreço
POST /v1/crypto/impermanent-lossCalculadora de perda impermanente para posições AMM Uniswap v2/v3$0,005
POST /v1/crypto/apy-apr-convertConversão entre APY e APR com composição configurável$0,002
POST /v1/crypto/liquidation-priceCalculadora de preço de liquidação para posições alavancadas$0,002
POST /v1/crypto/funding-rateAnálise de taxa de funding com anualização e detecção de regime$0,005
POST /v1/crypto/dex-slippageEstimador de slippage DEX para AMM de produto constante (x*y=k)$0,005
POST /v1/crypto/vesting-scheduleCronograma de vesting de tokens com cliff, desbloqueio linear/graduado, TGE$0,005
POST /v1/crypto/rebalance-thresholdAnalisador de rebalanceamento de portfólio: detecção de desvio e dimensionamento de negociação$0,005

Dados ao Vivo (2 endpoints) — nível pago, dados de mercado atualizados

EndpointDescriçãoPreço
POST /v1/live/volatilityVolatilidade realizada ao vivo (7d/30d/90d) + regime para um ativo cripto$0,01
POST /v1/live/funding-ratesTaxa de funding perpétuo ao vivo + carry anualizado para um ativo cripto$0,005

Pago desde a primeira chamada (não faz parte do nível gratuito); 20 chamadas gratuitas/IP/dia. Veja QuantOracle Live.

Watch — monitoramento de posição (6 endpoints)

EndpointDescriçãoPreço
POST /v1/watch/trialMonitor de teste gratuito de 48 horas (um por IP a cada 30 dias)Grátis
POST /v1/watch/positionMonitoramento 24/7 de uma posição perpétua por 30 dias$5,00
POST /v1/watch/extendEstender ou atualizar um monitor por 30 dias$5,00
PATCH /v1/watch/{id}Atualizar parâmetros de posição (direção/entrada/tamanho/colateral/mmr/webhook/limiares)Grátis
GET /v1/watch/{id}Status ao vivo + histórico de alertas (autenticação por token)Grátis
DELETE /v1/watch/{id}Cancelar um monitorGrátis

Preço por monitor, não por chamada. Veja QuantOracle Watch.

FX / Macro (7 endpoints)

EndpointDescriçãoPreço
POST /v1/fx/interest-rate-parityCalculadora de paridade de taxa de juros com detecção de arbitragem$0,005
POST /v1/fx/purchasing-power-parityEstimativa de valor justo de paridade do poder de compra$0,005
POST /v1/fx/forward-rateBootstrap de taxas a termo a partir de uma curva de rendimento à vista$0,005
POST /v1/fx/carry-tradeDecomposição de P&L de carry trade de moedas$0,005
POST /v1/macro/inflation-adjustedConversão de retornos nominais para reais usando a equação de Fisher$0,002
POST /v1/macro/taylor-rulePrescrição de taxa de juros pela Regra de Taylor$0,002
POST /v1/macro/real-yieldRendimento real e inflação de equilíbrio a partir de rendimentos nominais$0,002

Valor do Dinheiro no Tempo (5 endpoints)

EndpointDescriçãoPreço
POST /v1/tvm/present-valueValor presente de um montante fixo futuro e/ou fluxo de anuidade$0,002
POST /v1/tvm/future-valueValor futuro de um montante fixo presente e/ou fluxo de anuidade$0,002
POST /v1/tvm/irrTaxa interna de retorno via Newton-Raphson$0,005
POST /v1/tvm/npvValor presente líquido com índice de lucratividade e período de payback$0,002
POST /v1/tvm/cagrTaxa de crescimento anual composta com projeções futuras$0,002

Simulação (1 endpoint)

EndpointDescriçãoPreço
POST /v1/simulate/montecarloMonte Carlo GBM com contribuições/retiradas, até 5000 caminhos$0,015

Endpoints Compostos (somente pagos)

Endpoints de nível superior que combinam múltiplos cálculos em uma única chamada. Mesma matemática dos endpoints individuais — apenas empacotados para fluxos de trabalho comuns de agentes. Sem nível gratuito.

EndpointDescriçãoSubstituiPreço
POST /v1/backtest/strategyExecutar backtest de cruzamento SMA, reversão à média RSI, momentum ou breakout de Bollinger10+ chamadas de indicador + risco$0,10
POST /v1/options/spread-scanEscanear e classificar spreads verticais por risco/recompensa8-16 chamadas de opções/preço$0,05
POST /v1/portfolio/rebalance-planGerar lista de negociações para atingir pesos-alvo com estimativa de custoportfólio/otimizar + custo de transação$0,05
POST /v1/options/strategy-optimizerClassificar as melhores estratégias de opções dado cenário + visão de volatilidadeopções/estratégia + diagrama de payoff$0,08
POST /v1/hedging/recommendClassificar hedges efetivos mais baratos (put protetor, collar, futuros, parcial)opções/preço + Gregas$0,04
POST /v1/risk/full-analysisRelatório completo de risco: Sharpe, Sortino, VaR, Kelly, drawdown, Hurst, CAGR7 chamadas individuais$0,04
POST /v1/portfolio/healthVerificação de saúde do portfólio: risco, correlação, rebalanceamento, teste de estresse6 chamadas individuais$0,04
POST /v1/trade/evaluateAvaliação de negociação: dimensionamento, risco/recompensa, Kelly, custos, regime, sinais, veredito5 chamadas individuais$0,025
POST /v1/pairs/signalSinal de negociação de pares: cointegração, Hurst, z-score, meia-vida, razão de hedge4 chamadas individuais$0,025
POST /v1/indicators/regime-classifyTendência, regime de vol, RSI, direção, sugestão de estratégiatécnico + regime + vol realizada$0,015

Exemplo: Fluxo de Trabalho de Backtest de Agente

Um backtest típico de agente encadeia múltiplas chamadas QuantOracle por iteração:

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

Cada chamada é uma calculadora pura — sem estado, sem efeitos colaterais, sem chaves de API.

Otimizador de Estratégia (mais de 1.200 chamadas)

examples/strategy_optimizer.py é um otimizador de parâmetros walk-forward completo que demonstra uso intenso da API:

FaseO que fazChamadas de API
Varredura de ParâmetrosTesta 180 combinações de lookback/rebalance/RSI em 8 ativos~1.080
Análise Profunda22 métricas de risco + VaR + Kelly + Monte Carlo nas 3 principais configurações~60-80
Sobreposição de OpçõesPrecifica covered calls em 6 ativos x 4 vencimentos x 5 strikes~100-150
Análise de ParesVarredura de cointegração + expoente de Hurst em 45 pares de ativos~50-70
pip install requests
python examples/strategy_optimizer.py

Uma única execução faz cerca de 1.200-1.500 chamadas de API. Nas tarifas pagas, isso custa cerca de US$ 6-8 USDC. Os mesmos cálculos feitos por um LLM em contexto custariam US$ 12-60 em tokens (de Sonnet a Opus), levariam 4x mais tempo e errariam 15-30% da matemática complexa.


Auto-hospedagem

# 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

Precisão

Cada endpoint é testado contra soluções analíticas publicadas:

  • 120 benchmarks com citações (Hull, Wilmott, Bailey & Lopez de Prado, Goldman-Sosin-Gatto, Taylor, Fisher, Markowitz)
  • Mais de 65 testes de integração cobrindo todas as 63 calculadoras
  • Matemática pura em Python — sem numpy/scipy, zero dependências nativas
  • Determinístico: as mesmas entradas sempre produzem as mesmas saídas

Execute você mesmo a suíte de verificação:

python tests/accuracy_benchmarks.py https://api.quantoracle.dev

Arquitetura

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 na Base e Solana


Licença

MIT — use o QuantOracle como quiser.