---
title: "Stock directory — most-covered tickers and sector cards"
method: GET
path: "/api/symbols/directory/"
tags: ["symbols"]
---

# Stock directory — most-covered tickers and sector cards

`GET /api/symbols/directory/`

The hub index behind /stocks: the globally most-covered tickers over
the trailing window, plus one card per sector (size + its busiest
names). Ranked by recent enriched-news coverage.

## Response `200`

Most-active tickers and sector cards.

- SymbolDirectory
  - `most_active` DirectorySymbol[], required
    - `ticker` string, required
    - `name` string, required
    - `news_count` integer, required — Above-floor enriched-news rows mentioning the ticker in the window.
  - `sectors` DirectorySector[], required
    - `sector` string, required
    - `slug` string, required
    - `count` integer, required — Total active symbols in the sector.
    - `top` 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.
- `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/d6f73c217935/schema)