# x402stock Market Regime Analysis

> x402stock Market Regime Analysis is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns the current fused US stock market regime (e.g. 'Mixed Signals') combining Fear & Greed score, VIX, insider buying, and net liquidity, plus historical S&P 500 forward returns after similar regimes.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/fear-greed/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/x402stock-market-regime-analysis-f91efed3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2-BoWcfXraTbETQ9oqTJU

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 x402stock-market-regime-analysis-f91efed3
```

Example prompt: What's the current US stock market regime right now — like is it fear-driven or greed-driven — and how has the S&P 500 historically done in the weeks and months after a regime like this?

## When to prefer this

Use this endpoint when you need a single consolidated market regime signal instead of querying Fear & Greed, VIX, and insider data separately. Ideal for portfolio positioning, risk-on/risk-off decisions, or briefing an agent on overall market conditions before executing trades. The built-in historical backtesting (forward return win rates) makes it particularly useful for probabilistic market outlook.

## Known failure modes

- Service unavailable if upstream data sources (VIX, Fear & Greed, Treasury) are delayed or unavailable
- Payment failure if USDC balance insufficient or x402 payment not properly configured
- Null values in regime or indicator fields if data freshness cannot be confirmed
- Rate limiting if too many requests are made in a short period

## How this service works

The combined market regime — one read fusing the stock Fear & Greed score and velocity, VIX, insider-buying sentiment, and net liquidity into a named regime (e.g. Mixed Signals) with severity and a suggested stance, plus how the S&P 500 historically performed after similar regimes (forward 5/22-day and 1/3-month returns and win rates). From x402stock, a market & economic data API (x402, USDC).

## Output

A JSON object containing: the current regime name (e.g. 'Mixed Signals'), severity, description, and suggested action/stance; plus raw indicator values (Fear & Greed score, zone, velocity, VIX value and level label, insider sentiment score and label, liquidity score and label); and historical performance statistics for similar past regimes including average forward 5-day and 22-day percent returns, average 1-month and 3-month SPY returns, and win rates for 1-month and 3-month horizons.

## Example request

```json
{
 "properties": ""
}
```

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-05T00:00:00.000Z",
  "regime": {
   "id": "mixed",
   "name": "Mixed Signals",
   "action": "No historically significant setup detected. Monitor for signal alignment.",
   "severity": "neutral",
   "description": "No clear regime pattern. Signals are not aligned strongly in any direction."
  },
  "source": "x402stock",
  "current": {
   "vix": 15.4,
   "fg_zone": "greed",
   "fg_score": 69,
   "velocity": 5,
   "vix_level": "calm",
   "insider_label": "Sell Pressure",
   "insider_score": 34,
   "liquidity_label": "Expanding",
   "liquidity_score": 42
  },
  "history": {
   "episodes": 154,
   "avg_spy_1m_percent": 1.04,
   "avg_spy_3m_percent": 2.84,
   "win_rate_1m_percent": 70,
   "win_rate_3m_percent": 75,
   "avg_forward_5d_percent": -6.8,
   "avg_forward_22d_percent": -10.6
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-market-regime-analysis-f91efed3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)