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 filter, such as AAPL. Use it to narrow results to one company.

​
from
string<date>

Start date in YYYY-MM-DD format. Enter the first date to include in the research window.

Example:

"2024-01-01"

​
to
string<date>

End date in YYYY-MM-DD format. Enter the last date to include in the research window.

Example:

"2024-12-31"

Response

Analyst upgrades and downgrades.

​
data
object[]