Introduction
Tickerbot is a stock screener API for agents.
The API
POST /v2/scan takes a SQL WHERE clause and returns every ticker that matches, across 462+ signals on every US-listed stock and ETF. Add asof to backtest the same screen on any past date, or /subscribe to get an alert by webhook when a ticker starts matching.
Signals span price, volume, technicals, fundamentals, events, analyst ratings, news and more, ranging from raw data like price and revenue_ttm to precomputed indicators like rsi_14 and sma_50 to boolean conditions like gap_up and earnings_this_week. GET /v2/signals returns the full catalog of signals, with each one’s definition, refresh cadence and history start.
Every signal starts as data from institutional-grade vendors and public sources (the Fed, the Treasury, SEC EDGAR). On each refresh we compute the indicators and boolean conditions from that data, update each ticker’s latest values and save signal state by day, hour and minute. See how signals are built for each step.
You can drill down on any ticker’s bars, filings and more with the rest of our API. Tickerbot works over REST and MCP. See example screens for ready-made WHERE clauses.
The endpoints
Every path is on https://api.tickerbot.io.
| Family | Path | What it does |
|---|---|---|
| Scan | /v2/scan | Runs a SQL WHERE clause across every ticker and returns the matches, live, as of any past date or as a webhook. |
| Signals | /v2/signals | Lists the signal catalog and returns what one signal is and every ticker matching it, live or as of any past date. Define your own in SQL. |
| Tickers | /v2/tickers | Lists every ticker and returns everything about one: its signals live or as of any past date, its history from 1m to 1y, OHLCV bars, an ETF's holdings, or a webhook. |
| Events | /v2/events | Returns what happened on one timeline: earnings, dividends, splits, filings, insider trades and analyst actions, plus opt-in estimate revisions, news and signal firings. |
| News | /v2/news | Queries article-level news with SQL, back to 2015 and refreshed every 15 minutes, as articles or rollups by ticker, day, source or sentiment. |
| Universes | /v2/universes | Saves named ticker lists that scope any screen. |
| Webhooks | /v2/webhooks | Manages your subscriptions: each pairs a screen, a ticker or an event feed with a delivery we push when it fires. Create them with the subscribe call on Scan, Tickers or Events. |
| Websockets | /v2/stream | Streams each ticker's latest values over a held-open websocket as they update. |
Machine-readable
Every signal and the bar fields ship as JSON at /docs/schema.json, and every route is in the OpenAPI spec. Agents can start from /llms.txt.