Default

Stock Upgrade/Downgrade

Changed on

Get latest stock upgrade and downgrade.

get/stock/upgrade-downgrade

Request

  • Base URL
    https://finnhub.io/api/v1
  • URL
    https://finnhub.io/api/v1/stock/upgrade-downgrade
  • Auth
    API key in query parameter token

Query parameters

symbolstring

Symbol of the company: AAPL. If left blank, the API will return latest stock upgrades/downgrades.

fromstring date

From date: 2000-03-15.

tostring date

To date: 2020-03-16.

Response

successful operation

symbolstring

Company symbol.

gradeTimeinteger

Upgrade/downgrade time in UNIX timestamp.

fromGradestring

From grade.

toGradestring

To grade.

companystring

Company/analyst who did the upgrade/downgrade.

actionstring

Action can take any of the following values: <code>up(upgrade), down(downgrade), main(maintains), init(initiate), reit(reiterate)</code>.

Example response

[
  {
    "symbol": "symbol",
    "gradeTime": 0,
    "fromGrade": "fromGrade",
    "toGrade": "toGrade",
    "action": "action",
    "company": "company"
  }
]

Changes