FMP

FMP

Enter

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

API Access

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

Search

Learn how to search for specific financial data and assets using our powerful search functionalities.

Directory

Explore our directory of available companies and financial data assets, easily accessible through our platform.

Quote

Get real-time financial quotes for various assets, including stocks, commodities, and other financial instruments.

Company

Access detailed company information, including key metrics, executive compensation, mergers, and more to evaluate businesses.

Calendar

Stay up to date with key financial events, such as earnings reports, dividends, stock splits, and IPOs, all in one place.

Statements

Retrieve comprehensive financial statements like balance sheets, income statements, and cash flows for in-depth company analysis.

SEC Filings

Access SEC filings for important regulatory documents, such as 10-Ks and 10-Qs, and track changes in company reporting.

Analyst

Gain insights into analyst estimates, ratings, price targets, and stock upgrades/downgrades to help guide investment decisions.

Commitment of Traders

Explore Commitment of Traders data to analyze market sentiment based on the positions held by different trader categories.

ESG

Access environmental, social, and governance (ESG) data to evaluate companies based on their sustainability and social responsibility practices.

ETF & Mutual Funds

Track the performance of ETFs and mutual funds, including holdings, fund disclosures, and detailed data on their investment strategies.

Commodity

Explore real-time and historical data on commodities such as oil, gold, and agricultural products to track price trends and volatility.

Crypto

Monitor cryptocurrency prices and trends, including data on Bitcoin, Ethereum, and other digital currencies in real-time and intraday.

Forex

Access foreign exchange (forex) data with real-time quotes, historical trends, and intraday pricing for global currency pairs.

Indexes

Follow stock market indexes, including real-time quotes, historical data, and constituent information for major global indices.

Insider Trades

Monitor insider trading activity to understand how executives and directors are buying or selling shares in their own companies.

Market Hours

Check trading hours for global markets and exchanges to ensure you're trading at the right times for various financial assets.

News

Stay informed with the latest news articles covering financial markets, company updates, economic trends, and other investment-relevant stories.

Chart

Generate and analyze charts with end-of-day, intraday, and batch data to visualize trends and price movements across different assets.

Discounted Cash Flow

Learn about discounted cash flow (DCF) models, which help estimate the present value of companies based on future cash flows.

Bulk

Retrieve bulk data on company profiles and financials, ideal for comprehensive analysis of multiple companies and assets simultaneously.

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 80,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.

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

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

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.

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.

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

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

Where I can find my invoices?

down vote arrow

The invoices are available on your Dashboard

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

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

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

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 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 or https://financialmodelingprep.com/api/v3/historical-chart/1min/AAPL?from=2021-06-11&to=2021-06-11&extended=true&apikey=your_api_key

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

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

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 US companies?

down vote arrow

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

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

How can I get more than 5 years of data in one query?

down vote arrow

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=

When the End of Day (EOD) data are updated?

down vote arrow

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

How the FMP calculate the "AvgVol"?

down vote arrow

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

What is Capital gains?

down vote arrow

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.

How do you calculate the "change" data?

down vote arrow

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

How do you calculate the "changeOverTime" data?

down vote arrow

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

How many years of intraday data I can get in one query?

down vote arrow

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.

Is the Intraday price adjusted?

down vote arrow

Yes, the intraday data is adjusted for split.

What is the time zone for the Intraday endpoint?

down vote arrow

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.

What is the FMP Earning Transcripts data source?

down vote arrow

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

What countries and type of events does it cover in the Economic Calendar?

down vote arrow

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.

Does the Economic Calendar include any currency holidays?

down vote arrow

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.

What is the time zone for the Economic Calendar?

down vote arrow

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

Do you provide PCE or Consumer Spending data?

down vote arrow

We have PCE data and Consumer Sentiment, Consumer Expectations, Consumer Confidence and Consumer Inflation as part of our Economic Calendar.

Could you please clarify the difference between the API end points "earnings confirmed" and "earnings calendar"?

down vote arrow

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.

What is the FMP Earnings Transcript coverage?

down vote arrow

We currently cover transcripts for US stocks.

What is the Time Zone for Crypto data?

down vote arrow

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

How many unique companies do we cover their financial statements?

down vote arrow

There are 55,904 companies.

Why the Cash Flow Statement is not updated?

down vote arrow

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.

How often is your Financial Statement data is updated?

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.

Do you provide As Reported data for non- US companies?

down vote arrow

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

What Are the Forex Market Hours?

down vote arrow

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.

Forex data is on the EST time zone" but what exactly does that mean? What is the exact time of day for open and close?

down vote arrow

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)

What is the Time Zone for Commodities symbols?

down vote arrow

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

What are the Commodities Market Trading Hours?

down vote arrow

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.

Does Financial Modeling Prep support commodities data?

down vote arrow

Yes, we provide 20+ years of Historical Commodities data

How can I connect to a Financial Modeling Prep WebSocket?

down vote arrow

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

How many FMP WebSocket connections can I use at one time?

down vote arrow

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

How should I subscribe to a symbol on WebSocket?

down vote arrow

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

What is the work hours for the Stock WebSocket?

down vote arrow

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

What would you suggest the sleep time between 2 api calls to these bulk endpoints?

down vote arrow

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

Why am I getting 502 - Bad Gateway error?

down vote arrow

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.

Does the ten year, five year, three year growth rates represent the total growth rate over that period or the average annual growth rate?

down vote arrow

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

For the fields tenYDividendperShareGrowthPerShare, fiveYDividendperShareGrowthPerShare and threeYDividendperShareGrowthPerShare in the Financial Growth API what exactly do these represent? Are they indicative of the growth rate of dividends per share over 10, 5, and 3 years, respectively? Additionally, could you explain how I might derive the Compound Annual Growth Rate (CAGR) for dividends per share using these values?

down vote arrow

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.

How do you calculate the Exponential Moving Average (EMA) data on the Technical Indicators endpoint?

down vote arrow

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.

