GET Analysts

Returns the full list of analyst that are providing ratings

Response (200 OK)

{
  "removed": [
    {
      "id": "string",
      "firm_id": "string",
      "firm_name": "string",
      "name_first": "string",
      "name_last": "string",
      "name_full": "string",
      "ratings_accuracy": {
        "smart_score": "string (double)",
        "overall_success_rate": "string (double)",
        "overall_avg_return_percentile": "string (double)",
        "total_ratings_percentile": "string (double)",
        "total_ratings": "integer (int64)",
        "overall_gain_count": "integer (int64)",
        "overall_loss_count": "integer (int64)",
        "overall_average_return": "string (double)",
        "overall_stdev": "string (double)",
        "1m_gain_count": "string (double)",
        "1m_loss_count": "string (double)",
        "1m_average_return": "string (double)",
        "1m_stdev": "string (double)",
        "3m_gain_count": "string (double)",
        "3m_loss_count": "string (double)",
        "3m_average_return": "string (double)",
        "3m_stdev": "string (double)",
        "9m_gain_count": "string (double)",
        "9m_loss_count": "string (double)",
        "9m_average_return": "string (double)",
        "9m_stdev": "string (double)",
        "1y_gain_count": "string (double)",
        "1y_loss_count": "string (double)",
        "1y_average_return": "string (double)",
        "1y_stdev": "string (double)",
        "2y_gain_count": "string (double)",
        "2y_loss_count": "string (double)",
        "2y_average_return": "string (double)",
        "2y_stdev": "string (double)",
        "3y_gain_count": "string (double)",
        "3y_loss_count": "string (double)",
        "3y_average_return": "string (double)",
        "3y_stdev": "string (double)",
        "updated": "integer (int64)"
      },
      "updated": "integer (int64)"
    }
  ]
}

Authorizations

token

string

query

required

Query Parameters

fields

string

Default fields:

• id
• name_first
• name_last
• name_full
• firm_id
• firm_name
• ratings_accuracy
• updated

analyst

string

A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts.

firm

string

A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms.

firm_name

string

A comma separated list of analyst firm names to bring back. Omitting will bring back all available firms.

analyst_name

string

A comma separated list of analyst names to bring back. Omitting will bring back all available analysts.

page

integer

default:0

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.

pageSize

integer

Number of results returned. Limit 1000. Default 50.

updated

integer

Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

Response

200

application/json

success

removed

object[]

Show child attributes

removed.id

string

Id of the analyst

removed.firm_id

string

Id of the analyst firm

removed.firm_name

string

Firm name of the analyst

removed.name_first

string

Analyst first name

removed.name_last

string

Analyst last name

removed.name_full

string

Analyst full name for display

removed.ratings_accuracy

object

Analyst accuracy scores

Show child attributes

removed.ratings_accuracy.smart_score

string

A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate

removed.ratings_accuracy.overall_success_rate

string

The percentage of gain/loss ratings that resulted in a gain overall

removed.ratings_accuracy.overall_avg_return_percentile

string

The percentile of this analyst’s overall average return per rating in comparison to other analysts' overall average returns per rating

removed.ratings_accuracy.total_ratings_percentile

string

The percentile of this analyst’s total number of ratings in comparison to the total number of ratings published by all other analysts

removed.ratings_accuracy.total_ratings

integer

Number of recommendations made by this analyst

removed.ratings_accuracy.overall_gain_count

integer

The number of ratings that have gained value since the date of recommendation

removed.ratings_accuracy.overall_loss_count

integer

The number of ratings that have lost value since the date of recommendation

removed.ratings_accuracy.overall_average_return

string

The average percent price difference per rating since the date of recommendation

removed.ratings_accuracy.overall_stdev

string

The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation

removed.ratings_accuracy.1m_gain_count

string

The number of ratings that have gained value over the last month

removed.ratings_accuracy.1m_loss_count

string

The number of ratings that have lost value over the last month

removed.ratings_accuracy.1m_average_return

string

The average percent price difference per rating over the last month

removed.ratings_accuracy.1m_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last month

removed.ratings_accuracy.3m_gain_count

string

The number of ratings that have gained value over the last three months

removed.ratings_accuracy.3m_loss_count

string

The number of ratings that have lost value over the last three months

removed.ratings_accuracy.3m_average_return

string

The average percent price difference per rating over the last three months

removed.ratings_accuracy.3m_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last three months

removed.ratings_accuracy.9m_gain_count

string

The number of ratings that have gained value over the last nine months

removed.ratings_accuracy.9m_loss_count

string

The number of ratings that have lost value over the last nine months

removed.ratings_accuracy.9m_average_return

string

The average percent price difference per rating over the last nine months

removed.ratings_accuracy.9m_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last nine months

removed.ratings_accuracy.1y_gain_count

string

The number of ratings that have gained value over the last year (TTM)

removed.ratings_accuracy.1y_loss_count

string

The number of ratings that have lost value over the last year (TTM)

removed.ratings_accuracy.1y_average_return

string

The average percent price difference per rating over the last year (TTM)

removed.ratings_accuracy.1y_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM)

removed.ratings_accuracy.2y_gain_count

string

The number of ratings that have gained value over the last two years

removed.ratings_accuracy.2y_loss_count

string

The number of ratings that have lost value over the last two years

removed.ratings_accuracy.2y_average_return

string

The average percent price difference per rating over the last two years

removed.ratings_accuracy.2y_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last two years

removed.ratings_accuracy.3y_gain_count

string

The number of ratings that have gained value over the last three years

removed.ratings_accuracy.3y_loss_count

string

The number of ratings that have lost value over the last three years

removed.ratings_accuracy.3y_average_return

string

The average percent price difference per rating over the last three years

removed.ratings_accuracy.3y_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last three years

removed.ratings_accuracy.updated

integer

Last update timstamp in UTC Unix epoch timestamp (seconds)

removed.updated

integer

Last update timstamp in UTC Unix epoch timestamp (seconds)