Skip to main content
GET
/
v1
/
analytics
/
ratings
Get Analyst Ratings
curl --request GET \
  --url https://api.aries.com/v1/analytics/ratings \
  --header 'Authorization: Bearer <token>'
{
  "ratings": [
    {
      "id": "<string>",
      "date": "<string>",
      "time": "<string>",
      "ticker": "<string>",
      "exchange": "<string>",
      "name": "<string>",
      "currency": "<string>",
      "action_pt": "<string>",
      "action_company": "<string>",
      "rating_current": "<string>",
      "rating_prior": "<string>",
      "pt_current": 123,
      "pt_current_adjusted": 123,
      "pt_prior": 123,
      "pt_prior_adjusted": 123,
      "analyst": "<string>",
      "analyst_id": "<string>",
      "analyst_name": "<string>",
      "ratings_accuracy": {
        "smart_score": 123,
        "success_rate": 123,
        "total_ratings": 123,
        "gain_count_1m": 123,
        "loss_count_1m": 123,
        "avg_return_1m": 123,
        "std_dev_return_1m": 123,
        "gain_count_3m": 123,
        "loss_count_3m": 123,
        "avg_return_3m": 123,
        "std_dev_return_3m": 123,
        "gain_count_9m": 123,
        "loss_count_9m": 123,
        "avg_return_9m": 123,
        "std_dev_return_9m": 123,
        "gain_count_1y": 123,
        "loss_count_1y": 123,
        "avg_return_1y": 123,
        "std_dev_return_1y": 123,
        "gain_count_2y": 123,
        "loss_count_2y": 123,
        "avg_return_2y": 123,
        "std_dev_return_2y": 123,
        "gain_count_3y": 123,
        "loss_count_3y": 123,
        "avg_return_3y": 123,
        "std_dev_return_3y": 123
      },
      "importance": 123,
      "notes": "<string>",
      "updated": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

tickers
string

Comma-separated list of ticker symbols to filter by

Example:

"AAPL,GOOGL"

page
integer

Page number for pagination (1-based)

Required range: x >= 1
pageSize
integer

Number of results per page

Required range: x >= 1
date
string<date>

Filter by specific date (YYYY-MM-DD)

dateFrom
string<date>

Start date for date range (YYYY-MM-DD)

dateTo
string<date>

End date for date range (YYYY-MM-DD)

importance
integer

Minimum importance level (integer)

action
string

Filter by rating action type

analystId
string

Comma-separated analyst IDs to filter by

firmId
string

Comma-separated firm IDs to filter by

Response

Analyst ratings. Body has a ratings array. Each item includes only non-empty fields (empty ones are omitted). Optional fields notes and ratings_accuracy are omitted when empty—so they may be absent in many items. Common fields when present: id, date, time, ticker, exchange, name, currency, action_pt, action_company, rating_current, rating_prior, pt_current, pt_current_adjusted, pt_prior, pt_prior_adjusted, analyst, analyst_id, analyst_name, importance, updated.

Response for GET /v1/analytics/ratings. Only non-empty fields appear in each rating; notes and ratings_accuracy are omitted when empty.

ratings
object[]
required

Array of analyst rating objects