Market Data

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

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.

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

Query parameters

preview'1'

Set to 1 for a FREE sample in the identical schema to the paid board (previous day, top-3 names per book) — validate your parser before paying. No payment header needed.

preview'1'

preview=1 returns a FREE identical-schema preview (previous day, top-3 per book) — no payment.

Headers

PAYMENT-SIGNATUREstring

x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge.

X-PAYMENTstring

x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients.

Authorizationstring

MPP credential: Payment <base64 credential> answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge).

Response

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.

product'coil-board'
asof_dailystring

trading day of the scan, YYYY-MM-DD

computed_atstring

when this scan was computed (PT)

intradayboolean
book_orderstring[]
booksobject

per-book regime verdict, index/sector cards, buy-list lanes

disclaimerstring

Changes

No recorded changes to this operation across all 1 revision of this API.