Get a ticker's coverage
https://api.tickerbot.io/ v2/ tickers/ {ticker}/ coverageReports 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.
Path parameters
string[]requiredOne 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.
Returns
as_ofstringServer time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).
queryobjectYour request echoed: ticker, the symbols asked for (canonical, de-duplicated, in request order; a list even for one).
countnumberWith 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).
dataobjectThe 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).
Status codes
| Code | Meaning |
|---|---|
200 | Success: the response shape is documented under Returns above. |
400 | bad_request: a malformed symbol, or more than 50 in a list. |
401 | Missing or invalid API key. |
404 | not_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. |
Notes
- Bars and daily spans are computed live.
- An absent
1mspan is not "no intraday data."/v2/tickers/{ticker}/bars/{interval}serves sub-hour bars (1mto30m) for every active symbol; the first such request for a symbol loads them (a few seconds) and the span appears here after that.