tickerbot_get_ticker
Retrieve all signals for one ticker or up to 50 comma-separated symbols, live or as of a past date, with results keyed by symbol and missing symbols reported.
Instructions
Returns everything about one ticker or a comma list of up to 50 in the path (a screen's matches, say): every signal each one carries, live or on any past date with asof. A comma list returns data keyed by symbol plus not_found. Crypto is the X-prefixed pair (X:BTCUSD); bare BTC/ETH are US-listed ETFs.
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"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asof | No | Target moment as `YYYY-MM-DD` (that day's close) or an ISO timestamp (that intraday moment; daily-only signals then carry the previous session's close, never that day's): the same read as it stood then, unlimited depth. Full contract under As of a past date. | |
| grain | No | Only with `asof`. Grain the past state is read at: `1m`, `1h`, `1d` or `auto` (default). `auto` blends: each signal comes from its freshest grain at or before the instant (minute, then hourly, then the last closed daily session), so nothing is refused for grain and no ticker is dropped; `_meta.blended` and `_meta.grains_present` say what contributed. Pin a grain for the fastest response: one grain is read instead of three. A signal in `select` that the pinned grain does not store is a `400 interval_unavailable` naming the grains that carry it (`rsi_14`, fundamentals and valuation ratios are `1d`-only). Without `select`, the row carries the signals the pinned grain stores, and `_meta.signals_not_stored_at_grain` names the rest. A grain with no data for the ticker within its window (14 days for `1d`, 5 for `1h`/`1m`) is a `404 interval_unavailable`. `1m` and `1h` need a timestamp `asof`; with a bare date they are a `400 interval_unavailable`. A live read with `grain` is a 400. Values: 1m: Minute. The one-minute state at or before the instant. Covers the most liquid tickers and the signals stored at one minute. Needs a timestamp `asof`; with a bare date it is a `400 interval_unavailable`. 1h: Hour. The hourly state at or before the instant. Covers every ticker and the signals stored hourly. Needs a timestamp `asof`; with a bare date it is a `400 interval_unavailable`. 1d: Day. The last daily session closed before the instant; a bare date reads that day’s close. Covers every ticker and the most signals, including the daily-only ones such as `rsi_14`, fundamentals and valuation ratios. auto: Auto. Each signal from its freshest grain at or before the instant: minute, then hourly, then the last closed daily session. `_meta.blended` and `_meta.grains_present` say what contributed. | auto |
| select | No | Comma-separated signals to return: each row is `ticker` plus exactly these. Omit it, or send `*`, for the full row: every signal the ticker carries, or on an as-of read every signal the read's grain stores. An unknown signal is a 400, beside `*` too. | |
| 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 | Everything about the ticker: every signal it carries (see the catalog). On the list form, an object keyed by symbol. | |
| _meta | No | With `asof` only: how the result was reconstructed; on the list form, one block per symbol, keyed by symbol. This read's own keys: `signal_grains`, the grain each signal was served at (on a blended or pinned read), and `signals_not_stored_at_grain`, the signals a pinned grain does not store (on the full row, without `select`). Shared keys: see the `_meta` reference. | |
| 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, each param with its effective value: `ticker` (the symbols, canonical, de-duplicated, in request order; a list even for one), `asof`, `grain` (`null` on a live read) and `select` (`null` for the full row; `["*"]` when you sent `*`). | |
| 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). |