Skip to main content
GET
https://stocks-dev.up.railway.app
/
api
/
v1
/
fmp
/
stock
/
{symbol}
/
price-targets
Analyst Price Targets
curl --request GET \
  --url https://stocks-dev.up.railway.app/api/v1/fmp/stock/{symbol}/price-targets
{
  "symbol": "<string>",
  "priceTargetAverage": 123,
  "priceTargetHigh": 123,
  "priceTargetLow": 123,
  "priceTargetMedian": 123,
  "numberOfAnalysts": 123,
  "lastUpdated": "<string>",
  "strongBuy": 123,
  "buy": 123,
  "hold": 123,
  "sell": 123,
  "strongSell": 123,
  "consensusRating": "<string>",
  "recentChanges": [
    {
      "analystName": "<string>",
      "date": "<string>",
      "previousTarget": 123,
      "newTarget": 123,
      "rating": "<string>",
      "ratingChange": "<string>"
    }
  ],
  "source": "<string>",
  "timestamp": "<string>"
}

​
Overview

Retrieve analyst price targets and recommendations for any publicly traded company. This endpoint provides professional analyst forecasts including target prices, ratings, and recent changes, helping investors understand Wall Street sentiment and potential price movements.
Price targets represent analysts’ 12-month price forecasts based on fundamental analysis, valuation models, and market conditions. They provide insight into professional sentiment and potential upside/downside.

​
Parameters

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

​
Response

​
symbol
string
The stock ticker symbol
​
priceTargetAverage
number
Average analyst price target
​
priceTargetHigh
number
Highest analyst price target
​
priceTargetLow
number
Lowest analyst price target
​
priceTargetMedian
number
Median analyst price target
​
numberOfAnalysts
number
Number of analysts providing targets
​
lastUpdated
string
Date of last price target update

​
Recommendation Summary

​
strongBuy
number
Number of Strong Buy recommendations
​
buy
number
Number of Buy recommendations
​
hold
number
Number of Hold recommendations
​
sell
number
Number of Sell recommendations
​
strongSell
number
Number of Strong Sell recommendations
​
consensusRating
string
Overall consensus rating (Strong Buy, Buy, Hold, Sell, Strong Sell)

​
Recent Changes

​
recentChanges
array
Array of recent price target changes
​
source
string
Data source identifier (“FMP”)
​
timestamp
string
ISO timestamp of the response

​
Examples

curl "https://stocks-dev.up.railway.app/api/v1/fmp/stock/AAPL/price-targets"

​
Response Example

{
  "symbol": "AAPL",
  "priceTargetAverage": 225.50,
  "priceTargetHigh": 275.00,
  "priceTargetLow": 180.00,
  "priceTargetMedian": 220.00,
  "numberOfAnalysts": 32,
  "lastUpdated": "2025-06-28",
  "strongBuy": 8,
  "buy": 18,
  "hold": 5,
  "sell": 1,
  "strongSell": 0,
  "consensusRating": "Buy",
  "recentChanges": [
    {
      "analystName": "Morgan Stanley",
      "date": "2025-06-25",
      "previousTarget": 210.00,
      "newTarget": 230.00,
      "rating": "Overweight",
      "ratingChange": "Upgrade"
    },
    {
      "analystName": "Goldman Sachs",
      "date": "2025-06-20",
      "previousTarget": 240.00,
      "newTarget": 260.00,
      "rating": "Buy",
      "ratingChange": "Maintain"
    }
  ],
  "source": "FMP",
  "timestamp": "2025-06-28T20:30:15.123456"
}

​
Understanding Price Targets

How Analysts Set Targets:
  1. Valuation Models: DCF, P/E multiples, sum-of-parts analysis
  2. Time Horizon: Typically 12-month forward-looking targets
  3. Risk Assessment: Consider company-specific and market risks
  4. Peer Comparison: Relative valuation vs industry peers
  • Strong Buy/Buy: Analyst expects significant outperformance
  • Hold: Expected to perform in line with market
  • Sell/Strong Sell: Expected underperformance (rare)
  • Consensus: Weighted average of all recommendations
  • Historical Performance: Analysts achieve ~40-60% accuracy
  • Bias Factors: Tend to be optimistic, slow to downgrade
  • Market Conditions: Accuracy varies with market volatility
  • Coverage Quality: More analysts generally means better consensus

​
Use Cases

Investment Decisions

Buy/Sell Signals
  • Compare current price to targets
  • Assess risk/reward ratios
  • Time entry/exit points

Portfolio Management

Position Sizing
  • Upside potential analysis
  • Risk assessment
  • Diversification decisions

Research & Analysis

Due Diligence
  • Consensus sentiment tracking
  • Analyst revision trends
  • Peer comparison

Risk Management

Downside Protection
  • Identify potential risks
  • Stop-loss level setting
  • Volatility expectations

​
Target Analysis Tips

Strong Consensus Indicators:
  • 20+ analysts covering the stock
  • Narrow price target range
  • Recent target increases
  • High percentage of Buy ratings
Investment Strategies:
  • Look for stocks trading below average targets
  • Monitor target revision trends
  • Consider consensus rating changes
  • Compare targets to technical levels
Important Considerations:
  • Price targets are opinions, not guarantees
  • Analyst biases and conflicts of interest
  • Market conditions can change rapidly
  • Use targets as one of many analysis tools

​
Error Responses

{
  "error": "404: Failed to fetch price targets for INVALID"
}

{
  "error": "No analyst coverage available",
  "detail": "This stock is not covered by professional analysts"
}

{
  "error": "Rate limit exceeded",
  "detail": "FMP API limit reached. Please upgrade plan or try again later."
}

​
MCP Protocol Usage

For AI agents using the Model Context Protocol: 
{
  "method": "tools/call",
  "params": {
    "name": "fmp_get_price_targets",
    "arguments": {
      "symbol": "AAPL"
    }
  }
}

Analyst Estimates

Get earnings and revenue forecasts

Stock Quote

Get current market price for comparison

Upgrades/Downgrades

Get recent rating changes

Stock Recommendations

Get recommendation summaries