Did you find this page helpful?

Do you still need help with something?

Ticker Overview

GET

/v3/reference/tickers/{ticker}

Retrieve comprehensive details for a single ticker supported by Polygon.io. This endpoint offers a deep look into a company’s fundamental attributes, including its primary exchange, standardized identifiers (CIK, composite FIGI, share class FIGI), market capitalization, industry classification, and key dates. Users also gain access to branding assets (e.g., logos, icons), enabling them to enrich applications and analyses with visually consistent, contextually relevant information.

Use Cases: Company research, data integration, application enhancement, due diligence & compliance.

Path Parameters

ticker

string

required

The ticker symbol of the asset.

Query Parameters

date

string

Specify a point in time to get information about the ticker available on that date. When retrieving information from SEC filings, we compare this date with the period of report date on the SEC filing.

For example, consider an SEC filing submitted by AAPL on 2019-07-31, with a period of report date ending on 2019-06-29. That means that the filing was submitted on 2019-07-31, but the filing was created based on information from 2019-06-29. If you were to query for AAPL details on 2019-06-29, the ticker details would include information from the SEC filing.

Defaults to the most recent available date.

Code Examples

Query URL

GET

Scroll to see updated query response

Response Attributes

count

integer

optional

The total number of results for this request.

request_id

string

optional

A request id assigned by the server.

results

object

optional

Ticker with details.

active

boolean

Whether or not the asset is actively traded. False means the asset has been delisted.

address

object

optional

Company headquarters address details.

branding

object

optional

Provides URLs aiding in visual identification.

cik

string

optional

The CIK number for this ticker. Find more information here.

composite_figi

string

optional

The composite OpenFIGI number for this ticker. Find more information here

currency_name

string

The name of the currency that this asset is traded with.

delisted_utc

string

optional

The last date that the asset was traded.

description

string

optional

A description of the company and what they do/offer.

homepage_url

string

optional

The URL of the company's website homepage.

list_date

string

optional

The date that the symbol was first publicly listed in the format YYYY-MM-DD.

locale

enum (us, global)

The locale of the asset.

market

enum (stocks, crypto, fx, otc, indices)

The market type of the asset.

market_cap

number

optional

The most recent close price of the ticker multiplied by weighted outstanding shares.

name

string

The name of the asset. For stocks/equities this will be the companies registered name. For crypto/fx this will be the name of the currency or coin pair.

phone_number

string

optional

The phone number for the company behind this ticker.

primary_exchange

string

optional

The ISO code of the primary listing exchange for this asset.

round_lot

number

optional

Round lot size of this security.

share_class_figi

string

optional

The share Class OpenFIGI number for this ticker. Find more information here

share_class_shares_outstanding

number

optional

The recorded number of outstanding shares for this particular share class.

sic_code

string

optional

The standard industrial classification code for this ticker. For a list of SIC Codes, see the SEC's SIC Code List.

sic_description

string

optional

A description of this ticker's SIC code.

ticker

string

The exchange symbol that this item is traded under.

ticker_root

string

optional

The root of a specified ticker. For example, the root of BRK.A is BRK.

ticker_suffix

string

optional

The suffix of a specified ticker. For example, the suffix of BRK.A is A.

total_employees

number

optional

The approximate number of employees for the company.

type

string

optional

The type of the asset. Find the types that we support via our Ticker Types API.

weighted_shares_outstanding

number

optional

The shares outstanding calculated assuming all shares of other share classes are converted to this share class.

status

string

optional

The status of this request's response.