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

FieldDescription
dateDate and time the analyst rating information was received.
averageRatingWeighted average rating where:
1: Strong buy
2: Buy
3: Hold
4: Sell
5: Strong sell
totalRatingsThe total number of individual analyst ratings that were combined to form the averageRating.
priceChange1DPercent 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.
averageRatingDeltanewSummary.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.

Ready to get started? Get your free trial API key ➔
Language
Authorization
Query
Click Try It! to start a request and see the response here!