How to Map Tickers to Sectors and Industries via API

Pull a consistent ticker-to-sector-and-industry map from Alphanume and use it to build sector-neutral universes.

Consistency is the whole point of a classification map. If your sector labels drift between data sources, your sector-neutral strategy quietly stops being neutral. The Alphanume Ticker Classification endpoint gives you one stable taxonomy that lines up with the rest of the Alphanume datasets.

The endpoint

GET https://api.alphanume.com/v1/ticker-classification

Authenticate with ?api_key=alp_your_key or an X-API-Key header. The filters are ticker, sector, and industry. Sector and industry values are lowercase and underscore-separated, and an invalid value returns a 400.

Look up one ticker

import requests

r = requests.get(
    "https://api.alphanume.com/v1/ticker-classification",
    params={"ticker": "NVDA", "api_key": "alp_your_key"},
)
row = r.json()["data"][0]
print(row["alphanume_sector"], row["alphanume_industry"])

Pull a whole sector or industry

Drop the ticker and pass a sector or industry to get the full membership list:

GET https://api.alphanume.com/v1/ticker-classification?industry=semiconductors&api_key=alp_your_key

From there, building a sector-neutral universe is straightforward. Pull every name with its alphanume_sector, group your signals within each sector, and rank or weight inside the group so no single sector dominates your exposure.

Join it to other datasets

Because the classification is stable and has no date dimension, it is the natural join key for the rest of the catalog. Tag your IV/HV Rank or IV/HV Premium pulls with sector and industry to study volatility within and across groups, or to run sector-relative volatility screens.

Access and limits

Ticker Classification is on the free tier as a rolling 30-day delayed window, Pro at 600 requests per minute. Start with a free Alphanume API key and the API documentation, or explore it on Alphanume.

A join key for the whole catalog

The real power of a stable classification is composition. Tag a volatility pull from IV/HV Rank or IV/HV Premium with each name's sector and industry, and you can run sector-relative volatility screens, build sector-neutral baskets, or study how a factor behaves within versus across groups. The map is the connective tissue between datasets.

Because it has no date dimension, there is nothing to align in time: one lookup per ticker gives you alphanume_sector and alphanume_industry that stay constant across your pipelines. Pull a single sector with sector=technology, or a single industry with industry=semiconductors, to get a full membership list in one call.

Frequently asked questions

What is the classification endpoint?

GET https://api.alphanume.com/v1/ticker-classification. Authenticate with ?api_key=alp_your_key or an X-API-Key header.

How do I look up one ticker?

Pass ticker and read alphanume_sector and alphanume_industry from the returned row.

How do I pull a whole sector?

Drop the ticker and pass sector or industry, for example industry=semiconductors, to get the full membership list.

How does it help with sector-neutral strategies?

Tag each name with its sector, group your signals within sectors, and rank or weight inside each group so no single sector dominates your exposure.

Can I join it to volatility data?

Yes. Because it is stable with no date dimension, it is a clean join key for datasets like IV/HV Rank and IV/HV Premium, enabling sector-relative volatility screens.