{"uid":"cap_7mAgLwr3kwe2wNzrX5HhW","slug":"portfolio-risk-metrics-calculator-6e422af1","name":"Portfolio Risk Metrics Calculator","description":"Portfolio risk metrics over an array of periodic returns: value-at-risk, conditional VaR, Sharpe, Sortino, max drawdown, Calmar, volatility, and more. Pure computation over your inputs.","url":"https://payai.agentstools.dev/quant/risk","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"metrics":{"type":"array","items":{"enum":["mean","std","volatility","var_historical","var_parametric","cvar","downside_deviation","sharpe","sortino","max_drawdown","calmar"],"type":"string"},"description":"Which metrics to compute; omit for all"},"returns":{"type":"array","items":{"type":"number"},"description":"Periodic returns as decimals, at most 10000 entries"},"risk_free":{"type":"number","description":"Annual risk-free rate as a decimal, default 0"},"confidence":{"type":"number","description":"Confidence for VaR and CVaR, default 0.95"},"periods_per_year":{"type":"number","description":"Annualization factor, default 252"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2Lkr8RAwwhA1BxxFyCYcv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a comprehensive suite of portfolio risk and performance metrics (VaR, CVaR, Sharpe, Sortino, max drawdown, Calmar, volatility, etc.) from an array of periodic returns.","exampleAgentPrompt":"Calculate all risk metrics — VaR, CVaR, Sharpe, Sortino, max drawdown, and Calmar — for these 252 daily returns (as decimals): [0.01, -0.005, 0.02, ...], using a 4% annual risk-free rate and 95% confidence level.","exampleUseCases":[{"title":"Hedge fund strategy risk evaluation","prompt":"I have 500 daily returns (as decimals) for my long/short equity strategy. Can you compute the Sharpe ratio, Sortino ratio, max drawdown, and CVaR at 99% confidence using a 5% annual risk-free rate and 252 periods per year?"},{"title":"Crypto portfolio volatility snapshot","prompt":"Here are 365 daily returns for my Bitcoin portfolio. Calculate the historical VaR at 95% confidence, annualized volatility, and max drawdown so I can understand the downside risk."},{"title":"Comparing two trading systems","prompt":"For a monthly return series of 36 entries for my trend-following system, give me the Calmar ratio, Sortino ratio, and downside deviation — use 12 periods per year and a 2% risk-free rate."}],"resultDescription":"Returns a JSON object containing the requested risk and performance metrics computed from the provided returns array. Metrics may include: mean return, standard deviation, annualized volatility, historical VaR, parametric VaR, CVaR, downside deviation, Sharpe ratio, Sortino ratio, max drawdown, and Calmar ratio — all annualized and scaled appropriately based on the periods_per_year parameter.","failureModes":["Empty or missing returns array returns a validation error","Returns array exceeding 10,000 entries is rejected","Invalid metric enum values return a bad request error","Non-numeric values in returns array cause a parsing error","Invalid confidence value (outside 0-1) returns a validation error","Insufficient data points for certain metrics (e.g., max drawdown on a single return) may return NaN or an error"],"whenToPreferThis":"Choose this endpoint when you need server-side, stateless computation of a comprehensive set of quantitative risk and performance metrics from a raw returns series — especially when you need multiple metrics in one call rather than computing them individually. Ideal for portfolio analysis workflows where you have periodic returns but lack the computational environment to run financial libraries locally. Prefer this over general-purpose code execution when you want a purpose-built, reliable quant finance computation with no setup overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:05:40.009Z","isFirstParty":false}