# Coil Single-Name Score

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

Returns the full Coil trading score and state for a single stock symbol — opportunity score, entry quality, hold strength, gap risk, leadership flag, and market regime.

## Facts

- Endpoint: GET https://coil.trade/api/board/name
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-single-name-score-fe122c5c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2qtDJQ-dkGaRNVBAW7lkF

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-single-name-score-fe122c5c
```

Example prompt: What's the Coil score for NVDA right now — is it in a READY state and what's the entry quality and gap risk?

## When to prefer this

Use this endpoint when you need a deep, scored analysis of a single specific stock — you want all scoring dimensions (entry state, hold strength, gap risk, leadership, regime) for one name at once. Prefer this over the scanner or buy-list endpoints when you already know the ticker and want a full Coil read rather than a ranked list.

## Known failure modes

- Unknown or unsupported symbol returns the symbol directory instead of a score
- Market is closed or outside refresh window — scores may be stale (refreshed ~5 min during market hours)
- Invalid query parameter format returns an error
- Network timeout or service unavailability returns a 5xx error
- x402 payment failure if USDC balance is insufficient

## How this service works

Score one name or a whole watchlist in one read. GET /api/board/name?sym=NVDA (or ?sym=NVDA,AMD,MSFT — up to 10 names, one price) returns each name's full Coil read: opportunity 0-100 + percentile, entry quality and state (READY / SETUP / WAIT / CHASE / FALLING), hold strength, growth score, gap-risk, leadership flag, dollar volume, its coil read (coil_score, coil_kind, coil_note) and its book's regime. Any S&P 500, Nasdaq-100 or macro name. ~5-min refresh. Research, not advice.

## Output

Returns a JSON object with the stock's opportunity score (0-100) and percentile, entry state (READY/SETUP/WAIT/CHASE/FALLING), entry quality, hold strength score, growth score, overnight gap-risk score, leadership flag, dollar volume, and the book's current market regime. If the symbol is unknown, returns the symbol directory.

## 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": {
  "name": {
   "sym": "NVDA",
   "name": "NVIDIA",
   "state": "firing",
   "hold_q": 88,
   "sector": "Information Technology",
   "entry_q": 62,
   "opp_pct": 97,
   "gap_risk": 18,
   "adv20_usd": 26800000000,
   "gap_level": "LOW",
   "is_leader": true,
   "opp_score": 71.2,
   "hold_label": "STRONG",
   "growth_score": 58.8
  },
  "product": "coil-name",
  "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_regimes": {
   "spx": {
    "mode": "NAMES_ON",
    "verdict": "…"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coil-single-name-score-fe122c5c/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)