왜 QuantOracle인가?

모든 금융 에이전트에게는 수학이 필요합니다. QuantOracle이 바로 그 수학입니다.

63가지 순수 계산기: 옵션, 파생상품, 위험, 포트폴리오, 통계, 암호화폐/DeFi, FX/거시경제, TVM(화폐의 시간 가치) 전반을 아우름
의존성 제로: 시장 데이터, 계정, 타사 API에 의존하지 않음 -- 숫자만 입력하면 결과가 나옴
결정론적: 동일한 입력은 항상 동일한 출력을 생성하므로 에이전트가 호출을 캐싱, 검증 및 연결할 수 있음
출처 검증: 모든 공식은 출판된 교과서 값(Hull, Wilmott, Bailey & Lopez de Prado)을 기준으로 테스트됨
120개 정확도 벤치마크: 분석적 솔루션으로 통과
밀리초 미만의 응답 시간
무료 티어: IP당 하루 1,000회 호출, API 키 불필요, 가입 불필요, 제로 마찰

QuantOracle은 반복적으로 호출되도록 설계되었습니다. 백테스트를 실행하는 에이전트는 반복당 10개 이상의 엔드포인트를 호출할 수 있습니다. 이것이 바로 모델입니다. 에이전트가 퀀트 수학이 필요할 때마다 찾는 계산기가 되는 것입니다.

빠른 시작

# 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": 3.6862,
  "greeks": {
    "delta": 0.4467,
    "gamma": 0.0281,
    "theta": -0.0113,
    "vega": 0.2653,
    "rho": 0.1989
  },
  "d1": -0.1331,
  "d2": -0.2745,
  "ms": 0.04
}

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"])  # 3.6862

# 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

터미널에서 63개 엔드포인트를 모두 사용하세요. 의존성 제로.

npm install -g quantoracle-cli

또는 설치 없이 실행:

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

무료 티어

IP당 하루 1,000회 무료 호출. 가입 불필요. API 키 불필요. 그냥 API를 호출하세요.

	무료	유료 (x402)
호출	1,000회/일	무제한
인증	없음	x402 소액 결제 헤더
엔드포인트	63개 전체	63개 전체
속도 제한 헤더	예	예

모든 응답에는 에이전트가 스스로 관리할 수 있도록 속도 제한 헤더가 포함되어 있습니다:

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

사용량 확인:

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

1,000회 호출 후에는 API가 x402 결제 헤더와 함께 402 Payment Required를 반환합니다. x402 호환 에이전트는 자동으로 결제하고 계속 진행합니다:

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64-encoded payment instructions>

티어	가격	엔드포인트
Simple	$0.002	Z-score, APY/APR, 피보나치, 볼린저 밴드, ATR, 테일러 준칙, 인플레이션, 실질 수익률, PV, FV, NPV, CAGR, 정규 분포, 샤프 지수, 청산가, 풋-콜 패리티
Medium	$0.005	블랙-숄즈, 내재 변동성, 켈리 공식, 포지션 사이징, 낙폭(Drawdown), 레짐, 크로스오버, 채권 상환, 캐리 트레이드, IRP, PPP, 펀딩비, 슬리피지, 베스팅, 리밸런싱, IRR, 실현 변동성, PSR, 거래 비용
Complex	$0.008	포트폴리오 위험, 이항 트리, 배리어/아시아/룩백 옵션, 신용 스프레드, VaR, 스트레스 테스트, 회귀 분석, 공적분, 허스트 지수, 분포 적합도, 위험 패리티
Heavy	$0.015	몬테카를로, GARCH, 포트폴리오 최적화, 옵션 체인 분석, 변동성 표면, 수익률 곡선, 상관관계 행렬

x402 결제

QuantOracle은 호출당 소액 결제를 위해 x402 프로토콜을 사용합니다. 에이전트가 무료 티어를 모두 소진하면 API는 결제 지침과 함께 표준 402 응답을 반환합니다. x402 호환 에이전트(Coinbase AgentKit, OpenClaw 등)는 이를 자동으로 처리합니다:

에이전트가 엔드포인트를 호출하고 PAYMENT-REQUIRED 헤더가 포함된 402 응답을 받음
에이전트가 가스비 없는 USDC 전송 승인(EIP-3009)에 서명
에이전트가 PAYMENT-SIGNATURE 헤더와 함께 요청을 재전송
서버가 CDP 촉진자를 통해 검증하고 응답을 제공하며 온체인에서 정산

API 키 불필요. 구독 불필요. 계정 불필요. 오직 수학과 소액 결제뿐.

통화: Base 체인의 USDC (체인 ID 8453)
정산: Coinbase Developer Platform 촉진자를 통해
지갑: 0xC94f5F33ae446a50Ce31157db81253BfddFE2af6

MCP 서버

QuantOracle은 63개의 도구를 갖춘 네이티브 MCP 서버로 제공됩니다. Claude Desktop, Cursor, Windsurf 및 모든 MCP 호환 클라이언트와 작동합니다.

npm을 통한 설치

npx quantoracle-mcp

Claude Desktop / Claude Code

설정에서 커넥터로 추가하거나 claude_desktop_config.json에 추가하세요:

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

또는 npx를 통해 로컬에서 실행:

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

원격 MCP (스트리밍 HTTP)

