v2

latestOpenAPI 3.1.0Proprietary2026-08-05143259.2 KB

symbols

Symbol detail

get/api/symbols/{ticker}/

Path parameters

tickerstring required

Example:BTC-USD

Ticker symbol. US equities are bare (AAPL); cryptocurrencies use the <SYM>-USD form (BTC-USD); foreign listings use the Yahoo suffix (VOD.L).

Response

Symbol with extended metadata. Resolves delisted symbols too: check status, and renamed_to for the successor ticker when the company continues under a new symbol.

symbolstring required

namestring required

asset_typestring

Stock, ETF, or Crypto.

exchangestring

TradingView exchange prefix. US: NYSE / NASDAQ / AMEX / OTC / CBOE (from SEC's exchange mapping). Foreign listings carry their venue prefix (LSE, XETR, EURONEXT, TSE, HKEX, KRX, …); crypto carries the CRYPTO sentinel. Empty string when unknown.

sectorstring

industrystring

descriptionstring

websitestring uri nullable

brand_aliasesstring[]

Lowercase names the issuer is known by, when they differ from name (["spacex"] on SPCX, registered as SPACE EXPLORATION TECHNOLOGIES CORP). Use them to match a name a user typed against a ticker. Usually empty: most issuers are already reachable by their registered name. List responses only.

countrystring

ISO alpha-2 country of domicile. US for SEC-listed symbols, the listing venue's country for foreign listings. Empty for crypto — a coin has no domicile.

currencystring

Trading currency. USD for SEC-listed symbols and crypto pairs, the local currency for foreign listings.

statusstring

Listing status, active or delisted. Delisted symbols stay resolvable on this endpoint so their news history remains reachable.

delisted_atstring date-time nullable

When the symbol was marked delisted. Null for active symbols and for symbols delisted before July 2026.

renamed_tostring

Set on a delisted symbol when the company continues under a new ticker (for example SATS became ECHO). Empty otherwise.

Example response

{
  "asset_type": "Stock",
  "exchange": "NASDAQ",
  "brand_aliases": [
    "spacex"
  ],
  "country": "US",
  "currency": "USD",
  "status": "active"
}