Skip to main content
GET
/
v1
/
stock
/
upgrade-downgrade
Get Analyst Upgrades & Downgrades
curl --request GET \
  --url https://api.aries.com/v1/stock/upgrade-downgrade \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "symbol": "AAPL",
      "gradeTime": 1765238400,
      "company": "Citigroup",
      "fromGrade": "Buy",
      "toGrade": "Buy",
      "action": "main"
    },
    {
      "symbol": "AAPL",
      "gradeTime": 1765065600,
      "company": "Goldman Sachs",
      "fromGrade": "Neutral",
      "toGrade": "Buy",
      "action": "upgrade"
    },
    {
      "symbol": "AAPL",
      "gradeTime": 1764547200,
      "company": "Morgan Stanley",
      "fromGrade": "Overweight",
      "toGrade": "Overweight",
      "action": "main"
    }
  ]
}

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

​
symbol
string

Stock ticker to filter by. Send the plain uppercase symbol (e.g. AAPL). Omit to return data across all symbols.

​
from
string<date>

Start of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-01-01). Omit to read from the earliest available data.

Example:

"2024-01-01"

​
to
string<date>

End of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-12-31). Omit to read up to today.

Example:

"2024-12-31"

Response

Analyst upgrades and downgrades.

​
data
object[]