Sign in
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.

next_report_datestring date nullable

The next earnings date the company itself has confirmed, in America/New_York. Detail responses only.

Never an estimate. null means AlphaAI holds no confirmed date — NOT that the company does not report. Confirmed dates typically surface about five weeks ahead, so null further out is the normal state, and coverage at any moment is partial. We deliberately do not fill the gap with a projection from the reporting cadence: a date nothing corroborates is indistinguishable downstream from one that does.

Bridges share classes: a request for one class answers with the issuer's confirmed date whichever class it was filed under.

supports_insiderboolean

Whether this symbol has SEC Form 4 insider data — true for US SEC-listed equities, false for crypto and foreign listings. When false, /insider-summary/ and /insider-trades/ return empty rather than failing. Detail responses only.

tv_symbolstring

Per-symbol TradingView symbol override, when the venue-prefix rule built from exchange does not produce the right chart symbol. Empty for almost every row. Detail responses only.

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",
  "next_report_date": "2026-11-17",
  "supports_insider": true,
  "status": "active"
}

Changes