Returns a summary of the two most recent equity analyst ratings for a company.
Introduction
This endpoint delivers blended analyst ratings for a given asset, displayed as a score from 1 (strong buy) to 5 (strong sell). This blended rating is calculated based on individual ratings from various equity research analysts who cover the stock. It returns the previous and most recent analyst ratings summary for assets. This endpoint only supports Equity assets.
Response fields
Field | Description |
---|---|
date | Date and time the analyst rating information was received. |
averageRating | Weighted average rating where: 1: Strong buy 2: Buy 3: Hold 4: Sell 5: Strong sell |
totalRatings | The total number of individual analyst ratings that were combined to form the averageRating. |
priceChange1D | Percent change in price from date field to the next market close after that date (or until now, if it's been less than 24 hours). If it's been more than 24 hours since the date field, the most recent market close before date is used as the basis for calculating price change instead of using the date field. |
averageRatingDelta | newSummary.averageRating minus oldSummary.averageRating |
Examples
Consider some stock ABC trading on the NYSE with 1 Buy rating and 2 Strong Sell ratings timestamped at March 1, 2022 6:00:00 PM GMT-04:00
. Now on April 1, 2022 8:00:00 AM GMT-04:00
, there's a rating change and ABC now has 1 Buy rating, 1 Hold and 1 Sell. This would produce the following result:
{
"analystRatings": {
"asset": {
"atomAssetId": "..",
"ticker": "ABC",
"name": "ABC Company"
},
"newRating": {
"date": "2022-04-01T13:00:00.000Z",
"averageRating": 3,
"priceChange1D": ...
},
"oldRating": {
"date": "2022-03-01T22:00:00.000Z",
"averageRating": 4,
"priceChange1D": ...
},
"ratingDelta": -1
}
}
In this case, oldRating.priceChange1D
will equal the percent change in price from the closing price on March 1 to the closing price on March 2. If it's currently April 1, 2022 1:30:00 PM GMT-04:00, newRating.priceChange1D
will equal the percent change in price from 8:00am in the morning until now 1:30pm. If it's currently April 2, 2022 11:30:00 AM GMT-04:00, newRating.priceChange1D
will equal the percent change in price from the closing price on March 31 to the closing price on April 1.