---
title: "One sector's most-covered tickers"
method: GET
path: "/api/symbols/sectors/{slug}/"
tags: ["symbols"]
---

# One sector's most-covered tickers

`GET /api/symbols/sectors/{slug}/`

The tickers in a sector (by slug, e.g. `financial-services`), ranked by
recent enriched-news coverage. Powers the /stocks/{slug} sub-pages.

## Path parameters

- `slug` string, required

## Response `200`

The sector and its most-covered tickers.

- SectorSymbols
  - `sector` string, required
  - `slug` string, required
  - `count` integer, required
  - `symbols` DirectorySymbol[], required
    - `ticker` string, required
    - `name` string, required
    - `news_count` integer, required — Above-floor enriched-news rows mentioning the ticker in the window.

## Other responses

- `401` — Missing or invalid API key.
- `404` — Unknown sector slug.
- `429` — Rate limit exceeded — either the per-minute burst cap or the per-day volume cap. The `Retry-After` header tells you how long to wait (a burst block is short, ≤60s; a day-cap block is capped at 3600s — the true reset is `X-RateLimit-Reset`). The `X-RateLimit-*` trio shows the daily volume budget. The body's `extra` names your tier, its `limit_per_minute` / `limit_per_day`, `retry_after_seconds`, and — below Pro — an `upgrade` block with the higher tiers' caps and the pricing URL.

---

[API](https://skmtc.net/alphai/apis/alphai-rest-api.md) · [All operations](https://skmtc.net/alphai/apis/alphai-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alphai/alphai-rest-api/revisions/2f34f38bad24/schema)
