v1

latestOpenAPI 3.0.02026-07-266091181.5 KB

consensus_ratings

Returns analyst ratings consensus data

Returns aggregated consensus analyst ratings data for a given ticker symbol. This endpoint provides consensus price targets, aggregate ratings distribution, and analyst counts based on recent analyst ratings.

get/api/v1/consensus-ratings

Query parameters

pagesizeinteger

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

simplifyboolean

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

aggregate_type'number' | 'percentage'

To aggregate the ratings by either number or percentage

Headers

accept'application/json' required

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

Response

success

aggregate_typestring

consensus_price_targetnumber

consensus_ratingstring

consensus_rating_valnumber

high_price_targetnumber

low_price_targetnumber

total_analyst_countinteger

unique_analyst_countinteger

updated_atstring

Example response

{
  "aggregate_ratings": {
    "buy": 10,
    "hold": 3,
    "sell": 1,
    "strong_buy": 5
  },
  "aggregate_type": "90D",
  "consensus_price_target": 195.5,
  "consensus_rating": "Buy",
  "consensus_rating_val": 4.2,
  "high_price_target": 225,
  "low_price_target": 150,
  "total_analyst_count": 19,
  "unique_analyst_count": 15,
  "updated_at": "2024-01-09T16:00:00Z"
}