호스팅된 서버에 직접 연결하세요 (설치 불필요):

https://mcp.quantoracle.dev/mcp

Smithery

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

OpenClaw / ClawHub

clawhub install quantoracle

통합

QuantOracle은 여러 에이전트 생태계에서 사용할 수 있습니다:

플랫폼	연결 방법
Claude Desktop / Claude Code	커넥터 URL: `https://mcp.quantoracle.dev/mcp`
Cursor / Windsurf	MCP 설정: `npx quantoracle-mcp`
Smithery	`npx @smithery/cli mcp add QuantOracle/quantoracle`
OpenClaw / ClawHub	`clawhub install quantoracle`
CLI	`npm install -g quantoracle-cli` 또는 `npx quantoracle-cli`
Glama	glama.ai/mcp/servers
npm (MCP)	`npx quantoracle-mcp`
x402 생태계	x402.org/ecosystem
REST API	`https://api.quantoracle.dev/v1/...`
OpenAPI 사양	`https://api.quantoracle.dev/openapi.json`
Swagger UI	`https://api.quantoracle.dev/docs`

도구 탐색

# List all 63 tools with paths and pricing
curl https://api.quantoracle.dev/tools

# 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

전체 엔드포인트 참조

옵션 (4개 엔드포인트)

엔드포인트	설명	가격
`POST /v1/options/price`	10가지 그리스 지표(델타부터 컬러까지)를 포함한 블랙-숄즈 가격 결정	$0.005
`POST /v1/options/implied-vol`	뉴턴-랩슨 내재 변동성 솔버	$0.005
`POST /v1/options/strategy`	멀티 레그 옵션 전략 손익, 손익분기점, 최대 이익/손실	$0.008
`POST /v1/options/payoff-diagram`	멀티 레그 옵션 페이오프 다이어그램 데이터 생성	$0.005

파생상품 (7개 엔드포인트)

엔드포인트	설명	가격
`POST /v1/derivatives/binomial-tree`	미국식 및 유럽식 옵션을 위한 CRR 이항 트리 가격 결정	$0.008
`POST /v1/derivatives/barrier-option`	분석 공식을 사용한 배리어 옵션 가격 결정	$0.008
`POST /v1/derivatives/asian-option`	아시아 옵션 가격 결정: 기하학적 폐쇄형 또는 산술 근사치	$0.008
`POST /v1/derivatives/lookback-option`	룩백 옵션 가격 결정 (변동/고정 행사가, Goldman-Sosin-Gatto)	$0.008
`POST /v1/derivatives/option-chain-analysis`	옵션 체인 분석: 왜도, 최대 고통(Max Pain), 풋-콜 비율	$0.015
`POST /v1/derivatives/put-call-parity`	풋-콜 패리티 확인 및 차익거래 탐지	$0.002
`POST /v1/derivatives/volatility-surface`	시장 데이터로부터 내재 변동성 표면 구축	$0.015

위험 (8개 엔드포인트)

엔드포인트	설명	가격
`POST /v1/risk/portfolio`	22가지 위험 지표: 샤프, 소티노, 칼마, 오메가, VaR, CVaR, 낙폭	$0.008
`POST /v1/risk/kelly`	켈리 공식: 이산형(승/패) 또는 연속형(수익률 시리즈)	$0.005
`POST /v1/risk/position-size`	위험/보상 목표를 설정한 고정 분할 포지션 사이징	$0.005
`POST /v1/risk/drawdown`	언더워터 곡선을 포함한 낙폭 분해	$0.005
`POST /v1/risk/correlation`	수익률 시리즈로부터 N x N 상관관계 및 공분산 행렬	$0.008
`POST /v1/risk/var-parametric`	파라메트릭 VaR 및 조건부 VaR	$0.008
`POST /v1/risk/stress-test`	다중 시나리오에 걸친 포트폴리오 스트레스 테스트	$0.008
`POST /v1/risk/transaction-cost`	거래 비용 모델: 수수료 + 스프레드 + Almgren 시장 영향	$0.005

지표 (6개 엔드포인트)

엔드포인트	설명	가격
`POST /v1/indicators/technical`	13가지 기술적 지표(SMA, EMA, RSI, MACD 등) + 복합 신호	$0.005
`POST /v1/indicators/regime`	추세 + 변동성 레짐 + 복합 위험 분류	$0.005
`POST /v1/indicators/crossover`	신호 이력을 포함한 골든/데스 크로스 탐지	$0.005
`POST /v1/indicators/bollinger-bands`	%B, 대역폭 및 스퀴즈 탐지를 포함한 볼린저 밴드	$0.002
`POST /v1/indicators/fibonacci-retracement`	피보나치 되돌림 및 확장 레벨	$0.002
`POST /v1/indicators/atr`	정규화된 ATR 및 변동성 레짐을 포함한 평균 실제 범위(ATR)	$0.002

통계 (10개 엔드포인트)

엔드포인트	설명	가격
`POST /v1/stats/linear-regression`	R-제곱, t-통계량, 표준 오차를 포함한 OLS 선형 회귀	$0.008
`POST /v1/stats/polynomial-regression`	적합도 지표를 포함한 n차 다항 회귀	$0.008
`POST /v1/stats/cointegration`	헤지 비율 및 반감기를 포함한 엥글-그레인저 공적분 검정	$0

QuantOracle