Which Exponential Moving Average (EMA) do you use?

down vote arrow

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

What does the “period=” parameter mean on the Technical Indicator endpoints?

down vote arrow

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.

What is the price for data packages?

down vote arrow

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

Can I increase my api calls rate?

down vote arrow

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.

What are the contract terms?

down vote arrow

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

Do I need to have separate agreements with the exchanges for real-time data?

down vote arrow

Access to real-time or delayed data may be subject to additional agreements with the relevant exchange, and applicable licensing fees may be required. Please contact FMP for additional information or any questions.

Where I can get more information about your commercial plans?

down vote arrow

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

What data does the 1-Hour Forex Interval Chart API provide?

down vote arrow

The API provides OHLC (open, high, low, close) prices and trading volume for forex currency pairs at 1-hour intervals.

How often is the data updated?

down vote arrow

Data is updated every hour, allowing users to track price changes and volume fluctuations throughout the trading day.

How can I use this API for trading strategies?

down vote arrow

The 1-hour interval data can help swing traders or day traders identify key support and resistance levels, track overall trends, and time their entry and exit points more effectively.

Can I access historical 1-hour Forex data?

down vote arrow

Yes, the API offers historical data for 1-hour intervals, which is useful for backtesting strategies or analyzing past market performance.

How does this API benefit forex traders?

down vote arrow

Traders benefit from a more detailed view of price movements across the trading day, enabling them to track trends or market shifts and execute informed trades.

Is the 1-Hour Forex Interval Chart API compatible with Open AI?

down vote arrow

Yes, the Financial Modeling Prep 1-Hour Forex Interval Chart API is compatible with Open AI, allowing for seamless integration into AI-driven trading platforms or data analysis models.

What is the quality of FMP 1-hour interval data?

down vote arrow

The data is sourced from reliable financial markets and is updated in real-time to ensure accuracy and reliability for intraday trading and analysis.

Is your API free to use?

down vote arrow

Yes, you can get a free API to test the service on your dashboard by visiting https://site.financialmodelingprep.com/developer/docs/dashboard

Is the API free to use for testing purposes?

down vote arrow

Yes, you can get a free API to test the service on your dashboard. Visit https://site.financialmodelingprep.com/developer/docs/dashboard for more information.

How can I get historical data for ETF holdings using the API?

down vote arrow

To retrieve historical data for ETF holdings, the API call should be structured as follows: financialmodelingprep.com/stable/etf/holdings?date=desired_date&symbol=SPY&apikey=YOUR-API-KEY. You can find more information on how to make the API call for historical data on the Financial Modeling Prep documentation: https://site.financialmodelingprep.com/developer/docs#etf-holding-dates-etf-holdings

How can I change my subscription plan to align with the Trailing 30 Day Bandwidth Consumption policy?

down vote arrow

To change your subscription plan to align with the Trailing 30 Day Bandwidth Consumption policy, you can go to the Pricing Page on our website and select a plan that meets your data needs. If you have any specific questions or need assistance with selecting a plan, feel free to reach out to our customer support team for help.

How can I retrieve historical financial data using your API?

down vote arrow

To retrieve historical financial data using our API, you can make a GET request to the appropriate endpoint with the necessary parameters such as the date range and the specific data you are looking for. Our API documentation provides detailed instructions on how to do this.

How can I cancel my subscription?

down vote arrow

To cancel your subscription, please go to the Pricing Page on our website and select the free plan.

How is the graham net-net value calculated?

down vote arrow

The graham net-net value is calculated using the formula: grahamNetNet = (balanceSheet.cashAndCashEquivalents + balanceSheet.shortTermInvestments + (0.75 * balanceSheet.netReceivables) + (0.5 * balanceSheet.inventory) - balanceSheet.totalLiabilities) / shares.

Do you provide real-time treasury rates data through your API?

down vote arrow

Unfortunately, at the moment we only provide daily treasury rates data through our API. We do not offer real-time treasury rates data at this time.

Do you offer student discounts?

down vote arrow

Yes, we offer a 30% discount to students for all Financial Modeling Prep plans. To receive a student discount, please provide your current student email address and/or an image of your student ID.

How often does the usage limit reset for the API?

down vote arrow

The usage limit for the API is a rolling 30-day limit that updates daily. There is not a specific date that the limit is restored. The data consumed amount will slowly decrease day by day. If you need additional bandwidth, you can add extra limit with additional fees by submitting your information using the following link: https://site.financialmodelingprep.com/enterprise-contact

I am interested in Commercial / Enterprise Plans, how can I get more information?

down vote arrow

To receive more information, please submit your information using this link: https://site.financialmodelingprep.com/enterprise-contact. One of our account managers will follow up with you shortly for further assistance and information.

How can I enable auto-renewal for my subscription plan?

down vote arrow

All of our plans are automatically renewed. To cancel your subscription membership, you should go to the pricing page and switch your account to the Free plan before the next billing cycle.

Why was my account suspended even though I paid?

down vote arrow

An account may have been suspended temporarily due to failed payments

How can I download the full text of SEC filings using the API?

down vote arrow

You can download the full text of SEC filings using our API by accessing the following link: https://financialmodelingprep.com/api/v3/sec_filings/AAPL?type=10-k&page=0&apikey=YOUR-API-KEY

How is long term debt calculated using the financial data API?

down vote arrow

Long Term Debt is calculated using the formula: Long Term Debt to Capitalization = debt / (debt + totalStockHolderEquity). Additionally, debt is inclusive of capital leases as a result of ASC 842.

How can I get help with using FMP's financial data API?

down vote arrow

If you need assistance with using our financial data API, please reach out to our customer support team by sending us a message. We are here to help you with any questions or issues you may have.

What is the bandwidth limit policy and how can I reset it?

down vote arrow

Our company implemented a 30-day rolling monthly bandwidth limit to optimize system performance and ensure consistent service quality for all users. If you have exceeded the limit, you can upgrade your plan to purchase additional data bandwidth. You can also submit your information using the following link for further assistance: https://site.financialmodelingprep.com/enterprise-contact

