---
title: "Ticker sector/industry classification: maps every covered US ticker into"
method: GET
path: "/v1/ticker-classification"
---

# Ticker sector/industry classification: maps every covered US ticker into

`GET /v1/ticker-classification`

## Request

- Base URL: `https://api.alphanume.com`
- URL: `https://api.alphanume.com/v1/ticker-classification`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Ticker sector/industry classification: maps every covered US ticker into
Alphanume's own 11-sector / 25-industry scheme (derived from SIC codes, but
normalized into groups actually useful for trading -- e.g. 'semiconductors' and
'software' are separate industries under 'technology'). One row per ticker:
ticker, alphanume_sector, alphanume_industry.

Use it to group any other Alphanume dataset by sector, build sector-neutral
baskets, or pull all names in one industry. Look up one `ticker`, or filter by
`sector`/`industry` to enumerate a group. No date dimension and no tier
restriction -- the mapping is current-state.

## Query parameters

- `ticker` string
- `sector` 'essential_goods' | 'raw_materials' | 'energy_resources' | 'consumer_cyclical' | 'industrial_transport' | 'communications_media' | 'healthcare' | 'technology' | 'utilities_infrastructure' | 'finance' | 'real_assets'
- `industry` 'food_beverage' | 'basic_materials' | 'energy_production' | 'durables_apparel' | 'industrial_equipment' | 'business_services' | 'media_content' | 'pharma_biotech' | 'household_products' | 'automotive' | 'hardware_devices' | 'semiconductors' | 'healthcare_services' | 'transport_logistics' | 'telecom' | 'utilities' | 'retail_cyclical' | 'retail_staples' | 'consumer_services' | 'banking' | 'financial_services' | 'insurance' | 'real_estate_development' | 'reits' | 'software'

## Response `200`

Matching rows.

- Envelope
  - `count` integer, required
  - `data` object[], required

## Other responses

- `400`: Invalid or conflicting query parameters.
- `401`: Missing or unrecognized API key.
- `403`: PRO_SUBSCRIPTION_REQUIRED: the key's plan does not include API access; every endpoint requires an active Pro subscription. DATE_RANGE_RESTRICTED: a legacy free-tier key asked for dates outside its window. In both cases the data is not missing.
- `429`: Rate limit exceeded (600/min); the body carries retry_after_seconds.

---

[API](https://skmtc.dev/alphanume/apis/alphanume-api.md) · [All operations](https://skmtc.dev/alphanume/apis/alphanume-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphanume/apis/alphanume-api/revisions/2cb83f10bba4?raw)