Frequently Asked Questions

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

We keep track of all changes including new properties and new endpoints added to our API on our changelog.

Typically, we are able to gather financials through an 8-K within 24 hours of an earnings report, However, this data is not as reliable or as full as the data from their 10-Q which takes a bit longer to process.

You can upgrade at any time you will receive a prorated credit directly applied against the new subscription.

Yes, we offer discounts to startups for the Finanical Modeling Prep commerical plans to help scale your project and decrease initial overhead costs.

Yes, we have resources for developers that you can check here: Resources Page, these resources will help you better understand our api and speed up your work with ready to use packages.

Data quality is our main priority we take all precaution to always have accurate data, if you find any data discrepancy please email us at info@financialmodelingprep.com with: 1. Date/time of the issue 2. What you did you do to access the data 3. What you expected to happen 4. What actually happened 5. API Url (if applicable) 6. Any additional information

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

Yes, we have historical data adjusted for splits and dividends.

Yes, the Financial Modeling Prep API for financial market data is compatible with Open AI

Yes, we we have a powerful Google Sheet Add-on that allows you to quickly and easily stuart pulling financial market data into your excel model. We also provide documentation explaining how to integrate the excel model and formulas into your Google Sheet

The main difference is in terms of data type. In FMPCloud, you can access all market data in CSV format. https://fmpcloud.io/ was designed to show all the CSV endpoints and target more analysts since they needed documentation with all CSV endpoints (you will see a toggle with the CSV endpoint on fmpcloud.io). All the endpoints can have a base URL of https://financialmodelingprep.com/api/v3/ or https://fmpcloud.io/api/v3/ it will work the same.

Most of the time the net income will reflect the bottom line net income, however, if a company has unusual items that they subtract from their net income they are not accounted for in our net income. The bottom line net income is utilized in the calculation of EPS and EPS diluted though.

The filing date field is populated from the SEC, as a result, international stocks do not pull in data for the filing date and thus are mapped to the date.

Firstly, check if the financial statements are denominated in thousands or millions in their SEC statement. If this is not the case it is likely that our pull from the SEC is not denominated properly, which can affect just the shares outstanding (and diluted), or the entire statement. If you run into a rare instance of this please reach out to us here and we can get it fixed for you in a timely manner.

You will pay the difference between the new price plan and the unused time remaining on your current plan.

Yes, we offer a 30% discount to students on all Financial Modeling Prep plans

Yes, we we have a powerful Excel Add-on that allows you to quickly and easily start pulling financial market data into your excel model. We also provide documentation explaining how to integrate the excel model and formulas into your excel sheet

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

We offer a free plan that will allow users to make up to 250 market data API requests per day, for example you can access up to 5 years of annual statements for US companies. We also have Premium dataset endpoints that offer more historical data (up to 30+ years) and some endpoint that are only accessible via paid subscriptions such as earning calendar, stock peers and many others.

Yes you can access our Bach and Bulk endpoints where you will access companies financial statements in bulk. For the quote endpoint you can also call the API with multiple tickers separated via a comma.

Yes, you will have access to FMPCloud.io.

In order to cancel your subscription membership go to the pricing page and switch your account to the Free plan.

To access the historical data, you can use the URL "https://financialmodelingprep.com/api/v3/historical-chart/15min/AAPL?from=2005-01-01&to=2005-02-10&apikey=YOUR_API_KEY" as an example. However, please note that there is a limit to the amount of data you can retrieve in one request. For 15-minute intervals, you can get data for up to 2 months in one API call. To access all the historical data from 2005, you'll need to make multiple API calls, each covering a 2-month interval. This may require you to implement a loop in your code to adjust the "from" and "to" parameters in each request to retrieve the complete dataset. Here are some examples: "https://financialmodelingprep.com/api/v3/historical-chart/15min/AAPL?from=2005-03-01&to=2005-04-10&apikey=YOUR_API_KEY" "https://financialmodelingprep.com/api/v3/historical-chart/15min/AAPL?from=2005-04-01&to=2005-05-10&apikey=YOUR_API_KEY" You can use these examples as a reference to create multiple requests, adjusting the "from" and "to" dates accordingly to retrieve the entire historical dataset.

Sure, you can find the historical prices endpoint for stocks at this URL: "https://financialmodelingprep.com/api/v3/historical-price-full/AAPL?apikey=YOUR_API_KEY." You can refer to the documentation here: "https://site.financialmodelingprep.com/developer/docs#daily-chart-charts" for more details.

