# GET /v2/tickers

**List & bulk lookup**

Returns the universe of tracked symbols (~12,000 US equities + top 100 crypto by market cap) in alphabetical order with a slim payload (`ticker`, `name`, `asset_type`, `exchange`, `market_cap`). Use cursor pagination to walk the full list, or pass `?tickers=...` for bulk lookup of named symbols with full rows.

## Plan access

- **Plan access.** Included on every plan, Hobby through Enterprise.
- **Rate limit.** Hobby 60/min · Pro 2,000/min · Scale 10,000/min.
- **Universe.** All ~12,000 tracked tickers on every plan.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `tickers` | query | string | no | Comma-separated list of symbols (up to 50). When set, the response returns the full row for each requested symbol; pagination params are ignored. Symbols missing from our universe come back with `_not_found: true`. Example: `NVDA,TSLA,JPM`. |
| `limit` | query | integer | no | Page size for the alphabetical walk. Max 1000. Default: `50`. |
| `cursor` | query | string | no | Opaque cursor from the previous response's `next_cursor` field. Continues the walk from after that page. |
| `search` | query | string | no | Substring filter over `ticker` (case-insensitive) and `name`. When set, results are ordered by `market_cap DESC NULLS LAST`. Example: `NVDA`. |
| `asset_type` | query | string | no | Filter by asset type — typically `equity` or `crypto`. Matched case-insensitively against the stored value. Example: `equity`. |
| `exchange` | query | string | no | Filter by exchange code (uppercase). Common values: `XNYS`, `XNAS`, `BATS`. Example: `XNAS`. |
| `sector` | query | string | no | Filter by sector name. Exact match against the stored `sector` field. Example: `Technology`. |
| `min_market_cap` | query | number | no | Minimum market cap (USD). Results are ordered by `market_cap DESC NULLS LAST` when set. Example: `2000000000`. |

## Status codes

- **200** — Page of tickers with `as_of`, `count`, `next_cursor`, and `results`.
- **400** — Invalid cursor, invalid `tickers` list, or bulk lookup over 50 symbols.
- **401** — Missing or invalid API key.

## Sample response

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "count": 3,
  "next_cursor": "eyJhZnRlcl90aWNrZXIiOiJBQUEifQ",
  "results": [
    { "ticker": "A",   "name": "Agilent Technologies Inc.", "asset_type": "CS", "exchange": "XNYS", "market_cap": 31905801589 },
    { "ticker": "AA",  "name": "Alcoa Corporation",          "asset_type": "CS", "exchange": "XNYS", "market_cap": 17844233347 },
    { "ticker": "AAA", "name": "Alternative Access CLO ETF", "asset_type": "ETF","exchange": "BATS", "market_cap": null }
  ]
}
```

## Examples

### Walk the universe alphabetically

Request:

```shell
curl "https://api.tickerbot.io/v2/tickers?limit=3" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "count": 3,
  "next_cursor": "eyJhZnRlcl90aWNrZXIiOiJBQUEifQ",
  "results": [
    { "ticker": "A",   "name": "Agilent Technologies Inc.", "asset_type": "CS", "exchange": "XNYS", "market_cap": 31905801589 },
    { "ticker": "AA",  "name": "Alcoa Corporation",          "asset_type": "CS", "exchange": "XNYS", "market_cap": 17844233347 },
    { "ticker": "AAA", "name": "Alternative Access CLO ETF", "asset_type": "ETF","exchange": "BATS", "market_cap": null }
  ]
}
```

### Bulk lookup: full rows for named symbols

Request:

```shell
curl "https://api.tickerbot.io/v2/tickers?tickers=NVDA,TSLA,JPM" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "requested": ["NVDA", "TSLA", "JPM"],
  "count": 3,
  "results": [
    { "ticker": "NVDA", "name": "NVIDIA Corp", "asset_type": "CS", "exchange": "XNAS", "market_cap": 2510000000000, "price": 226.41, "day_change_pct": 0.0153, "...": "(full row)" },
    { "ticker": "TSLA", "name": "Tesla, Inc.", "asset_type": "CS", "exchange": "XNAS", "market_cap": 1430000000000, "price": 445.77, "day_change_pct": -0.0241, "...": "(full row)" },
    { "ticker": "JPM",  "name": "JPMorgan Chase","asset_type": "CS","exchange": "XNYS", "market_cap": 720000000000,  "price": 254.55, "day_change_pct": 0.0091,  "...": "(full row)" }
  ]
}
```

## Notes

- Cursors are opaque base64url tokens. Pass `next_cursor` back unchanged as `?cursor=...` to walk forward.
- The list mode returns five slim columns. To pull the full row for a known ticker, use `GET /v2/tickers/{ticker}` or the bulk form above.

---

Interactive sandbox + parameter editor: https://tickerbot.io/api/endpoints/tickers/list