symbols

One sector's most-covered tickers

Changed on

The tickers in a sector (by slug, e.g. financial-services), ranked by recent enriched-news coverage. Powers the /stocks/{slug} sub-pages. Returns up to 500 index-eligible tickers per page, ordered by coverage descending then ticker. Increment page while has_next is true. count is the number on this page; total_count is the whole sector. A page beyond the end returns an empty symbols array and has_next: false. Rankings refresh periodically; this is a live directory, not a historical snapshot.

get/api/symbols/sectors/{slug}/

Request

  • Base URL
    https://api.alphai.io
  • URL
    https://api.alphai.io/api/symbols/sectors/{slug}/
  • Auth
    HTTP bearer

Path parameters

slugstring required

Query parameters

pageinteger

One-based sector page, 500 tickers per page.

Response

The sector and its most-covered tickers.

sectorstring required
slugstring required
countinteger required

Number of symbols on this page.

total_countinteger required

Total index-eligible symbols in the sector.

pageinteger required
page_size500 required
has_nextboolean required

Example response

{
  "symbols": [
    {
      "ticker": "NVDA",
      "name": "NVIDIA Corp"
    }
  ]
}

Changes

    • info

      added the new optional query request parameter page

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status