# Tickerbot API — 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

Swap `YOUR_KEY` for the value from https://tickerbot.io/dashboard/keys.

```shell
# 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?to=2026-04-30" \
  -H "Authorization: Bearer YOUR_KEY"

# Find every small cap gapping up on volume
curl "https://api.tickerbot.io/v2/scan?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"
  }'
```