# Carbon & Cashmere Vol Regime API – BTC

> Carbon & Cashmere Vol Regime API – BTC is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the current volatility regime classification, next-state transition probabilities, vol clustering statistics, and annualized volatility percentile for Bitcoin.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/vol-regime/BTC
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/carbon-cashmere-vol-regime-api-btc-55e1205d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BhJa0ezbsPqfXNkHkb_WN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability carbon-cashmere-vol-regime-api-btc-55e1205d
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Professional crypto market intelligence. Real-time prices, signals, and market scoring.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/carbon-cashmere-vol-regime-api-btc-55e1205d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.carbon-cashmere.de](https://www.zero.xyz/host/api.carbon-cashmere.de/llms.txt)