View as markdown
Tickerbot API · v2

Quickstart

Get your first request running in 60 seconds. Authenticate with a bearer token; everything else is shaped like a normal REST call.

60-second quickstart

Four calls that cover most of what the API does. Swap YOUR_KEY for the value from /dashboard/keys.

Get the current state of one ticker

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

Pull the daily history of TSLA’s market cap

curl "https://api.tickerbot.io/v2/signals/market_cap/TSLA/history/1d" \
  --get \
  --data-urlencode 'to=2026-04-30' \
  -H "Authorization: Bearer YOUR_KEY"

Find every small cap gapping up on volume

curl "https://api.tickerbot.io/v2/scan" \
  --get \
  --data-urlencode 'q=gap_up_3pct AND volume_unusual_2x AND market_cap < 2000000000' \
  -H "Authorization: Bearer YOUR_KEY"

Create a webhook that fires on small-cap breakouts

curl -X POST https://api.tickerbot.io/v2/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"
  }'