latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

Symbol Lookup

Lookup by symbol

Returns enriched profile (name, CIK, exchange, sector, industry, description, logo) for a given ticker symbol.

get/api/lookup/symbol

Query parameters

symbolstring

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

Response

Symbol profile

symbolsstring[]

Tickers of the entity's currently active listings, primary first. Positionally aligned with exchanges (symbols[i] trades on exchanges[i]); not deduplicated, so a multi-class issuer lists every class.

exchangesstring[]

Exchange for each ticker in symbols, in the same order. Not deduplicated.

namestring

Company or fund name

cikinteger

SEC Central Index Key

seriesIdinteger

Series ID (0 for stocks, non-zero for ETF/mutual fund series sharing a CIK)

type'stock' | 'etf' | 'mf' | 'cef' | 'fund'

Security type

sectorstring nullable

Business sector derived from SIC code

industrystring nullable

Industry classification derived from SIC code

industryGroupstring nullable

High-value industry group (Semiconductors, Software & SaaS, Pharma & Biotech, Aerospace & Defense, Automotive, Airlines, Oil & Gas, Fintech & Payments). Null if company is not in one of these groups.

compositeFigistring nullable

Bloomberg Composite FIGI

eininteger nullable

Employer Identification Number

formerNamesstring[]

Historical company names

status'operating' | 'delisted'

Operating status. delisted ONLY when the entity has no active listing left on ANY exchange (it has gone fully dark and no longer trades anywhere we track, including OTC). A company that left a major exchange but still trades over-the-counter reads operating; see priorTickers for the listings it has left behind.

Example response

{
  "symbols": [
    "BRK-B",
    "BRK-A"
  ],
  "exchanges": [
    "NYSE",
    "NYSE"
  ],
  "name": "Apple Inc.",
  "cik": 320193,
  "type": "stock",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "industryGroup": "Software & SaaS",
  "compositeFigi": "BBG000B9XRY4",
  "ein": 942404110,
  "formerNames": [
    "APPLE COMPUTER INC"
  ],
  "status": "operating",
  "priorTickers": [
    {
      "symbol": "NLST",
      "exchange": "Nasdaq",
      "lastSeen": "2023-09-30"
    }
  ]
}