{"uid":"cap_YSlVKeNu8cHbPooCETCwu","slug":"token-historical-volatility-calculator-e783bca1","name":"Token Historical Volatility Calculator","description":"Computes historical volatility for any CoinGecko-listed token: log-return standard deviation over the last N days (default 30), annualized by sqrt(365). Returns daily and annualized volatility as percent, count of return observations, and first and last close prices. Backed by CoinGecko's free public market_chart endpoint. Use it as an annualized vol calculator, standard-deviation-of-returns tool, or crypto vol calculator.","url":"https://x402.agentutility.ai/token-volatility","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["coingecko_id"],"properties":{"days":{"type":"number","description":"Lookback window in days. Range [7, 365]. Default 30."},"coingecko_id":{"type":"string","description":"CoinGecko coin id (e.g. 'ethereum', 'bitcoin', 'solana'). Lower-case slug, not the symbol."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"days":{"type":"integer"},"source":{"type":"string"},"coingecko_id":{"type":"string"},"returns_count":{"type":"integer"},"last_price_usd":{"type":"number"},"first_price_usd":{"type":"number"},"daily_volatility_pct":{"type":"number"},"annualized_volatility_pct":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"days":30,"source":"coingecko","coingecko_id":"ethereum","returns_count":30,"last_price_usd":3284.13,"first_price_usd":3142.55,"daily_volatility_pct":3.421,"annualized_volatility_pct":65.3742}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AN_FZL0ekAIbA5eB__zKc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes annualized and daily historical volatility (log-return standard deviation) for any CoinGecko-listed cryptocurrency token over a configurable lookback window","exampleAgentPrompt":"What's the annualized historical volatility of Solana over the last 60 days? Use its CoinGecko ID 'solana' and give me the daily vol too.","exampleUseCases":[{"title":"Portfolio risk assessment for DeFi tokens","prompt":"I'm considering adding Chainlink to my portfolio — can you calculate its annualized volatility over the last 90 days using its CoinGecko ID 'chainlink'? I want to see the daily vol as well."},{"title":"Options pricing volatility input","prompt":"I need the 30-day historical volatility for Ethereum (CoinGecko ID: ethereum) to plug into my options pricing model — give me both daily and annualized figures."},{"title":"Comparing volatility across crypto assets","prompt":"Can you get me the 14-day annualized volatility for Bitcoin (CoinGecko ID: bitcoin) so I can compare it against other assets in my risk dashboard?"}],"resultDescription":"Returns a JSON object containing: daily volatility as a percentage, annualized volatility as a percentage (daily vol × sqrt(365)), the number of log-return observations used in the calculation, and the first and last closing prices from the selected period.","failureModes":["Invalid or unrecognized CoinGecko token ID returns an error — token must be a valid CoinGecko slug (e.g. 'bitcoin', not 'BTC')","Requesting too few days (e.g. N=1) may yield insufficient data points for a meaningful standard deviation","CoinGecko rate limits or downtime may cause upstream failures","N values beyond CoinGecko's free-tier history window may return incomplete data","Payment failure via x402 will block the request before computation"],"whenToPreferThis":"Choose this endpoint when you need a fast, single-call annualized volatility figure for any CoinGecko-listed token without building your own price-history pipeline. It is ideal for risk scoring, options input, portfolio analytics, or any agent workflow that needs a reliable crypto vol number backed by CoinGecko data. Prefer it over rolling your own when you want log-return methodology and annualization already handled, and when USDC micropayment via x402 is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:12:25.696Z","isFirstParty":false}