Ticker Overview

GET

/v3/reference/tickers/{ticker}

Retrieve comprehensive details for a single ticker supported by Massive that is active as-of a given date. 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.

For information on delisted tickers, use the All Tickers endpoint with active=false. Use Cases: Company research, data integration, application enhancement, due diligence & compliance.

Indices BasicFree

Indices Starter$49/mo

Indices Advanced$99/mo

Indices BasicFree

Indices Starter$49/mo

Indices Advanced$99/mo

Plan AccessIncluded in all Indices plans

Indices BasicFree

Updated hourly

Indices Starter$49/mo

Updated hourly

Indices Advanced$99/mo

Updated hourly

Indices BasicFree

Updated hourly

Indices Starter$49/mo

Updated hourly

Indices Advanced$99/mo

Updated hourly

Plan RecencyUpdated hourly

Indices BasicFree

All history

Indices Starter$49/mo

All history

Indices Advanced$99/mo

All history

Indices BasicFree

All history

Indices Starter$49/mo

All history

Indices Advanced$99/mo

All history

Plan HistoryRecords date back to February 14, 2023

Path Parameters

ticker

string

required

Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.

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.

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

Enum values: global, us

The locale of the asset.

market

enum

Enum values: crypto, fx, indices, otc, stocks

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.

Code Examples

curl -X GET "https://api.massive.com/v3/reference/tickers/AAPL?apiKey=YOUR_API_KEY"

from massive import RESTClient

client = RESTClient("YOUR_API_KEY")

details = client.get_ticker_details(
	"AAPL",
	)

print(details)

package main

import (
	"context"
	"fmt"
	"log"
	"github.com/massive-com/client-go/v3/rest"
	"github.com/massive-com/client-go/v3/rest/gen"
)

func main() {

	c := rest.NewWithOptions("YOUR_API_KEY",
		rest.WithTrace(false),
		rest.WithPagination(true),
	)
	ctx := context.Background()

	params := &gen.GetTickerParams{
	}

	resp, err := c.GetTickerWithResponse(
		ctx,
		"AAPL",
		params,
	)
	if err != nil {
		log.Fatal(err)
	}

	if err := rest.CheckResponse(resp); err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp.JSON200)
}

import { restClient } from '@massive.com/client-js';

const apiKey = "YOUR_API_KEY";
const rest = restClient(apiKey, 'https://api.massive.com');

async function example_getTicker() {
  try {
    const response = await rest.getTicker(
      {
        ticker: "AAPL",
      }
    );
    console.log('Response:', response);
  } catch (e) {
    console.error('An error happened:', e);
  }
}

example_getTicker();

package com.massive.client

import com.massive.client.apis.DefaultApi
import com.massive.client.infrastructure.*
import com.massive.client.models.*

fun main() {
    ApiClient.apiKey["apiKey"] = "YOUR_API_KEY"

    val api = DefaultApi()
    try {
        val result = api.getTicker(
            ticker = "AAPL",
        )
        println(result)
    } catch (e: Exception) {
        println("Error calling getTicker: ${e.message}")
        e.printStackTrace()
    }
}

Query URL

GET

https://api.massive.com/v3/reference/tickers/{ticker}?apiKey=YOUR_API_KEY

Run query unavailable

Create account or sign in to Massive

Scroll to see updated query response

Response Object

