tickerbot_list_tickers
List every tracked ticker, active or delisted, with filters for search, exchange, asset type, and asset class. Page through results to find symbols and their identity records.
Instructions
Lists every ticker we track, active or delisted, with its identity. For everything about one, use Get a ticker.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "tickerbot_list_tickers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size. Max 1000 until 2027-01-12, then 100 (a larger value is clamped to the max, not an error; see Deprecations). | |
| active | No | `true` for tickers that trade today, `false` for delisted ones. Omit it for both. | |
| cursor | No | The previous response's `next_cursor`. Send it with the same params as the first page (`limit` may change); a page whose params differ is a 400 naming the param. | |
| search | No | Case-insensitive match on `ticker` or `name`, max 64 characters (longer is a 400). Results are ranked: an exact ticker match first, then symbols that start with the term, then symbols that contain it, then names that have it as a whole word, then names that contain it; alphabetical within each rank. The cursor carries the rank, so paging a search never repeats or skips. | |
| ticker | No | One symbol or a comma-separated list (up to 50; more is a 400): just those tickers' identity records, in the usual order. A symbol we don't track is absent from `results` and listed in `not_found`. For everything about each one, put the list in the path of Get a ticker. | |
| exchange | No | Filter by exchange name (one or a comma list): the value results carry in their `exchange` field. MIC codes (`XNAS`, `XNYS`, `BATS`) are also accepted and match `exchange_mic`. A malformed value (non-letters, over 16 chars) is a 400. | |
| asset_type | No | Filter by instrument type within equities (one or a comma list): the stored `asset_type` value (`CS`, `ETF`, `ADRC`, `PFD`, `FUND`, `UNIT`, `SP`, `ETS`, `WARRANT`, `RIGHT`, `ETN`, `ETV`), matched case-insensitively. `equity` is a convenience value expanding to the equity-like set. This is not an asset class: `asset_type=crypto` is a 400 (use `asset_class=crypto`). Values: CS: Common stock. ETF: Exchange-traded fund. ADRC: ADR. PFD: Preferred stock. FUND: Fund. UNIT: Unit. SP: Structured product. ETS: Single-stock ETF. WARRANT: Warrant. RIGHT: Right. ETN: Exchange-traded note. ETV: Exchange-traded vehicle. equity: Equity. | |
| asset_class | No | Filter by asset class: `stocks`, `rates`, `crypto`, `fx` or a comma-separated list (the live classes today; validated for shape, not against a fixed list, so a well-formed class outside these matches nothing). Omit for every class. This is the class of instrument, distinct from `asset_type` below (the instrument type within equities). Every result carries its `asset_class`, so a non-equity result identifies itself. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _meta | No | With `asset_class` only: `scope.asset_class` lists the classes the page was filtered to. | |
| as_of | Yes | Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of). | |
| count | Yes | Tickers in this page. | |
| query | Yes | Your request echoed, each param with its effective value: `search`, `ticker`, `asset_class`, `asset_type` and `exchange` (lists), `active` and `limit`. A filter you did not send is `null`. | |
| results | Yes | One identity record per ticker: the signals in the catalog's Identifiers & reference category (`ticker`, `name`, `asset_class`, `asset_type`, `exchange`, `country`, `currency_name`, `cik`, `composite_figi`, `active`, `delisted_utc` and the rest), nothing else. Delisted tickers (`active: false`) carry `delisted_utc` (ISO 8601); they are still addressable on the state route with `asof`. | |
| not_found | No | With `ticker` only: the symbols you named that we do not track, in request order; an empty array when we track every one. A tracked symbol that another filter or the page leaves out is not in it. | |
| _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). | |
| next_cursor | Yes | Opaque token for the next page; `null` on the last page. |