Dashboard

Search symbols

GET/api/lookup/search

Free Starter Pro

Search-as-you-type over tickers and names. Ranking: exact ticker first, then ticker prefixes and names with a word starting with the search term, then other name matches; within each group the more widely held (stocks: 13F holders, funds: net assets) comes first. Warrants, units and rights are excluded. Returns enriched profiles with sector, industry, description, and logo. Covers stocks, ETFs, and mutual funds.

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/lookup/search?searchString=Apple&exchange=NASDAQ&sector=Technology' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Matching tickers ranked by relevance. A multi-class issuer (e.g. Alphabet) returns one result per active ticker (GOOG and GOOGL separately).

Response schema

array of:
  • symbol string | null

    Ticker symbol if available. Null for entities not listed anymore.

  • exchange string | null

    Exchange this ticker is listed on. Null for entity-only matches (see symbol).

  • name string

    Company or fund name

  • cik integer

    SEC Central Index Key

  • seriesId integer

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

  • type string (enum)

    Security type

    Allowed values: stock, etf, mf, cef, fund
  • sector string | null

    Business sector derived from SIC code

  • industry string | null

    Industry derived from SIC code

  • industryGroup string | null

    High-value industry group, or null

  • compositeFigi string | null

    Bloomberg Composite FIGI

  • ein integer | null

    Employer Identification Number

  • formerNames array of string

    Historical company names

  • status string (enum)

    Operating status. `delisted` ONLY when the entity has no active listing left on ANY exchange (fully dark, including OTC). A name still trading OTC after leaving a major reads `operating`.

    Allowed values: operating, delisted
  • priorTickers array of object

    Listings the entity no longer trades on (delisted), e.g. a Nasdaq listing left behind after a move to OTC. Empty for entities that never left a listing.

    array of:
    • symbol string

      The former ticker on this venue

    • exchange string

      The exchange the entity has since left

    • lastSeen string (date) | null

      The most recent date (ISO 8601) this former ticker was confirmed active, its last-seen date, i.e. roughly when the entity stopped trading under it. For a clean ticker rename (no SEC Form 25/15 removal filing) this approximates the switchover and may be a recent period-end rather than the exact change date. Null when unknown.

Example response

[
  {
    "symbol": "GOOGL",
    "exchange": "Nasdaq",
    "name": "Alphabet Inc.",
    "cik": 1652044,
    "seriesId": 0,
    "type": "stock",
    "sector": "Technology",
    "industry": "Computer Programming, Data Processing",
    "industryGroup": "Software & SaaS",
    "compositeFigi": "BBG009S39JX6",
    "ein": 611767919,
    "formerNames": [],
    "status": "operating",
    "priorTickers": [
      {
        "symbol": "NLST",
        "exchange": "Nasdaq",
        "lastSeen": "2023-09-30"
      }
    ]
  }
]

400 Bad Request

Invalid search string

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}