# Coil Trade Market Regime Classifier

> Coil Trade Market Regime Classifier is a paid API for AI agents from coil.trade, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns a market regime verdict (trade, be selective, or stand down) per book (S&P 500, Nasdaq-100, macro, crypto) with green sectors and the top-down permission ladder for individual stock entry, refreshed ~5 minutes during market hours.

## Facts

- Endpoint: GET https://coil.trade/api/board/regime
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-trade-market-regime-classifier-ea05cabe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4ray_EzsA664lvbQ6W7TH

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 coil-trade-market-regime-classifier-ea05cabe
```

Example prompt: What's the current market regime — is the tape risk-on or risk-off right now, and does the top-down permission ladder say I'm clear to enter individual stock names in the S&P 500 and Nasdaq-100?

## When to prefer this

Use this endpoint when a trading agent needs to make a top-down go/no-go decision before entering any position — specifically when you want a structured regime classification across multiple books (equities, macro, crypto) with sector-level and name-level entry permission, rather than raw price data or a stock screener. Prefer this over generic market data endpoints when you need a pre-computed risk-on/risk-off regime verdict with a permission hierarchy rather than computing it yourself.

## Known failure modes

- Service unavailable outside market hours — regime data may be stale or endpoint may return an error
- Rate limiting or payment failure for x402 micropayment — returns 402 Payment Required
- Temporary data refresh lag — timestamp may indicate data older than the ~5 min refresh window
- Network timeout if regime calculation is in progress
- Empty or null sector list if no sectors meet the green threshold

## How this service works

Market regime classifier for trading agents — is the tape risk-on or risk-off right now? Returns a regime verdict per book (S&P 500, Nasdaq-100, macro, crypto): trade, be selective, or stand down — with the market-state mode, which sectors are green, and the top-down permission ladder (index → sector → name) saying whether individual names are enterable at all. Refreshed ~5 min in market hours, timestamped. Research, not advice.

## Output

A JSON object containing a regime verdict per book (S&P 500, Nasdaq-100, macro, crypto) — one of 'trade', 'be selective', or 'stand down' — along with the current market-state mode, a list of green sectors, a top-down permission ladder indicating whether individual names are enterable (index → sector → name), and a refresh timestamp. Labeled as research, not financial advice.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": {
   "spx": {
    "label": "SPX",
    "regime": {
     "mode": "NAMES_ON",
     "ladder": {
      "note": "index + 3 sector(s) open",
      "rung": "NAMES"
     },
     "verdict": "ALL SYSTEMS — index green, 9 sectors green",
     "green_sectors": [
      "Energy",
      "Health Care"
     ]
    }
   }
  },
  "product": "coil-regime",
  "freshness": {
   "poll_hint": "Market open — this board recomputes about every 5 minutes; polling faster returns the same payload.",
   "market_open": true,
   "next_refresh_at": "<ISO-8601 UTC — always present; do not re-buy before this>",
   "data_age_seconds": 142
  },
  "asof_daily": "2026-07-17",
  "book_order": [
   "spx",
   "qqq",
   "macro",
   "crypto"
  ]
 }
}
```

## More

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