An API key may be invalid for several reasons, however, typically the API key was not configured properly in the query parameters. First, check if you mistype or provide the wrong API key, it will be invalid. Ensure you copy and paste it correctly. You can view and copy your API Key from your dashboard accessible in the top right corner or visit https://site.financialmodelingprep.com/developer/docs/dashboard once you've signed in. Second, check if the API is configured with the proper query parameters. An example is provided below for a simple quote request: https://financialmodelingprep.com/api/v3/quote/AAPL?apikey=YOUR_API_KEY If you have multiple query parameters, all subsequent query parameters are attached with an "&" instead of a "?". Only the first query parameter is attached with a "?". The ordering of the query parameters will not affect the response. The API key can be attached at the beginning, middle, or end with multiple query parameters. For example: Beginning of the request query parameters: https://financialmodelingprep.com/api/v3/income-statement/AAPL?apikey=YOUR_API_KEY&period=FY&limit=5 Within the request query parameters: https://financialmodelingprep.com/api/v3/income-statement/AAPL?period=FY&apikey=YOUR_API_KEY&limit=5 At the end of the request query parameters: https://financialmodelingprep.com/api/v3/income-statement/AAPL?period=FY&limit=5&apikey=YOUR_API_KEY If you are still having issues and you verified you have tried the above solutions, contact us at info@financialmodelingprep.com for more details.

The Number of shares outstanding is sourced from quarterly and annual filings.

You can subscribe up to 25 symbols at one time. The number of tickers that can be subscribed at the same time in the Websocket can be increased for an additional fee.

The formula used to calculate Volume-Weighted Average Price (VWAP) is: vwap = ((high + low + close) / 3 * volume) / volume

In general, the time zone for the endpoints correspond to the country/region the exchange is located in. For example, stocks traded on the NYSE are on the EST time zone, stocks traded on the London Stock Exchange (LSE) correspond to the GMT time zone. Forex data is on the EST time zone

Financial Modeling Prep works with several data providers to source and provide financial and market news

Unfortunately we currently do not provide bond data but are planning in implementing this in the near future. If you would like a custom solution, please reach out to sales@financialmodelingprep.com

You use the 'quarterly' financial statements and add the parameter 'limit=4' which will provide data from the last 4 quarters, and then sum the fields for the desired values.

Yes, the 'close' price is adjusted only for stock splits and 'adjClose' is adjusted for stock splits and dividends.

ROIC is calculated as 'Net Operating Profit After Tax' (NOPAT) / (Total Invested Capital) NOPAT = Operating Income * (1 - tax rate) Total Invested Capital = Total Debt + Capital Lease Obligations + Total Equity

We currently cover over 80,000 symbols globally, and are continually working to expand our coverage

The invoices are available on your Dashboard

We accept debit and credit cards through Stripe, or PayPal. We also provide bank transfer for Enterprise clients

Yes, we can generate a new API key. Please use the contact us form and we will assist you

Yes, we can provide additional API keys to meet your specific use case. Please reach out to us via the contact us form

Here is a list of Analyst rating Firms we provide coverage for: Alliance Global Partners, Analyst Company, Arete Research, Argus Research, Ascendiant, Atlantic Equities, Autonomous Research, B.Riley Financial, Banco Santander, Bank of America Securities, Barclays, Barrington, Benchmark Co., Berenberg Bank, Bernstein, BlackRock, BMO Capital, BNP Paribas, BOCOM International Holdings Company, Boenning & Scattergood, Bradesco, Bryan Garnier & Co Ltd, BTG Pactual, BTIG, C.L. King, Canaccord Genuity, Cannonball Research, Cantor Fitzgerald, Capital One Financial, CBRE, CFRA, Chardan Capital, China Renaissance Securities (US) Inc., CIBC, Citigroup, CLSA, CMB International Securities, Coker Palmer, Colliers Securities, Compass Point, Cowen & Co., Craig-Hallum, Credit Suisse, Cross Research, D.A. Davidson, Daiwa, Desjardins, Deutsche Bank, DNB Markets, DZ BANK AG, EF Hutton, Eight Capital, Evercore ISI, FBN Securities, Fermium Research, Fox Advisors, Fundamental Research, Gabelli, GLJ Research, Goldman Sachs, Gordon Haskett Capital Corporation, Griffin, Guggenheim, H.C. Wainwright, Hovde Group, HSBC, Independent Research, Industrial Alliance Securities, J.P. Morgan, Janney Montgomery, Jefferies, JMP Securities, Johnson Rice, JonesTrading, KBW, Kempen & Co, Kepler Capital, KeyBanc, KGI Securities, Ladenburg Thalmann & Co., Laidlaw, Lake Street, Langenberg & Co., Leerink Partners, LightShed Partners, Loop Capital Markets, Macquarie, Maxim Group, Melius Research, Mizuho Securities, MKM Partners, MoffettNathanson, Monness, Morgan Stanley, Motley Fool, National Bank, Needham, Neuberger Berman, New Street, Nomura, Norddeutsche Landesbank, Northcoast Research, Northland Securities, Oddo BHF, Odeon Capital Group LLC, Oppenheimer, PI Financial, Piper Sandler, Pivotal Research, R.F. Lafferty, R5 Capital, Raymond James, RBC Capital, Redburn Partners, Robert W. Baird, Rosenblatt Securities, Roth Capital, Scotiabank, Seaport Global, SEB Enskilda, Siebert Williams Shank & Co, SMBC Nikko, Societe Generale, Stephens, Stifel Nicolaus, Summit Redstone Partners, Susquehanna, SVB Securities, TD Securities, Telsey Advisory, Thrivent, Tigress Financial, Truist Financial, Tudor Pickering, UBS, UOB Kay Hian, US Capital Advisors, US Tiger Securities, Veritas Investment Research, Vertical Group, Vertical Research, VTB Capital, Warburg Research, Wedbush, Wells Fargo, Westpark Capital, William Blair, Williams Trading, Wolfe Research

