{"uid":"cap_A62SkP9mLLyASG0lRW87C","slug":"finmath-volatility-calculator-dd92a954","name":"finmath Volatility Calculator","description":"Deterministic finance and crypto math for AI agents: TradFi (NPV, IRR, XIRR, Black-Scholes + Greeks, bonds, VaR, Sharpe) and DeFi (impermanent loss, perp liquidation, funding, Uniswap v3, health factor, cost basis). Exact, model-free arithmetic that LLMs get wrong — priced per call in USDC.","url":"https://finmath.qzqh5rrbkz.workers.dev/v1/volatility","method":"POST","headers":{},"bodySchema":{"type":"object","required":["returns"],"properties":{"returns":{"type":"array","description":"returns"},"periods_per_year":{"type":"number","description":"periods_per_year"}}},"responseSchema":{"type":"object","required":["result","meta"],"properties":{"meta":{"type":"object"},"result":{}}},"example":{"request":{"returns":[0.012,-0.005,0.008,-0.021,0.003,0.015,-0.009,0.006,-0.002,0.011],"periods_per_year":252},"response":{"meta":{"tool":"volatility","disclaimer":"Deterministic calculation utility. Not financial, investment, or trading advice.","deterministic":true},"result":0.17689771055612902}},"exampleRequest":{"returns":[0.012,-0.005,0.008,-0.021,0.003,0.015,-0.009,0.006,-0.002,0.011],"periods_per_year":252},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KH6uCJ2MF-yCFarYNV46w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes annualized volatility from a series of periodic returns using exact deterministic arithmetic","exampleAgentPrompt":"Calculate the annualized volatility for this series of daily returns: [0.012, -0.005, 0.008, -0.021, 0.003, 0.015, -0.009, 0.006, -0.002, 0.011] — there are 252 trading days per year.","exampleUseCases":null,"resultDescription":"Returns a result object containing the computed annualized volatility value and a meta object with calculation details such as the number of periods and scaling factor used.","failureModes":["Empty or missing returns array returns a validation error","Non-numeric values in the returns array cause a parsing failure","Single-element returns array insufficient for variance calculation","Invalid periods_per_year value (zero or negative) causes division error","Payment not included or insufficient USDC triggers 402 response"],"whenToPreferThis":"Use this endpoint when you need exact, deterministic annualized volatility — not an LLM estimate — from a known return series, especially as input to Black-Scholes pricing, VaR calculations, or Sharpe ratio computation. Prefer it over asking an LLM directly because LLMs make arithmetic errors on financial calculations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:15.532Z","isFirstParty":false}