FMP
Earnings Surprises API
A list of earnings announcements for publicly traded companies that were either positive or negative surprises. This endpoint includes the date of the earnings announcement, the estimated EPS, the actual EPS, and the earnings surprise.
About Earnings Surprises API
How it works
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.
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.
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 Earnings Surprises APIs
A list of upcoming & past earnings announcements for publicly traded companies, including the date, estimated earnings per share (EPS), and actual EPS (if available). Read more
A list of historical & upcoming earnings announcements for a specific company, including the date, estimated EPS, and actual EPS. Read more
A list of earnings announcements for publicly traded companies that have already been confirmed. Read more
Earnings Surprises API FAQs
Could you please clarify the difference between the API end points "earnings confirmed" and "earnings calendar"?
The Earning Confirmed endpoint is a list of earnings announcements for publicly traded companies that have already been confirmed and do not return upcoming dates. The Earnings Calendar API is a list of upcoming & past earnings announcements for publicly traded companies, including the date, estimated earnings per share (EPS), and actual EPS (if available) and it's the quarterly schedule and timetable laying out individual release dates of financial reports containing performance data for publicly traded corporations.
Which plan includes the earnings call transcripts API?
To access the earnings call transcripts API, you will need at least the Premium plan.
How can I determine if earnings data was released before or after markets open from the historical earnings data?
You can determine if earnings data was released before or after markets open by looking at the 'time' field in the earning calendar API. If the 'time' field shows 'BMO' it means the earnings were released before markets open, and if it shows 'AMC' it means the earnings were released after markets close.
How can I access quarterly financial data using the API?
To access quarterly financial data using the API, you will need to upgrade to any of our paid plans. The free plan only provides annual data for some US stocks. With a paid plan, you can access quarterly data for any company. You can use the following endpoint to retrieve quarterly data: https://financialmodelingprep.com/api/v3/income-statement/AAPL?period=quarter&apikey=YOUR-API-KEY
What is the source of the Analyst Estimates data?
We have multiple estimates, such as Davit Kirakosyan, who has been working for us for a few months, and we aggregate the analyst reports from the news to aggregate them. We are using estimates from the news that we extract for the growth rate and have an algorithm for smaller cap stocks, that uses the CAGR formula with a rolling period of 5 years. We are also working on extracting the estimate from the press release and Wall Street analysts to have a consensus estimate, which will be available soon. We also have Wall Street Analyst estimates: https://financialmodelingprep.com/api/v4/earning-estimate?page=0&apikey=your_api_key
How does the API calculate sector performance?
The API calculates sector performance by taking the average change percentage of all the companies within that sector. The change percentage can be found on the quote endpoint, while the sector information can be found on the profile endpoint.
How can I build a detailed dividend yield chart with the same resolution as intraday price charts using your APIs?
You can retrieve the Dividend yield data using the Ratios API for quarter or annual frequency. For more information, you can visit our documentation here: https://site.financialmodelingprep.com/developer/docs#ratios-statement-analysis
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!
