# Coil Sector Drill-Down

> Coil Sector Drill-Down is a paid API for AI agents from coil.trade, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Returns every stock in a given sector with full Coil scores (opportunity, entry quality, hold strength, growth, gap-risk, leadership) ranked by opportunity, plus the sector ETF row

## Facts

- Endpoint: GET https://coil.trade/api/board/sector
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-sector-drill-down-fb27ee4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LqOAxMHTk2Gu-qcnSwnx0

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-sector-drill-down-fb27ee4e
```

Example prompt: Pull the full Coil sector drill-down for Energy — give me every stock scored by opportunity, entry quality, hold strength, and gap-risk, ranked best to worst, using either the sector name 'Energy' or the ETF ticker XLE.

## When to prefer this

Use this endpoint when you need a comprehensive, scored view of all stocks within a specific sector — especially when doing sector rotation analysis, comparing opportunity scores within a sector, or identifying the best entry candidates inside Energy, Technology, Financials, or any of the 20 supported sector groups. Prefer this over the single-name endpoint when you don't know which specific stock to examine and want to survey the entire sector landscape.

## Known failure modes

- Unknown sector name returns sector directory listing rather than stock scores
- Invalid ETF ticker returns an error or empty result
- Missing both 'name' and 'etf' query parameters may return an error or the sector directory
- Rate limiting or payment failure (x402) if USDC payment not properly handled
- Network timeout for large sectors with many constituents

## How this service works

Every stock in one sector, scored — GET /api/board/sector?name=Energy (or ?etf=XLE) returns each member of that sector with the full Coil read: opportunity 0-100 + percentile, entry quality and state, hold strength, growth score, overnight gap-risk score, leadership flag and dollar volume, ranked by opportunity, plus the sector's own ETF row. All 20 sector groups across the S&P 500, Nasdaq-100 and macro book. ~5-min refresh. Research, not advice.

## Output

A ranked list of every stock in the specified sector, each with: opportunity score (0-100) and percentile, entry quality and state, hold strength score, growth score, overnight gap-risk score, leadership flag, dollar volume — plus the sector's own ETF row at the top. Unknown sector names return the sector directory instead.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "etf": {
   "sym": "XLE",
   "light": "g",
   "state": "cold",
   "opp_pct": 80,
   "opp_score": 62.1
  },
  "sector": "Energy",
  "members": [
   {
    "sym": "XOM",
    "name": "Exxon Mobil",
    "state": "ready",
    "hold_q": 84,
    "entry_q": 70,
    "opp_pct": 91,
    "gap_risk": 14,
    "adv20_usd": 2100000000,
    "gap_level": "LOW",
    "is_leader": true,
    "growth_score": 55
   }
  ],
  "product": "coil-sector",
  "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coil-sector-drill-down-fb27ee4e/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)