You can find the S1 filings data in the IPO Calendar endpoint. https://site.financialmodelingprep.com/developer/docs/#IPO-Calendar

Yes, the historical market data for pre-market and post-market data can be found here https://financialmodelingprep.com/api/v4/historical-price/AAPL/1/minute/2021-06-11/2021-06-11?apikey=your_api_key or https://financialmodelingprep.com/api/v3/historical-chart/1min/AAPL?from=2021-06-11&to=2021-06-11&extended=true&apikey=your_api_key

Yes, we have real-time stock quote for pre-market and post-market data. The data can be found here https://financialmodelingprep.com/api/v4/pre-post-market-trade/AAPL?apikey=your_api_key and https://financialmodelingprep.com/api/v4/pre-post-market/AAPL?apikey=your_api_key

Yes, we provide Historical Shares Float data https://financialmodelingprep.com/api/v4/historical/shares_float?symbol=AAPL&apikey=Your_api_key

Please review our Excel documentation. The specific query in this case is : =Financial Modeling Prep.INCOMESTATEMENT('AAPL';10;'quarter') =Financial Modeling Prep.INCOMESTATEMENT(symbol;[limit];[datatype];[headers];[interval])

One request counts as one API call. A request can include a range of dates, data, and symbols, and when the request is made, it counts as one call

The Shares Float data is extracted from the 10-Q 10-K, 6-K, 8-K, 20-K, and 40-F. They are also adjusted for insider shares via proxy statements.

We currently do not offer free trials, but our sales team will be happy to provide sample data sets as needed. You can subscribe to one of our plans which allows you to cancel anytime if needed.

You can find the methodology used to calculate the WACC here: https://site.financialmodelingprep.com/weighted-average-cost-of-capital

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

Fundamental data is sourced from the Securities and Exchange Commission (SEC) open source website Edgar

We source International Fundamental data from the exchanges and third-party data providers

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/

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

Please reach out via the contact us form or send an email info@financialmodelingprep.com to update your payment method.

If you require more than 5 years of data you will need to implement a loop that iterates over 5 year intervals covering the entire desired time range using the "from" and "to" parameters. ?from=2023-08-10&to=2023-09-10&apikey=

The End of Day (EOD) data is updated in real time after the market is closed.

The formula used to calculate Volume-Weighted Average Price (VWAP) is: vwap = ((high + low + close) / 3 * volume) / volume

Capital gains are the profit made from selling an asset for more than its purchase price. When Apple (AAPL) reports capital gains, it means the company has realized a profit from selling investments or assets. For example, if Apple sells an investment for $2 million that it originally purchased for $1.5 million, the capital gain is $500,000. This profit would be reported in Apple's financial statements as part of its earnings.

The formula used to calculate the "change" is: Change= close - open

The formula to calculate "changeOverTime" is: changeOverTime= close - open / open

Due to the sheer size and volume of the historical intraday price data there are limits to the number of records that can be returned in a given query. Contact our support team for more information.

Yes, the intraday data is adjusted for split.

In general, the time zone for the endpoints corresponds to the country/region the exchange is located in. For example, stocks traded on the NYSE are on the EST time zone, and stocks traded on the London Stock Exchange (LSE) correspond to the GMT zone.

We have multiple data sources for Earnings Transcript data. Sometimes the data is available from the SEC, but it is mostly through company websites or our third party data providers. We have multiple sources where we get access to the earnings call transcript: One source is we use the SEC website to access the available transcripts as an example and when not available, we get them from their investor relations website as in example here . In addition, we have our analysts listen in to the call and have developed apps to transcribe the call and lastly, we have partnership with various data vendors to fill out gaps when needed

We have many types of events like stock change or YOY, MOM of sales, investments or inventories and etc. The coverage for it is about 150+ countries.

Yes, we provide Currency Holiday data. For example, 2024 - USD on Monday, January 15 - Martin Luther King Day we have the event returning on the endpoint.

