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 AlphAI 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.

crypto_counterpartstring nullable

When this symbol owns a bare string an ACTIVE cryptocurrency also answers to (delisted SOL = Emeren Group vs the coin SOL-USD, BTC = Grayscale ETF vs BTC-USD), the coin's ticker. null for symbols without an active crypto twin. Detail responses only.

crypto_counterpart_namestring

Display name of crypto_counterpart (empty when it is null). 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,
  "crypto_counterpart": "SOL-USD",
  "crypto_counterpart_name": "Solana",
  "status": "active"
}

Changes

Changed in 3 of the 16 revisions of this API.6

Sep 4, 2026b67e4d4f389e2See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Aug 28, 2026da7f6abbd9223See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Aug 5, 20262f34f38bad241See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added

Full history