# Coil Index Scores

> Coil Index Scores is a paid API for AI agents from coil.trade, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns opportunity scores, percentiles, signal lights, entry states, and regime verdicts for major market indices (S&P 500/SPY, Nasdaq-100/QQQ) plus macro and BTC/ETH crypto books

## Facts

- Endpoint: GET https://coil.trade/api/board/indices
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-index-scores-1d5e8ac3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rBtSe1jOaxY4qjG1nFDqE

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-index-scores-1d5e8ac3
```

Example prompt: Give me the current Coil index scores for SPY, QQQ, and the crypto book — I want to see the opportunity scores, green/yellow/red signals, and regime verdicts before I decide whether to trade today.

## When to prefer this

Use this endpoint when you need a fast, cheap top-down read of the entire market tape across the four major books (S&P 500, Nasdaq-100, macro, crypto) in a single call. Prefer this over single-name or sector endpoints when doing regime-level or index-level assessment before drilling into individual stocks or sectors.

## Known failure modes

- Payment not included or insufficient (402 Payment Required)
- Service temporarily unavailable during off-market hours (data may be stale)
- Network timeout if endpoint is slow to respond
- Malformed response if data feed is interrupted

## How this service works

Index scores for trading agents — how strong is each major index right now? One read returns the scored index row per book: S&P 500 (SPY) and Nasdaq-100 (QQQ) plus the macro and BTC/ETH crypto books — 0-100 opportunity score, percentile, green/yellow/red light and entry state for each index, with every book's regime verdict alongside. The cheapest top-down read of the whole tape. Refreshed ~5 min in market hours, timestamped. Research, not advice.

## Output

Returns one scored row per book: S&P 500 (SPY), Nasdaq-100 (QQQ), macro, and BTC/ETH crypto. Each row includes a 0-100 opportunity score, percentile rank, green/yellow/red signal light, entry state, and regime verdict. Data is refreshed approximately every 5 minutes during market hours and includes a timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": {
   "spx": {
    "index": {
     "sym": "SPY",
     "light": "g",
     "state": "cold",
     "opp_pct": 90,
     "opp_score": 65.5
    },
    "label": "SPX",
    "verdict": "…",
    "regime_mode": "NAMES_ON"
   }
  },
  "product": "coil-indices",
  "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-22",
  "book_order": [
   "spx",
   "qqq",
   "macro",
   "crypto"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coil-index-scores-1d5e8ac3/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)