The Time Zone for the Economic Calendar events is UTC time zone.

We have PCE data and Consumer Sentiment, Consumer Expectations, Consumer Confidence and Consumer Inflation as part of our Economic 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.

We currently cover transcripts for US stocks.

It's EST (Eastern Standard Time) is the time zone for the eastern part of the United States and Canada, which is 5 hours behind Coordinated Universal Time (UTC-5).

There are 55,904 companies.

The Cashflow Statements are rarely released with an 8-K (earnings press release) and are only filled after the company releases a 10-Q, 10-K, 20-F etc.

Typically, we are able to gather financials through an 8-K within 24 hours of an earnings report, However, this data is not as reliable or as full as the data from their 10-Q which takes a bit longer to process.

At the moment we only provide the Financial Statement as Reported data for US market companies.

The forex market, also known as the foreign exchange market, is a global decentralized market where currencies are traded. It operates 24 hours a day, five days a week, starting from Sunday 5:00 PM Eastern Time (ET) until Friday 5:00 PM ET.

The Forex market operates on a 24-hour basis because it spans multiple time zones globally. When it is stated that Forex data is on the EST (Eastern Standard Time) time zone, it means that all times mentioned are based on the EST time zone. Sunday: Market opens at 5:00 PM EST (this is the beginning of the trading week, aligning with the start of the trading session in Sydney). Monday through Thursday: Open 24 hours. Friday: Market closes at 5:00 PM EST (end of the trading week, aligning with the closing of the New York session). EST (Eastern Standard Time) is the time zone for the eastern part of the United States and Canada, which is 5 hours behind Coordinated Universal Time (UTC-5)

It's EST (Eastern Standard Time) is the time zone for the eastern part of the United States and Canada, which is 5 hours behind Coordinated Universal Time (UTC-5).

The commodity market operates in two sessions: Morning Session: Which runs from 9:00 AM to 5:00 PM. Evening Session: Starts at 5:00 PM and ends at 11:30 PM. However, during daylight saving time (DST) in the US, this evening session extends to 11:55 PM.

Yes, we provide 20+ years of Historical Commodities data

Our WebSocket APIs are based on entitlements that control which WebSocket Clusters you can connect to and which kinds of data you can access.

Each account comes with access to one simultaneous WebSocket connection per cluster.

You should use the instructions on our documentation and always subscribe to a symbol in lowercase. e.g. "aapl".

Currently, our WebSocket returns data from 8 AM - 5 PM EST.

You can hit the bulk endpoints Once / 10 seconds and the Profile Bulk / ETF Bulk - Once / 60 seconds.

The bulks were designed initially to mitigate significant numbers of requests to the API and were mainly used to fill the database initially. They should not be run that frequently. What likely happened is that you were connected to one server and the overwhelming number of bulk requests overloaded the service. (Note we have over 200-300 servers globally at any given time). When you connect to the API the balancer will assign you one service closest and the most healthy to provide data to you - until your connection ends (typically every 60 seconds it will refresh you to another healthier service to keep you on the same service). We do have restrictions in place for select bulk endpoints and we will put more restrictions in place moving forward, however for now, it's best if you spread out your requests as they are updated once every 6-8 hours.

The growth rates represent the total growth rate over the specified period.

It's just an annual growth rate over 10, 5, or 3 years, you can just use those values directly for the CAGR formula since they are already pre-calculated.

For the Exponential Moving Average (EMA), the period calculates the ema over the 13 most recent daily intervals. It aligns with the indicator period. For example, if you used the daily technical indicator and set the period to 13, it would calculate EMA using data from the last 13 days.

The "EMA" corresponds to the period you set for the technical indicator.

The “period=” parameter is a period for the type, for example, “sma” is a simple moving average, so if the period is 20 (period=20), it will be on the last 20 candles like the last 20 periods.

Depends on the data package. You can get more information about our plans and prices on the Pricing Page.

If you are an Enterprise customer you can increase our API rate limit for a nominal fee we can increase the rate limit. Please contact our Enterprise Solutions Team for more information.

Our contract and data licensing terms for commercial usage are outlined in our quote and we also have our Terms of Service.

It's only one api key per account. If you are an Enterprise Customer you can require more api keys for an additional fee. Please contact our Enterprise Solutions Team for more information.

No, as we collaborate with multiple data partners who liaise with exchanges to acquire real-time data, and our agreements cover this aspect. We handle reporting and licensing fees passed on by the exchanges to our partners, and subsequently to us. That is why we have our data display agreement.

Thank you for your interest! To better assist you, please submit your information using the link below. One of our account managers will follow up with you shortly. If there is anything else I can help with, please let me know. https://site.financialmodelingprep.com/enterprise-contact