How can I get access to historical financial data through your API?

down vote arrow

To access historical financial data through our API, you can make use of our historical data endpoints. These endpoints allow you to retrieve historical stock prices, financial statements, and other relevant data for analysis and research purposes. Please refer to our API documentation for more details on how to access this information.

How much data is used on average for a single symbol through the websocket?

down vote arrow

The WebSocket does not account for the 30 Day Bandwidth Consumption.

I noticed a discrepancy in the financial statements for a stock. How should I report this issue?

down vote arrow

To report a discrepancy in the financial statements for a specific stock, please submit a bug ticket through our chatbot. Make sure to provide all the requested information to help us investigate and resolve the issue promptly.

How can I check my data usage details?

down vote arrow

You can find your data usage on the Dashboard > View Data Bandwidth Consumption > Data Usage

How can I access historical share-float values older than 2021 through the API?

down vote arrow

At the moment, we provide historical shares float data from 2021 onwards. If you require access to historical share-float values older than 2021, unfortunately, that data is not available through our API at this time.

When does the monthly data limit reset?

down vote arrow

The monthly data limit does not reset on a specific date. It is a 30-day rolling limit, so the consumed amount will slowly decrease day by day.

How can I renew my Enterprise-annual Plan?

down vote arrow

To proceed with renewing your Enterprise-annual Plan, please contact your account manager. They will be able to assist you with selecting the correct plan and any other questions you may have.

Will the data I retrieve from a specific year remain the same, or can it be modified over time?

down vote arrow

Old data can be changed for various reasons, including manual corrections, functional fixes, stock splits, and remapping statements. It is recommended to periodically fetch old data to ensure you have the most up-to-date information.

Do you provide short interest data in your API?

down vote arrow

Unfortunately, we do not provide short interest data at the moment.

Why am I experiencing limitations on my subscription that I did not have before?

down vote arrow

Our company recently implemented a 30-day rolling monthly bandwidth limit to optimize system performance and ensure consistent service quality for all users. This change was made to encourage efficient data usage while maintaining fairness across all accounts. Without this limitation, there could be strain on our servers and jeopardize our operations. We are here to help you optimize your data querying methods and suggest strategies to reduce bandwidth consumption. If you have any specific concerns about accessing certain data, please let us know so we can assist you further.

Why am I receiving a 'Bandwidth Limit Reached' error message when using the API?

down vote arrow

The 'Bandwidth Limit Reached' error message indicates that you have exceeded the 30-day rolling monthly bandwidth limit implemented by our company to optimize system performance and ensure consistent service quality for all users. This limit impacts less than 0.5% of our user base and is in place to encourage efficient data usage while maintaining fairness across all accounts. We recommend reviewing your current API usage patterns, optimizing your data querying methods, and considering upgrading your plan to purchase additional data bandwidth to avoid future limitations.

How can I access historical data of a specific stock using the API?

down vote arrow

To access historical data of a specific stock using our API, you need to search with the symbol in the Daily EOD API. Make sure you have the appropriate plan that includes access to historical data. If you encounter any issues, feel free to reach out to our support team for assistance.

I have a premium plan but cannot access certain financial data. What should I do?

down vote arrow

If you have a premium plan but are unable to access certain financial data, please reach out to our customer support team with the specific endpoint or data you are trying to access. Our team will review your request and assist you accordingly.

How does the bandwidth limit work for the financial data API?

down vote arrow

The 30-day bandwidth limit is a rolling aggregation of the total data consumed via the API over the past 30 days. It is set at a high threshold to avoid impacting normal usage and manage excessive usage patterns. This limit serves as a safeguard to prevent spamming and abusive behavior. Users can analyze their data consumption through the dashboard, which provides a breakdown by API call.

What time is considered the end of the day for Crypto full historical data?

down vote arrow

For Crypto full historical data, the close is considered as of 12 AM EST as Crypto markets operate 24/7.

What API plan should I choose if I need 15-minute delayed data from a stock exchanges for commercial usage?

down vote arrow

For commercial usage requiring 15-minute delayed data from specific stock exchanges, we recommend our enterprise-level tier. Please submit your information using the following link so one of our account managers can assist you further: https://site.financialmodelingprep.com/enterprise-contact

What market data licenses does your company offer, specifically the rebroadcast license?

down vote arrow

We offer various market data licenses, including the rebroadcast license. The terms and conditions of the rebroadcast license will be provided to you upon request to help you understand your data access rights.

How does the trailing 30-day bandwidth consumption quota reset?

down vote arrow

The trailing 30-day bandwidth consumption quota resets based on a rolling 30-day period. Your consumed usage will gradually decrease over time.

How can I access historical financial data using your API?

down vote arrow

To access historical financial data using our API, you can make a request specifying the date range and data points you are interested in. Our API will then return the historical financial data based on your request parameters.

If I upgrade from the starter plan to the premium plan, what limitations will I still have regarding using the endpoints?

down vote arrow

If you upgrade from the starter plan to the premium plan, you will still have limitations on the number of tickers you can search for certain endpoints. To have full access to all tickers without any limit, you would need to upgrade to the Ultimate plan.

How can I get a free API Key?

down vote arrow

You can find your free API Key on the dashboard. Please visit https://site.financialmodelingprep.com/developer/docs/dashboard for more information.

What is advanced data and what is websocket?

down vote arrow

Advanced data refers to the detailed and specialized information provided through our API endpoints. WebSocket is a technology that allows for real-time price data for US stocks, Forex, and Crypto to be delivered instantly.

How can I get a list of companies for a specific exchange and historical end of day prices for each company?

down vote arrow

1). You can use the Symbol exchange API to get the list of symbols for the exchange you want. 2) You need to search by a symbol in the Daily EOD API or use the Batch EOD API, but you will get data for all symbols we cover as you cannot filter by exchange.

Do you have the historical data of the constituents of the S&P 500?

down vote arrow

