Market Data

Today's ranked buy candidates per book, with entry windows and leadership flags

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/buylist

Request

  • Base URL: https://coil.trade
  • URL: https://coil.trade/api/board/buylist
  • Auth: one of:
    • API key in header X-PAYMENT
    • HTTP 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

Today's ranked candidate names per book across both lanes (risk-adjusted + swing), with entry windows and leadership flags. 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 required

Changes

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