consensus

Get consensus price target and recommendation.

Examples

from openbb import obb
obb.equity.estimates.consensus(symbol='AAPL', provider='fmp')
obb.equity.estimates.consensus(symbol='AAPL,MSFT', provider='yfinance')

---

Parameters

• standard
• fmp
• intrinio
• tmx
• yfinance

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, tmx, yfinance.	None	True
provider	Literal['fmp', 'intrinio', 'tmx', 'yfinance']	The provider to use, by default None. If None, the priority list configured in the settings is used. Default priority: fmp, intrinio, tmx, yfinance.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, tmx, yfinance.	None	True
provider	Literal['fmp', 'intrinio', 'tmx', 'yfinance']	The provider to use, by default None. If None, the priority list configured in the settings is used. Default priority: fmp, intrinio, tmx, yfinance.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, tmx, yfinance.	None	True
provider	Literal['fmp', 'intrinio', 'tmx', 'yfinance']	The provider to use, by default None. If None, the priority list configured in the settings is used. Default priority: fmp, intrinio, tmx, yfinance.	None	True
industry_group_number	int	The Zacks industry group number.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, tmx, yfinance.	None	True
provider	Literal['fmp', 'intrinio', 'tmx', 'yfinance']	The provider to use, by default None. If None, the priority list configured in the settings is used. Default priority: fmp, intrinio, tmx, yfinance.	None	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): fmp, intrinio, tmx, yfinance.	None	True
provider	Literal['fmp', 'intrinio', 'tmx', 'yfinance']	The provider to use, by default None. If None, the priority list configured in the settings is used. Default priority: fmp, intrinio, tmx, yfinance.	None	True

---

Returns

OBBject
    results : List[PriceTargetConsensus]
        Serializable results.

    provider : Optional[Literal['fmp', 'intrinio', 'tmx', 'yfinance']]
        Provider name.

    warnings : Optional[List[Warning_]]
        List of warnings.

    chart : Optional[Chart]
        Chart object.

    extra : Dict[str, Any]
        Extra info.

---

Data

• standard
• fmp
• intrinio
• tmx
• yfinance

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	The company name
target_high	float	High target of the price target consensus.
target_low	float	Low target of the price target consensus.
target_consensus	float	Consensus target of the price target consensus.
target_median	float	Median target of the price target consensus.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	The company name
target_high	float	High target of the price target consensus.
target_low	float	Low target of the price target consensus.
target_consensus	float	Consensus target of the price target consensus.
target_median	float	Median target of the price target consensus.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	The company name
target_high	float	High target of the price target consensus.
target_low	float	Low target of the price target consensus.
target_consensus	float	Consensus target of the price target consensus.
target_median	float	Median target of the price target consensus.
standard_deviation	float	The standard deviation of target price estimates.
total_anaylsts	int	The total number of target price estimates in consensus.
raised	int	The number of analysts that have raised their target price estimates.
lowered	int	The number of analysts that have lowered their target price estimates.
most_recent_date	date	The date of the most recent estimate.
industry_group_number	int	The Zacks industry group number.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	The company name
target_high	float	High target of the price target consensus.
target_low	float	Low target of the price target consensus.
target_consensus	float	Consensus target of the price target consensus.
target_median	float	Median target of the price target consensus.
target_upside	float	Percent of upside, as a normalized percent.
total_analysts	int	Total number of analyst.
buy_ratings	int	Number of buy ratings.
sell_ratings	int	Number of sell ratings.
hold_ratings	int	Number of hold ratings.
consensus_action	str	Consensus action.

Name	Type	Description
symbol	str	Symbol representing the entity requested in the data.
name	str	The company name
target_high	float	High target of the price target consensus.
target_low	float	Low target of the price target consensus.
target_consensus	float	Consensus target of the price target consensus.
target_median	float	Median target of the price target consensus.
recommendation	str	Recommendation - buy, sell, etc.
recommendation_mean	float	Mean recommendation score where 1 is strong buy and 5 is strong sell.
number_of_analysts	int	Number of analysts providing opinions.
current_price	float	Current price of the stock.
currency	str	Currency the stock is priced in.