DOCSEARCHbyAlgolia
Submit Docs

Financial Modeling Prep API Documentation

repository·master·Indexed 20 days ago

https://github.com/financialmodelingprepapi/financial-modeling-prep-api

A comprehensive financial data API providing real-time and historical stock prices, financial statements (Income Statement, Balance Sheet, Cash Flow), and market fundamentals for over 25,000 stocks. Key features include SEC filings, earnings calendars, DCF valuations, stock screeners, and international financial filings from exchanges such as TSX, Euronext, and XETRA. Data is available in JSON and CSV formats with SDK support for Java, NodeJS, PHP, Python, C#, Go, Ruby, R, Rust, Scala, Strest, and Swift.

Tokens
9K
Snippets
42
Records
43
Agent score
21%

What's inside Financial Modeling Prep API

  1. Access EuroNext prices and historical data

    master

    The API provides endpoints specifically for EuroNext symbols, including real-time quotes and historical price data (including dividends and splits).

    https://financialmodelingprep.com/api/v3/symbol/available-euronext?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/quotes/euronext?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-price-full/stock_dividend/EDF.PA?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-price-full/stock_split/EDF.PA?apikey=YOUR_API_KEY

  3. Access TSX prices and historical data

    master

    Retrieve real-time quotes and historical data for the Toronto Stock Exchange (TSX), including dividend and split history.

    https://financialmodelingprep.com/api/v3/symbol/available-tsx?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/quotes/tsx?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-price-full/stock_dividend/FNV.TO?apikey=YOUR_API_KEY

  4. Register and obtain an API key

    master

    To use the API, follow these steps:

    1. Create an account: Register at financialmodelingprep.com/register.
    2. Confirm registration: Verify your email address via the link sent to your inbox.
    3. Select a plan: Choose from Free (default), Starter, Professional, or Enterprise plans.
    4. Retrieve API key: Visit the dashboard to find your unique apikey token.

    Important: Keep your API key secret. You must include it as a query parameter in every request using apikey=YOUR_API_KEY.

    https://financialmodelingprep.com/api/v3/income-statement/TSLA?apikey=YOUR_API_KEY

  5. Get started with Financial Modeling Prep API

    master

    The Financial Modeling Prep API provides real-time and historical financial data for over 25,000 stocks across multiple exchanges (U.S. market, XETRA, EURONEX, TSX, SEDAR, SEHK, etc.). Data is sourced from SEC filings and is available in JSON and CSV formats.

    Key features include:

    • Up to 30 years of historical data.
    • Earnings calendars and financial statements.
    • Real-time mode for critical endpoints.
    • Free tier available (up to 250 requests per day).
    https://financialmodelingprep.com/api/v3/income-statement/AAPL?limit=120&apikey=YOUR_API_KEY

  6. Access Stock News and Press Releases

    master

    Retrieve various types of news data:

    • FMP Articles: Articles written by FMP analysts (v4).
    • Stock News:
      • Multiple tickers: Use tickers=AAPL,FB,GOOG.
      • Single ticker: Use tickers=AAPL.
      • Latest news: Omit ticker parameter to get the latest general news.
    • Press Releases: Company-specific press releases.
    https://financialmodelingprep.com/api/v3/stock_news?tickers=AAPL,FB,GOOG,AMZN&limit=50&apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/press-releases/AAPL?limit=100&apikey=YOUR_API_KEY

  7. Get Forex exchange rates and historical prices

    master

    Retrieve real-time currency exchange rates, specific currency pair rates (e.g., EURUSD), all real-time forex prices, and historical data for available forex pairs at various intraday and daily intervals.

    https://financialmodelingprep.com/api/v3/fx?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/fx/EURUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/quotes/forex?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-chart/1min/JPYUSD?apikey=YOUR_API_KEY

  8. Search for Stocks and Companies

    master

    Search for financial instruments using tickers, company names, or specific exchanges.

    Search via Ticker and Name:

    • Endpoint: /api/v3/search?query={query}&limit={limit}&exchange={exchange}
    • Supported Exchanges: ETF, MUTUAL_FUND, COMMODITY, INDEX, CRYPTO, FOREX, TSX, AMEX, NASDAQ, NYSE, EURONEXT, XETRA, NSE, LSE.

    Search via Ticker Only:

    • Endpoint: /api/v3/search-ticker?query={query}&limit={limit}&exchange={exchange}
    https://financialmodelingprep.com/api/v3/search?query=AA&limit=10&exchange=NASDAQ&apikey=YOUR_API_KEY

  9. Get historical commodity prices

    master

    Retrieve historical commodity prices at various time intervals (1min, 5min, 15min, 30min, 1hour, 4hour) and full daily historical prices using the historical-chart and historical-price-full endpoints. Replace SYMBOL with the commodity symbol (e.g., ZGUSD) and YOUR_API_KEY with your actual API key.

    https://financialmodelingprep.com/api/v3/historical-chart/1min/ZGUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-chart/5min/ZGUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-chart/15min/ZGUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-chart/30min/ZGUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-chart/1hour/ZGUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-chart/4hour/ZGUSD?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/historical-price-full/ZGUSD?apikey=YOUR_API_KEY

  10. Retrieve Company Profile and Executive Information

    master

    Access fundamental company data using the company symbol.

    • Company Profile: Returns general company information.
    • Key Executives: Returns a list of company executives.
    • Market Capitalization: Returns current market cap. Use the historical-market-capitalization endpoint for daily historical data.
    • Company Outlook: Returns company outlook data (v4).
    • Stock Peers: Returns peer companies based on sector, exchange, and market cap (v4).
    https://financialmodelingprep.com/api/v3/profile/AAPL?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/key-executives/AAPL?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v3/market-capitalization/AAPL?apikey=YOUR_API_KEY
