Forward-looking and consensus analytics—earnings and revenue estimates, EPS trends and revisions, growth projections, analyst recommendations and ratings, price targets, and other consensus metrics. Perfect for incorporating expert forecasts and sentiment into your models and dashboards.
The earnings estimate endpoint provides access to analysts' projected earnings per share (EPS) for a specific company, covering both upcoming quarterly and annual periods. This data is crucial for users who need to track and compare expected financial performance across different timeframes, aiding in the evaluation of a company's future profitability.
Route
/earnings_estimateAPI credits cost
20 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringThe FIGI of an instrument for which data is requested. This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
country
stringThe country where the instrument is traded, e.g., United States or US
Example:
United States
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"earnings_estimate": [
{
"date": "2022-09-30",
"period": "current_quarter",
"number_of_analysts": 27,
"avg_estimate": 1.26,
"low_estimate": 1.13,
"high_estimate": 1.35,
"year_ago_eps": 1.24
}
],
"status": "ok"
}The revenue estimate endpoint provides a company's projected quarterly and annual revenue figures based on analysts' estimates. This data is useful for users seeking insights into expected company performance, allowing them to compare forecasted sales with historical data or other companies' estimates.
Route
/revenue_estimateAPI credits cost
20 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
dp
integerNumber of decimal places for floating values. Should be in range [0,11] inclusive
Default:
5
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"revenue_estimate": [
{
"date": "2022-09-30",
"period": "current_quarter",
"number_of_analysts": 24,
"avg_estimate": 88631500000,
"low_estimate": 85144300000,
"high_estimate": 92794900000,
"year_ago_sales": 83360000000,
"sales_growth": 0.06
}
],
"status": "ok"
}The EPS trend endpoint provides detailed historical data on Earnings Per Share (EPS) trends over specified periods. It returns a comprehensive breakdown of estimated EPS changes, allowing users to track and analyze the progression of a company's earnings performance over time. This endpoint is ideal for users seeking to understand historical EPS fluctuations and assess financial growth patterns.
Route
/eps_trendAPI credits cost
20 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"eps_trend": [
{
"date": "2022-09-30",
"period": "current_quarter",
"current_estimate": 1.26,
"7_days_ago": 1.26,
"30_days_ago": 1.31,
"60_days_ago": 1.32,
"90_days_ago": 1.33
}
],
"status": "ok"
}The EPS revisions endpoint provides updated analyst forecasts for a company's earnings per share (EPS) on both a quarterly and annual basis. It delivers data on how these EPS predictions have changed over the past week and month, allowing users to track recent adjustments in analyst expectations. This endpoint is useful for monitoring shifts in market sentiment regarding a company's financial performance.
Route
/eps_revisionsAPI credits cost
20 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"eps_revision": [
{
"date": "2022-09-30",
"period": "current_quarter",
"up_last_week": 1,
"up_last_month": 5,
"down_last_week": 0,
"down_last_month": 0
}
],
"status": "ok"
}Consensus analyst estimates of EPS growth (adjusted, diluted) for the current and next quarter, current and next year, and the next 5 years, plus actual growth over the past 5 years.
Route
/growth_estimatesAPI credits cost
20 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringThe FIGI of an instrument for which data is requested. This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringThe country where the instrument is traded, e.g., United States or US
Example:
United States
exchange
stringExchange where instrument is traded
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"growth_estimates": {
"current_quarter": 0.016,
"next_quarter": 0.01,
"current_year": 0.087,
"next_year": 0.055999998,
"next_5_years_pa": 0.094799995,
"past_5_years_pa": 0.23867
},
"status": "ok"
}The recommendations endpoint provides a summary of analyst opinions for a specific stock, delivering an average recommendation categorized as Strong Buy, Buy, Hold, or Sell. It also includes a numerical recommendation score, offering a quick overview of market sentiment based on expert analysis.
Route
/recommendationsAPI credits cost
100 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringThe FIGI of an instrument for which data is requested. This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringThe country where the instrument is traded, e.g., United States or US
Example:
United States
exchange
stringThe exchange name where the instrument is traded, e.g., Nasdaq, NSE.
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"trends": {
"current_month": {
"strong_buy": 13,
"buy": 20,
"hold": 8,
"sell": 0,
"strong_sell": 0
},
"previous_month": {
"strong_buy": 13,
"buy": 20,
"hold": 8,
"sell": 0,
"strong_sell": 0
},
"2_months_ago": {
"strong_buy": 13,
"buy": 20,
"hold": 8,
"sell": 0,
"strong_sell": 0
},
"3_months_ago": {
"strong_buy": 13,
"buy": 20,
"hold": 8,
"sell": 0,
"strong_sell": 0
}
},
"rating": 8.2,
"status": "ok"
}The price target endpoint provides detailed projections of a security's future price as estimated by financial analysts. It returns data including the high, low, and average price targets. This endpoint is useful for users seeking to understand potential future valuations of specific securities based on expert analysis.
Route
/price_targetAPI credits cost
75 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
Request example
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"price_target": {
"high": 220,
"median": 185,
"low": 136,
"average": 184.01,
"current": 169.5672,
"currency": "USD"
},
"status": "ok"
}The analyst ratings snapshot endpoint provides a streamlined summary of ratings from analyst firms for both US and international markets. It delivers essential data on analyst recommendations, including buy, hold, and sell ratings, allowing users to quickly assess the general sentiment of analysts towards a particular stock.
Route
/analyst_ratings/lightAPI credits cost
75 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
rating_change
stringFilter by rating change action
Supports: Maintains, Upgrade, Downgrade, Initiates, Reiterates
outputsize
integerNumber of records in response
Default:
30
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"ratings": [
{
"date": "2022-08-19",
"firm": "Keybanc",
"rating_change": "Maintains",
"rating_current": "Overweight",
"rating_prior": "Overweight"
}
],
"status": "ok"
}The analyst ratings US equities endpoint provides detailed information on analyst ratings for U.S. stocks. It returns data on the latest ratings issued by various analyst firms, including the rating itself, the firm issuing the rating, and any changes in the rating. This endpoint is useful for users tracking analyst opinions on U.S. equities, allowing them to see how professional analysts view the potential performance of specific stocks.
Route
/analyst_ratings/us_equitiesAPI credits cost
200 per symbol
symbol
stringFilter by symbol
Example:
AAPL
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000B9Y5X2
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US0378331005
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
594918104
exchange
stringFilter by exchange name
Example:
NASDAQ
mic_code
stringThe Market Identifier Code (MIC) of the exchange where the instrument is traded, e.g., XNAS, XLON.
Example:
XNAS
rating_change
stringFilter by rating change action
Supports: Maintains, Upgrade, Downgrade, Initiates, Reiterates
outputsize
integerNumber of records in response
Default:
30
Response
{
"meta": {
"symbol": "AAPL",
"name": "Apple Inc",
"currency": "USD",
"exchange_timezone": "America/New_York",
"exchange": "NASDAQ",
"mic_code": "XNGS",
"type": "Common Stock"
},
"ratings": [
{
"date": "2022-08-19",
"firm": "Keybanc",
"analyst_name": "Brandon Nispel",
"rating_change": "Maintains",
"rating_current": "Overweight",
"rating_prior": "Overweight",
"time": "08:29:48",
"action_price_target": "Raises",
"price_target_current": 185.14,
"price_target_prior": 177.01
}
],
"status": "ok"
}