Skip to main content
GET
Returns analyst ratings consensus data

Authorizations

token
string
query
required

Headers

accept
enum<string>
default:application/json
required

Specifies return format. Query parameters work the same for both formats

Available options:
application/json

Query Parameters

pagesize
integer

Number of results returned. Limit 1000

parameters[date_from]
string<YYYY-MM-DD>

Date to query from point in time

parameters[date_to]
string<YYYY-MM-DD>

Date to query to point in time

parameters[tickers]
string

One ticker symbol to query the aggregate for. Maximum 1 ticker

simplify
boolean
default:false

To simplify the aggregate ratings to only BUY, SELL, HOLD, default will return all ratings (STRONG_BUY, BUY, HOLD, SELL, STRONG_SELL)

aggregate_type
enum<string>
default:number

To aggregate the ratings by either number or percentage

Available options:
number,
percentage

Response

success

aggregate_ratings
object

Aggregate rating counts by category

aggregate_type
string

Time period for aggregation (30D, 90D, 1Y)

Example:

"90D"

consensus_price_target
number

Consensus (average) price target

Example:

195.5

consensus_rating
string

Consensus rating (Strong Buy, Buy, Hold, Sell, Strong Sell)

Example:

"Buy"

consensus_rating_val
number

Numerical consensus rating value (1-5 scale)

Example:

4.2

high_price_target
number

Highest analyst price target

Example:

225

low_price_target
number

Lowest analyst price target

Example:

150

total_analyst_count
integer

Total number of analysts providing ratings

Example:

19

unique_analyst_count
integer

Number of unique analysts (excluding duplicates)

Example:

15

updated_at
string

Timestamp when consensus was last updated

Example:

"2024-01-09T16:00:00Z"