Tickerbot — The stock market, in SQL

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 6,000/min · Scale 60,000/min.

Capacity

Unlimited on every plan.

Body parameters

idstring

Optional slug. Lowercase letters, digits, underscore. Must be unique within your account.

namestringrequired

Human-readable label.

descriptionstring

Free-form notes.

tickersstring[]required

Ticker symbols. Validated against your plan scope + the active universe.

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 only if the plan cap is 0 (no self-serve plan — every plan, Free included, ships unlimited universes), or resource_limit_reached when over an internal/Enterprise cap.

409

slug_taken when id collides with one of your existing universes.

curl -X POST "https://api.tickerbot.io/v2/universes" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "my_watchlist"
  }'

Try it

This endpoint requires an authenticated key. Sign in to run it from your dashboard, or get a free key. tickerbot.io/dashboard.

Sample response

{
  "as_of": "2026-05-14T11:41:01.000Z",
  "id": "my_watchlist",
  "name": "My Watchlist",
  "description": null,
  "tickers": ["AAPL", "NVDA", "TSLA"],
  "size": 3,
  "system": false,
  "created_at": 1778720416,
  "updated_at": 1778720416
}