Yes, you can use the Historical S&P 500 Constituents API. You can find more information and access the API: https://site.financialmodelingprep.com/developer/docs#historical-sp-500-constituents

Do you provide after-hours financial data through your API?

down vote arrow

Yes, you can use the Aftermarket Quote API for after-hours financial data. You can find more information about it in the documentation.

How can I change my API key?

down vote arrow

To change your API key, you can reach out to our customer support team for assistance. They will help you generate a new API key and provide you with the necessary steps to update it on your dashboard.

Do you provide real-time Options data or Level-2 (Depth of Market Data) through your API?

down vote arrow

At the moment, we do not support options data or Level-2 (Depth of Market Data) through our API.

How can I retrieve historical bulk key-metrics for a period spanning multiple years?

down vote arrow

At the moment, it is not possible to retrieve historical bulk key-metrics for a period spanning multiple years in one batch. You can specify the year and period for annual or quarterly data using the Bulk Key Metrics API.

Do you offer real-time, non-delayed US ETF prices?

down vote arrow

Yes, we offer real-time, non-delayed US ETF prices with our Ultimate plan.

Can I use unlimited websockets with the Ultimate plan for real-time prices?

down vote arrow

Yes, with the Ultimate plan, you can use unlimited websockets for real-time prices.

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

down vote arrow

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 timeframes are supported by the API for historical candlestick data?

down vote arrow

Our API supports various timeframes for historical candlestick data, including but not limited to 1 minute, 5 minutes, 15 minutes, etc. Please refer to our API documentation for a comprehensive list of supported timeframes.

How can I view my API usage over the last month?

down vote arrow

You can view your API usage over the last month by accessing the Dashboard on our website. This will provide you with detailed information on your data consumption, allowing you to plan your usage accordingly. If you need to reduce your usage to stay within the limit or require extra limit, you can upgrade your plan.

Where can I find my API key?

down vote arrow

Your API key is available on the dashboard. You can access it by visiting https://site.financialmodelingprep.com/developer/docs/dashboard

How do I cancel my subscription?

down vote arrow

To cancel your subscription, go to the Pricing Page on our website and select the free plan.

How frequently does your company check news sources for new articles?

down vote arrow

We check every news page every hour for any new articles. This ensures that we do not miss any news from the sources that we have.

Is market capitalization data for European stocks available in the Starter package?

down vote arrow

Yes, the Starter plan for $29 allows you access to market cap data for European stocks.

Can I get a refund on my subscription if I no longer use the FMP API?

down vote arrow

Unfortunately, we do not process refunds as stated in Section 1.4 of our Terms of Service. To cancel your subscription membership, you should go to the pricing page and switch your account to the Free plan or contact our support team regarding the cancellation before the next billing cycle.

Where can I find information on using weekly or monthly resolutions for historical chart data?

down vote arrow

You can find information on using weekly or monthly resolutions for historical chart data in the Intraday chart API documentation. Visit the following link for more details: https://site.financialmodelingprep.com/developer/docs#chart-intraday

How can I request a trial version of your paid API for commercial use?

down vote arrow

To request a trial version of our paid API for commercial use, please submit your information using the following link: https://site.financialmodelingprep.com/enterprise-contact. One of our account managers will follow up with you shortly.

What is the upper limit of the number of symbols I can give to the batch aftermarket API?

down vote arrow

The upper limit for the number of symbols you can give to the batch aftermarket API is 1,000 symbols.

How can I quickly receive the sector of a stock?

down vote arrow

You can get the sector of a stock by using the Profile API. You can find more information on how to access this data here: https://site.financialmodelingprep.com/developer/docs#company-profile-company-information

How often is the data in the API at financialmodelingprep.com/api/v3/stock-screener updated?

down vote arrow

The screener API is updated in real time during market trading hours.

What is the average latency from the filing (insider or 13f) appearing on SEC Edgar to being available through your APIs?

down vote arrow

The initial extraction of data from when it gets filed to being available through our APIs should be under a few hours. However, the full holding analytics can take up to 48 hours as all the holdings previously would need to be recalculated.

How can I delete my account?

down vote arrow

To delete your account, please reach out to our customer support team and request for your account to be deleted. Once your request is received, our team will assist you in deleting your account.

Why was my account suspended or blocked?

down vote arrow

If your account was suspended or blocked, it may have been due to a variety of reasons such as non-payment, suspicious activity, or violation of our terms of service.

Do I get access to all tickers in the ultimate plan?

down vote arrow

Yes, in the ultimate plan, you will have access to all tickers available in our financial data API.

How can I request the addition of a specific stock symbol to your database?

down vote arrow

To request the addition of a specific stock symbol to our database, please reach out to our customer support team with the symbol you would like to add. Please note that the process may take some time due to validation and testing requirements. If you would like to expedite the process, you may consider subscribing to our Enterprise plan for quicker symbol additions.

How can I upgrade or downgrade my plan?

down vote arrow

You can Upgrade / Downgrade your plan by going to the Pricing Page and selecting the plan you wish to change to.

What is the difference between the DCF value calculated by the 'DCF' API and the 'Advanced DCF' API?

down vote arrow

The 'Advanced DCF' API calculates the DCF valuation for a company with advanced features like modeling multiple scenarios and using different valuation methods, while the 'DCF' API gets the DCF valuation for a company, taking into account its debt levels.

How are companies scored in your company ratings?

down vote arrow

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.

Do you provide historical Beta data for stocks?

down vote arrow

At the moment, we do not provide historical Beta data for stocks.

How can I get more information about Commercial / Enterprise Plans?

down vote arrow

To get more information about our Commercial / Enterprise Plans, please submit your information using the following link: https://site.financialmodelingprep.com/enterprise-contact. One of our account managers will follow up with you shortly for further assistance and information.

How can I access index price information using your API?

down vote arrow

You can check the Indexes list we have by using the Available Indexes API. Then, you can search by the symbol in the Daily Chart EOD API.

How can I generate a new API key?