{
  "request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
  "results": {
    "active": true,
    "address": {
      "address1": "One Apple Park Way",
      "city": "Cupertino",
      "postal_code": "95014",
      "state": "CA"
    },
    "branding": {
      "icon_url": "https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_icon.png",
      "logo_url": "https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_logo.svg"
    },
    "cik": "0000320193",
    "composite_figi": "BBG000B9XRY4",
    "currency_name": "usd",
    "description": "Apple designs a wide variety of consumer electronic devices, including smartphones (iPhone), tablets (iPad), PCs (Mac), smartwatches (Apple Watch), AirPods, and TV boxes (Apple TV), among others. The iPhone makes up the majority of Apple's total revenue. In addition, Apple offers its customers a variety of services such as Apple Music, iCloud, Apple Care, Apple TV+, Apple Arcade, Apple Card, and Apple Pay, among others. Apple's products run internally developed software and semiconductors, and the firm is well known for its integration of hardware, software and services. Apple's products are distributed online as well as through company-owned stores and third-party retailers. The company generates roughly 40% of its revenue from the Americas, with the remainder earned internationally.",
    "homepage_url": "https://www.apple.com",
    "list_date": "1980-12-12",
    "locale": "us",
    "market": "stocks",
    "market_cap": 2771126040150,
    "name": "Apple Inc.",
    "phone_number": "(408) 996-1010",
    "primary_exchange": "XNAS",
    "round_lot": 100,
    "share_class_figi": "BBG001S5N8V8",
    "share_class_shares_outstanding": 16406400000,
    "sic_code": "3571",
    "sic_description": "ELECTRONIC COMPUTERS",
    "ticker": "AAPL",
    "ticker_root": "AAPL",
    "total_employees": 154000,
    "type": "CS",
    "weighted_shares_outstanding": 16334371000
  },
  "status": "OK"
}

// Run a query to see a response

package main import ( "context" "fmt" "log" "github.com/massive-com/client-go/v3/rest" "github.com/massive-com/client-go/v3/rest/gen" ) func main() { c := rest.NewWithOptions("YOUR_API_KEY", rest.WithTrace(false), rest.WithPagination(true), ) ctx := context.Background() params := &gen.GetTickerParams{ } resp, err := c.GetTickerWithResponse( ctx, "AAPL", params, ) if err != nil { log.Fatal(err) } if err := rest.CheckResponse(resp); err != nil { log.Fatal(err) } fmt.Printf("%+v\n", resp.JSON200) }

import { restClient } from '@massive.com/client-js'; const apiKey = "YOUR_API_KEY"; const rest = restClient(apiKey, 'https://api.massive.com'); async function example_getTicker() { try { const response = await rest.getTicker( { ticker: "AAPL", } ); console.log('Response:', response); } catch (e) { console.error('An error happened:', e); } } example_getTicker();

package com.massive.client import com.massive.client.apis.DefaultApi import com.massive.client.infrastructure.* import com.massive.client.models.* fun main() { ApiClient.apiKey["apiKey"] = "YOUR_API_KEY" val api = DefaultApi() try { val result = api.getTicker( ticker = "AAPL", ) println(result) } catch (e: Exception) { println("Error calling getTicker: ${e.message}") e.printStackTrace() } }

{ "request_id": "31d59dda-80e5-4721-8496-d0d32a654afe", "results": { "active": true, "address": { "address1": "One Apple Park Way", "city": "Cupertino", "postal_code": "95014", "state": "CA" }, "branding": { "icon_url": "https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_icon.png", "logo_url": "https://api.massive.com/v1/reference/company-branding/d3d3LmFwcGxlLmNvbQ/images/2022-01-10_logo.svg" }, "cik": "0000320193", "composite_figi": "BBG000B9XRY4", "currency_name": "usd", "description": "Apple designs a wide variety of consumer electronic devices, including smartphones (iPhone), tablets (iPad), PCs (Mac), smartwatches (Apple Watch), AirPods, and TV boxes (Apple TV), among others. The iPhone makes up the majority of Apple's total revenue. In addition, Apple offers its customers a variety of services such as Apple Music, iCloud, Apple Care, Apple TV+, Apple Arcade, Apple Card, and Apple Pay, among others. Apple's products run internally developed software and semiconductors, and the firm is well known for its integration of hardware, software and services. Apple's products are distributed online as well as through company-owned stores and third-party retailers. The company generates roughly 40% of its revenue from the Americas, with the remainder earned internationally.", "homepage_url": "https://www.apple.com", "list_date": "1980-12-12", "locale": "us", "market": "stocks", "market_cap": 2771126040150, "name": "Apple Inc.", "phone_number": "(408) 996-1010", "primary_exchange": "XNAS", "round_lot": 100, "share_class_figi": "BBG001S5N8V8", "share_class_shares_outstanding": 16406400000, "sic_code": "3571", "sic_description": "ELECTRONIC COMPUTERS", "ticker": "AAPL", "ticker_root": "AAPL", "total_employees": 154000, "type": "CS", "weighted_shares_outstanding": 16334371000 }, "status": "OK" }