tickerbot.io
Data › Signals › Analysts › Price targets

analyst_target_upside_pct

Implied upside from the current price to the consensus target, in percent. (analyst_consensus_target_price - price) / price * 100. Negative when price is above target. Recomputed every minute, 4 AM to 8 PM ET.

Facts

A numeric signal: screen on it with a comparison operator (analyst_target_upside_pct > 290). It's null on tickers it doesn't apply to.

definition(analyst consensus price target − price) ÷ price × 100, to 2 decimals. Null below a $0.01 price or beyond 10,000%.
typenumeric
unit%
refreshhourly · 24/7
grains1d
asset classesUS equities
coverageall tickers
historypartial · since 2016
nullableyes

Examples

Screen on it

curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "analyst_target_upside_pct > 290",
    "order": "analyst_target_upside_pct"
  }'

Backtest it on a past date

curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "analyst_target_upside_pct > 290",
    "asof": "2026-08-17",
    "order": "analyst_target_upside_pct"
  }'

Get an alert when a ticker starts matching

curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "analyst_target_upside_pct > 290",
    "target_url": "https://example.com/hooks/tickerbot"
  }'

Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.

Its history

curl "https://api.tickerbot.io/v2/tickers/NVDA/history?select=close,analyst_target_upside_pct" \
  -H "Authorization: Bearer YOUR_KEY"