View as markdown
Endpoints · Universes

Get all universes

GEThttps://api.tickerbot.io/v2/universes

Every universe you can reference — your own named ticker lists and the built-in ones.

Query parameters

enumdefault me

Which universes to list: me (your own), system (built-ins), or all (both).

medefaultUniverses your account created. The default.
systemThe built-in universes (top_10, top_100), rebalanced monthly.
allBoth, with system: true|false on every row to tell them apart.
integerdefault 50

Page size (applies to your own). Max 100.

string

Opaque cursor from the previous response.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

countnumber

Rows in this page.

next_cursorstring

Opaque token for the next page; `null` on the last page. Pass it back as `cursor`.

universesarray

The universes in scope. Every row carries `system: true|false`.

Status codes

200
Success — the response shape is documented under Returns above.
400
Invalid owner value, malformed cursor, or a non-positive-integer limit.

Notes

  • A universe is a named list of tickers you reference from /v2/scan?universe=, /v2/signals/{signal}?universe=, and /v2/tickers?universe=, or pass as universe in the body when subscribing on a resource.
  • Built-in and custom universes come from one list, filtered by owner — the same way the signal catalog unifies built-in and custom signals with kind. owner=me (the default) is your own, owner=system the built-ins (top_10, top_100), owner=all both. Every row carries system: true|false so you can tell them apart.
  • System universes are a small fixed set: returned in full on the first page, never repeated across your cursor pages.
  • Universe tickers are validated against the active tickers in our universe. Symbols we don't track return 400 unknown_tickers with a disallowed array. Every account gets the full ~14,602-ticker universe — no symbol restriction.