HomeChatAlertsCalendarScreenerWatchlistsFiles
DocsSettings
Sign upJoinLog in

Docs

Overview

IntroductionMCP ServerOpenAPI Spec

REST API

GETAll TickersGETCompany Profile (Ticker)GETCompany Profile (CIK)GETCompany Profile (ISIN)GETCompany Profile (CUSIP)GETCompany Profile (Search)

WebSocket

Live Quotes (Per Second)Live Quotes (Per Minute)Live NewsLive SEC FilingsTrading Halts

Company Profile (Ticker)

GET/v1/companydata/tickers/{ticker}
View as markdown

Retrieve comprehensive reference and profile data for a single ticker. The response includes company or fund name, exchange, sector, industry, country, CEO, employee count, website, CIK and a business description - everything you need to label a ticker in a UI or enrich analytics without a separate fundamentals call. Pass any supported ticker (e.g. AAPL, SPY) as the path parameter.

Use cases

  • Company research and security master enrichment
  • Displaying issuer context next to quotes or portfolio holdings
  • Mapping tickers to CIK for SEC filing workflows
  • Due diligence and compliance reference lookups

Input parameters

(*) Required

ParameterTypeDescription
ticker(*)stringTicker, e.g. AAPL.

Output parameters

FieldTypeDescription
tickerstringTicker.
companystringCompany or fund name.
sectorstringGICS sector when available.
industrystringIndustry classification.
exchangestringPrimary listing exchange.
exchangeShortstringShort exchange code.
countrystringCountry of incorporation or domicile.
etfbooleanTrue when the ticker is an ETF.
fundbooleanTrue when the ticker is a mutual fund.
cikstringSEC Central Index Key.
isinstringInternational Securities Identification Number.
cusipstringCUSIP identifier.
websitestringIssuer website URL.
descriptionstringBusiness description or fund summary.
ceostringChief executive officer when available.
employeesstringEmployee count when available.
phonestringCompany phone number.
addressstringStreet address.
citystringCity.
statestringState or region.
zipstringPostal code.
ipostringIPO date (YYYY-MM-DD) when known.
from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")

result = client.get_ticker("AAPL")

print(result)
{
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "exchange": "NASDAQ Global Select",
  "exchangeShort": "NASDAQ",
  "country": "US",
  "etf": false,
  "fund": false,
  "cik": "0000320193",
  "isin": "US0378331005",
  "cusip": "037833100",
  "website": "https://www.apple.com",
  "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a l...",
  "ceo": "Timothy D. Cook",
  "employees": "164000",
  "phone": "(408) 996-1010",
  "address": "One Apple Park Way",
  "city": "Cupertino",
  "state": "CA",
  "zip": "95014",
  "ipo": "1980-12-12"
}
All Tickers
Company Profile (CIK)