View as markdown
Tickerbot API · v2

The stock market, in SQL

A computed table of every ticker × every signal: 14,602+ US tickers plus rates, FX and crypto, 421+ signal columns, refreshed every minute. Query it live, as of any past moment, or as a webhook subscription.

The schema is the API

One unified set of columns powers every endpoint.

Every ticker column — numerics like price and rsi_14, classifications like sector, pre-thresholded flags like gap_up and golden_cross — is queryable from SQL, returnable in a payload, and pullable as a time series.

Know the schema and you know the API.

Three scopes — one ticker, one signal’s matches, the whole market. Each readable live or as of any past moment (as-of), and watchable for state changes (Webhooks). Over time, the same columns become Series; what happened along the way is Events.

The endpoints

Grouped by the question they answer. One schema underneath all of them; each is documented in detail under Endpoints.

BucketPathWhat it answers
Tickershttps://api.tickerbot.io/v2/tickersOne ticker, one moment: its current state, time-travel via ?asof=, and ETF composition. Or paginate/scope the whole universe.
Signalshttps://api.tickerbot.io/v2/signalsWhat signals exist and who matches one right now (or at a past moment with asof) — built-in and your custom ones, one catalog.
Scanhttps://api.tickerbot.io/v2/scanMany tickers, one moment. Pass a SQL WHERE clause, get every matching ticker — now, or at a past instant with asof. group_by turns it into market-breadth rollups.
Serieshttps://api.tickerbot.io/v2/seriesTicker state over time on one aligned grid: any columns for any tickers — at 1m / 1h / 1d / 1w / 1q. OHLCV bars keep their own chart feed.
Eventshttps://api.tickerbot.io/v2/eventsDiscrete things that happened, cross-ticker: dividends, splits, insider transactions, analyst actions — plus opt-in signal firings and news — one timeline, queryable by payload.
Newshttps://api.tickerbot.io/v2/newsSQL query over the news archive. Article rows or rollups by ticker, day, source, or sentiment.
Custom signalshttps://api.tickerbot.io/v2/signalsNamed boolean predicates you author and reference like a built-in signal — reusable in any q.
Universeshttps://api.tickerbot.io/v2/universesNamed ticker lists you reference from any query endpoint with ?universe=<slug>.
Webhookshttps://api.tickerbot.io/v2/webhooksA trigger plus a delivery. POST /v2/webhooks (or a /subscribe shortcut) and we push your endpoint when a scan, signal, or event fires. The registry lists and manages them.
Websocketshttps://api.tickerbot.io/v2/streamHold a websocket open and receive each subscribed ticker’s freshly-computed row on every refresh.

What this API doesn’t do

Honest scope boundaries. Pair us with the right tool for the job.

  • No order execution. We tell you when the conditions you care about are met. Routing the order is your broker’s job.
  • No SLAs at launch. Best-effort uptime today; contact us if you need an SLA.