PRICE_TARGET
Get analyst price targets by company.
Syntax
=OBB.EQUITY.ESTIMATES.PRICE_TARGET([symbol],[limit],[provider],[page],[date],[start_date],[end_date],[updated],[importance],[action],[analyst_ids],[firm_ids],[fields],[with_grade])
Examples
=OBB.EQUITY.ESTIMATES.PRICE_TARGET(,,"benzinga")
=OBB.EQUITY.ESTIMATES.PRICE_TARGET("msft",10,"benzinga",,,"2020-01-01","2024-02-16",,,"downgrades")
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| symbol | Text | Symbol to get data for. Multiple comma separated items allowed. | False |
| limit | Number | The number of data entries to return. | False |
| provider | Text | Options: benzinga, fmp, defaults to benzinga. | False |
| page | Number | 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. | False |
| date | Text | Date for calendar data, shorthand for date_from and date_to. | False |
| start_date | Text | Start date of the data, in YYYY-MM-DD format. | False |
| end_date | Text | End date of the data, in YYYY-MM-DD format. | False |
| updated | Any | 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. | False |
| importance | Number | Importance level to filter by. Uses Greater Than or Equal To the importance indicated | False |
| action | Text | Filter by a specific action_company. Options: downgrades, maintains, reinstates, reiterates, upgrades, assumes, initiates, terminates, removes, suspends, firm_dissolved. | False |
| analyst_ids | Any | Comma-separated list of analyst (person) IDs. Omitting will bring back all available analysts. Multiple comma separated items allowed. | False |
| firm_ids | Any | Comma-separated list of firm IDs. Multiple comma separated items allowed. | False |
| fields | Any | 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 comma separated items allowed. | False |
| with_grade | Boolean | Include upgrades and downgrades in the response. | False |
Data
- benzinga
- fmp
| Name | Description |
|---|---|
| published_date | Published date of the price target. |
| published_time | Time of the original rating, UTC. |
| symbol | Symbol representing the entity requested in the data. |
| exchange | Exchange where the company is traded. |
| company_name | Name of company that is the subject of rating. |
| analyst_name | Analyst name. |
| analyst_firm | Name of the analyst firm that published the price target. |
| currency | Currency the data is denominated in. |
| price_target | The current price target. |
| adj_price_target | Adjusted price target for splits and stock dividends. |
| price_target_previous | Previous price target. |
| previous_adj_price_target | Previous adjusted price target. |
| price_when_posted | Price when posted. |
| rating_current | The analyst's rating for the company. |
| rating_previous | Previous analyst rating for the company. |
| action | Description of the change in rating from firm's last rating. |
| news_url | News URL of the price target. |
| news_title | News title of the price target. |
| news_publisher | News publisher of the price target. |
| news_base_url | News base URL of the price target. |
| Name | Description |
|---|---|
| published_date | Published date of the price target. |
| published_time | Time of the original rating, UTC. |
| symbol | Symbol representing the entity requested in the data. |
| exchange | Exchange where the company is traded. |
| company_name | Name of company that is the subject of rating. |
| analyst_name | Analyst name. |
| analyst_firm | Name of the analyst firm that published the price target. |
| currency | Currency the data is denominated in. |
| price_target | The current price target. |
| adj_price_target | Adjusted price target for splits and stock dividends. |
| price_target_previous | Previous price target. |
| previous_adj_price_target | Previous adjusted price target. |
| price_when_posted | Price when posted. |
| rating_current | The analyst's rating for the company. |
| rating_previous | Previous analyst rating for the company. |
| action_company | Description of the change in rating from firm's last rating.Note that all of these terms are precisely defined. |
| action_pt | Description of the change in price target from firm's last price target. |
| importance | Subjective Basis of How Important Event is to Market. 5 = High |
| notes | Notes of the price target. |
| analyst_id | Id of the analyst. |
| url_news | URL for analyst ratings news articles for this ticker on Benzinga.com. |
| url_analyst | URL for analyst ratings page for this ticker on Benzinga.com. |
| id | Unique ID of this entry. |
| updated | Last updated timestamp, UTC. |