Syminfo

Symbol information namespace providing metadata about the current trading symbol.

View as Markdown

Symbol information namespace providing metadata about the current trading symbol.

Symbol Identification

ConstantStatusDescription
syminfo.current_contractContract name for futures (e.g., "Perpetual")
syminfo.descriptionHuman-readable description (e.g., "BTC / USDT Perpetual")
syminfo.isinISIN code (empty for crypto)
syminfo.main_tickeridMain ticker identifier
syminfo.prefixExchange identifier (e.g., "BINANCE")
syminfo.rootBase asset/root symbol (e.g., "BTC")
syminfo.tickerSymbol name (e.g., "BTCUSDT", "BTCUSDT.P")
syminfo.tickeridExchange:Symbol format (e.g., "BINANCE:BTCUSDT"); carries the chart-type modifier on a non-standard chart (e.g., "BINANCE:BTCUSDT;heikinashi" — see note)
syminfo.typeInstrument type ("crypto" or "futures")
syminfo.prefix()Prefix function
syminfo.ticker()Ticker function

Currency & Location

ConstantStatusDescription
syminfo.basecurrencyBase currency (e.g., "BTC")
syminfo.currencyQuote currency (e.g., "USDT")
syminfo.timezoneTimezone (always "Etc/UTC" for crypto)
syminfo.countryCountry code (empty for crypto)

Price & Contract Info

ConstantStatusDescription
syminfo.mintickMinimum price increment (from Binance filters)
syminfo.pricescalePrice scale (inverse of tick size)
syminfo.minmoveMinimum movement (always 1)
syminfo.pointvaluePoint value/contract multiplier
syminfo.mincontractMinimum contract size (from Binance filters)

Session & Market

ConstantStatusDescription
syminfo.sessionTrading session (always "24x7" for crypto)
syminfo.volumetypeVolume type (always "base" for crypto)
syminfo.expiration_dateContract expiration (0 for perpetuals, timestamp for delivery)

Company Data

ConstantStatusDescription
syminfo.employeesNumber of employees (N/A for crypto, returns 0)
syminfo.industryIndustry sector (N/A for crypto, returns "")
syminfo.sectorMarket sector (N/A for crypto, returns "")
syminfo.shareholdersNumber of shareholders (N/A for crypto, returns 0)
syminfo.shares_outstanding_floatFloat shares (N/A for crypto, returns 0)
syminfo.shares_outstanding_totalTotal shares (N/A for crypto, returns 0)

Analyst Ratings

ConstantStatusDescription
syminfo.recommendations_buyBuy recommendations (N/A for crypto, returns 0)
syminfo.recommendations_buy_strongStrong buy recommendations (N/A for crypto, returns 0)
syminfo.recommendations_dateRecommendations date (N/A for crypto, returns 0)
syminfo.recommendations_holdHold recommendations (N/A for crypto, returns 0)
syminfo.recommendations_sellSell recommendations (N/A for crypto, returns 0)
syminfo.recommendations_sell_strongStrong sell recommendations (N/A for crypto, returns 0)
syminfo.recommendations_totalTotal recommendations (N/A for crypto, returns 0)

Price Targets

ConstantStatusDescription
syminfo.target_price_averageAverage price target (N/A for crypto, returns 0)
syminfo.target_price_datePrice target date (N/A for crypto, returns 0)
syminfo.target_price_estimatesNumber of estimates (N/A for crypto, returns 0)
syminfo.target_price_highHigh price target (N/A for crypto, returns 0)
syminfo.target_price_lowLow price target (N/A for crypto, returns 0)
syminfo.target_price_medianMedian price target (N/A for crypto, returns 0)

Implementation Notes

Chart-Type Modifier in tickerid

On a non-standard chart — declared by constructing PineTS with an extended ticker, e.g. new PineTS(source, 'BTCUSDT;heikinashi', 'D', …)syminfo.tickerid carries the chart-type suffix ("BINANCE:BTCUSDT;heikinashi"), matching TradingView's behavior of encoding the chart type into the ticker id. syminfo.ticker stays clean. ticker.standard(syminfo.tickerid) strips the modifier; passing the modified tickerid to request.security routes a chart-typed data request to the data source (see Ticker and Chart).

Binance Provider

The BinanceProvider implementation supports:

  • Spot Markets: Standard symbols like BTCUSDT, ETHUSDT
  • Perpetual Futures: Symbols with .P suffix like BTCUSDT.P, ETHUSDT.P
  • Delivery Futures: Symbols with _ like BTCUSD_210625

Market Type Detection

  • Symbols ending with .P → Perpetual futures (uses fapi.binance.com)
  • Symbols containing _ → Delivery futures (uses dapi.binance.com)
  • Other symbols → Spot market (uses api.binance.com)

On this page