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

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

symbol
string

(Optional) Stock ticker symbol

from
string<date>

Start date (YYYY-MM-DD)

Example:

"2024-01-01"

to
string<date>

End date (YYYY-MM-DD)

Example:

"2024-12-31"

Response

Analyst upgrades and downgrades.

data
object[]