---
title: "The full scored board — 600+ names, every book, sector lanes, both buy lists"
method: GET
path: "/api/board/agent"
tags: ["Market Data"]
---

# The full scored board — 600+ names, every book, sector lanes, both buy lists

`GET /api/board/agent`

## Request

- Base URL: `https://coil.trade`
- URL: `https://coil.trade/api/board/agent`
- Auth: one of:
  - API key in header `X-PAYMENT`
  - HTTP payment

NO WALLET? This endpoint is paid, but a sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board: top 3 per book, headline fields, one market day delayed), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.

## Query parameters

- `preview` '1'
- `preview` '1'

## Headers

- `PAYMENT-SIGNATURE` string
- `X-PAYMENT` string
- `Authorization` string

## Response `200`

The full scored board (fresh; carries computed_at + intraday flag). Settlement receipt in the PAYMENT-RESPONSE header. Includes a `freshness` object (market_open, data_age_seconds, next_refresh_at, poll_hint) so a client polls only when the board has actually changed.

- object
  - `product` 'coil-board'
  - `asof_daily` string: trading day of the scan, YYYY-MM-DD
  - `computed_at` string: when this scan was computed (PT)
  - `intraday` boolean
  - `book_order` string[]
  - `books` object: per-book regime verdict, index/sector cards, buy-list lanes
  - `names` object[]: ~575 scored names
    - `sym` string
    - `name` string
    - `sector` string
    - `price` number
    - `chg_pct` number
    - `opp_score` number: 0-100 opportunity blend
    - `opp_pct` number: cross-sectional percentile
    - `state` string: entry state: READY/SETUP/WAIT/CHASE/FALLING (plus firing/cold light)
    - `entry_q` number
    - `hold_q` number
    - `hold_label` string
    - `is_leader` boolean
  - `disclaimer` string

## Other responses

- `402`: Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header

---

[API](https://skmtc.dev/coil/apis/coil-scanner-agent-api.md) · [All operations](https://skmtc.dev/coil/apis/coil-scanner-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coil/apis/coil-scanner-agent-api/revisions/e087ee004cfb?raw)