View as markdown
Endpoints · Universes

Create a universe

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

Create a named ticker list owned by the calling account. Body: `{ id?, name, description?, tickers }`. If `id` is omitted, a slug is generated.

Plan access

Included on every plan.

Rate limit

Hobby 600/min · Pro 2,000/min · Scale 10,000/min.

Capacity

Unlimited on every paid plan.

Status codes

201
Universe created. Returns the full universe doc.
400
bad_request for malformed tickers or oversized universe; unknown_tickers (with a disallowed array) when symbols aren't in our universe.
403
universes_tier_required if the plan lacks universes, or resource_limit_reached when over the plan cap. (Every paid plan ships unlimited universes — this only fires on internal/Enterprise caps.)
409
slug_taken when id collides with one of your existing universes.