← tickerbot.io
View as markdown
Concepts

Tickers (rows)

The row axis of the table: every row is one tradeable instrument — every US-listed stock and ETF plus curated rates, FX, metals and crypto series — in one canonical namespace prefixed by asset class so identifiers never collide.

Tickers and the universe

The unit and the population.

A ticker is one tradeable instrument: an equity (AAPL), an interest rate (R:SOFR), a currency pair (X:EURUSD) or a cryptocurrency (X:BTCUSD). The universe is 23,212+ tickers across 4 asset classes.

The non-equity series are curated, not exhaustive. We carry the full US Treasury par-yield curve and the Fed policy rates rather than every rate published; the major currency pairs and spot metals rather than every cross.

Each ticker is one row of the table, carrying every column that applies to its class. The catalog itself is GET /v2/tickers (Tickers › Catalog). The universe tracks the market: new listings appear as they start trading, and a symbol always resolves to whoever holds it now — for delisted companies and reused symbols, read the row as-of a past date and the symbol resolves to whoever held it then.

The asset classes

Equities are bare symbols; every other class carries a prefix.

Asset classPrefixExampleWhat it covers
stocks(none)AAPLEvery US-listed equity — NYSE, Nasdaq and AMEX — including ETFs, ADRs and preferred shares.
ratesR:R:SOFRThe full US Treasury par-yield curve, the Fed policy rates (SOFR, EFFR, and both ends of the target band), and the headline curve spreads.
cryptoX:X:BTCUSDThe major crypto pairs by liquidity, quoted against USD.
fxX:X:EURUSDThe major currency pairs, plus spot gold and spot silver — metals quote and trade as FX pairs, and carry ISO 4217 codes (XAU, XAG).

X: appears twice on purpose. FX and crypto both quote one thing in terms of another, and both live under it — so the prefix tells you a symbol isn’t an equity, but it does not tell you which class it is. Don’t branch on the prefix alone.

The rosters

Equities are the whole US market, so the catalog is their roster. The other three classes are curated lists, here in full.

Equities stocks

Every US-listed equity, active or delisted — the bulk of the 23,212+ tickers, too many to list here. The roster is the catalog: GET /v2/tickers?asset_class=stocks, searchable with ?search= (Tickers › Catalog).

Rates rates

TickerNameKind
R:EFFREffective Federal Funds Ratepolicy rate
R:SOFRSecured Overnight Financing Ratepolicy rate
R:FFLOWERFed Funds Target Range, lower boundpolicy rate
R:FFUPPERFed Funds Target Range, upper boundpolicy rate
R:UST1M1-Month Treasury Bill Yieldtreasury curve
R:UST6W6-Week Treasury Bill Yieldtreasury curve
R:UST2M2-Month Treasury Bill Yieldtreasury curve
R:UST3M3-Month Treasury Bill Yieldtreasury curve
R:UST4M4-Month Treasury Bill Yieldtreasury curve
R:UST6M6-Month Treasury Bill Yieldtreasury curve
R:UST1Y1-Year Treasury Yieldtreasury curve
R:UST2Y2-Year Treasury Note Yieldtreasury curve
R:UST3Y3-Year Treasury Note Yieldtreasury curve
R:UST5Y5-Year Treasury Note Yieldtreasury curve
R:UST7Y7-Year Treasury Note Yieldtreasury curve
R:UST10Y10-Year Treasury Note Yieldtreasury curve
R:UST20Y20-Year Treasury Bond Yieldtreasury curve
R:UST30Y30-Year Treasury Bond Yieldtreasury curve
R:UST2S10S10-Year minus 2-Year Treasury Spreadcurve spread
R:UST3M10Y10-Year minus 3-Month Treasury Spreadcurve spread
R:UST5S30S30-Year minus 5-Year Treasury Spreadcurve spread

FX and metals fx

TickerNameKind
X:EURUSDEuro / US Dollarcurrency pair
X:GBPUSDBritish Pound / US Dollarcurrency pair
X:USDJPYUS Dollar / Japanese Yencurrency pair
X:USDCHFUS Dollar / Swiss Franccurrency pair
X:USDCADUS Dollar / Canadian Dollarcurrency pair
X:AUDUSDAustralian Dollar / US Dollarcurrency pair
X:USDCNHUS Dollar / Chinese Yuan (offshore)currency pair
X:USDMXNUS Dollar / Mexican Pesocurrency pair
X:USDSEKUS Dollar / Swedish Kronacurrency pair
X:XAUUSDGold / US Dollarspot metal
X:XAGUSDSilver / US Dollarspot metal

Crypto crypto

TickerNameKind
X:BTCUSDBitcoincrypto
X:ETHUSDEthereumcrypto
X:SOLUSDSolanacrypto
X:XRPUSDXRPcrypto
X:ADAUSDCardanocrypto
X:DOGEUSDDogecoincrypto
X:LINKUSDChainlinkcrypto
X:AVAXUSDAvalanchecrypto
X:BCHUSDBitcoin Cashcrypto
X:LTCUSDLitecoincrypto

No auto-resolution

Every parameter expects the canonical form.

The API doesn’t guess. Passing BTC to a stock endpoint returns the Grayscale Bitcoin Mini Trust ETF — a real US-listed equity with that ticker — not bitcoin spot. If you want the cryptocurrency, ask for X:BTCUSD.

Symbols that collide

Watch for these when you’re building from user input.

  • BTC: Grayscale Bitcoin Mini Trust ETF (equity) vs X:BTCUSD (bitcoin spot).
  • ETH: Grayscale Ethereum Staking Mini ETF (equity) vs X:ETHUSD (ether spot).

What each class carries

Same endpoints and the same response shape — but the columns that apply differ.

Every class goes through the same endpoints. What changes is which columns are populated. The column set was built for equities, and most of it is meaningless elsewhere — a Treasury yield has no P/E ratio and no earnings date.

  • stocks carries the full schema: price, volume, price action, technicals, fundamentals, events, profile, analyst ratings and news.
  • rates, fx and crypto carry price, price action and the technical indicators — crypto with volume too — and nothing built on company financials. Equity-specific columns are null on these rows — not false or 0. That distinction matters: a null never satisfies a filter, so a non-equity row cannot accidentally match an equity screen.
  • Corporate-event and news endpoints (/v2/events, /v2/news) are stocks-only by definition — a rate pays no dividend. Passing a non-equity symbol returns an error naming its asset class rather than an empty result.

History depth, by class

Depth varies by source, and it is not equity-depth everywhere.

ClassDaily history fromNote
US equities stocks2003Full OHLCV, plus intraday bars and every column. Each ticker’s own history starts at its first day of coverage, so a 2021 listing begins in 2021.
Rates rates1990One value per business day, and no open/high/low or volume — a rate has no intraday range and nothing trades, so those come back null.
Crypto crypto2010Genuine traded volume.
FX fx1968Spot metals reach furthest back (1968); the currency pairs begin in 2007. Pre-2024 metal bars are a single daily fixing, so open = high = low = close with no volume. FX has no consolidated traded size, so the volume field carries a tick count rather than shares or notional.

Intraday coverage (1h, 1m) varies by class and is expanding — the major crypto pairs have it, most non-equity series do not yet. Rather than guess from this page, ask: a request for an uncovered interval returns an explicit coverage marker, never a silent empty list, and /v2/tickers/{ticker}/coverage reports exactly what is held per ticker.