latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

analysis

Analyst ratings snapshot

The analyst ratings snapshot endpoint provides a streamlined summary of ratings from analyst firms for both US and international markets. It delivers essential data on analyst recommendations, including buy, hold, and sell ratings, allowing users to quickly assess the general sentiment of analysts towards a particular stock.

get/analyst_ratings/light

Query parameters

symbolstring

Filter by symbol

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

exchangestring

Filter by exchange name

mic_codestring

The Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.

rating_change'Maintains' | 'Upgrade' | 'Downgrade' | 'Initiates' | 'Reiterates'

Filter by rating change action

outputsizeinteger

Number of records in response

countrystring

Filter by country name or alpha code, e.g., United States or US

Response

statusstring required

Response status

Example response

{
  "meta": {
    "symbol": "AAPL",
    "name": "Apple Inc",
    "currency": "USD",
    "exchange_timezone": "America/New_York",
    "exchange": "NASDAQ",
    "mic_code": "XNGS",
    "type": "Common Stock"
  },
  "ratings": [
    {
      "date": "2022-08-19",
      "firm": "Keybanc",
      "rating_change": "Maintains",
      "rating_current": "Overweight",
      "rating_prior": "Overweight"
    }
  ],
  "status": "ok"
}