# GET /v2/universes

**List your universes**

A universe is a named list of tickers you can reference from `/v2/scan?universe=`, `/v2/signals/{signal}?universe=`, `/v2/tickers?universe=`, and `/v2/webhooks`. System universes (`top_10` and `top_100`, the top-N most-actively-traded tickers, rebalanced monthly) are available to every account at `GET /v2/universes/system`.

## Plan access

- **Plan access.** Included on every plan.
- **Rate limit.** Hobby 60/min · Pro 2,000/min · Scale 10,000/min.
- **Capacity.** Hobby 5 · Pro 25 · Scale 100 · Enterprise unlimited.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `limit` | query | integer | no | Page size. Max 100. Default: `50`. |
| `cursor` | query | string | no | Opaque cursor from the previous response. |

## Status codes

- **200** — Page of universes with `as_of`, `count`, `next_cursor`, `universes`.

## Sample response

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "count": 1,
  "next_cursor": null,
  "universes": [
    {
      "id": "my_watchlist",
      "name": "My Watchlist",
      "description": "Stocks I'm tracking",
      "tickers": ["AAPL", "NVDA", "TSLA"],
      "size": 3,
      "system": false,
      "created_at": 1778720416,
      "updated_at": 1778720416
    }
  ]
}
```

## Examples

### List your universes

Request:

```shell
curl https://api.tickerbot.io/v2/universes \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "count": 1,
  "next_cursor": null,
  "universes": [
    {
      "id": "my_watchlist",
      "name": "My Watchlist",
      "description": "Stocks I'm tracking",
      "tickers": ["AAPL", "NVDA", "TSLA"],
      "size": 3,
      "system": false,
      "created_at": 1778720416,
      "updated_at": 1778720416
    }
  ]
}
```

## Notes

- Universe tickers are validated against the plan's ticker scope and the active tickers in our universe. Submitting a ticker outside your plan scope returns `tickers_outside_plan_scope`.

---

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