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": "rate-1001", "date": "2026-01-12", "time": "09:45:00", "ticker": "AAPL", "exchange": "NASDAQ", "name": "Apple Inc.", "currency": "USD", "action_pt": "raised", "action_company": "maintain", "rating_current": "Buy", "rating_prior": "Hold", "pt_current": 210, "pt_current_adjusted": 208.5, "pt_prior": 195, "pt_prior_adjusted": 194, "analyst": "jdoe", "analyst_id": "an-9001", "analyst_name": "Jane Doe", "ratings_accuracy": { "smart_score": 72.5, "success_rate": 0.68, "total_ratings": 140, "gain_count_1m": 8, "loss_count_1m": 3, "avg_return_1m": 0.021, "std_dev_return_1m": 0.045, "gain_count_3m": 22, "loss_count_3m": 9, "avg_return_3m": 0.055, "std_dev_return_3m": 0.09, "gain_count_9m": 58, "loss_count_9m": 21, "avg_return_9m": 0.12, "std_dev_return_9m": 0.14, "gain_count_1y": 72, "loss_count_1y": 28, "avg_return_1y": 0.18, "std_dev_return_1y": 0.22, "gain_count_2y": 130, "loss_count_2y": 48, "avg_return_2y": 0.31, "std_dev_return_2y": 0.28, "gain_count_3y": 180, "loss_count_3y": 65, "avg_return_3y": 0.42, "std_dev_return_3y": 0.33 }, "importance": 2, "notes": "Services outlook improved.", "updated": "2026-01-12T09:45:00Z" } ] }

Authorizations

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

​
tickers
string

Comma-separated list of ticker symbols to filter by

Example:

"AAPL,GOOGL"

​
page
integer

Page number for pagination (0-based)

Required range: x >= 0
​
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. Response has a ratings array; each item may include 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. Some fields may be absent when empty.

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

​
ratings
object[]

Array of analyst rating objects