FMP

FMP

Enter

Stock Grades API

Access the latest stock grades from top analysts and financial institutions with the FMP Grades API. Track grading actions, such as upgrades, downgrades, or maintained ratings, for specific stock symbols, providing valuable insight into how experts evaluate companies over time.

About Stock Grades API

The FMP Grades API offers timely data on stock evaluations by prominent financial institutions, including:

  • Grading Company: Identify the institution providing the stock rating.
  • Previous Grade and New Grade: View the change in grade, if any, from previous assessments to the latest one.
  • Action Taken: Determine whether the grade was upgraded, downgraded, or maintained.
  • Date of Evaluation: See when the latest grading action occurred.

This API helps investors and analysts understand the latest sentiment from financial experts, enabling better investment decisions based on how stocks are graded.

Example Use Case
An investor can use the Grades API to track the latest stock ratings for their portfolio, seeing how financial institutions view the company's current performance and investment potential.

Stock Grades API Parameters

Query Parameter

Type

Example

symbol*

string

AAPL

(*) Required

How it works

How-it-works Signup

Get Started: Sign Up Today!

Begin your data journey by signing up and accessing our API endpoints. Get instant access to a vast array of financial data to power your applications and analyses.

How-it-works Free plan

Dive into Data: Free Plan Access

Explore our free data plan and access a wide range of financial data through our API endpoints. Start integrating real-time data into your applications and projects.

How-it-works Upgrade-Premium

Unlock Premium Data: Upgrade Now!

Upgrade to our premium plan for exclusive access to advanced financial datasets via our API endpoints. Take your analyses to the next level and gain a competitive edge in the market.

Related Stock Grades APIs

link-image
Historical Ratings

Track changes in financial performance over time with the FMP Historical Ratings API. This API provides access to historical financial ratings for stock symbols in our database, allowing users to view... Read more

link-image
Price Target Latest News

Stay updated with the most recent analyst price target updates for all stock symbols using the FMP Price Target Latest News API. Get access to detailed forecasts, stock prices at the time of the updat... Read more

link-image
Stock Grade Latest News

Stay informed on the latest stock rating changes with the FMP Grade Latest News API. This API provides the most recent updates on analyst ratings for all stock symbols, including links to the original... Read more

link-image
Financial Estimates

Retrieve analyst financial estimates for stock symbols with the FMP Financial Estimates API. Access projected figures like revenue, earnings per share (EPS), and other key financial metrics as forecas... Read more

link-image
Price Target News

Stay informed with real-time updates on analysts' price targets for stocks using the FMP Price Target News API. Access the latest forecasts, stock prices at the time of the update, and direct links to... Read more

Stock Grades API FAQs

What are the possible values for newGrade and previousGrade in the Stock Grades API?

Both the newGrade and previousGrade fields in the Stock Grades API can include any of the following values: Conviction Buy Underperformer Strong Buy Accumulate Sector Perform Top Pick Cautious Sector Underperform Above Average Sell Market Outperform Underperform Market Perform Reduce Perform Peer Perform Neutral Hold Neutral Below Average Positive Outperformer Mixed Speculative Buy Hold Negative Overweight Sector Overweight Equal-Weight Strong Sell Outperform In-Line Sector Outperform Market Underperform Buy Action List Buy Sector Weight Underweight

Does the 'Analyst Estimates API' provide estimates in the currency of the company or in dollars?

The analyst estimates currency is the same as the financial statement.

Why am I seeing multiple entries for the same fiscal year in the Analyst Estimates API? Are they duplicates?

No, they’re not duplicates. If you don’t use filters, the API returns both quarterly and annual estimates, which can make it look like the same fiscal year appears more than once. To avoid this, use the period filter in your query: Quarterly only: ...?period=quarter Annual only: ...?period=annual For example: https://financialmodelingprep.com/stable/analyst-estimates?symbol=AAPL&period=annual&apikey=YOUR-API-KEY

What are the possible values for newGrade and previousGrade in the Stock Grades API?

Both the newGrade and previousGrade fields in the Stock Grades API can include any of the following values: Conviction Buy Underperformer Strong Buy Accumulate Sector Perform Top Pick Cautious Sector Underperform Above Average Sell Market Outperform Underperform Market Perform Reduce Perform Peer Perform Neutral Hold Neutral Below Average Positive Outperformer Mixed Speculative Buy Hold Negative Overweight Sector Overweight Equal-Weight Strong Sell Outperform In-Line Sector Outperform Market Underperform Buy Action List Buy Sector Weight Underweight

How many years of data do you cover?

We cover more than 30+ years for most of our endpoints if the information is available on company filings.

How many stocks do you provide financial data for?

We have over 80,000 unique symbols that we provide financial data for across 60 stock exchanges globally

What is the quality of FMP data?

Quality data is key to making accurate, informed decisions. It is our main focus to deliver the most accurate financial data to our users.

Unlock Premium Financial Insights Today!

Join Financial Modeling Prep now to access real-time data, in-depth analysis, and personalized insights tailored to your financial goals. Stay ahead of the game and make informed decisions with our comprehensive tools and dedicated support. Sign up today and take the first step towards financial success!

Start Your Journey Now!
FMP

FMP

Financial Modeling Prep API provides real time stock price, company financial statements, major index prices, stock historical data, forex real time rate and cryptocurrencies. Financial Modeling Prep stock price API is in real time, the company reports can be found in quarter or annual format, and goes back 30 years in history.
twitterlinkedin
2017-2025 © Financial Modeling Prep