down vote arrow

To generate a new API key, you can visit the Dashboard on our website and create a new key.

Where can I find more information and examples of implementations for the DCF API?

down vote arrow

You can find more information and examples of implementations for the DCF API on our webpage at a https://site.financialmodelingprep.com/developer/docs/dcf-formula and https://site.financialmodelingprep.com/discounted-cash-flow-model/AAPL

I need more time to pay for my subscription due to issues with my credit card. What should I do?

down vote arrow

If you need more time to pay for your subscription due to credit card issues, please reach out to our customer support team for assistance. They will be able to help you with your situation and provide guidance on how to proceed.

I tried to get 1-minute historical data by setting the 'from' and 'to' dates to a period before 2022, but only an empty list is returned. What could be the issue?

down vote arrow

When querying historical intraday price data, there are limits to the number of records that can be returned in a given query. If you need data from a period before 2022, you will need to implement a loop that iterates over day intervals covering the entire desired time range. This will ensure a suitable response speed for the data being returned.

How can I change my payment method?

down vote arrow

You can change your payment method by accessing the Dashboard > Settings > Billing section on our website. If you need further assistance, please reach out to our support team.

How can I update my billing information?

down vote arrow

You can update your billing information by going to the billing settings in your Dashboard. If you encounter any issues or need assistance, please reach out to our team for help.

Why does the /stable/aftermarket-quote?symbol=AAPL API return zero volume for the current time?

down vote arrow

The volume displayed in the API represents the day volume. If the market is not open yet (pre-market), the volume will be zero. For the volume of the last trade, it is displayed as lastSaleSize.

How can I retrieve index historical price like ^GSPC in Google Sheets using the premium access API?

down vote arrow

