Skip to main content
GET
Upgrades Downgrades
Get the history of analyst rating changes (upgrades and downgrades) for a symbol. Requires an organization with recommendation access.

Query Parameters

Response

Returns a dictionary keyed by field name, with each field itself a dictionary keyed by the grade date:
Field names use this exact casing (firm, toGrade, fromGrade, action), keyed by grade-change date in this string format (no timezone offset in the string itself). Returns null when no rating-change data is found for the symbol. The endpoint responds 403 with a kyc_required problem when the caller’s organization is not KYC-verified.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

symbol
string
required

Stock symbol(s). Single or comma-separated

Examples:

"AAPL"

"AAPL,MSFT,GOOG"

Response

Successful Response

Last modified on November 6, 2026