{"uid":"cap_BhJa0ezbsPqfXNkHkb_WN","slug":"carbon-cashmere-vol-regime-api-btc-55e1205d","name":"Carbon & Cashmere Vol Regime API – BTC","description":"Professional crypto market intelligence. Real-time prices, signals, and market scoring.","url":"https://api.carbon-cashmere.de/v1/vol-regime/BTC","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"_meta":{"disclaimer":"Informational research data only — not investment advice."},"symbol":"BTC","current_regime":"normal","next_state_probs":{"normal":0.65,"expanded":0.17,"compressed":0.18},"vol_clustering_acf":[0.34,0.21,0.15,0.11,0.08],"current_vol_annualized":0.38,"percentile_vs_lookback":0.45}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zF-b66KCllfJSFjSULdB2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current volatility regime classification, next-state transition probabilities, vol clustering statistics, and annualized volatility percentile for Bitcoin.","exampleAgentPrompt":"What's Bitcoin's current volatility regime right now — is it normal, expanded, or compressed — and what are the probabilities it transitions to each state next?","exampleUseCases":[{"title":"Options strategy vol environment check","prompt":"Before I set up a BTC options position, can you tell me what volatility regime Bitcoin is currently in and how likely it is to shift to an expanded or compressed state soon? I want to make sure I'm sizing my position appropriately for the environment."},{"title":"Risk sizing for BTC trend system","prompt":"I'm running a trend-following system on Bitcoin and need to know whether we're in a compressed or expanded vol regime right now, plus where current annualized vol ranks historically — I adjust my position size based on the vol environment."},{"title":"Detect incoming Bitcoin vol regime shift","prompt":"Is Bitcoin volatility showing any signs of a regime shift right now? Give me the current state, the transition probabilities into an expanded regime, and whether the vol clustering stats suggest momentum or mean-reversion in volatility."}],"resultDescription":"A JSON object containing: the current vol regime label (e.g. 'normal'), transition probabilities to each next state (normal/expanded/compressed), an ACF array for vol clustering at multiple lags, the current annualized volatility as a decimal, and a percentile rank of current vol vs the historical lookback window.","failureModes":["Invalid or unsupported symbol returns 404 or empty result","Network timeout if upstream market data feed is delayed","Malformed response if vol model has insufficient recent data","Payment failure (x402) if USDC balance is insufficient for the $0.01 fee","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need a probabilistic, regime-aware view of Bitcoin's volatility state — particularly useful for options strategies, risk sizing, or trend-following systems that need to adapt to vol environment. Prefer this over simple realized-vol endpoints when you need forward-looking regime transition probabilities and ACF clustering diagnostics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:48:40.131Z","isFirstParty":false}