FMP

FMP

Enter

Ratings Snapshot API

Quickly assess the financial health and performance of companies with the FMP Ratings Snapshot API. This API provides a comprehensive snapshot of financial ratings for stock symbols in our database, based on various key financial ratios.

About Ratings Snapshot API

The FMP Ratings Snapshot API allows users to evaluate a company's financial performance across multiple dimensions by delivering:

  • Overall Rating: Get a summary score that reflects the company's financial standing.
  • Discounted Cash Flow (DCF) Score: Understand the company’s valuation compared to its future cash flow potential.
  • Return on Equity (ROE) Score: Measure how efficiently a company is generating profit relative to shareholders' equity.
  • Return on Assets (ROA) Score: Gauge how effectively a company uses its assets to generate earnings.
  • Debt-to-Equity Score: Analyze the company’s capital structure and risk by comparing its debt to equity.
  • Price-to-Earnings (P/E) Score: Assess the company’s stock price relative to its earnings to understand its valuation.
  • Price-to-Book (P/B) Score: Compare the company’s market price to its book value to evaluate potential investment opportunities.

This API offers an overall rating, along with scores for critical metrics such as discounted cash flow, return on equity, return on assets, debt-to-equity, price-to-earnings, and price-to-book ratios. It is perfect for investors, financial analysts, and researchers who need a fast, comprehensive view of a company’s financial health based on key metrics.

Example Use Case
An equity analyst can use the Ratings Snapshot API to compare multiple companies' financial health based on return on equity, debt levels, and valuation ratios, helping them make more informed investment recommendations.

Ratings Snapshot API Parameters

Query Parameter

Type

Example

symbol*

string

AAPL

limit

number

1

(*) 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 Ratings Snapshot APIs

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
Stock Grade News

Stay informed on the latest analyst grade changes with the FMP Grade News API. This API provides real-time updates on stock rating changes, including the grading company, previous and new grades, and ... 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
Historical Stock Grades

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 Read more

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

Ratings Snapshot API FAQs

How are sentiment scores computed for the Stock News Sentiments RSS Feed API?

The sentiment scores for the Stock News Sentiments RSS Feed API are computed based on the number of positive and negative/neutral comments received in a 24-hour period. For example, if there are 500 positive comments and 500 negative/neutral comments, the sentiment score would be calculated as (500 * 1) + (500 * 0) = 500. The average mentions per day value would then be 500 / 1000 = 0.5. Additionally, the Average Hype Index (AHI) and Relative Hype Index (RHI) are calculated to provide further insights into sentiment.

What is the source of the Environmental, Social, and Governance (ESG) ratings and scores data?

We source our ESG data from company filings where we apply NLP to extract those keywords: -Social = 'Accident, (Adult AND entertainment), Alcohol, Anti-personnel, Behavior, Charity, (Child AND Labor), Community, Controversial, Controversy, Discrimination, Gambling, Health, Human capital, Human rights, Inclusion, Injury, Labor, Munitions, Opposition, Pay, Philanthropic, Quality, Responsible.' -Environment = 'Biodiversity, Carbon, Cleantech, Clean, Climate, Coal, Conservation, Ecosystem, Emission, Energy, Fuel, Green, Land, Natural, Pollution, (Raw AND materials), Renewable, Resources, Sustainability, Sustainable, Toxic, Waste, Water.' -Governance = 'Advocacy, Bribery, Compensation, Competitive, Corruption, (Data AND breach), Divestment, Fraud, (Global AND Compact), GRI, (Global AND Reporting AND Initiative), Independent, Justice, Stability, Stewardship, Transparency.' Those are the key concepts that we extract from the statements to create the score. We then, with NLP, create the sentiment score to finally create a ranking score. We have developed our methodology based on available frameworks. We also compare each company to the industry benchmark to be able to rank ESG companies compared to their peers. For the bounds of the rating, a score of 0 is the worst and 100 is the best, so a 50 would be average. You can read more here https://site.financialmodelingprep.com/developer/docs/esg-score-api/

Is the financial scores data provided by the /stable/financial-scores endpoint based on 10-K data or 10-Q data?

The financial scores data provided by the /stable/financial-scores endpoint is based on 6/8-K data until the 10-Q/K data gets released, at which point it overrides the previous data.

How are companies scored in your company ratings?

Companies are scored based on a quintile ranking within their respective industry and sector. The scoring within the brackets is weighted by the industry and the sector, and split into quintiles based on their relative score.

What are the basis for ESG Risk Ratings provided by your company?

Our ESG Risk Ratings are based on a comprehensive analysis of environmental, social, and governance factors that impact a company's sustainability and ethical practices. These factors are evaluated using a combination of qualitative and quantitative data to provide a holistic view of a company's ESG performance.

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 do I get the industry information of tickers?

You can get this information on the Profile API: https://site.financialmodelingprep.com/developer/docs#company-profile-company-information

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