Skip to main content
GET
https://stocks-dev.up.railway.app
/
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