← tickerbot.io
View as markdown
Tickerbot API · v2

Introduction

The stock market API designed for agents. Real-time and historical market data served as one wide precomputed table you or your agent query in SQL.

The table is the API

Know the table and you know the API.

Every US stock, plus rates, FX, metals, and crypto, is a row. Every data point, from price to 200-day average to golden cross, real-time and historical, is a column that we call a signal. Numerics like price and rsi_14, classifications like sector, booleans like gap_up and golden_cross — every one is queryable from SQL, returnable in a payload, and pullable as a time series.

The table has state: every cell’s value, now and at every past date. Read it by ticker (its row), by signal (the tickers matching it), or by WHERE clause (the whole market), live or as of any past date. Subscribe to any of the three and we push you when the answer changes. Series is state over time; Events is what happened along the way.

The endpoints

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

FamilyPathWhat it answers
Tickershttps://api.tickerbot.io/v2/tickersOne ticker: the symbol catalog, its full row now or as of any past date, and how well it is covered.
Signalshttps://api.tickerbot.io/v2/signalsWhich signals exist, and every ticker matching one, now or as of any past date. Built-in and custom, one catalog.
Scanhttps://api.tickerbot.io/v2/scanEvery ticker matching a SQL WHERE clause, now or as of any past date. group_by turns it into market-breadth rollups.
Serieshttps://api.tickerbot.io/v2/seriesState over time on one aligned grid: any signals for any tickers, at 1m / 1h / 1d / 1w / 1q.
Barshttps://api.tickerbot.io/v2/barsRaw OHLCV, 1s through monthly, up to 50 tickers a call. The prices underneath the table.
Eventshttps://api.tickerbot.io/v2/eventsWhat happened, on one timeline: dividends, splits, insider transactions, analyst actions, plus opt-in signal firings and news. Queryable by payload.
Newshttps://api.tickerbot.io/v2/newsSQL query over the news archive. Article rows or rollups by ticker, day, source, or sentiment.
ETFhttps://api.tickerbot.io/v2/etfWhat an ETF is made of: its holdings and its sector weights.
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. We push your endpoint when a scan matches, a signal flips, or an event lands.
Websocketshttps://api.tickerbot.io/v2/streamHold a websocket open and receive each subscribed ticker’s freshly-computed row on every refresh.

Next: your first request

Seven calls that cover the API, each a real request you can paste.

Start at the Quickstart.

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. Best-effort uptime; contact us if you need one.