{"uid":"cap_lrF9abWHg06BSPXJBxzo5","slug":"api-quantoracle-dev-97ad55c9","name":"QuantOracle Parametric Value-at-Risk (VaR) Calculator","description":"QuantOracle: risk/var-parametric","url":"https://api.quantoracle.dev/v1/risk/var-parametric","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"returns":{"type":"array","items":{"type":"number"},"title":"Returns","maxItems":5000,"minItems":10,"description":"Array of historical returns (max 5000)"},"portfolio_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Portfolio Value","description":"Optional portfolio value for dollar VaR"},"confidence_levels":{"type":"array","items":{"type":"number"},"title":"Confidence Levels","default":[0.95,0.99],"maxItems":5,"minItems":1,"description":"Confidence levels for VaR calculation (max 5 levels)"},"holding_period_days":{"type":"integer","title":"Holding Period Days","default":1,"maximum":252,"minimum":1,"description":"VaR holding period in days (1-252)"}}},"responseSchema":null,"example":{"request":{"returns":[0.01,-0.02,0.015,-0.005,0.03,-0.01,0.02,-0.015,0.005,-0.025,0.008,-0.012,0.018,-0.007,0.022,0.011,-0.018,0.025,-0.008,0.013,-0.011,0.019,-0.006,0.016,-0.014,0.009,-0.003,0.021,-0.009,0.012]},"response":{"n":30,"ms":8.22,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","calculator":"https://quantoracle.dev/value-at-risk-calculator","powered_by":"QuantOracle"},"kurtosis":-1.2588,"skewness":-0.065,"live_data":{"note":"Parametric VaR scales directly with volatility. For crypto, validate against fresh realized vol from /v1/live/volatility ($0.01).","watch":"Monitoring a live crypto position? QuantOracle Watch tracks liq distance + funding flips 24/7 and webhooks you: POST /v1/watch/trial (free 48h), then $5/30d.","volatility":"/v1/live/volatility"},"var_results":{"95":{"var":0.022239,"cvar":0.028634,"var_pct":2.2239,"cvar_pct":2.8634},"99":{"var":0.032709,"cvar":0.037866,"var_pct":3.2709,"cvar_pct":3.7866}},"volatility_daily":0.015361,"volatility_annual":0.2439,"holding_period_days":1}},"exampleRequest":{"returns":[0.01,-0.02,0.015,-0.005,0.03,-0.01,0.02,-0.015,0.005,-0.025,0.008,-0.012,0.018,-0.007,0.022,0.011,-0.018,0.025,-0.008,0.013,-0.011,0.019,-0.006,0.016,-0.014,0.009,-0.003,0.021,-0.009,0.012]},"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_7zCT9qN4Hsiy1JUuQMzw0","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 parametric VaR and CVaR for a portfolio at specified confidence levels given a series of historical returns","exampleAgentPrompt":"Calculate the parametric VaR and CVaR for my $1,000,000 portfolio using these daily returns: [-0.012, 0.008, -0.003, 0.015, -0.021, 0.005, -0.008, 0.012, -0.006, 0.01], at both 95% and 99% confidence levels over a 1-day holding period.","exampleUseCases":null,"resultDescription":"Returns VaR and CVaR values as both percentages and dollar amounts at each requested confidence level, plus portfolio statistics including daily and annualized volatility, skewness, and kurtosis of the return distribution.","failureModes":["Too few data points in returns array to compute reliable statistics","Invalid confidence levels (outside 0-1 range or improperly formatted)","Non-numeric values in the returns array","Missing required fields (returns, portfolio_value, or confidence_levels)","Network timeout for unusually large return series"],"whenToPreferThis":"Use this endpoint when you need fast, parametric (normal-distribution-based) VaR and CVaR calculations for a portfolio, especially when you already have a time series of returns and want dollar-denominated risk figures. Prefer this over historical simulation VaR when computational speed is a priority and when the return distribution is reasonably normal. Ideal for daily risk monitoring, regulatory reporting estimates, or portfolio stress-testing workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:20.063Z","isFirstParty":false}