{"uid":"cap_rw9Bix_EOzvlL3r1k0f2X","slug":"api-quantoracle-dev-1fe50ab6","name":"QuantOracle Risk/Portfolio Analytics","description":"QuantOracle: risk/portfolio","url":"https://api.quantoracle.dev/v1/risk/portfolio","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"returns":{"type":"array","items":{"type":"number"},"title":"Returns","maxItems":5000,"minItems":5,"description":"Array of periodic portfolio returns (e.g. daily), max 5000"},"risk_free_rate":{"type":"number","title":"Risk Free Rate","default":0.05,"description":"Annual risk-free rate for Sharpe/Sortino calculation"},"benchmark_returns":{"anyOf":[{"type":"array","items":{"type":"number"},"maxItems":5000},{"type":"null"}],"title":"Benchmark Returns","description":"Optional benchmark return series for relative metrics"}}},"responseSchema":null,"example":{"request":{"input":{"body":{"returns":[0.001,-0.002,0.003,0.0015,-0.0008,0.002,0.0005,-0.001,0.0012,0.0018,0.0022,-0.0005,0.0008,0.0011,0.0009],"risk_free_rate":0.05,"benchmark_returns":[0.0008,-0.0015,0.0025,0.001,-0.0005,0.0018,0.0003,-0.0012,0.001,0.0016,0.002,-0.0003,0.0006,0.0009,0.0007]},"type":"http","method":"POST","bodyType":"json"}},"response":{"n":15,"ms":17.74,"risk":{"omega":3.7209,"calmar":98.28,"sharpe":6.8484,"var_95":-0.002,"var_99":-0.002,"cvar_95":-0.002,"sortino":12.8411,"max_drawdown":-0.002},"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"returns":{"vol":0.0214,"best":0.003,"total":0.0118,"worst":-0.002,"win_rate":0.7333,"annualized":0.1966,"profit_factor":3.7209},"benchmark":{"beta":1.1713,"alpha":0.0143,"tracking_error":0.0043,"information_ratio":7.8673},"distribution":{"skewness":-0.5387,"fat_tails":false,"excess_kurtosis":-0.0878}}},"exampleRequest":{"returns":[0.001,-0.002,0.003,0.0015,-0.0008,0.002,0.0005,-0.001,0.0012,0.0018,0.0022,-0.0005,0.0008,0.0011,0.0009],"risk_free_rate":0.05,"benchmark_returns":[0.0008,-0.0015,0.0025,0.001,-0.0005,0.0018,0.0003,-0.0012,0.001,0.0016,0.002,-0.0003,0.0006,0.0009,0.0007]},"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_quMK7AmfZOiWjtibKoEGp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes comprehensive portfolio risk metrics including Sharpe, Sortino, VaR, CVaR, max drawdown, alpha/beta, and return distribution statistics from a return series","exampleAgentPrompt":"Can you run a full risk and performance analysis on this return series [0.001, -0.002, 0.003, 0.0015, -0.0008, 0.002, 0.0005, -0.001, 0.0012, 0.0018] using a risk-free rate of 5% and benchmark returns [0.0008, -0.0015, 0.0025, 0.001, -0.0005, 0.0018, 0.0003, -0.0012, 0.001, 0.0016] — I want Sharpe, Sortino, VaR, max drawdown, alpha, beta, and distribution stats?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing: risk metrics (Sharpe, Sortino, Omega, Calmar ratios; VaR at 95/99; CVaR at 95; max drawdown), return statistics (volatility, best/worst return, total return, annualized return, win rate, profit factor), benchmark comparison (alpha, beta, tracking error, information ratio), and distribution properties (skewness, excess kurtosis, fat tails flag), plus computation metadata (n observations, latency in ms).","failureModes":["Empty or too-short returns array causing insufficient data for statistical calculations","Mismatched length between returns and benchmark_returns arrays","Invalid risk_free_rate (e.g. negative or extremely large values)","Non-numeric values in returns arrays causing parse errors","Missing required returns field returning 400 or validation error"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, multi-metric portfolio risk and performance report in a single call — covering risk ratios, VaR/CVaR, benchmark attribution, and return distribution. Prefer this over individual metric calculators when you want Sharpe, Sortino, alpha/beta, and VaR computed together at low latency. Best suited for evaluating trading strategies, backtests, or portfolio slices where you already have a return series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:52:31.533Z","isFirstParty":false}