tickerbot.io

Get a ticker's coverage

GEThttps://api.tickerbot.io/v2/tickers/{ticker}/coverage

Reports what we hold for one ticker or a comma list of up to 50, and how far back, so an empty result is never ambiguous.

string[]required

One symbol, or a comma-separated list of up to 50 for a response keyed by symbol. Case-insensitive. Equities are bare symbols (NVDA); every other class carries a prefix: rates (R:SOFR), crypto (X:BTCUSD), fx (X:EURUSD). Bare BTC/ETH are US-listed ETFs, not spot crypto. See Tickers.

as_ofstring

Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).

queryobject

Your request echoed: ticker, the symbols asked for (canonical, de-duplicated, in request order; a list even for one).

countnumber

With a comma list only: the symbols in data, that is, how many of the symbols asked for were found.

not_foundstring[]

With a comma list only: the requested symbols we do not track, in request order; an empty array when every symbol was found; every symbol when none was (still a 200).

dataobject

The ticker's coverage (on the list form, an object keyed by symbol): ticker and name; spans, per grain (bars, 1d, 1h, 1m), each oldest, newest and rows, with bars and 1d adding contiguous, expected_sessions, missing_sessions and gaps (the sessions missing inside the span), 1h and 1m adding measured_at, and 1m adding included and rank (whether the symbol is in the precomputed minute tier, which does not limit what bars you can read); measured_signals, the depth measured per signal where the backfill engine has probed (signal, grain, first_date, last_date, pct_complete); and live_row, the ticker's current state: signals (published signals it carries), populated and null_signals (those null on it right now; a symbol with no fundamentals, such as an OTC-traded ADR, lists them here).

CodeMeaning
200Success: the response shape is documented under Returns above.
400bad_request: a malformed symbol, or more than 50 in a list.
401Missing or invalid API key.
404not_found: the one symbol in the path is not a ticker we track. A comma list is never a 404: untracked symbols are named in not_found, even when that is all of them.
  • Bars and daily spans are computed live.
  • An absent 1m span is not "no intraday data." /v2/tickers/{ticker}/bars/{interval} serves sub-hour bars (1m to 30m) for every active symbol; the first such request for a symbol loads them (a few seconds) and the span appears here after that.