# Tickers

Find tickers with available research

> Section: API reference

> Last updated: **2026-10-17**.

> API version: **v1 (Latest)**. OpenAPI publication: **2026-11-08**.

## `GET /v1/tickers`

Discover companies and check available research coverage. Use q to search the current SEC-registered US company directory, or omit it for released coverage, analyst counts, and observation dates. Public discovery needs no API key.

Lifecycle: **stable**. Availability: **released**. Authentication: **none**.

## Examples

No API key is needed for these public discovery requests. Free.

Response excerpts below illustrate the shape only; placeholders and empty arrays are not live research or proof of coverage. Actual responses include additional fields.

### Discover companies and check research coverage

Search the current SEC-registered US company directory by name or ticker and check whether direct research is available.

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/tickers?q=NVIDIA'
```

Response excerpt:

```json
{
  "discovery": {
    "query": "NVIDIA",
    "scope": "sec_registered_us_listings"
  }
}
```

Read discovery.results[].direct_research before requesting research. Omit q to list released coverage with belief and analyst counts. Directory coverage is not global; public discovery needs no API key.

## Request

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/tickers'
```

```javascript
const options = { method: "GET", headers: {} };

fetch("https://beliefstate.ai/v1/tickers", options)
  .then((response) => response.json())
  .then((data) => console.log(data));
```

```python
import requests

url = "https://beliefstate.ai/v1/tickers"
headers = {}

response = requests.get(url, headers=headers)
print(response.text)
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `q` | query | `string` | no | Filter by q. |
| `as_of` | query | `string<date-time>` | no | RFC 3339 point in time cutoff. Future values are clamped. |
| `tracked_only` | query | `boolean` | no | Filter by tracked_only. |

## Response includes

- Covered ticker symbols
- Belief and analyst counts per ticker
- Release time and first/latest belief observation times

## Response schemas

### 200 Successful public discovery response

- `limitations` (string[])
- `coverage_scope` (released_library | query_matches)
- `listing_references` (object)
  - `query` (string, required)
  - `scope` ("venue_qualified_pilot", required)
  - `results` (object[], required)
    - `selector` (string, required)
    - `ticker` (string, required)
    - `exchange` (string, required)
    - `country` (string, required)
    - `currency` (string, required)
    - `isin` (string, required)
    - `name` (string, required)
    - `instrument` (ordinary_share | depositary_share | preferred_share, required)
    - `source_url` (string<uri>, required)
- `fund_discovery` (object)
  - `query` (string, required)
  - `scope` ("fund_identity", required)
  - `results` (object[], required)
    - `ticker` (string, required)
    - `name` (string, required)
    - `source_url` (string<uri>, required)
    - `research_tool` ("get_brief", required)
  - `limitation` (string, required)
- `discovery` (object)
  - `query` (string, required)
  - `scope` ("sec_registered_us_listings", required)
  - `source_url` (string<uri>, required)
  - `results` (object[], required)
    - `ticker` (string, required)
    - `name` (string, required)
    - `exchange` (string | null, required)
    - `cik` (number, required)
    - `direct_research` (boolean, required)
- `tracking` (object)
  - `limit` (integer, required)
  - `active` (integer, required)
  - `paused` (string[], required)
  - `unavailable` (string[], required)
  - `related_or_pending` (string[])
  - `manage_url` (string, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `tickers` (string[], required)
- `totals` (object, required)
  - `ticker_count` (integer, required)
  - `belief_count` (integer, required)
- `coverage` (object[], required)
  - `ticker` (string, required)
  - `security_id` (string, required)
  - `security_name` (string, required)
  - `release_state` ("released", required)
  - `release_effective_at` (string<date-time>, required)
  - `belief_count` (integer, required)
  - `investor_count` (integer, required)
  - `first_belief_observed_at` (string<date-time>, required)
  - `latest_belief_observed_at` (string<date-time>, required)

### 400 Invalid input

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

### 503 Stored intelligence temporarily unavailable

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

## Agent feedback

Report unclear, stale, or incorrect documentation through [BeliefState support](https://beliefstate.ai/contact). Include this page URL and the smallest reproducible detail.

<!-- BeliefState-Origin: https://beliefstate.ai/docs/api/tickers; Content-Fingerprint: bs-sha256-1592f6e9fc6f05a96239f4613d63599cd9cbcf5796ebacba118080ad067c502c -->