FMP

FMP

Enter

FAQs - Financial Modeling Prep API

FAQs for Financial Modeling Prep API

Frequently Asked Questions

Sections

Data

Everything you need to know about our Financial Data offerings

Plans and Pricing

Details about our available data subscriptions and pricing

Platform

Learn more about our support and available resources

Financial Statements

Questions about our financial statements? Here are some answers.

API Access

Issues that involve data access with regards to your API Key, Websocket, Rate Limit, Error Codes, and more

How many years of intraday data do you cover?

down vote arrow

We provide 15+ years of intraday historical data. ( intraday historical coverage is asset and frequency-dependent. )

How many years of data do you cover?

down vote arrow

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?

down vote arrow

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

What is the quality of FMP data?

down vote arrow

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

Is your data split adjusted?

down vote arrow

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

Where does the data come from?

down vote arrow

Stock Fundamental data is sourced from the U.S. Securities and Exchange Commission (SEC) and companies filings, you can see our process standardization approach here: Parsing Statement Process Stock financial ratios and key metrics formula can be found here: Ratios Formula Commitments of Traders is sourced from Commodity Futures Trading Commission Economic Indicators are sourced from Board of Governors of the Federal Reserve System (US)

How can I see new endpoints added to the API?

down vote arrow

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

How long does your data take to populate after a stock reports their earnings?

down vote arrow

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.

If I upgrade my subscription will I be charged for the full amount of the new plan?

down vote arrow

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

How do I upgrade/downgrade a subscription in the same category?

down vote arrow

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

Do you provide discount for students?

down vote arrow

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

Do you offer any discounts for startups?

down vote arrow

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

What is the difference between free and paid subscriptions?

down vote arrow

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.

Is the FMP API compatible with Open AI?

down vote arrow

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

Do you have a Excel Add-on?

down vote arrow

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

Do you have a Google Sheet add on?

down vote arrow

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

Do you have existing packages for your API?

down vote arrow

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.

How is it possible to report a data discrepancy?

down vote arrow

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

Do you have bulk endpoints where I can easily access multiple companies' financial statements?

down vote arrow

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.

What is the difference between https://site.financialmodelingprep.com/ and FMPCloud.io?

down vote arrow

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.

Will I also have access to the FMPCloud.io package by subscribing to https://site.financialmodelingprep.com?

down vote arrow

Yes, you will have access to FMPCloud.io.

How can I cancel my subscription?

down vote arrow

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

Why does the net income field deviate from a companies bottom-line net income?

down vote arrow

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.

Why does the filing date match the date?

down vote arrow

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.

Why are fields in the income statement 1,000 or 1,000,000 times larger than reported in their SEC filings?

down vote arrow

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.

How can I get the daily historical data from the year 2005 of Apple stock in 15-minute time intervals?

down vote arrow

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.

I can't find the full historical prices endpoint for stocks anymore. Can you help me locate it?

down vote arrow

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.

Why is my API Key invalid?

down vote arrow

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

Is it the 'close' price data adjusted for stock splits 'and adjClose' is the close adjusted for stock splits and dividends?

down vote arrow

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

How many symbols can you subscribe to on a single Financial Modeling Prep WebSocket connection?

down vote arrow

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.

What is the formula for Return on Invested Capital (ROIC)?

down vote arrow

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

Where do you source data for 'numberOfShares' in terms of 'ownership structure'?

down vote arrow

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

How I can query the Trailing Twelve Months (TTM) data for financials statements (Income Statement, Balance Sheet, and Cash Flow Statement)?

down vote arrow

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.

How many symbols does Financial Modeling Prep provide data for?

down vote arrow

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

What payment methods you accept?

down vote arrow

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

What analyst firms do you support and cover?

down vote arrow

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

Do you provide Historical Shares Float data?

down vote arrow

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

What is the source of the company fundamental data for US companies?

down vote arrow

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

Is it possible to get a new API Key?

down vote arrow

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

Do you provide S1 filings data?

down vote arrow

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

Does the intraday historical market cover pre-market and after hours?

down vote arrow

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

How do I retrieve quarterly financial data information on Excel?

down vote arrow

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])

What qualifies as an API call?

down vote arrow

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

How do you calculate shares float?

down vote arrow

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.

Do you offer free trials?

down vote arrow

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.

How do you calculate Weighted Average Cost of Capital (WACC)?

down vote arrow

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

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

down vote arrow

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

What is the source of the company fundamental data for non-US companies?

down vote arrow

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

What is the period used to calculate Volume-Weighted Average Price (VWAP)?

down vote arrow

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

What is the time zone for each endpoint?

down vote arrow

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

Where does Financial Modeling Prep source news from?

down vote arrow

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

Does Financial Modeling Prep currently have bond data?

down vote arrow

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

Where I can find my invoices?

down vote arrow

The invoices are available on your Dashboard

Can I have more than one API key?

down vote arrow

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

Does real-time stock quote cover pre-market and after hours?

down vote arrow

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

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

down vote arrow

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/

What is the source of the Analyst Estimates data?

down vote arrow

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 can I change my payment method?

down vote arrow

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

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.
twitterlinkedinfacebookinstagram
2017-2024 © Financial Modeling Prep