https://financialmodelingprep.com/api/v4/company-outlook?symbol=AAPL&apikey=YOUR_API_KEY

  11. Analyze Stock Fundamentals and Ratios

    master

    Perform deep fundamental analysis using various financial metrics.

    Key Metrics & Ratios:

    • TTM Ratios: /api/v3/ratios-ttm/{symbol}
    • Financial Ratios: /api/v3/ratios/{symbol} (supports period=quarter and limit).
    • Key Metrics (TTM): /api/v3/key-metrics-ttm/{symbol}
    • Key Metrics (Annual/Quarterly): /api/v3/key-metrics/{symbol}.

    Growth Metrics:

    • Income Statement Growth: /api/v3/income-statement-growth/{symbol}
    • Balance Sheet Growth: /api/v3/balance-sheet-statement-growth/{symbol}
    • Cash Flow Growth: /api/v3/cash-flow-statement-growth/{symbol}
    • General Financial Growth: /api/v3/financial-growth/{symbol}.

    Valuation & Enterprise Value:

    • Enterprise Value: /api/v3/enterprise-values/{symbol} (supports period=quarter).
    • Discounted Cash Flow (DCF): /api/v3/discounted-cash-flow/{symbol} (Real-time intrinsic value).
    • Historical DCF: /api/v3/historical-discounted-cash-flow-statement/{symbol} (Supports period=quarter or daily via /api/v3/historical-daily-discounted-cash-flow/{symbol}).
    https://financialmodelingprep.com/api/v3/ratios/AAPL?period=quarter&limit=140&apikey=YOUR_API_KEY

  12. Get fund holdings (ETF, Institutional, and Mutual Fund)

    master

    Access data regarding who holds specific assets or what assets companies hold.

    • ETF Holders: List of holders for a specific ETF.
    • Institutional Holders: List of institutional holders for a company.
    • Mutual Fund Holders: List of mutual fund holders for a company.
    • ETF Sector/Country Weightings: Weightings of sectors or countries within an ETF.
    // ETF holders
https://financialmodelingprep.com/api/v3/etf-holder/SPY?apikey=YOUR_API_KEY

// Institutional holders
https://financialmodelingprep.com/api/v3/institutional-holder/AAPL?apikey=YOUR_API_KEY

// ETF Sector Weightings
https://financialmodelingprep.com/api/v3/etf-sector-weightings/SPY?apikey=YOUR_API_KEY