Analyst Ratings

Get Analyst Ratings

curl --request GET \
  --url https://api.aries.com/v1/analytics/ratings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/analytics/ratings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aries.com/v1/analytics/ratings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aries.com/v1/analytics/ratings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aries.com/v1/analytics/ratings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

GET

analytics

ratings

Get Analyst Ratings

curl --request GET \
  --url https://api.aries.com/v1/analytics/ratings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/analytics/ratings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aries.com/v1/analytics/ratings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aries.com/v1/analytics/ratings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aries.com/v1/analytics/ratings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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. 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

Show child attributes

Top Volume Options for ETFs Market Breadth

Analytics

Options

Stocks

Economy

Calendar

Market

Company

Ownership

Financials

Filings

Corporate Actions

Indices

Logos

Stock Estimates

Stock Alternative

News

ETF

Technical Analysis

Signals

Authorizations

Query Parameters

Response