# AlgoVault Market Regime Classifier

> AlgoVault Market Regime Classifier is a paid API for AI agents from api.algovault.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Classifies the current market regime (trending up/down or ranging) for a perpetual-futures market, returning confidence score, ADX trend metrics, volatility state, price structure, cross-venue funding sentiment, and a plain-language strategy suggestion.

## Facts

- Endpoint: POST https://api.algovault.com/x402/get_market_regime
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/algovault-market-regime-classifier-3de5649b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4_kLcavd6aluenY9n-la4

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 algovault-market-regime-classifier-3de5649b -d '<json body>'
```

Example prompt: What's the current market regime for BTC on Hyperliquid using the 4h timeframe — is it trending or ranging, how confident are you, and what trading playbook should I use?

## When to prefer this

Use this endpoint when an AI trading agent needs to determine the correct strategy playbook before entering a perpetual-futures position — specifically when you need a structured regime label with confidence and ADX metrics, not just a raw buy/sell signal. Prefer this over generic price feeds when you want explainable regime context (trend vs. ranging) and cross-venue funding sentiment in a single call.

## Known failure modes

- Invalid coin symbol returns 400 or empty result
- Unsupported exchange enum value returns validation error
- Requested timeframe not available for the given exchange
- Insufficient historical candle data for ADX calculation at daily timeframe
- Payment failure or insufficient USDC balance returns 402
- Network timeout from upstream exchange data feed

## How this service works

Market-regime classifier for a perpetual-futures market: returns the regime (e.g. TRENDING_UP / TRENDING_DOWN / RANGING) with a 0–100 confidence, ADX-based trend metrics (strength, slope), volatility state, price structure, cross-venue funding sentiment, and a plain-language strategy suggestion (trend-following vs mean-reversion, position-sizing guidance) so an agent can pick the right playbook before entering.

## Output

Returns a regime label (e.g. TRENDING_UP, TRENDING_DOWN, RANGING), a 0–100 confidence score, ADX-based trend strength and slope, volatility state, price structure summary, cross-venue funding sentiment, and a plain-language recommendation on whether to use trend-following or mean-reversion with position-sizing guidance.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "maxLength": 20,
   "description": "Asset symbol, e.g. BTC, ETH, SOL."
  },
  "exchange": {
   "enum": [
    "HL",
    "BINANCE",
    "BYBIT",
    "OKX",
    "BITGET",
    "ASTER",
    "BINGX",
    "GATE",
    "HTX",
    "KUCOIN",
    "MEXC",
    "PHEMEX",
    "WHITEBIT",
    "XT",
    "WEEX"
   ],
   "type": "string",
   "default": "HL",
   "description": "Derivatives venue to evaluate."
  },
  "timeframe": {
   "enum": [
    "1h",
    "4h",
    "1d"
   ],
   "type": "string",
   "default": "4h",
   "description": "Candle timeframe for regime classification."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/algovault-market-regime-classifier-3de5649b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.algovault.com](https://www.zero.xyz/host/api.algovault.com/llms.txt)