price_target
Get analyst price targets by company.
Examples
from openbb import obb
obb.equity.estimates.price_target(provider='benzinga')
# Get price targets for Microsoft using 'benzinga' as provider.
obb.equity.estimates.price_target(start_date=2020-01-01, end_date=2024-02-16, limit=10, symbol='msft', provider='benzinga', action=downgrades)
Parameters
- standard
- benzinga
- finviz
- fmp
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, finviz, fmp.
• Optional: True
limit: int
The number of data entries to return.
• Default: 200
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, finviz, fmp.
• Optional: True
limit: int
The number of data entries to return.
• Default: 200
• Optional: True
page: int
Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date. Used in conjunction with the limit and date parameters.
• Default: 0
• Optional: True
date: Union[date, str]
Date for calendar data, shorthand for date_from and date_to.
• Optional: True
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
updated: Union[date, int]
Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. The date can be a date string or a Unix timestamp. The date string must be in the format of YYYY-MM-DD.
• Optional: True
importance: int
Importance level to filter by. Uses Greater Than or Equal To the importance indicated
• Optional: True
action: Literal['downgrades', 'maintains', 'reinstates', 'reiterates', 'upgrades', 'assumes', 'initiates', 'terminates', 'removes', 'suspends', 'firm_dissolved']
Filter by a specific action_company.
• Optional: True
analyst_ids: Union[Union[str, list[str]], list[Union[str, list[str]]]]
Comma-separated list of analyst (person) IDs. Omitting will bring back all available analysts. Multiple items allowed for provider(s): benzinga.
• Optional: True
firm_ids: Union[Union[str, list[str]], list[Union[str, list[str]]]]
Comma-separated list of firm IDs. Multiple items allowed for provider(s): benzinga.
• Optional: True
fields: Union[Union[str, list[str]], list[Union[str, list[str]]]]
Comma-separated list of fields to include in the response. See https://docs.benzinga.io/benzinga-apis/calendar/get-ratings to learn about the available fields. Multiple items allowed for provider(s): benzinga.
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, finviz, fmp.
• Optional: True
limit: int
The number of data entries to return.
• Default: 200
• Optional: True
symbol: Union[str, list[str]]
Symbol to get data for. Multiple items allowed for provider(s): benzinga, finviz, fmp.
• Optional: True
limit: int
The number of data entries to return.
• Default: 200
• Optional: True
with_grade: bool
Include upgrades and downgrades in the response.
• Default: False
• Optional: True
Returns
results: list[PriceTarget]
Serializable results.
provider: Optional[Literal['benzinga', 'finviz', 'fmp']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- benzinga
- finviz
- fmp
published_date: Union[date, datetime]
Published date of the price target.
published_time: datetime.time
Time of the original rating, UTC.
symbol: str
Symbol representing the entity requested in the data.
exchange: str
Exchange where the company is traded.
company_name: str
Name of company that is the subject of rating.
analyst_name: str
Analyst name.
analyst_firm: str
Name of the analyst firm that published the price target.
currency: str
Currency the data is denominated in.
price_target: float
The current price target.
adj_price_target: float
Adjusted price target for splits and stock dividends.
price_target_previous: float
Previous price target.
previous_adj_price_target: float
Previous adjusted price target.
price_when_posted: float
Price when posted.
rating_current: str
The analyst's rating for the company.
rating_previous: str
Previous analyst rating for the company.
action: str
Description of the change in rating from firm's last rating.
published_date: Union[date, datetime]
Published date of the price target.
published_time: datetime.time
Time of the original rating, UTC.
symbol: str
Symbol representing the entity requested in the data.
exchange: str
Exchange where the company is traded.
company_name: str
Name of company that is the subject of rating.
analyst_name: str
Analyst name.
analyst_firm: str
Name of the analyst firm that published the price target.
currency: str
Currency the data is denominated in.
price_target: float
The current price target.
adj_price_target: float
Adjusted price target for splits and stock dividends.
price_target_previous: float
Previous price target.
previous_adj_price_target: float
Previous adjusted price target.
price_when_posted: float
Price when posted.
rating_current: str
The analyst's rating for the company.
rating_previous: str
Previous analyst rating for the company.
action: Literal['Downgrades', 'Maintains', 'Reinstates', 'Reiterates', 'Upgrades', 'Assumes', 'Initiates Coverage On', 'Terminates Coverage On', 'Removes', 'Suspends', 'Firm Dissolved']
Description of the change in rating from firm's last rating.Note that all of these terms are precisely defined.
action_change: Literal['Announces', 'Maintains', 'Lowers', 'Raises', 'Removes', 'Adjusts']
Description of the change in price target from firm's last price target.
importance: Literal[0, 1, 2, 3, 4, 5]
Subjective Basis of How Important Event is to Market. 5 = High
notes: str
Notes of the price target.
analyst_id: str
Id of the analyst.
url_news: str
URL for analyst ratings news articles for this ticker on Benzinga.com.
url_analyst: str
URL for analyst ratings page for this ticker on Benzinga.com.
id: str
Unique ID of this entry.
last_updated: datetime
Last updated timestamp, UTC.
published_date: Union[date, datetime]
Published date of the price target.
published_time: datetime.time
Time of the original rating, UTC.
symbol: str
Symbol representing the entity requested in the data.
exchange: str
Exchange where the company is traded.
company_name: str
Name of company that is the subject of rating.
analyst_name: str
Analyst name.
analyst_firm: str
Name of the analyst firm that published the price target.
currency: str
Currency the data is denominated in.
price_target: float
The current price target.
adj_price_target: float
Adjusted price target for splits and stock dividends.
price_target_previous: float
Previous price target.
previous_adj_price_target: float
Previous adjusted price target.
price_when_posted: float
Price when posted.
rating_current: str
The analyst's rating for the company.
rating_previous: str
Previous analyst rating for the company.
action: str
Description of the change in rating from firm's last rating.
status: str
The action taken by the firm. This could be 'Upgrade', 'Downgrade', 'Reiterated', etc.
rating_change: str
The rating given by the analyst. This could be 'Buy', 'Sell', 'Underweight', etc. If the rating is a revision, the change is indicated by '->'
published_date: Union[date, datetime]
Published date of the price target.
published_time: datetime.time
Time of the original rating, UTC.
symbol: str
Symbol representing the entity requested in the data.
exchange: str
Exchange where the company is traded.
company_name: str
Name of company that is the subject of rating.
analyst_name: str
Analyst name.
analyst_firm: str
Name of the analyst firm that published the price target.
currency: str
Currency the data is denominated in.
price_target: float
The current price target.
adj_price_target: float
Adjusted price target for splits and stock dividends.
price_target_previous: float
Previous price target.
previous_adj_price_target: float
Previous adjusted price target.
price_when_posted: float
Price when posted.
rating_current: str
The analyst's rating for the company.
rating_previous: str
Previous analyst rating for the company.
action: str
Description of the change in rating from firm's last rating.
news_url: str
News URL of the price target.
news_title: str
News title of the price target.
news_publisher: str
News publisher of the price target.
news_base_url: str
News base URL of the price target.