# Volatility Regime Detector

> Volatility Regime Detector is a paid API for AI agents from api.edifiedlab.com, paid per call via x402, $0.011/call, status unknown (last checked 2026-10-01).

Returns ATR percentile-based volatility regime classification and optional VIX z-score for a specified futures instrument.

## Facts

- Endpoint: GET https://api.edifiedlab.com/v1/market/vol-regime?utm_source=zero.xyz
- Price: $0.011/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/volatility-regime-detector-b6fc4506
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nrc9Hpfn6Jwwcc7AxT2Dz

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 volatility-regime-detector-b6fc4506
```

Example prompt: What's the current volatility regime for MNQ micro Nasdaq futures — give me the ATR percentile and whether we're in a high or low vol environment?

## When to prefer this

Choose this endpoint when you need a fast, pre-computed volatility regime signal for a specific micro or standard futures instrument without needing to run your own ATR calculations. It is especially useful for options traders sizing positions based on historical vol percentile, or for systematic traders who switch strategies based on regime. It covers a curated set of CME and CBOT futures; for equities or ETFs, look elsewhere.

## Known failure modes

- Invalid or unsupported instrument symbol returns a validation error — only the enumerated symbols (MES, MNQ, MYM, etc.) are accepted
- Missing instrument query parameter returns a 400 bad request
- Stale market data may result in an as-of date that lags the current trading session
- Payment failure (x402) results in a 402 Payment Required response
- Service unavailability returns a 5xx error

## How this service works

Options-style volatility regime: ATR percentile and market-regime detection for a futures instrument.

## Output

Returns a JSON object containing the instrument symbol, the current ATR percentile (0–100 scale indicating where recent volatility sits vs. its historical range), an optional VIX z-score over a 20-period window, a payload type ('vol_regime'), an action field ('status'), and the as-of date for the data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "instrument"
     ],
     "properties": {
      "instrument": {
       "enum": [
        "MES",
        "MNQ",
        "MYM",
        "M2K",
        "MCL",
        "MGC",
        "M6E",
        "M6B",
        "SIL",
        "MHG",
        "MNG",
        "ZT",
        "ZN",
        "ZB",
        "MBT",
        "ZC",
        "ZS",
        "ZW",
        "ZL",
        "ZM",
        "HE",
        "LE",
        "6E",
        "6B",
        "6A",
        "6J",
        "UB",
        "PL",
        "M6A",
        "MET"
       ],
       "type": "string",
       "example": "MNQ"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "payload",
      "action",
      "instrument",
      "atr_pctile",
      "asof"
     ],
     "properties": {
      "asof": {
       "type": "string",
       "format": "date"
      },
      "action": {
       "type": "string",
       "const": "status"
      },
      "payload": {
       "type": "string",
       "const": "vol_regime"
      },
      "vix_z20": {
       "type": "number"
      },
      "atr_pctile": {
       "type": "number"
      },
      "instrument": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/volatility-regime-detector-b6fc4506/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.edifiedlab.com](https://www.zero.xyz/host/api.edifiedlab.com/llms.txt)