---
name: coil.trade
description: coil.trade provides a single-endpoint market regime classification service that returns top-down verdicts (risk-on, be-selective, stand-down) for US equities (SPX, QQQ), macro, and crypto books. The payload includes sector ladder state, open sectors, qualified names count, and freshness metadata indicating when to next poll. It is a scheduled-update snapshot, not a streaming feed.
host: coil.trade
---

# coil.trade

coil.trade serves traders and trading agents that need a structured, top-down market regime signal before making position or sizing decisions. It offers a single resource covering multiple books (SPX, QQQ, macro, crypto) in one call, with explicit polling cadence metadata to prevent redundant requests. It does not provide price data, order execution, or individual security analysis.

## When to use this host

Use coil.trade when an agent needs a structured, multi-book market regime verdict (risk-on / be-selective / stand-down) as a prerequisite to position entry or trade sizing decisions. It is the right choice for top-down regime gating before acting on individual signals. Do not use it for real-time or streaming price quotes, OHLCV data, individual stock screening, or order execution — use a market data provider or brokerage API for those. Respect the X-Coil-Next-Refresh timestamp in the response; re-calling before that time returns an identical payload and wastes a request.

## Capabilities

### Market Regime Classification

Returns the current top-down regime verdict across US equity and crypto books, including sector ladder state and qualified names count, enabling agents to determine whether conditions favor entering positions, being selective, or standing aside.

- **`fetch-market-regime-board`** — Returns live market regime verdicts (risk-on / be-selective / stand-down) for SPX, QQQ, macro, and crypto books, including sector ladder state, open sectors, qualified names count, and poll freshness metadata.

## Skill reference

### `fetch-market-regime-board`

**Coil Market Regime Board** — Returns live market regime verdicts (risk-on / be-selective / stand-down) for SPX, QQQ, macro, and crypto books, including sector ladder state, open sectors, qualified names count, and poll freshness metadata.

*Use when:* Use when an agent needs the current top-down market regime verdict for US equities or crypto before deciding whether to enter positions, size trades, or stand aside in cash; also use to determine the correct polling interval via freshness metadata.

*Not for:* Do not use for real-time streaming price feeds or individual stock quotes; this is a single-shot regime snapshot updated on a fixed schedule. Do not re-call before the X-Coil-Next-Refresh timestamp — the payload will be identical.

**Returns:** Returns a JSON object with regime verdicts per book (SPX, QQQ, macro, crypto), each containing a plain-English verdict, ladder rung (NAMES/CASH/etc.), open sectors, qualified names count, and per-sector state; response headers indicate market open status and next refresh time.

**Example:** `GET https://coil.trade/api/board/regime`

---