Skip to main content
GET
/
api
/
v1
/
stock
/
{symbol}
/
recommendations
curl -X GET "https://stocks-dev.up.railway.app/api/v1/stock/AAPL/recommendations" \
  -H "X-API-Key: your_api_key"

{
  "symbol": "AAPL",
  "recommendations": {
    "strongBuy": 15,
    "buy": 12,
    "hold": 8,
    "sell": 2,
    "strongSell": 0
  },
  "summary": {
    "total_analysts": 37,
    "average_rating": 1.8,
    "consensus": "Buy"
  }
}
Get current analyst recommendations including buy, sell, and hold ratings from major financial institutions.

​
Parameters

​
symbol
string
required
Stock symbol (e.g., AAPL, MSFT, GOOGL)

​
Response

​
symbol
string
The stock symbol
​
recommendations
object
Current recommendation counts
​
summary
object
Recommendation summary statistics
curl -X GET "https://stocks-dev.up.railway.app/api/v1/stock/AAPL/recommendations" \
  -H "X-API-Key: your_api_key"

{
  "symbol": "AAPL",
  "recommendations": {
    "strongBuy": 15,
    "buy": 12,
    "hold": 8,
    "sell": 2,
    "strongSell": 0
  },
  "summary": {
    "total_analysts": 37,
    "average_rating": 1.8,
    "consensus": "Buy"
  }
}

​
Use Cases

  • Investment Research: Gauge analyst sentiment
  • Decision Making: Consider professional opinions
  • Market Analysis: Track recommendation changes over time
  • Risk Assessment: Understand analyst concerns

​
Rating Scale

  • 1.0-1.5: Strong Buy
  • 1.5-2.5: Buy
  • 2.5-3.5: Hold
  • 3.5-4.5: Sell
  • 4.5-5.0: Strong Sell

​
Notes

  • Recommendations are aggregated from major financial institutions
  • Data is updated regularly but may have slight delays
  • Consider recommendations as one factor among many in investment decisions
  • Analyst coverage varies by stock size and sector