FMP

FMP

Enter

Historical Stock Grades API

Access a comprehensive record of analyst grades with the FMP Historical Grades API. This tool allows you to track historical changes in analyst ratings for specific stock symbol

About Historical Stock Grades API

The FMP Historical Grades API offers an in-depth look at how analysts have rated specific stocks in the past. This API is perfect for:

  • Trend Analysis: Investors can use historical ratings to spot long-term trends in market sentiment for a stock, helping to predict future price movements.
  • Investment Strategy Optimization: By tracking changes in analyst sentiment over time, investors can adjust their strategies based on whether analysts are becoming more bullish or bearish.
  • Benchmarking Performance: Compare a stock’s historical ratings to its actual performance, enabling a deeper understanding of how well the stock has lived up to expectations.
  • Market Sentiment Tracking: Use the API to analyze how buy, hold, and sell ratings have changed, providing insight into broader market confidence or caution around a stock.

This API empowers investors with historical context, offering a valuable tool for long-term financial analysis and decision-making.

Example Use Case
A portfolio manager can utilize the Historical Grades API to observe changes in analyst sentiment for a particular stock, helping them adjust their strategy based on evolving market outlooks.

Historical Stock Grades API Parameters

Query Parameter

Type

Example

symbol*

string

AAPL

limit

number

100

(*) Required | Maximum 1000 records per request

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 Historical Stock Grades APIs

link-image
Stock Grades Summary

Quickly access an overall view of analyst ratings with the FMP Grades Summary API. This API provides a consolidated summary of market sentiment for individual stock symbols, including the total number... 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
Price Target Consensus

Access analysts' consensus price targets with the FMP Price Target Consensus API. This API provides high, low, median, and consensus price targets for stocks, offering investors a comprehensive view o... Read more

link-image
Stock Grades

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 symb... 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

Historical 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

Can I access historical data through the Financial Statement APIs?

Yes, the Financial Statement APIs offer access to more than 10 years of historical financial data. This includes quarterly and annual statements, growth rates, and comparison views. With such a deep archive, you can perform trend analysis, sector benchmarking, or backtesting with high confidence in the consistency and reliability of the data.

Do you provide historical bond price data?

Unfortunately, we do not provide bond data at the moment.

Where can I find historical outstanding shares data for each stock by year?

You can find historical outstanding shares data for each stock by year in the real-time income statement section.

How do you handle historical data of financial statements when stock splits or reverse splits occur?

The financial statements are handled as required by the SEC. The number of shares outstanding are directly sourced from these filings. For historical price and shares outstanding, these are adjusted to account for stock splits and reverse stock splits

Does the FMP.HISTORICALMARKETCAPITALIZATION formula have an 'interval' parameter?

No, the FMP.HISTORICALMARKETCAPITALIZATION formula does not have an 'interval' parameter. The formula is limited to a maximum of five years of data and does not include an 'interval' parameter.

What historical data do you provide for delisted companies?

We strive to gather data for delisted companies; however, some symbols may be unavailable due to limitations in our data sources. Currently, we provide historical price data for select US companies, which you can explore using the Delisted Companies API. For more specific information on historical data for delisted companies, please reach out to our account managers using the following link: https://site.financialmodelingprep.com/enterprise-contact

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