tickerbot_get_ticker_coverage
Reports the data coverage and history range held for one ticker or up to 50 comma-separated symbols, so you can distinguish missing bars from absent coverage before diagnosing an outage.
Instructions
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. Ask this before treating a gap in bars or history as an outage. An absent 1m span is not a gap: sub-hour bars load on the first request for a symbol.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "tickerbot_get_ticker_coverage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | 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). | |
| as_of | Yes | Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of). | |
| count | No | With a comma list only: the symbols in `data`, that is, how many of the symbols asked for were found. | |
| query | Yes | Your request echoed: `ticker`, the symbols asked for (canonical, de-duplicated, in request order; a list even for one). | |
| not_found | No | 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). | |
| _advisories | No | Present only when the response carried a warning: `deprecated` (since, sunset_on, successor, warning; on a deprecated tool, successor names the tool to call), `rate_limit` (warning, retry_after_seconds, limit, remaining, reset_epoch_s) or `monthly_quota` (warning, limit, remaining, reset_epoch_s). |