tickerbot.io

Get a universe

GEThttps://api.tickerbot.io/v2/universes/{universe}

Returns one universe: a built-in (top_10, top_100) or one you own.

stringrequired

Universe slug: a built-in (top_10, top_100) or one of yours.

as_ofstring

Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of).

idstring

The slug: the universe's handle in ?universe=.

namestring

Display label.

descriptionstring

Free-form notes; "" when unset.

tickersarray

Members.

sizenumber

Member count.

kindstringenum

Whose universe it is.

builtinA built-in universe, the same for every account: top_10 and top_100. Read-only.
customOne of your own universes.
effective_atnumber

Built-in universes only: when this membership took effect (epoch seconds).

next_rebalance_atnumber

Built-in universes only: when membership is next recomputed (epoch seconds).

created_atnumber

Creation timestamp (epoch seconds).

updated_atnumber

Last modification timestamp (epoch seconds).

rebalance_methodstring

Built-in universes only: how membership is chosen.

CodeMeaning
200The universe doc.
400Malformed universe slug (must match ^[a-z][a-z0-9_]{0,62}$).
404not_found.
  • Built-ins are rebalanced monthly, so a screen scoped to top_100 is scoped to that month's members. Pin membership by copying the list into a universe of your own.