---
title: "One sector's members, scored and ranked (?name=Energy or ?etf=XLE)"
method: GET
path: "/api/board/sector"
tags: ["Market Data"]
---

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

`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

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

- `name` string
- `etf` string

## Headers

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

## Response `200`

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

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