# Coil Top-Volume Scores

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

Returns scored trading signals for the highest-liquidity S&P 500 stocks, ranked by 20-day average dollar volume within each sector.

## Facts

- Endpoint: GET https://coil.trade/api/board/top-volume
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-top-volume-scores-f6ac6b56
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_81ghuxl3s6G2O9rsd4J0V

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-top-volume-scores-f6ac6b56
```

Example prompt: Pull up Coil's top-volume scores right now — I want to see which mega-cap stocks are in a READY entry state across each S&P 500 sector, along with their opportunity scores and leadership flags.

## When to prefer this

Use this endpoint when you need a broad, cross-sector view of the most liquid S&P 500 stocks and their current trading setup quality in a single call. Prefer this over the single-name score endpoint when you want to screen the entire liquid universe at once, and over the sector drill-down when you want top names across all sectors rather than every name in one sector. Best for portfolio-level screening of tradeable mega-caps.

## Known failure modes

- Payment not provided or invalid x402 payment header — returns 402 Payment Required
- Market closed outside regular trading hours — data may be stale or endpoint may return cached last-session values
- Network timeout during high-traffic market open periods
- Malformed request beyond the expected GET with no required query params — returns 400
- Upstream data feed delay may cause scores to lag beyond the typical 5-minute refresh

## How this service works

Scores for the most-traded US stocks — the liquid mega-caps agents actually trade. One read returns the top names by 20-day average dollar volume in every S&P 500 sector, each scored: opportunity 0-100 plus board percentile, entry state (READY / SETUP / WAIT / CHASE / FALLING), hold strength, leadership flag, and the dollar-volume figure that ranked it. High-liquidity names only, no illiquid tail. Refreshed ~5 min in market hours. Research, not advice.

## Output

A list of the top-traded US stocks by sector, each with: opportunity score (0-100), board percentile rank, entry state (READY/SETUP/WAIT/CHASE/FALLING), hold strength value, leadership flag (true/false), and the 20-day average dollar volume figure used to rank them. Results cover every S&P 500 sector and are 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": {
  "product": "coil-top-volume",
  "sectors": {
   "Information Technology": [
    {
     "sym": "NVDA",
     "name": "NVIDIA",
     "state": "firing",
     "hold_q": 88,
     "entry_q": 62,
     "opp_pct": 97,
     "adv20_usd": 28400000000,
     "is_leader": true
    }
   ]
  },
  "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-top-volume-scores-f6ac6b56/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)