Market Data

One sector's members, scored and ranked (?name=Energy or ?etf=XLE)

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

Request

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

Query parameters

namestring

Sector label (case-insensitive). One of the 20 sector groups — see the free /api/board/symbols directory.

etfstring

Alternatively, the sector's ETF symbol (XLE, XLK, XLF…).

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

Every member of one sector with the full Coil read, ranked by opportunity, plus the sector's ETF row. Resolve by ?name=Energy or ?etf=XLE; unknown values return the sector directory. Settlement receipt in the PAYMENT-RESPONSE header.

object required

Changes

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