# Coil Market Leaders

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

Returns today's top market-leading stocks per index book (S&P 500, Nasdaq-100, macro), ranked by opportunity score with entry state, hold strength, growth score, and dollar volume.

## Facts

- Endpoint: GET https://coil.trade/api/board/leaders
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-market-leaders-e749adec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iPknzUKfDaHUajCw7mUSY

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-market-leaders-e749adec
```

Example prompt: Pull up today's Coil market leaders — I want to see which S&P 500 and Nasdaq-100 stocks are in confirmed uptrends and ranked highest by opportunity score right now, including their entry state and hold strength.

## When to prefer this

Use this endpoint when you need a pre-ranked, cross-book view of the strongest market leaders rather than scoring a single stock or scanning all stocks. Ideal for quickly identifying leadership rotation signals, building a watchlist of high-opportunity names, or determining which stocks are driving index strength. Prefer over the buy list endpoint when you want uptrend leaders across multiple index books simultaneously rather than a single actionable buy list.

## Known failure modes

- Market closed or outside trading hours — data may be stale or endpoint returns last known snapshot
- Rate limiting or payment failure (x402) — requires valid USDC payment per call
- Empty result set if no stocks meet leadership criteria on a given day
- Network timeout if called during high-traffic market open periods

## How this service works

Today's market leaders, ranked — which stocks are leading the tape right now? Top leadership names per book (S&P 500, Nasdaq-100, macro) by opportunity score, each with opportunity 0-100 + percentile, entry state, hold strength, growth score, dollar volume and coil read. Plus the AWARENESS block: sector money flows (mean move + breadth), coiled setups (compression or held post-catalyst, coil_score 0-100) and coverage. Refreshed ~5 min in market hours, timestamped. Research, not advice.

## Output

A ranked list of top market-leading stocks per index book (S&P 500, Nasdaq-100, macro), each with an opportunity score (0-100), opportunity percentile, entry state, hold strength, growth score, 20-day dollar volume, and a timestamp. Refreshed approximately every 5 minutes during market hours.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": {
   "spx": [
    {
     "sym": "NVDA",
     "name": "NVIDIA",
     "state": "firing",
     "hold_q": 88,
     "sector": "Information Technology",
     "entry_q": 62,
     "opp_pct": 97,
     "adv20_usd": 26800000000,
     "growth_score": 58.8
    }
   ]
  },
  "product": "coil-leaders",
  "ranking": "top 10 leadership names per book by opportunity score",
  "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-market-leaders-e749adec/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)