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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

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. Use this to control pagination size in list views.

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 to include. Use higher values to filter for more market-moving events or ratings.

​
action
string

Rating action filter. Use it to return only upgrades, downgrades, initiations, or other supported action types.

​
analystId
string

Comma-separated analyst IDs. Use this to limit insight results to specific analysts. 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