---
title: "Ticker universe search"
method: GET
path: "/tickers"
tags: ["Utility"]
---

# Ticker universe search

`GET /tickers`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/tickers`
- Auth: none required

List tickers in the universe or search by name/symbol. Free (discovery). Use the `mag7` flag to retrieve the MAG7 tickers. Use `include_metadata` for sector and ETF assignment per ticker.

## Query parameters

- `array` 'ticker' | 'teo'
- `search` string
- `mag7` boolean
- `include_metadata` boolean

## Response `200`

Ticker list or search results.

- object
  - `ticker` string: With `search`: the exact ticker match, or the best match when there is none.
  - `resolved_via` 'most_recent_holder': With `search`, present only when the modelled registry has no live row for the searched ticker and it resolves to the security that holds or most recently held it (e.g. the delisted `CTRA`). Same rule as `GET /ticker-returns`.
  - `modelled_ticker` string, nullable: With `resolved_via`: the answering security's own ticker (registry or security master) when it differs from the requested ticker, e.g. `BYON` for a `BBBY` request answered by a listing pin.
  - `delisted` boolean: `true` when the answering security is closed in the security master or flagged delisted in the registry; `false` when the most-recent-holder pass found it open. Absent on ordinary answers and on answers kept unchanged from earlier releases whose registry row is not flagged delisted.
  - `ticker_reassigned` boolean: `true` when the security master shows a different security holding the ticker today that the API cannot serve (no registry row under the ticker, no daily history), so the answer is still the previous holder's series (e.g. `FB` keeps answering Meta while another security holds FB). Absent otherwise.
  - `current_holder` object: With `ticker_reassigned`, the security holding the ticker today.
    - `symbol` string
    - `name` string, nullable
  - `resolution_degraded` boolean: `true` when the most-recent-holder check could not read its evidence (security master, registry or daily index outage) and the previous answer was returned unchecked; a later request may answer a different security. Absent otherwise.
  - `tickers` string[]
  - `metadata` object, nullable

---

[API](https://skmtc.dev/riskmodels/apis/riskmodels-api.md) · [All operations](https://skmtc.dev/riskmodels/apis/riskmodels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskmodels/apis/riskmodels-api/revisions/1a034cad408a?raw)