---
title: "Today's ranked buy candidates per book, with entry windows and leadership flags"
method: GET
path: "/api/board/buylist"
tags: ["Market Data"]
---

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

`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

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.

## Headers

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

## Response `200`

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

## 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)