Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

analysis

Recommendations

The recommendations endpoint provides a summary of analyst opinions for a specific stock, delivering an average recommendation categorized as Strong Buy, Buy, Hold, or Sell. It also includes a numerical recommendation score, offering a quick overview of market sentiment based on expert analysis.

get/recommendations

Query parameters

symbolstring

Filter by symbol

figistring

The FIGI of an instrument for which data is requested. 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

countrystring

The country where the instrument is traded, e.g., United States or US

exchangestring

The exchange name where the instrument is traded, e.g., Nasdaq, NSE.

mic_codestring

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

Response

ratingnumber double

Rating from 0 to 10 represents overall analysts' recommendation. 0 to 2 - strong sell, 2 to 4 - sell, 4 to 6 - hold, 6 to 8 - buy, 8 to 10 - strong buy.

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"
  },
  "trends": {
    "current_month": {
      "strong_buy": 13,
      "buy": 20,
      "hold": 8
    },
    "previous_month": {
      "strong_buy": 13,
      "buy": 20,
      "hold": 8
    },
    "2_months_ago": {
      "strong_buy": 13,
      "buy": 20,
      "hold": 8
    },
    "3_months_ago": {
      "strong_buy": 13,
      "buy": 20,
      "hold": 8
    }
  },
  "rating": 8.2,
  "status": "ok"
}