{"uid":"cap_nrc9Hpfn6Jwwcc7AxT2Dz","slug":"volatility-regime-detector-b6fc4506","name":"Volatility Regime Detector","description":"Options-style volatility regime: ATR percentile and market-regime detection for a futures instrument.","url":"https://api.edifiedlab.com/v1/market/vol-regime?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.011","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__3oCmWeuVPQl8ocDU2wK0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ATR percentile-based volatility regime classification and optional VIX z-score for a specified futures instrument.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-trade vol check for options strategy","prompt":"Before I put on a short gamma trade on MES, can you check the current ATR percentile and vol regime so I know if implied vol is stretched or compressed?"},{"title":"Regime filter for automated futures trading","prompt":"Check the volatility regime for ZB Treasury bond futures — I need to know the ATR percentile to decide whether to run my trend-following or mean-reversion strategy today."},{"title":"Multi-asset vol regime dashboard","prompt":"Pull the current volatility regime and ATR percentile for MCL crude oil futures — I'm building a morning briefing on which asset classes are in elevated vol conditions."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:30:06.625Z","isFirstParty":false,"canonicalSlug":"volatility-regime-detector-b6fc4506"}