# Analyst ratings catalog — Tickerbot Analyst ratings API

41 columns. Group overview from https://tickerbot.io/docs/signals/catalog/analyst/ · full catalog: https://tickerbot.io/docs/signals/catalog.md · concept: https://tickerbot.io/docs/signals.md

Third-party analyst judgment: the consensus, individual firm actions, price targets, and forward estimates.

## Consensus ratings

The aggregate analyst opinion: consensus rating, the buy/hold/sell distribution, coverage depth.

- [analyst_consensus_rating](https://tickerbot.io/docs/signals/analyst_consensus_rating.md) (text) — Consensus analyst rating across contributing firms. One of `strong buy`, `buy`, `hold`, `sell`, `strong sell`. NULL for tickers without analyst coverage.
- [analyst_consensus_rating_value](https://tickerbot.io/docs/signals/analyst_consensus_rating_value.md) (numeric) — Consensus rating as a numeric score on the standard 1–5 scale (1 = strong buy, 5 = strong sell). Lower is more bullish.
- [analyst_count_buy](https://tickerbot.io/docs/signals/analyst_count_buy.md) (integer) — Number of contributing firms rating the ticker as buy.
- [analyst_count_hold](https://tickerbot.io/docs/signals/analyst_count_hold.md) (integer) — Number of contributing firms rating the ticker as hold (neutral).
- [analyst_count_sell](https://tickerbot.io/docs/signals/analyst_count_sell.md) (integer) — Number of contributing firms rating the ticker as sell.
- [analyst_count_strong_buy](https://tickerbot.io/docs/signals/analyst_count_strong_buy.md) (integer) — Number of contributing firms rating the ticker as strong buy.
- [analyst_count_strong_sell](https://tickerbot.io/docs/signals/analyst_count_strong_sell.md) (integer) — Number of contributing firms rating the ticker as strong sell.
- [analyst_count_total](https://tickerbot.io/docs/signals/analyst_count_total.md) (integer) — Total number of contributing firms covering the ticker with any rating. Sum of the five `analyst_count_*` buckets. `well_covered` fires when this is at least 10.
- [analyst_count_with_target](https://tickerbot.io/docs/signals/analyst_count_with_target.md) (integer) — Number of contributing firms whose rating includes a published 12-month price target. Always ≤ `analyst_count_total`.
- [bearish_consensus](https://tickerbot.io/docs/signals/bearish_consensus.md) (state) — Consensus analyst rating is `sell` or `strong sell`.
- [bullish_consensus](https://tickerbot.io/docs/signals/bullish_consensus.md) (state) — Consensus analyst rating is `strong buy` or `buy`.
- [well_covered](https://tickerbot.io/docs/signals/well_covered.md) (classification) — Ten or more analyst firms cover the ticker.

## Upgrades & downgrades

Individual firm actions: rating changes, initiations, and price-target changes.

- [last_rating_action](https://tickerbot.io/docs/signals/last_rating_action.md) (text) — Action taken in the most recent rating change. Common values: `upgrades`, `downgrades`, `initiates_coverage_on`, `maintains`, `reiterates`, `assumes`, `reinstates`, `suspends`.
- [last_rating_date](https://tickerbot.io/docs/signals/last_rating_date.md) (date) — Date of the most recent rating action across all firms covering the ticker.
- [last_rating_firm](https://tickerbot.io/docs/signals/last_rating_firm.md) (text) — Name of the firm that issued the most recent rating action.
- [recent_downgrade](https://tickerbot.io/docs/signals/recent_downgrade.md) (state) — At least one analyst downgraded the ticker in the last 7 days.
- [recent_initiation](https://tickerbot.io/docs/signals/recent_initiation.md) (state) — At least one analyst initiated coverage in the last 7 days.
- [recent_target_lower](https://tickerbot.io/docs/signals/recent_target_lower.md) (state) — At least one analyst lowered their price target in the last 7 days.
- [recent_target_raise](https://tickerbot.io/docs/signals/recent_target_raise.md) (state) — At least one analyst raised their price target in the last 7 days.
- [recent_upgrade](https://tickerbot.io/docs/signals/recent_upgrade.md) (state) — At least one analyst upgraded the ticker in the last 7 days.

## Price targets

Where analysts say it's going: consensus/high/low targets and price-versus-target state.

- [analyst_consensus_target_price](https://tickerbot.io/docs/signals/analyst_consensus_target_price.md) (numeric) — Mean of contributing analysts' 12-month price targets.
- [analyst_target_price_high](https://tickerbot.io/docs/signals/analyst_target_price_high.md) (numeric) — Highest single-analyst 12-month price target across contributing firms.
- [analyst_target_price_low](https://tickerbot.io/docs/signals/analyst_target_price_low.md) (numeric) — Lowest single-analyst 12-month price target across contributing firms.
- [analyst_target_upside_pct](https://tickerbot.io/docs/signals/analyst_target_upside_pct.md) (numeric) — 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 during market hours.
- [above_price_target](https://tickerbot.io/docs/signals/above_price_target.md) (state) — Current price is above the consensus analyst target.
- [below_price_target](https://tickerbot.io/docs/signals/below_price_target.md) (state) — Current price is below the consensus analyst target.
- [target_downside_above_10pct](https://tickerbot.io/docs/signals/target_downside_above_10pct.md) (state) — Current price is more than 10% above the consensus target — significant implied downside.
- [target_upside_above_10pct](https://tickerbot.io/docs/signals/target_upside_above_10pct.md) (state) — Consensus price target implies more than 10% upside from the current price.
- [target_upside_above_25pct](https://tickerbot.io/docs/signals/target_upside_above_25pct.md) (state) — Consensus price target implies more than 25% upside from the current price.

## Estimates

What analysts say it will earn: forward EPS/revenue estimates and their revisions.

- [eps_estimate_revision_down_30d](https://tickerbot.io/docs/signals/eps_estimate_revision_down_30d.md) (integer) — Count of analysts who lowered their next-quarter EPS estimate in the last 30 days.
- [eps_estimate_revision_up_30d](https://tickerbot.io/docs/signals/eps_estimate_revision_up_30d.md) (integer) — Count of analysts who raised their next-quarter EPS estimate in the last 30 days. A positive read on forward sentiment momentum.
- [last_eps_estimate](https://tickerbot.io/docs/signals/last_eps_estimate.md) (numeric) — Consensus EPS estimate going into the most recent earnings announcement.
- [next_eps_estimate](https://tickerbot.io/docs/signals/next_eps_estimate.md) (numeric) — Wall Street consensus EPS estimate for the next reported quarter — weighted average across analyst contributors.
- [next_eps_estimate_high](https://tickerbot.io/docs/signals/next_eps_estimate_high.md) (numeric) — Highest single-analyst EPS estimate for the next reported quarter.
- [next_eps_estimate_low](https://tickerbot.io/docs/signals/next_eps_estimate_low.md) (numeric) — Lowest single-analyst EPS estimate for the next reported quarter.
- [next_revenue_estimate](https://tickerbot.io/docs/signals/next_revenue_estimate.md) (bigint) — Wall Street consensus revenue estimate (USD, full dollars) for the next reported quarter.
- [estimate_revised_down](https://tickerbot.io/docs/signals/estimate_revised_down.md) (state) — At least one analyst lowered their next-quarter EPS estimate in the last 30 days.
- [estimate_revised_up](https://tickerbot.io/docs/signals/estimate_revised_up.md) (state) — At least one analyst raised their next-quarter EPS estimate in the last 30 days.
- [high_earnings_estimate](https://tickerbot.io/docs/signals/high_earnings_estimate.md) (classification) — Consensus next-quarter EPS estimate exceeds an absolute $1.00 per share threshold.
- [loss_estimate](https://tickerbot.io/docs/signals/loss_estimate.md) (classification) — Analyst consensus expects negative EPS for the upcoming report.
- [profitable_estimate](https://tickerbot.io/docs/signals/profitable_estimate.md) (classification) — Analyst consensus expects positive EPS for the upcoming report.