To retrieve index historical price like ^GSPC in Google Sheets using the premium access API, you can use the formula =fmpHistoricalPriceFull(""^GSPC"

Why am I unable to access the 'Company Profile Bulk' API endpoint?

down vote arrow

The 'Company Profile Bulk' API endpoint is currently restricted to the Ultimate, Build, and Enterprise plans as it is still in development.

If I change my plan, do I need to generate a new token for my code, or can I continue to use the same token in my old plan to access the upgraded plan?

down vote arrow

No, you will be updated automatically to the plan you want with the same API key.

What is the data usage limit for the Ultimate plan?

down vote arrow

The data usage limit for the Ultimate plan is 150GB. If you need more information or have specific requirements, you can contact your account manager for further assistance.

Why am I experiencing intermittent connection issues with the Crypto WebSocket service?

down vote arrow

Intermittent connection issues with the Crypto WebSocket service can be caused by various factors such as gateway timeout errors, bad gateway errors, connection reset errors, and connection refused errors. These errors can occur randomly during normal operation and may require a server restart to temporarily resolve the issue. It is recommended to maintain an open WebSocket connection constantly, subscribe to specific symbols only when users request them, and unsubscribe from symbols when no users are watching. If you are experiencing these issues, please provide detailed logs and snapshots for further investigation.

How long does it take for the quarterly financial statements to be updated in the API after they are released by the companies?

down vote arrow

The financial statements are updated in the API 24-48 hours after the data is released by the company.

Where can I find information about access restrictions on the API endpoints?

down vote arrow

Access restrictions on the API endpoints are mentioned in the documentation.

What price is displayed after the market closes until it opens again for equities?

down vote arrow

For equities, there is no price displayed after the market closes until it opens again. However, you can check this data during pre and post-market hours using the Aftermarket Trade API.

I noticed errors in the financial data for certain companies. How do I report this?

down vote arrow

If you notice any errors in the financial data for specific companies, please send an email to info@financialmodelingprep.com with the full details about the issue. Our development team will investigate and address the issue accordingly.

Where can I find the units of measure for commodities in your API?

down vote arrow

Currently, we do not have the units of measure for commodities in our additional descriptors.

Can I access press releases through your API?

down vote arrow

Yes, you can access press releases through our API. Our API provides access to a wide range of financial data, including press releases, to help you make informed decisions.

How can I search for company details using the CIK?

down vote arrow

You can search for company details using the CIK by accessing our CIK search API. Simply input the CIK of the company you are looking for, and you will receive the relevant data. For more information and a sample of the data returned using the CIK search API, you can visit our documentation here: https://site.financialmodelingprep.com/developer/docs#cik-name-search-company-search

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

down vote arrow

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

I am unable to login even after resetting my password. What should I do?

down vote arrow

If you are still unable to login after resetting your password, please reach out to our customer support team for further assistance.

Can I make isolated purchases of more bandwidth/data without upgrading my plan?

down vote arrow

No, isolated purchases of more bandwidth/data are not possible. You can only increase your bandwidth/data limit by upgrading your plan to a higher tier.

If I exceed the usage limit under one plan, will I automatically be pushed into a higher tier plan?

down vote arrow

No, we do not automatically upgrade your plan if you exceed the usage limit. If you go over the limit, your API key will not work until the usage is within the plan limit again.

Why am I receiving a 'too many requests' error when trying to use the API key?

down vote arrow

The 'too many requests' error typically occurs when the API usage limit has been reached. This can happen if you are making a large number of requests in a short period of time. To resolve this issue, you may need to wait until the usage limit resets or consider upgrading to a plan with higher usage limits.

Do you offer a bulk API endpoint for the institutional-ownership/symbol-positions-summary?

down vote arrow

At the moment, we do not have a bulk API for the institutional-ownership/symbol-positions-summary endpoint.

How often does the AUM (Assets Under Management) data update?

down vote arrow

The AUM data updates every few days.

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

down vote arrow

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 can I determine the currency in which the earnings estimates are provided in the FMP.ANALYSTESTIMATES function?

down vote arrow

The currency for our financial data is dependent on how the company reported its financial reports. You can cross-reference the currency by checking the company's financial statements or reports to determine the currency in which the earnings estimates are provided.

Do you provide historical time series data for German Bund yields?

down vote arrow

Unfortunately, we do not provide historical time series data for German Bund yields at this time. Our current offerings are focused on US Treasury rates.

Do you provide historical bond price data?

down vote arrow

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

How can I resolve the 'Unauthorized' response when trying to connect to the streaming (websocket) API?

down vote arrow

If you are receiving an 'Unauthorized' response when trying to connect to the streaming (websocket) API, please make sure you are using the correct API key. Double-check that the API key you are using is correct and properly formatted in your request. If you continue to experience issues, please refer to the documentation provided on our website or reach out to our support team for further assistance.

If I purchase premium today, and then decide to upgrade to Ultimate today, can I just pay the difference or do I have to pay the full price of both?

down vote arrow

If you upgrade from the Premium plan to the Ultimate plan on the same day, you will only need to pay the price difference between the two plans and the unused time of your Premium plan.

I have a credit on my account, but it is not reflecting when I try to subscribe again. What should I do?

down vote arrow

If you have a credit on your account, but it is not reflecting when you try to subscribe again, please refresh the page and try again. The credit should be automatically applied to your invoice when you subscribe to the service.

How can I check my API usage limits and data consumption?

down vote arrow

You can find the correct number of calls for your API on the Dashboard > API Key and the Data Usage on the Dashboard > View Data Bandwidth Consumption > Data Usage. If you need further assistance, please let us know.

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

down vote arrow

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.

How can I pull the daily close price for a given security for the last 10 years?

down vote arrow

You can use the Daily EOD API by adding the parameters 'from' and 'to' in the following example: https://financialmodelingprep.com/api/v3/historical-price-full/URTH?from=2012-01-01&to=2025-03-04&apikey=YOUR-API-KEY

How can I retrieve historical intraday price data for more than 1 month?

down vote arrow

To retrieve historical intraday price data for more than 1 month, you will need to implement a loop that iterates over day intervals covering the entire desired time range. This approach ensures a suitable response speed for the data being returned. For example, if you require more than 1 month of 30-minute data, you can make queries over day intervals to cover the entire desired time range. Here is an example link for retrieving 1-minute data: https://financialmodelingprep.com/api/v3/historical-chart/1min/AAPL?from=2024-12-04&to=2024-12-06&apikey=YOUR-API-KEY

What timezone does the quote API for stocks and forex use?

down vote arrow

The timezone for the quote API is aligned with the timezone of the exchange that the symbol trades on.

I have a monthly payment and I want to switch to an annual plan with a discount, but the discount code is not being applied. What should I do?

down vote arrow

Please reach out to our support team with your name, email, and a brief description of the issue you are facing. We will assist you in applying the discount code and switching to the annual plan.

If my premium plan is working, should I be able to access all the limited endpoints?

down vote arrow

Access to specific endpoints may still be restricted even with a premium plan. Some endpoints may require additional permissions or may be under development. Please refer to our documentation or contact customer support for more information on endpoint availability.

Is there a customizable plan available to increase data usage limits while keeping everything else the same as the Premium plan?

down vote arrow

To inquire about a customizable plan with increased data usage limits, please submit your information using the following link: https://site.financialmodelingprep.com/enterprise-contact. One of our account managers will follow up with you shortly for further assistance and information.

Is it possible to get downloadable API documentation?

down vote arrow

Yes, you can find downloadable API documentation below each endpoint on our website. You can also export the data in CSV format for your convenience.

How can I request to have my bandwidth consumption wiped out for my account?

down vote arrow

Unfortunately, we do not have the capability to wipe out bandwidth consumption for individual accounts. However, you can upgrade your plan to accommodate your usage needs and avoid exceeding the limits in the future. We can provide you with a detailed usage report to help you understand your consumption patterns and suggest optimization strategies. If you have any questions or need further assistance, please contact our support team.

How can I determine if earnings data was released before or after markets open from the historical earnings data?

down vote arrow

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.

Where does your company source its financial data from?

down vote arrow

We source our data from multiple places. Our primary channels include gathering financials and filings-related data from the SEC (EDGAR), collaborating with data partners for real-time and historical prices, and extracting data from news sources for datasets such as analyst estimates. We typically have 2 or 3 sources for most datasets to ensure data validity and reliability.

How can I request one particular minute's bar data?

down vote arrow

You can use the Intraday chart API endpoint with the specific date and stock symbol to request one particular minute's bar data. For example, you can use the following URL format: https://financialmodelingprep.com/api/v3/historical-chart/1min/AAPL?from=2025-02-28&to=2025-02-28&apikey=YOUR-API-KEY

How are historical prices adjusted for splits in your system?

down vote arrow

In our End of Day (EOD) API, the 'close' price is adjusted for splits, and the 'adjClose' price is adjusted for both splits and dividends. This adjustment is applied to all symbols in the same manner. You can refer to the API documentation for more details.

How can I access Commitment Of Traders (COT) reports using the API?

down vote arrow

You can access comprehensive Commitment of Traders (COT) reports with the FMP COT Report API. This API provides detailed information about long and short positions across various sectors, helping you assess market sentiment and track positions in commodities, indices, and financial instruments.

How does the API calculate sector performance?

down vote arrow

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.

Where is the financial data hosted?

down vote arrow

We host our financial data on secure servers in multiple data centers to ensure reliability and security for our clients.

Can I specify a specific date and ticker when using the =FMP.HISTORICALSHAREFLOAT function in Excel?

down vote arrow

No, you can only search for one symbol per query and you cannot specify the dates. This endpoint returns all the historical shares float data in one query.

How can I get unadjusted 1min price data using the Financial Modeling Prep API?

down vote arrow

To get unadjusted 1min price data using the Financial Modeling Prep API, you can add the parameter 'nonadjusted=true' to the URL of the historical chart endpoint. This will provide you with the data without any reverse stock split adjustments.

Why am I not receiving all the data for historical intraday price data on the API?

down vote arrow

Due to the size and volume of historical intraday price data, there are limits to the number of records that can be returned in a single query. You may need to make queries over multiple periods to retrieve all the data you need. If you require more data than what is being returned, you can implement a loop to iterate over intervals covering the entire desired time range.

How can I enable add-ins in Excel to access your financial data API?

down vote arrow

To enable add-ins in Excel to access our financial data API, you can use our Excel Add-on. You can find more details and the catalogue URL for our Excel Add-on by visiting the following link: https://site.financialmodelingprep.com/developer/docs/excel-add-on

Does FMP have an OpenAPI spec available for use?

down vote arrow

Yes, we do have an OpenAPI spec available for enterprise customers. To learn more about our enterprise plan and access the OpenAPI spec, please submit your information using the following link: https://site.financialmodelingprep.com/enterprise-contact

When does the daily API call reset happen?

down vote arrow

The daily API call reset happens every day at 3 PM EST.

How does the billing work if I switch from a Premium annual plan to an Ultimate annual plan?

down vote arrow

If you switch to an Ultimate annual plan, you will pay the price difference between the Ultimate plan and the remaining time on your Premium plan. Your billing will be adjusted accordingly.

Does the 'Analyst Estimates API' provide estimates in the currency of the company or in dollars?

down vote arrow

The analyst estimates currency is the same as the financial statement.

How can I retrieve the tickers included in an index using your API?

down vote arrow

To retrieve the tickers included in an index using our API, you can make a request to the following endpoint: https://financialmodelingprep.com/stable/etf-holder-bulk. This will provide you with the information you are looking for.

I have a premium membership, but I cannot access Websockets. How can I resolve this issue?

down vote arrow

If you are facing issues accessing Websockets with your premium membership, please follow these steps: 1. Ensure you are using the correct API key. 2. Check if you are following the correct instructions to access the WebSocket data. 3. If you are still unable to access Websockets, please contact our support team for further assistance.

How far back does the news data go?

down vote arrow

The news data goes back to 2019.

Does the Key metrics API cover stocks listed on the Toronto Stock Exchange?

down vote arrow

Yes, the Key metrics API covers stocks listed on the Toronto Stock Exchange as well as our international market.

How can I track my daily bandwidth usage and get a detailed report?

down vote arrow

You can track your daily bandwidth usage from the dashboard. Additionally, you can request a detailed report of your usage by reaching out to our support team.

How can I retrieve the 12-month price target and Year-to-Date data for a stock using your API?

down vote arrow

You can use the Price Target endpoint to retrieve historical data for a ticker, including the 12-month price target and Year-to-Date information. Our data includes Historical Price Target data starting from 2021.

How can I access filing links for International stocks such as India, China, etc?

down vote arrow

You can access filing links for International stocks by checking the final links field in our financial endpoints. Please refer to our documentation at https://site.financialmodelingprep.com/developer/docs#income-statements-financial-statements for more information.

Can I retrieve the 15 largest market cap stocks for each sector using the company-screener endpoint?

down vote arrow

Currently, you can add the market cap parameter to the company-screener endpoint to filter stocks based on a specific market cap value, but the data will not be returned in sorted order from largest to smallest.

What type of data is included in the 'Advanced Data' and 'Corporate Filings' packages that isn't in the starter package?

down vote arrow

The 'Advanced Data' package includes more detailed financial data such as historical stock prices, financial ratios, and analyst recommendations. The 'Corporate Filings' package includes access to SEC filings, annual reports, and other regulatory documents filed by public companies.

I am unable to fetch data using my API key, what should I do?

down vote arrow

If you are having trouble fetching data using your API key, please ensure that your API key is correctly formatted in your code without any extra characters such as { or }. You can test your API key by using it in a sample query like this: https://financialmodelingprep.com/api/v3/historical-price-full/stock_dividend/AAPL?apikey=YOUR_API_KEY If the issue persists, please reach out to our support team for further assistance.

Which plan includes the earnings call transcripts API?

down vote arrow

To access the earnings call transcripts API, you will need at least the Premium plan.

How can I access quarterly financial data using the API?

down vote arrow

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 does 'null' values mean in the financial statement data?

down vote arrow

Null values in financial statement data represent missing or unknown values for that particular field. It could indicate that the data for that specific entry is not available or was not reported by the company for the given period.

How does your company handle errors in the financial data provided through the API?

down vote arrow

We take data accuracy very seriously. Our development team is constantly working to improve the quality of the data we provide. In cases where errors are identified, we investigate them promptly and make necessary corrections. We also have specialized mapping for industries prone to errors like banking and insurance. If you encounter any discrepancies or errors in the data, please report them to us so that we can address them accordingly.

How can I filter out inactive stocks from the API?

down vote arrow

You can filter out inactive stocks by using the API endpoint to see the list of active symbols. Please refer to this link for more information: https://site.financialmodelingprep.com/developer/docs#tradable-search-stock-list

Do you provide option pricing and chains data through your API?

down vote arrow

At the moment, we do not provide options and chains data.

How can I build a detailed dividend yield chart with the same resolution as intraday price charts using your APIs?

down vote arrow

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

What historical data do you provide for delisted companies?

down vote arrow

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

Can I get data for Indian Stock through your API? If yes, which subscription plan do I need to take?

down vote arrow

Yes, you can get data for Indian Stock through our API. To access this data, you would need to subscribe to our premium plan. For more information on our subscription plans, please visit our documentation or contact one of our account managers for further assistance.

Which subscription tier provides access to historical institution ownership and historical insider ownership data?

down vote arrow

The Institutional ownership endpoints are available in the Ultimate plan. This plan provides access to historical institution ownership and historical insider ownership data.

Does the Starter package come with access to Canadian stocks?

down vote arrow

Yes, the Starter package does come with access to Canadian stocks.

I noticed a discrepancy in the cash flow statement for a specific stock ticker. What should I do?

down vote arrow

If you notice any discrepancies in the financial data provided for a specific stock ticker, please reach out to our customer support team with the details. Our team will investigate the issue and work to resolve it as quickly as possible.

What type of real-time price data is available via web sockets?

down vote arrow

Our API provides real-time price data for US stocks, cryptocurrencies, and forex.

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

down vote arrow

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.

Can the 1-minute interval stock price API provide data accurate to minute level?

down vote arrow

Yes, the 1-minute interval stock price API can provide data accurate to minute level. You can specify the time in the format YYYY-MM-DD HH:MM for minute-level data.

How can I check the list of Cryptocurrencies covered by your API?

down vote arrow

You can check the Cryptocurrencies List API to get all the Cryptocurrencies we cover at the moment. Please visit the following link for more information: https://site.financialmodelingprep.com/developer/docs#cryptocurrencies-list-crypto

Is the stock price change API showing percent change or dollar change?

down vote arrow

The stock price change API shows percent change.

Which subscription plan gives access to the economic calendar?

down vote arrow

The economic calendar API is available in the Premium and Ultimate plans. Here is a summary of the endpoints available across the different personal usage plans.

Why am I getting an error message about reaching the bandwidth limit and what should I do?

down vote arrow

The error message about reaching the bandwidth limit is due to our 30-day rolling monthly bandwidth limit to optimize system performance and ensure consistent service quality for all users. To resolve this, you can review your current API usage patterns, optimize your data querying methods, upgrade your plan to purchase additional data bandwidth, or reach out to our support team for assistance.

Do you provide a specific API endpoint for small, mini, and micro cap financial data?

down vote arrow

No, we do not provide a specific endpoint that returns this data. Our API offers a wide range of financial data, but specific categories like small, mini, and micro cap may not have dedicated endpoints.

Can I access SEC filings themselves through your API, not just the links?

down vote arrow

Yes, you can access SEC filings themselves through our API. For more information on how to do this, please refer to our documentation on SEC Filings: https://site.financialmodelingprep.com/developer/docs#sec-filings-securities-and-exchange-commission-(s.e.c)

Can I delete my payment method without losing API access?

down vote arrow

Yes, you can delete your payment method without losing API access. Your payment method is used for billing purposes only and does not affect your access to the API.

Do you provide Russell 2000 data through your API?

down vote arrow

Unfortunately, we do not provide Russell 2000 data at the moment. We only provide the constituents list for Dow Jones, Nasdaq, and S&P 500.

Do you provide country and regions exposure for bonds at a fund level?

down vote arrow

At the moment, we do not provide bonds data. However, for fund level data regarding region or country exposures, along with historical prices, we do offer ETF fund and country allocation data. If you are interested in commercial use of our data, please submit your information using the following link: https://site.financialmodelingprep.com/enterprise-contact

How does your company handle discrepancies in stock price data?

down vote arrow

Our company takes discrepancies in stock price data seriously. When discrepancies are reported, our development team investigates and fixes the issues promptly. We also continuously work on improving our data quality by running reliable daily verification loops on our dataset.

I am receiving a 401 error when using the API. What should I do?

down vote arrow

If you are receiving a 401 error when using our API, it typically means there is an issue with authentication. Please make sure you are using the correct API key and that it has not been exposed. If you are still experiencing issues, please reach out to our support team for further assistance.

Do you provide images of cryptocurrencies through your API?

down vote arrow

At the moment, we only provide images or logos for stocks and not for cryptocurrencies through our API.

Do you offer a deeper history of financial data beyond the 4-year income statements available for free users?

down vote arrow

Yes, we do offer a deeper history of financial data beyond the 4-year income statements available for free users. For more information on the depth of historical data available and which subscription plan provides access to it, please contact our sales team using the following link: https://site.financialmodelingprep.com/enterprise-contact

What are the differences between Legacy V1 and Stable APIs?

down vote arrow

The Legacy V1 and Stable APIs differ in terms of data availability and functionality. Legacy V1 APIs may have certain data that is not present in Stable APIs. Additionally, Stable APIs are designed to be more reliable and efficient. It's important to note that Legacy V1 services may be deprecated in the future, so we recommend transitioning to Stable APIs for long-term support.

How can I retrieve the prices of each stock by quarter using the API?

down vote arrow

You can use the historical price chart feature and filter for the days that correspond to the quarter you are interested in to retrieve the prices of each stock by quarter.

If I purchase the $20 a month plan for personal use but later decide to charge users for my software, will I be breaching non-commercial use policies?

down vote arrow

If you purchase our $20 a month plan for personal use and later decide to charge users for your software, you may be breaching our non-commercial use policies. We recommend reaching out to our account managers for further assistance and information regarding your specific situation.

Is the API key free to obtain for embedding data on my website? Does your company provide any WordPress plugin for integration?

down vote arrow

Thank you for your interest! To get more information about obtaining an API key and any available WordPress plugins for integration, please submit your information using the following link: https://site.financialmodelingprep.com/enterprise-contact

Does your API provide access to ETF net assets or AUM historical data?

down vote arrow

Yes, our API does provide access to ETF net assets and AUM historical data. You can find more information about this data in the ETF Information API documentation here: https://site.financialmodelingprep.com/developer/docs#etf-information-etf-holdings

How can I access historical float data for a specific ticker?

down vote arrow

You can access historical float data for a specific ticker by using the Historical shares float API provided by our company. Please visit the following link for more information: https://site.financialmodelingprep.com/developer/docs#company-historical-share-float. Please note that historical float data is available starting from 2021.

How do I get the industry information of tickers?

down vote arrow

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

Can I see the constituents of the OMXs30 index through your API?

down vote arrow

Unfortunately, we do not provide the constituents data for the OMXs30 index at the moment. However, you can find more information about the index in the Available Indexes API documentation.

Is there a limit to the number of websocket subscriptions I can have?

down vote arrow

For Premium plans, you can subscribe up to 100 symbols at one time. However, for Ultimate and Enterprise plans, you have unlimited symbols for websocket subscriptions. Additionally, WebSocket data does not count towards the 30 Day Bandwidth Consumption limit.

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