Tickerbot API · v1

The interpreted market in a realtime database

The Tickerbot API exposes a real-time scanner database covering ~12,000 US-listed equities and the top 100 cryptocurrencies, focused on pattern flags and precomputed signals. Use it to understand the state and history of any ticker, scan the market natively with SQL, identify technical setups and trade ideas, or subscribe to webhooks that fire when conditions you define become true. Use it for research or build products on top of it.

Four endpoints

The whole API. Each one is documented in detail under Endpoints.

/v1/tickers — see the current state of any given ticker. Get full financial data and a suite of proprietary signal flags.
/v1/signals/{ticker}/{signal} — historical time series for any signal on any ticker. Numerics return bars; flags return on/off windows or trigger timestamps.
/v1/scan — “who matches this right now?” Pass a SQL WHERE clause; get matching tickers back.
/v1/webhooks — “tell me when this becomes true.” Same SQL grammar; we POST to your URL once a minute when any ticker enters the match set.

The schema is the API

One unified set of columns powers every endpoint.

The schema page documents every column on a ticker — numerics like price and market_cap, classifications like sector, and 76+ pre-thresholded boolean flags like breakout and volume_unusual_2x. Once you know the schema you know the API: every column is queryable from SQL, returnable in a ticker payload, and pullable as a time series.

We compute the signals, you compose them. Bring a SQL WHERE clause; we’ll evaluate it across the universe in real time.

60-second quickstart

Authenticate with a bearer token; everything else is shaped like a normal REST call.

Get the current state of one ticker

curl https://api.tickerbot.io/v1/tickers/AAPL \
  -H "Authorization: Bearer YOUR_KEY"

Pull the history of TSLA's market cap

curl "https://api.tickerbot.io/v1/signals/TSLA/market_cap?to=2026-04-30" \
  -H "Authorization: Bearer YOUR_KEY"

Find every small cap gapping up on volume

curl "https://api.tickerbot.io/v1/scan?q=gap_up_3pct%20AND%20volume_unusual_2x%20AND%20market_cap%20%3C%202000000000" \
  -H "Authorization: Bearer YOUR_KEY"

Create a webhook that fires on small-cap breakouts

curl -X POST https://api.tickerbot.io/v1/webhooks \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "small-cap breakouts",
    "q": "breakout AND market_cap < 2000000000",
    "target_url": "https://yourapp.com/hooks/breakouts"
  }'

Where to go next

Pick the path that matches what you’re building.

Want to understand the data first? Start with the schema.
Building a screener or scanner? See /scan and the SQL reference.
Backtesting or charting? See /signals for time series.
Wiring an alert app or Discord bot? Jump to webhooks.
Need a key first? Authentication.

What this API doesn’t do

Honest scope boundaries — pair us with the right tool for the job.

No raw OHLCV bars. Polygon, Tiingo, and Finnhub already do this well. Snapshot price context (current price, prior close, day change, volume) is included on ticker responses so you don’t need a second call to interpret a signal, but tick-by-tick bars and full historical OHLCV live with your data vendor.
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; enterprise SLAs gated to a future tier.