# Financial Modeling Prep > Get stock market and company data from Financial Modeling Prep: a company's profile, peers and latest price, price history, income statements, balance sheets and cash flows, key metrics, ratios and scores, a DCF valuation, analysts' ratings, consensus and price targets, earnings and dividends, the day's market movers and sector performance, market hours and holidays, treasury rates, FMP's articles, SEC filings and, on paid plans, company news and insider trades. Needs a free Financial Modeling Prep API key. App · Accounting & Finance · 27 actions. Web page: https://docs.lodol.com/docs/integrations/financial-modeling-prep ## Actions ### Get analyst consensus Get how many analysts rate a stock a strong buy, buy, hold, sell or strong sell, and the consensus those make. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `analyst_count` (number): How many analysts rated it in all - `buy` (number): How many rate it a buy - `consensus` (text): The consensus, e.g. Buy or Hold - `hold` (number): How many rate it a hold - `sell` (number): How many rate it a sell - `strong_buy` (number): How many analysts rate it a strong buy - `strong_sell` (number): How many rate it a strong sell - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "analyst_count": 111, "buy": 70, "consensus": "Buy", "hold": 32, "sell": 8, "strong_buy": 1, "strong_sell": 0, "symbol": "AAPL" } ``` ### Get balance sheet Get a company's balance sheets, newest first: cash, current and total assets, liabilities, debt and equity at the end of each year or quarter, with every line under FMP's own names. The free plan returns 5 annual statements of a US company. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Period (`period`, text): Annual figures (fiscal years) or quarterly ones. The free plan only has annual figures; quarters need a paid plan. One of: `annual`, `quarter` (Quarterly). Default: `annual`. - Maximum periods (`limit`, number): How many periods to return, newest first. Leave blank for 5, which is the most the free plan returns; paid plans go back up to 30 years. At least 1. **Outputs** - `latest` (object): The newest one - `period` (text): annual or quarter - `statement_count` (number): How many statements there are - `statements` (list): The balance sheets, newest first - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "latest": { "all_fields": { "acceptedDate": "2025-10-31 06:01:26", "accountPayables": 69860000000, "accountsReceivables": 39777000000, "accruedExpenses": 8919000000, "accumulatedOtherComprehensiveIncomeLoss": -5571000000, "additionalPaidInCapital": 0, "capitalLeaseObligations": 13720000000, "capitalLeaseObligationsCurrent": 2117000000, "capitalLeaseObligationsNonCurrent": 11603000000, "cashAndCashEquivalents": 35934000000, "cashAndShortTermInvestments": 54697000000, "cik": "0000320193", "commonStock": 93568000000, "date": "2025-09-27", "deferredRevenue": 9055000000, "deferredRevenueNonCurrent": 0, "deferredTaxLiabilitiesNonCurrent": 0, "filingDate": "2025-10-31", "fiscalYear": "2025", "goodwill": 0, "goodwillAndIntangibleAssets": 0, "intangibleAssets": 0, "inventory": 5718000000, "longTermDebt": 78328000000, "longTermInvestments": 77723000000, "minorityInterest": 0, "netDebt": 76443000000, "netReceivables": 72957000000, "otherAssets": 0, "otherCurrentAssets": 14585000000, "otherCurrentLiabilities": 42335000000, "otherLiabilities": 0, "otherNonCurrentAssets": 62950000000, "otherNonCurrentLiabilities": 29946000000, "otherPayables": 13016000000, "otherReceivables": 33180000000, "otherTotalStockholdersEquity": 0, "period": "FY", "preferredStock": 0, "prepaids": 0, "propertyPlantEquipmentNet": 49834000000, "reportedCurrency": "USD", "retainedEarnings": -14264000000, "shortTermDebt": 20329000000, "shortTermInvestments": 18763000000, "symbol": "AAPL", "taxAssets": 20777000000, "taxPayables": 0, "totalAssets": 359241000000, "totalCurrentAssets": 147957000000, "totalCurrentLiabilities": 165631000000, "totalDebt": 112377000000, "totalEquity": 73733000000, "totalInvestments": 96486000000, "totalLiabilities": 285508000000, "totalLiabilitiesAndTotalEquity": 359241000000, "totalNonCurrentAssets": 211284000000, "totalNonCurrentLiabilities": 119877000000, "totalPayables": 82876000000, "totalStockholdersEquity": 73733000000, "treasuryStock": 0 }, "cash_and_equivalents": 35934000000, "cash_and_short_term_investments": 54697000000, "currency": "USD", "date": "2025-09-27", "filing_date": "2025-10-31", "fiscal_year": "2025", "long_term_debt": 78328000000, "net_debt": 76443000000, "period": "FY", "retained_earnings": -14264000000, "total_assets": 359241000000, "total_current_assets": 147957000000, "total_current_liabilities": 165631000000, "total_debt": 112377000000, "total_equity": 73733000000, "total_liabilities": 285508000000 }, "period": "annual", "statement_count": 2, "statements": [ { "all_fields": { "acceptedDate": "2025-10-31 06:01:26", "accountPayables": 69860000000, "accountsReceivables": 39777000000, "accruedExpenses": 8919000000, "accumulatedOtherComprehensiveIncomeLoss": -5571000000, "additionalPaidInCapital": 0, "capitalLeaseObligations": 13720000000, "capitalLeaseObligationsCurrent": 2117000000, "capitalLeaseObligationsNonCurrent": 11603000000, "cashAndCashEquivalents": 35934000000, "cashAndShortTermInvestments": 54697000000, "cik": "0000320193", "commonStock": 93568000000, "date": "2025-09-27", "deferredRevenue": 9055000000, "deferredRevenueNonCurrent": 0, "deferredTaxLiabilitiesNonCurrent": 0, "filingDate": "2025-10-31", "fiscalYear": "2025", "goodwill": 0, "goodwillAndIntangibleAssets": 0, "intangibleAssets": 0, "inventory": 5718000000, "longTermDebt": 78328000000, "longTermInvestments": 77723000000, "minorityInterest": 0, "netDebt": 76443000000, "netReceivables": 72957000000, "otherAssets": 0, "otherCurrentAssets": 14585000000, "otherCurrentLiabilities": 42335000000, "otherLiabilities": 0, "otherNonCurrentAssets": 62950000000, "otherNonCurrentLiabilities": 29946000000, "otherPayables": 13016000000, "otherReceivables": 33180000000, "otherTotalStockholdersEquity": 0, "period": "FY", "preferredStock": 0, "prepaids": 0, "propertyPlantEquipmentNet": 49834000000, "reportedCurrency": "USD", "retainedEarnings": -14264000000, "shortTermDebt": 20329000000, "shortTermInvestments": 18763000000, "symbol": "AAPL", "taxAssets": 20777000000, "taxPayables": 0, "totalAssets": 359241000000, "totalCurrentAssets": 147957000000, "totalCurrentLiabilities": 165631000000, "totalDebt": 112377000000, "totalEquity": 73733000000, "totalInvestments": 96486000000, "totalLiabilities": 285508000000, "totalLiabilitiesAndTotalEquity": 359241000000, "totalNonCurrentAssets": 211284000000, "totalNonCurrentLiabilities": 119877000000, "totalPayables": 82876000000, "totalStockholdersEquity": 73733000000, "treasuryStock": 0 }, "cash_and_equivalents": 35934000000, "cash_and_short_term_investments": 54697000000, "currency": "USD", "date": "2025-09-27", "filing_date": "2025-10-31", "fiscal_year": "2025", "long_term_debt": 78328000000, "net_debt": 76443000000, "period": "FY", "retained_earnings": -14264000000, "total_assets": 359241000000, "total_current_assets": 147957000000, "total_current_liabilities": 165631000000, "total_debt": 112377000000, "total_equity": 73733000000, "total_liabilities": 285508000000 }, { "all_fields": { "acceptedDate": "2024-10-31 06:01:26", "accountPayables": 69860000000, "accountsReceivables": 39777000000, "accruedExpenses": 8919000000, "accumulatedOtherComprehensiveIncomeLoss": -5571000000, "additionalPaidInCapital": 0, "capitalLeaseObligations": 13720000000, "capitalLeaseObligationsCurrent": 2117000000, "capitalLeaseObligationsNonCurrent": 11603000000, "cashAndCashEquivalents": 33777960000, "cashAndShortTermInvestments": 54697000000, "cik": "0000320193", "commonStock": 93568000000, "date": "2024-09-27", "deferredRevenue": 9055000000, "deferredRevenueNonCurrent": 0, "deferredTaxLiabilitiesNonCurrent": 0, "filingDate": "2024-10-31", "fiscalYear": "2024", "goodwill": 0, "goodwillAndIntangibleAssets": 0, "intangibleAssets": 0, "inventory": 5718000000, "longTermDebt": 78328000000, "longTermInvestments": 77723000000, "minorityInterest": 0, "netDebt": 76443000000, "netReceivables": 72957000000, "otherAssets": 0, "otherCurrentAssets": 14585000000, "otherCurrentLiabilities": 42335000000, "otherLiabilities": 0, "otherNonCurrentAssets": 62950000000, "otherNonCurrentLiabilities": 29946000000, "otherPayables": 13016000000, "otherReceivables": 33180000000, "otherTotalStockholdersEquity": 0, "period": "FY", "preferredStock": 0, "prepaids": 0, "propertyPlantEquipmentNet": 49834000000, "reportedCurrency": "USD", "retainedEarnings": -14264000000, "shortTermDebt": 20329000000, "shortTermInvestments": 18763000000, "symbol": "AAPL", "taxAssets": 20777000000, "taxPayables": 0, "totalAssets": 337686540000, "totalCurrentAssets": 147957000000, "totalCurrentLiabilities": 165631000000, "totalDebt": 112377000000, "totalEquity": 73733000000, "totalInvestments": 96486000000, "totalLiabilities": 268377520000, "totalLiabilitiesAndTotalEquity": 359241000000, "totalNonCurrentAssets": 211284000000, "totalNonCurrentLiabilities": 119877000000, "totalPayables": 82876000000, "totalStockholdersEquity": 69309020000, "treasuryStock": 0 }, "cash_and_equivalents": 33777960000, "cash_and_short_term_investments": 54697000000, "currency": "USD", "date": "2024-09-27", "filing_date": "2024-10-31", "fiscal_year": "2024", "long_term_debt": 78328000000, "net_debt": 76443000000, "period": "FY", "retained_earnings": -14264000000, "total_assets": 337686540000, "total_current_assets": 147957000000, "total_current_liabilities": 165631000000, "total_debt": 112377000000, "total_equity": 69309020000, "total_liabilities": 268377520000 } ], "symbol": "AAPL" } ``` ### Get cash flow statement Get a company's cash flow statements, newest first: cash from operations, investing and financing, capital expenditure, free cash flow, dividends and buybacks for each year or quarter, with every line under FMP's own names. The free plan returns 5 annual statements of a US company. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Period (`period`, text): Annual figures (fiscal years) or quarterly ones. The free plan only has annual figures; quarters need a paid plan. One of: `annual`, `quarter` (Quarterly). Default: `annual`. - Maximum periods (`limit`, number): How many periods to return, newest first. Leave blank for 5, which is the most the free plan returns; paid plans go back up to 30 years. At least 1. **Outputs** - `latest` (object): The newest one - `period` (text): annual or quarter - `statement_count` (number): How many statements there are - `statements` (list): The cash flow statements, newest first - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "latest": { "all_fields": { "acceptedDate": "2025-10-31 06:01:26", "accountsPayables": 902000000, "accountsReceivables": -7029000000, "acquisitionsNet": 0, "capitalExpenditure": -12715000000, "cashAtBeginningOfPeriod": 29943000000, "cashAtEndOfPeriod": 35934000000, "changeInWorkingCapital": -25000000000, "cik": "0000320193", "commonDividendsPaid": -15421000000, "commonStockIssuance": 0, "commonStockRepurchased": -90711000000, "date": "2025-09-27", "deferredIncomeTax": 0, "depreciationAndAmortization": 11698000000, "effectOfForexChangesOnCash": 0, "filingDate": "2025-10-31", "fiscalYear": "2025", "freeCashFlow": 98767000000, "incomeTaxesPaid": 43369000000, "interestPaid": 0, "inventory": 1400000000, "investmentsInPropertyPlantAndEquipment": -12715000000, "longTermNetDebtIssuance": -6451000000, "netCashProvidedByFinancingActivities": -120686000000, "netCashProvidedByInvestingActivities": 15195000000, "netCashProvidedByOperatingActivities": 111482000000, "netChangeInCash": 5991000000, "netCommonStockIssuance": -90711000000, "netDebtIssuance": -8483000000, "netDividendsPaid": -15421000000, "netIncome": 112010000000, "netPreferredStockIssuance": 0, "netStockIssuance": -90711000000, "operatingCashFlow": 111482000000, "otherFinancingActivities": -6071000000, "otherInvestingActivities": -1480000000, "otherNonCashItems": -89000000, "otherWorkingCapital": -20273000000, "period": "FY", "preferredDividendsPaid": 0, "purchasesOfInvestments": -24407000000, "reportedCurrency": "USD", "salesMaturitiesOfInvestments": 53797000000, "shortTermNetDebtIssuance": -2032000000, "stockBasedCompensation": 12863000000, "symbol": "AAPL" }, "capital_expenditure": -12715000000, "cash_at_end_of_period": 35934000000, "currency": "USD", "date": "2025-09-27", "dividends_paid": -15421000000, "filing_date": "2025-10-31", "financing_cash_flow": -120686000000, "fiscal_year": "2025", "free_cash_flow": 98767000000, "investing_cash_flow": 15195000000, "net_change_in_cash": 5991000000, "net_income": 112010000000, "operating_cash_flow": 111482000000, "period": "FY", "stock_repurchased": -90711000000 }, "period": "annual", "statement_count": 2, "statements": [ { "all_fields": { "acceptedDate": "2025-10-31 06:01:26", "accountsPayables": 902000000, "accountsReceivables": -7029000000, "acquisitionsNet": 0, "capitalExpenditure": -12715000000, "cashAtBeginningOfPeriod": 29943000000, "cashAtEndOfPeriod": 35934000000, "changeInWorkingCapital": -25000000000, "cik": "0000320193", "commonDividendsPaid": -15421000000, "commonStockIssuance": 0, "commonStockRepurchased": -90711000000, "date": "2025-09-27", "deferredIncomeTax": 0, "depreciationAndAmortization": 11698000000, "effectOfForexChangesOnCash": 0, "filingDate": "2025-10-31", "fiscalYear": "2025", "freeCashFlow": 98767000000, "incomeTaxesPaid": 43369000000, "interestPaid": 0, "inventory": 1400000000, "investmentsInPropertyPlantAndEquipment": -12715000000, "longTermNetDebtIssuance": -6451000000, "netCashProvidedByFinancingActivities": -120686000000, "netCashProvidedByInvestingActivities": 15195000000, "netCashProvidedByOperatingActivities": 111482000000, "netChangeInCash": 5991000000, "netCommonStockIssuance": -90711000000, "netDebtIssuance": -8483000000, "netDividendsPaid": -15421000000, "netIncome": 112010000000, "netPreferredStockIssuance": 0, "netStockIssuance": -90711000000, "operatingCashFlow": 111482000000, "otherFinancingActivities": -6071000000, "otherInvestingActivities": -1480000000, "otherNonCashItems": -89000000, "otherWorkingCapital": -20273000000, "period": "FY", "preferredDividendsPaid": 0, "purchasesOfInvestments": -24407000000, "reportedCurrency": "USD", "salesMaturitiesOfInvestments": 53797000000, "shortTermNetDebtIssuance": -2032000000, "stockBasedCompensation": 12863000000, "symbol": "AAPL" }, "capital_expenditure": -12715000000, "cash_at_end_of_period": 35934000000, "currency": "USD", "date": "2025-09-27", "dividends_paid": -15421000000, "filing_date": "2025-10-31", "financing_cash_flow": -120686000000, "fiscal_year": "2025", "free_cash_flow": 98767000000, "investing_cash_flow": 15195000000, "net_change_in_cash": 5991000000, "net_income": 112010000000, "operating_cash_flow": 111482000000, "period": "FY", "stock_repurchased": -90711000000 }, { "all_fields": { "acceptedDate": "2024-10-31 06:01:26", "accountsPayables": 902000000, "accountsReceivables": -7029000000, "acquisitionsNet": 0, "capitalExpenditure": -12715000000, "cashAtBeginningOfPeriod": 29943000000, "cashAtEndOfPeriod": 35934000000, "changeInWorkingCapital": -25000000000, "cik": "0000320193", "commonDividendsPaid": -15421000000, "commonStockIssuance": 0, "commonStockRepurchased": -90711000000, "date": "2024-09-27", "deferredIncomeTax": 0, "depreciationAndAmortization": 11698000000, "effectOfForexChangesOnCash": 0, "filingDate": "2024-10-31", "fiscalYear": "2024", "freeCashFlow": 92840980000, "incomeTaxesPaid": 43369000000, "interestPaid": 0, "inventory": 1400000000, "investmentsInPropertyPlantAndEquipment": -12715000000, "longTermNetDebtIssuance": -6451000000, "netCashProvidedByFinancingActivities": -120686000000, "netCashProvidedByInvestingActivities": 15195000000, "netCashProvidedByOperatingActivities": 111482000000, "netChangeInCash": 5991000000, "netCommonStockIssuance": -90711000000, "netDebtIssuance": -8483000000, "netDividendsPaid": -15421000000, "netIncome": 105289400000, "netPreferredStockIssuance": 0, "netStockIssuance": -90711000000, "operatingCashFlow": 104793080000, "otherFinancingActivities": -6071000000, "otherInvestingActivities": -1480000000, "otherNonCashItems": -89000000, "otherWorkingCapital": -20273000000, "period": "FY", "preferredDividendsPaid": 0, "purchasesOfInvestments": -24407000000, "reportedCurrency": "USD", "salesMaturitiesOfInvestments": 53797000000, "shortTermNetDebtIssuance": -2032000000, "stockBasedCompensation": 12863000000, "symbol": "AAPL" }, "capital_expenditure": -12715000000, "cash_at_end_of_period": 35934000000, "currency": "USD", "date": "2024-09-27", "dividends_paid": -15421000000, "filing_date": "2024-10-31", "financing_cash_flow": -120686000000, "fiscal_year": "2024", "free_cash_flow": 92840980000, "investing_cash_flow": 15195000000, "net_change_in_cash": 5991000000, "net_income": 105289400000, "operating_cash_flow": 104793080000, "period": "FY", "stock_repurchased": -90711000000 } ], "symbol": "AAPL" } ``` ### Get company peers Get the companies most like one company: on the same exchange, in the same sector and of a similar size, each with its name, price and market cap. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `peer_count` (number): How many peers there are - `peers` (list): The peers, as FMP ranks them - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "peer_count": 3, "peers": [ { "market_cap": 4040168831718, "name": "Alphabet Inc.", "price": 333.84, "symbol": "GOOGL" }, { "market_cap": 3866000000000, "name": "Microsoft Corporation", "price": 520.12, "symbol": "MSFT" }, { "market_cap": 4650000000000, "name": "NVIDIA Corporation", "price": 190.55, "symbol": "NVDA" } ], "symbol": "AAPL" } ``` ### Get company profile Get a company's name, description, sector, industry, exchange, country, chief executive, employees, website, address, identifiers, IPO date, latest price, market cap, beta, volume, 52-week range and logo. The free plan covers companies listed in the US. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `address` (text): Its street address - `average_volume` (number): Shares traded on an average day - `beta` (number): Beta: how much the price moves with the market - `ceo` (text): Its chief executive - `change` (number): How much the price moved since the previous close - `cik` (text): Its SEC CIK number - `city` (text): Its city - `country` (text): The two-letter code of the country of its headquarters - `currency` (text): The currency its figures are in, e.g. USD - `cusip` (text): Its CUSIP - `description` (text): What the company does - `employees` (number): How many full-time employees it has - `exchange` (text): The exchange's code, e.g. NASDAQ - `exchange_name` (text): The exchange's name - `industry` (text): Its industry, e.g. Consumer Electronics - `ipo_date` (text): When it went public, YYYY-MM-DD - `is_actively_trading` (true/false): True while it still trades - `is_adr` (true/false): True when it is an American depositary receipt - `is_etf` (true/false): True when the symbol is an ETF - `is_fund` (true/false): True when it is a fund - `isin` (text): Its ISIN - `last_dividend` (number): The last dividend paid per share, over a year - `logo_url` (text): A link to its logo - `market_cap` (number): Its market capitalization, in its currency - `name` (text): The company's name - `percent_change` (number): That move as a percentage - `phone` (text): Its phone number - `price` (number): The latest share price - `sector` (text): Its sector, e.g. Technology - `state` (text): Its state or region - `symbol` (text): The stock symbol, e.g. AAPL - `volume` (number): Shares traded today - `website` (text): Its website - `week_52_high` (number): The highest price in the last 52 weeks - `week_52_low` (number): The lowest price in the last 52 weeks - `zip` (text): Its postal code **Example output** ```json { "address": "One Apple Park Way", "average_volume": 55309000, "beta": 1.097, "ceo": "Timothy D. Cook", "change": -6.33498, "cik": "0000320193", "city": "Cupertino", "country": "US", "currency": "USD", "cusip": "037833100", "description": "Apple Inc. is a global technology corporation that specializes in the conceptualization, production, and sale of a diverse suite of electronic devices. Its comprehensive hardware lineup features the well-known iPhone smartphones, Mac personal computers, and versatile iPad tablets. The company also supplies a range of wearables, smart home products, and accessories, including AirPods, Apple TV, Apple Watch, items from the Beats brand, and HomePod speakers. Beyond its device offerings, Apple deliv...", "employees": 166000, "exchange": "NASDAQ", "exchange_name": "NASDAQ Global Select", "industry": "Consumer Electronics", "ipo_date": "1980-12-12", "is_actively_trading": true, "is_adr": false, "is_etf": false, "is_fund": false, "isin": "US0378331005", "last_dividend": 1.05, "logo_url": "https://images.financialmodelingprep.com/symbol/AAPL.png", "market_cap": 4874072686740, "name": "Apple Inc.", "percent_change": -1.8732, "phone": "(408) 996-1010", "price": 331.85501, "sector": "Technology", "state": "CA", "symbol": "AAPL", "volume": 28718014, "website": "https://www.apple.com", "week_52_high": 344.57, "week_52_low": 201.5, "zip": "95014" } ``` ### Get DCF valuation Get FMP's discounted cash flow value of a share, against the share price, and whether that makes the stock undervalued. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `date` (text): The day of the valuation, YYYY-MM-DD - `dcf_value` (number): The discounted cash flow value per share - `is_undervalued` (true/false): True when the DCF value is above the price - `price` (number): The share price it was compared with - `symbol` (text): The stock symbol, e.g. AAPL - `upside_percent` (number): How far the DCF value sits above the price, as a percentage; negative when below **Example output** ```json { "date": "2026-07-30", "dcf_value": 147.10881272667325, "is_undervalued": false, "price": 338.19, "symbol": "AAPL", "upside_percent": -56.5011 } ``` ### Get dividends Get a company's dividends, newest first, each with its ex-dividend, record, payment and declaration dates, amount per share, yield and how often it is paid. The free plan returns 5 dividends. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Maximum dividends (`limit`, number): How many dividends to return, newest first. Leave blank for 5, which is the most the free plan returns. At least 1. **Outputs** - `dividend_count` (number): How many there are - `dividends` (list): The dividends, newest first - `latest` (object): The newest one - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "dividend_count": 3, "dividends": [ { "adjusted_dividend": 0.27, "declaration_date": "2026-07-30", "dividend": 0.27, "ex_date": "2026-08-10", "frequency": "Quarterly", "payment_date": "2026-08-13", "record_date": "2026-08-10", "yield_percent": 0.3587535875358754 }, { "adjusted_dividend": 0.27, "declaration_date": "2026-04-30", "dividend": 0.27, "ex_date": "2026-05-11", "frequency": "Quarterly", "payment_date": "2026-05-14", "record_date": "2026-05-11", "yield_percent": 0.36 }, { "adjusted_dividend": 0.26, "declaration_date": "2026-01-29", "dividend": 0.26, "ex_date": "2026-02-09", "frequency": "Quarterly", "payment_date": "2026-02-12", "record_date": "2026-02-09", "yield_percent": 0.41 } ], "latest": { "adjusted_dividend": 0.27, "declaration_date": "2026-07-30", "dividend": 0.27, "ex_date": "2026-08-10", "frequency": "Quarterly", "payment_date": "2026-08-13", "record_date": "2026-08-10", "yield_percent": 0.3587535875358754 }, "symbol": "AAPL" } ``` ### Get earnings Get a company's earnings dates, newest first, upcoming ones included: the EPS and revenue reported against what analysts expected, whether it beat the estimate, the next report to come and the latest one out. The free plan returns 5 dates. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Maximum reports (`limit`, number): How many earnings dates to return, newest first, upcoming ones included. Leave blank for 5, which is the most the free plan returns. At least 1. **Outputs** - `latest_reported` (object): The most recent results, if any - `next_report` (object): The next report still to come, if any - `report_count` (number): How many there are - `reports` (list): The earnings dates, newest first - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "latest_reported": { "beat_estimate": true, "date": "2026-07-30", "eps_actual": 1.97, "eps_estimated": 1.88, "eps_surprise": 0.09, "eps_surprise_percent": 4.7872, "last_updated": "2026-07-31", "reported": true, "revenue_actual": 112800000000, "revenue_estimated": 109038900000, "revenue_surprise": 3761100000, "symbol": "AAPL" }, "next_report": { "beat_estimate": null, "date": "2026-10-29", "eps_actual": null, "eps_estimated": 1.88, "eps_surprise": null, "eps_surprise_percent": null, "last_updated": "2026-10-08", "reported": false, "revenue_actual": null, "revenue_estimated": 109038900000, "revenue_surprise": null, "symbol": "AAPL" }, "report_count": 5, "reports": [ { "beat_estimate": null, "date": "2027-01-28", "eps_actual": null, "eps_estimated": 2.61, "eps_surprise": null, "eps_surprise_percent": null, "last_updated": "2026-10-08", "reported": false, "revenue_actual": null, "revenue_estimated": 141200000000, "revenue_surprise": null, "symbol": "AAPL" }, { "beat_estimate": null, "date": "2026-10-29", "eps_actual": null, "eps_estimated": 1.88, "eps_surprise": null, "eps_surprise_percent": null, "last_updated": "2026-10-08", "reported": false, "revenue_actual": null, "revenue_estimated": 109038900000, "revenue_surprise": null, "symbol": "AAPL" }, { "beat_estimate": true, "date": "2026-07-30", "eps_actual": 1.97, "eps_estimated": 1.88, "eps_surprise": 0.09, "eps_surprise_percent": 4.7872, "last_updated": "2026-07-31", "reported": true, "revenue_actual": 112800000000, "revenue_estimated": 109038900000, "revenue_surprise": 3761100000, "symbol": "AAPL" }, { "beat_estimate": true, "date": "2026-04-30", "eps_actual": 1.65, "eps_estimated": 1.62, "eps_surprise": 0.03, "eps_surprise_percent": 1.8519, "last_updated": "2026-05-01", "reported": true, "revenue_actual": 95400000000, "revenue_estimated": 94600000000, "revenue_surprise": 800000000, "symbol": "AAPL" }, { "beat_estimate": false, "date": "2026-01-29", "eps_actual": 2.4, "eps_estimated": 2.45, "eps_surprise": -0.05, "eps_surprise_percent": -2.0408, "last_updated": "2026-01-30", "reported": true, "revenue_actual": 124300000000, "revenue_estimated": 124800000000, "revenue_surprise": -500000000, "symbol": "AAPL" } ], "symbol": "AAPL" } ``` ### Get earnings calendar Get every company reporting earnings between two dates, worldwide, with the expected and reported EPS and revenue. Covers the next 7 days unless you set dates; the free plan goes back a month. **Inputs** - Start date (`start_date`, date): The first day to include. Leave blank for today. The free plan goes back a month. - End date (`end_date`, date): The last day to include. Leave blank for 7 days after the start date. **Outputs** - `end_date` (text): The last day covered, YYYY-MM-DD - `release_count` (number): How many releases there are - `releases` (list): The earnings releases, in date order - `start_date` (text): The first day covered, YYYY-MM-DD **Example output** ```json { "end_date": "2026-10-16", "release_count": 3, "releases": [ { "beat_estimate": true, "date": "2026-10-09", "eps_actual": 2.29, "eps_estimated": 2.26, "eps_surprise": 0.03, "eps_surprise_percent": 1.3274, "last_updated": "2026-10-09", "reported": true, "revenue_actual": 23900000000, "revenue_estimated": 23800000000, "revenue_surprise": 100000000, "symbol": "PEP" }, { "beat_estimate": null, "date": "2026-10-13", "eps_actual": null, "eps_estimated": 4.62, "eps_surprise": null, "eps_surprise_percent": null, "last_updated": "2026-10-08", "reported": false, "revenue_actual": null, "revenue_estimated": 45100000000, "revenue_surprise": null, "symbol": "JPM" }, { "beat_estimate": null, "date": "2026-10-14", "eps_actual": null, "eps_estimated": 0.501, "eps_surprise": null, "eps_surprise_percent": null, "last_updated": "2026-10-08", "reported": false, "revenue_actual": null, "revenue_estimated": 1086300000, "revenue_surprise": null, "symbol": "GRG.L" } ], "start_date": "2026-10-09" } ``` ### Get financial ratios Get a company's ratios for each year or quarter, newest first: gross, operating and net margins, P/E, PEG, price to book and to sales, dividend yield and payout, debt to equity, current and quick ratios, and per-share figures, plus every other ratio FMP has. The free plan returns 5 annual periods of a US company. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Period (`period`, text): Annual figures (fiscal years) or quarterly ones. The free plan only has annual figures; quarters need a paid plan. One of: `annual`, `quarter` (Quarterly). Default: `annual`. - Maximum periods (`limit`, number): How many periods to return, newest first. Leave blank for 5, which is the most the free plan returns; paid plans go back up to 30 years. At least 1. **Outputs** - `latest` (object): The newest one - `period` (text): annual or quarter - `ratio_count` (number): How many ratios there are - `ratios` (list): The ratios for each period, newest first - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "latest": { "all_ratios": { "acceptedDate": "2025-10-31 06:01:26", "assetTurnover": 1.1584451663368045, "bookValuePerShare": 4.932468140616115, "bottomLineProfitMargin": 0.2691506412181824, "capexPerShare": 0.8505870154196074, "capitalExpenditureCoverageRatio": 8.767754620526937, "cashPerShare": 3.6590293340468945, "cashRatio": 0.21695214060169896, "continuousOperationsProfitMargin": 0.2691506412181824, "currentRatio": 0.8932929222186667, "date": "2025-09-27", "debtServiceCoverageRatio": 6.085296866545329, "debtToAssetsRatio": 0.3128178576498785, "debtToCapitalRatio": 0.6038203213153511, "debtToEquityRatio": 1.5241072518411023, "debtToMarketCap": 0.02583493549414094, "dividendPaidAndCapexCoverageRatio": 3.962254762581746, "dividendPayoutRatio": 0.1376752075707526, "dividendPerShare": 1.0316085225942402, "dividendYield": 0.004038238951672435, "dividendYieldPercentage": 0.4038238951672435, "ebitMargin": 0.3189366615324358, "ebitdaMargin": 0.34704597499525425, "ebtPerEbit": 0.997587373167982, "effectiveTaxRate": 0.15610002335586043, "enterpriseValueMultiple": 26.969935053694947, "filingDate": "2025-10-31", "financialLeverageRatio": 4.8721874872852045, "fiscalYear": "2025", "fixedAssetTurnover": 8.350945137857687, "forwardPriceToEarningsGrowthRatio": 1.5100913295021379, "freeCashFlowOperatingCashFlowRatio": 0.8859457132093074, "freeCashFlowPerShare": 6.607151219185871, "grossProfitMargin": 0.4691, "interestCoverageRatio": 0, "interestDebtPerShare": 7.51761046258822, "inventoryTurnover": 38.6428821266177, "longTermDebtToCapitalRatio": 0.5151090680713661, "netIncomePerEBT": 0.8438999766441395, "netIncomePerShare": 7.49305950429809, "netProfitMargin": 0.2692, "operatingCashFlowCoverageRatio": 0.9920357368500672, "operatingCashFlowPerShare": 7.457738234605479, "operatingCashFlowRatio": 0.6730744848488508, "operatingCashFlowSalesRatio": 0.26788190147563085, "operatingProfitMargin": 0.31970799762591884, "payablesTurnover": 3.1628972230174637, "period": "FY", "pretaxProfitMargin": 0.3189366615324358, "priceToBookRatio": 51.79151546797228, "priceToEarningsDilutedGrowthRatio": 1.5087197420056728, "priceToEarningsDilutedRatio": 34.243967828418235, "priceToEarningsGrowthRatio": 1.5100913295021379, "priceToEarningsRatio": 34.1068, "priceToFairValue": 51.79151546797228, "priceToFreeCashFlowRatio": 38.66416728259439, "priceToOperatingCashFlowRatio": 34.25435325882205, "priceToSalesRatio": 9.176121284791222, "quickRatio": 0.858770399261008, "receivablesTurnover": 5.704195622078759, "reportedCurrency": "USD", "revenuePerShare": 27.83964946315684, "shareholdersEquityPerShare": 4.932468140616115, "shortTermOperatingCashFlowCoverageRatio": 5.483890009346254, "solvencyRatio": 0.43329083598358015, "symbol": "AAPL", "tangibleBookValuePerShare": 4.932468140616115, "workingCapitalTurnoverRatio": -20.261496141580857 }, "asset_turnover": 1.1584451663368045, "book_value_per_share": 4.932468140616115, "cash_ratio": 0.21695214060169896, "currency": "USD", "current_ratio": 0.8932929222186667, "date": "2025-09-27", "debt_to_assets": 0.3128178576498785, "debt_to_equity": 1.5241072518411023, "dividend_payout_percent": 13.7675, "dividend_per_share": 1.0316085225942402, "dividend_yield_percent": 0.4038238951672435, "ebitda_margin_percent": 34.7046, "effective_tax_rate_percent": 15.61, "eps": 7.49305950429809, "filing_date": "2025-10-31", "fiscal_year": "2025", "free_cash_flow_per_share": 6.607151219185871, "gross_margin_percent": 46.91, "interest_coverage": 0, "net_margin_percent": 26.92, "operating_margin_percent": 31.9708, "pe_ratio": 34.1068, "peg_ratio": 1.5100913295021379, "period": "FY", "price_to_book": 51.79151546797228, "price_to_free_cash_flow": 38.66416728259439, "price_to_sales": 9.176121284791222, "quick_ratio": 0.858770399261008, "revenue_per_share": 27.83964946315684 }, "period": "annual", "ratio_count": 2, "ratios": [ { "all_ratios": { "acceptedDate": "2025-10-31 06:01:26", "assetTurnover": 1.1584451663368045, "bookValuePerShare": 4.932468140616115, "bottomLineProfitMargin": 0.2691506412181824, "capexPerShare": 0.8505870154196074, "capitalExpenditureCoverageRatio": 8.767754620526937, "cashPerShare": 3.6590293340468945, "cashRatio": 0.21695214060169896, "continuousOperationsProfitMargin": 0.2691506412181824, "currentRatio": 0.8932929222186667, "date": "2025-09-27", "debtServiceCoverageRatio": 6.085296866545329, "debtToAssetsRatio": 0.3128178576498785, "debtToCapitalRatio": 0.6038203213153511, "debtToEquityRatio": 1.5241072518411023, "debtToMarketCap": 0.02583493549414094, "dividendPaidAndCapexCoverageRatio": 3.962254762581746, "dividendPayoutRatio": 0.1376752075707526, "dividendPerShare": 1.0316085225942402, "dividendYield": 0.004038238951672435, "dividendYieldPercentage": 0.4038238951672435, "ebitMargin": 0.3189366615324358, "ebitdaMargin": 0.34704597499525425, "ebtPerEbit": 0.997587373167982, "effectiveTaxRate": 0.15610002335586043, "enterpriseValueMultiple": 26.969935053694947, "filingDate": "2025-10-31", "financialLeverageRatio": 4.8721874872852045, "fiscalYear": "2025", "fixedAssetTurnover": 8.350945137857687, "forwardPriceToEarningsGrowthRatio": 1.5100913295021379, "freeCashFlowOperatingCashFlowRatio": 0.8859457132093074, "freeCashFlowPerShare": 6.607151219185871, "grossProfitMargin": 0.4691, "interestCoverageRatio": 0, "interestDebtPerShare": 7.51761046258822, "inventoryTurnover": 38.6428821266177, "longTermDebtToCapitalRatio": 0.5151090680713661, "netIncomePerEBT": 0.8438999766441395, "netIncomePerShare": 7.49305950429809, "netProfitMargin": 0.2692, "operatingCashFlowCoverageRatio": 0.9920357368500672, "operatingCashFlowPerShare": 7.457738234605479, "operatingCashFlowRatio": 0.6730744848488508, "operatingCashFlowSalesRatio": 0.26788190147563085, "operatingProfitMargin": 0.31970799762591884, "payablesTurnover": 3.1628972230174637, "period": "FY", "pretaxProfitMargin": 0.3189366615324358, "priceToBookRatio": 51.79151546797228, "priceToEarningsDilutedGrowthRatio": 1.5087197420056728, "priceToEarningsDilutedRatio": 34.243967828418235, "priceToEarningsGrowthRatio": 1.5100913295021379, "priceToEarningsRatio": 34.1068, "priceToFairValue": 51.79151546797228, "priceToFreeCashFlowRatio": 38.66416728259439, "priceToOperatingCashFlowRatio": 34.25435325882205, "priceToSalesRatio": 9.176121284791222, "quickRatio": 0.858770399261008, "receivablesTurnover": 5.704195622078759, "reportedCurrency": "USD", "revenuePerShare": 27.83964946315684, "shareholdersEquityPerShare": 4.932468140616115, "shortTermOperatingCashFlowCoverageRatio": 5.483890009346254, "solvencyRatio": 0.43329083598358015, "symbol": "AAPL", "tangibleBookValuePerShare": 4.932468140616115, "workingCapitalTurnoverRatio": -20.261496141580857 }, "asset_turnover": 1.1584451663368045, "book_value_per_share": 4.932468140616115, "cash_ratio": 0.21695214060169896, "currency": "USD", "current_ratio": 0.8932929222186667, "date": "2025-09-27", "debt_to_assets": 0.3128178576498785, "debt_to_equity": 1.5241072518411023, "dividend_payout_percent": 13.7675, "dividend_per_share": 1.0316085225942402, "dividend_yield_percent": 0.4038238951672435, "ebitda_margin_percent": 34.7046, "effective_tax_rate_percent": 15.61, "eps": 7.49305950429809, "filing_date": "2025-10-31", "fiscal_year": "2025", "free_cash_flow_per_share": 6.607151219185871, "gross_margin_percent": 46.91, "interest_coverage": 0, "net_margin_percent": 26.92, "operating_margin_percent": 31.9708, "pe_ratio": 34.1068, "peg_ratio": 1.5100913295021379, "period": "FY", "price_to_book": 51.79151546797228, "price_to_free_cash_flow": 38.66416728259439, "price_to_sales": 9.176121284791222, "quick_ratio": 0.858770399261008, "revenue_per_share": 27.83964946315684 }, { "all_ratios": { "acceptedDate": "2024-10-31 06:01:26", "assetTurnover": 1.1584451663368045, "bookValuePerShare": 4.932468140616115, "bottomLineProfitMargin": 0.2691506412181824, "capexPerShare": 0.8505870154196074, "capitalExpenditureCoverageRatio": 8.767754620526937, "cashPerShare": 3.6590293340468945, "cashRatio": 0.21695214060169896, "continuousOperationsProfitMargin": 0.2691506412181824, "currentRatio": 0.8932929222186667, "date": "2024-09-27", "debtServiceCoverageRatio": 6.085296866545329, "debtToAssetsRatio": 0.3128178576498785, "debtToCapitalRatio": 0.6038203213153511, "debtToEquityRatio": 1.5241072518411023, "debtToMarketCap": 0.02583493549414094, "dividendPaidAndCapexCoverageRatio": 3.962254762581746, "dividendPayoutRatio": 0.1376752075707526, "dividendPerShare": 1.0316085225942402, "dividendYield": 0.004038238951672435, "dividendYieldPercentage": 0.4038238951672435, "ebitMargin": 0.3189366615324358, "ebitdaMargin": 0.34704597499525425, "ebtPerEbit": 0.997587373167982, "effectiveTaxRate": 0.15610002335586043, "enterpriseValueMultiple": 26.969935053694947, "filingDate": "2024-10-31", "financialLeverageRatio": 4.8721874872852045, "fiscalYear": "2024", "fixedAssetTurnover": 8.350945137857687, "forwardPriceToEarningsGrowthRatio": 1.5100913295021379, "freeCashFlowOperatingCashFlowRatio": 0.8859457132093074, "freeCashFlowPerShare": 6.607151219185871, "grossProfitMargin": 0.4409, "interestCoverageRatio": 0, "interestDebtPerShare": 7.51761046258822, "inventoryTurnover": 38.6428821266177, "longTermDebtToCapitalRatio": 0.5151090680713661, "netIncomePerEBT": 0.8438999766441395, "netIncomePerShare": 7.49305950429809, "netProfitMargin": 0.253, "operatingCashFlowCoverageRatio": 0.9920357368500672, "operatingCashFlowPerShare": 7.457738234605479, "operatingCashFlowRatio": 0.6730744848488508, "operatingCashFlowSalesRatio": 0.26788190147563085, "operatingProfitMargin": 0.31970799762591884, "payablesTurnover": 3.1628972230174637, "period": "FY", "pretaxProfitMargin": 0.3189366615324358, "priceToBookRatio": 51.79151546797228, "priceToEarningsDilutedGrowthRatio": 1.5087197420056728, "priceToEarningsDilutedRatio": 34.243967828418235, "priceToEarningsGrowthRatio": 1.5100913295021379, "priceToEarningsRatio": 32.0604, "priceToFairValue": 51.79151546797228, "priceToFreeCashFlowRatio": 38.66416728259439, "priceToOperatingCashFlowRatio": 34.25435325882205, "priceToSalesRatio": 9.176121284791222, "quickRatio": 0.858770399261008, "receivablesTurnover": 5.704195622078759, "reportedCurrency": "USD", "revenuePerShare": 27.83964946315684, "shareholdersEquityPerShare": 4.932468140616115, "shortTermOperatingCashFlowCoverageRatio": 5.483890009346254, "solvencyRatio": 0.43329083598358015, "symbol": "AAPL", "tangibleBookValuePerShare": 4.932468140616115, "workingCapitalTurnoverRatio": -20.261496141580857 }, "asset_turnover": 1.1584451663368045, "book_value_per_share": 4.932468140616115, "cash_ratio": 0.21695214060169896, "currency": "USD", "current_ratio": 0.8932929222186667, "date": "2024-09-27", "debt_to_assets": 0.3128178576498785, "debt_to_equity": 1.5241072518411023, "dividend_payout_percent": 13.7675, "dividend_per_share": 1.0316085225942402, "dividend_yield_percent": 0.4038238951672435, "ebitda_margin_percent": 34.7046, "effective_tax_rate_percent": 15.61, "eps": 7.49305950429809, "filing_date": "2024-10-31", "fiscal_year": "2024", "free_cash_flow_per_share": 6.607151219185871, "gross_margin_percent": 44.09, "interest_coverage": 0, "net_margin_percent": 25.3, "operating_margin_percent": 31.9708, "pe_ratio": 32.0604, "peg_ratio": 1.5100913295021379, "period": "FY", "price_to_book": 51.79151546797228, "price_to_free_cash_flow": 38.66416728259439, "price_to_sales": 9.176121284791222, "quick_ratio": 0.858770399261008, "revenue_per_share": 27.83964946315684 } ], "symbol": "AAPL" } ``` ### Get financial scores Get a company's Altman Z-score, which says how likely it is to go bankrupt, and Piotroski F-score, which rates its financial strength from 0 to 9, with the figures behind them. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `altman_z_score` (number): Altman's Z-score: above 2.99 is safe, below 1.81 is distress - `altman_zone` (text): safe, grey or distress - `currency` (text): The currency the figures are in - `ebit` (number): Earnings before interest and tax - `market_cap` (number): Market capitalization - `piotroski_score` (number): Piotroski's F-score, 0 (weakest) to 9 (strongest) - `retained_earnings` (number): Retained earnings - `revenue` (number): Revenue - `symbol` (text): The stock symbol, e.g. AAPL - `total_assets` (number): Total assets - `total_liabilities` (number): Total liabilities - `working_capital` (number): Current assets less current liabilities **Example output** ```json { "altman_z_score": 14.041374927993303, "altman_zone": "safe", "currency": "USD", "ebit": 147722000000, "market_cap": 5042169135511, "piotroski_score": 9, "retained_earnings": 12359000000, "revenue": 451442000000, "symbol": "AAPL", "total_assets": 371082000000, "total_liabilities": 264591000000, "working_capital": 9473000000 } ``` ### Get FMP articles Get the latest market articles written by Financial Modeling Prep, newest first, each with its text, the symbols it is about and a link. **Inputs** - Maximum articles (`limit`, number): The most articles to return, newest first. Leave blank for 10. At least 1. **Outputs** - `article_count` (number): How many articles there are - `articles` (list): The articles, newest first **Example output** ```json { "article_count": 2, "articles": [ { "author": "Andrew Wynn", "content": "Strategic Growth & Operational Excellence: Centerra Gold is strategically investing in its North American assets, exemplified by a 29% increase in gold production at the Mount Milligan mine, driving future growth. Robust Financial Health & Increased Guidance: The company maintains a strong financial position with zero long-term debt and approximately $450 million in cash, leading to increased 2026 gold ...", "image_url": "https://portal.financialmodelingprep.com/positions/6a6b7d9c2514096bb2027277.jpeg", "published_at": "2026-07-30T16:11:45", "site": "Financial Modeling Prep", "tickers": [ "CGAU" ], "title": "Centerra Gold (NYSE:CGAU) Drives Growth with North American Investments and Strong Financials", "url": "https://financialmodelingprep.com/market-news/centerra-gold-cgau-growth-north-american-investments-strong-financials" }, { "author": "Andrew Wynn", "content": "Microsoft raised its Azure growth outlook.", "image_url": "https://portal.financialmodelingprep.com/positions/msft.jpeg", "published_at": "2026-07-30T15:40:02", "site": "Financial Modeling Prep", "tickers": [ "MSFT" ], "title": "Microsoft (NASDAQ:MSFT) Lifts Cloud Guidance", "url": "https://financialmodelingprep.com/market-news/microsoft-lifts-cloud-guidance" } ] } ``` ### Get historical prices Get a symbol's daily open, high, low, close and volume between two dates, oldest first, with the change over the whole range. Covers the last 30 days unless you set dates; the free plan goes back 5 years for about 90 of the most traded US stocks. **Inputs** - Symbol (`symbol`, text, required): A stock or ETF symbol such as AAPL or SPY, an index such as ^GSPC, a crypto pair such as BTCUSD, a currency pair such as EURUSD or a commodity such as GCUSD for gold. - Start date (`start_date`, date): The first day to include. Leave blank for 30 days before the end date. The free plan goes back 5 years. - End date (`end_date`, date): The last day to include. Leave blank for today. **Outputs** - `change` (number): Last close less first close - `end_date` (text): The last day covered, YYYY-MM-DD - `first_close` (number): The closing price on the first day - `last_close` (number): The closing price on the last day - `latest` (object): The last trading day - `percent_change` (number): That as a percentage of the first close - `price_count` (number): How many trading days there are - `prices` (list): Each trading day, oldest first - `start_date` (text): The first day covered, YYYY-MM-DD - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "change": 28.77, "end_date": "2026-10-09", "first_close": 303.62, "last_close": 332.39, "latest": { "change": 0.74, "close": 332.39, "date": "2026-10-08", "high": 334.48, "low": 328.11, "open": 331.65, "percent_change": 0.2231268, "volume": 29207295, "vwap": 332.02 }, "percent_change": 9.4757, "price_count": 22, "prices": [ { "change": 0.74, "close": 303.62, "date": "2026-09-09", "high": 305.71, "low": 299.34, "open": 302.88, "percent_change": 0.2443212, "volume": 29207295, "vwap": 303.25 }, { "change": 0.74, "close": 304.99, "date": "2026-09-10", "high": 307.08, "low": 300.71, "open": 304.25, "percent_change": 0.243221, "volume": 29207295, "vwap": 304.62 }, { "change": 0.74, "close": 306.36, "date": "2026-09-11", "high": 308.45, "low": 302.08, "open": 305.62, "percent_change": 0.2421308, "volume": 29207295, "vwap": 305.99 }, { "change": 0.74, "close": 307.73, "date": "2026-09-14", "high": 309.82, "low": 303.45, "open": 306.99, "percent_change": 0.2410502, "volume": 29207295, "vwap": 307.36 }, { "change": 0.74, "close": 309.1, "date": "2026-09-15", "high": 311.19, "low": 304.82, "open": 308.36, "percent_change": 0.2399792, "volume": 29207295, "vwap": 308.73 }, { "change": 0.74, "close": 310.47, "date": "2026-09-16", "high": 312.56, "low": 306.19, "open": 309.73, "percent_change": 0.2389178, "volume": 29207295, "vwap": 310.1 }, { "change": 0.74, "close": 311.84, "date": "2026-09-17", "high": 313.93, "low": 307.56, "open": 311.1, "percent_change": 0.2378656, "volume": 29207295, "vwap": 311.47 }, { "change": 0.74, "close": 313.21, "date": "2026-09-18", "high": 315.3, "low": 308.93, "open": 312.47, "percent_change": 0.2368227, "volume": 29207295, "vwap": 312.84 }, { "change": 0.74, "close": 314.58, "date": "2026-09-21", "high": 316.67, "low": 310.3, "open": 313.84, "percent_change": 0.2357889, "volume": 29207295, "vwap": 314.21 }, { "change": 0.74, "close": 315.95, "date": "2026-09-22", "high": 318.04, "low": 311.67, "open": 315.21, "percent_change": 0.2347641, "volume": 29207295, "vwap": 315.58 }, { "change": 0.74, "close": 317.32, "date": "2026-09-23", "high": 319.41, "low": 313.04, "open": 316.58, "percent_change": 0.2337482, "volume": 29207295, "vwap": 316.95 }, { "change": 0.74, "close": 318.69, "date": "2026-09-24", "high": 320.78, "low": 314.41, "open": 317.95, "percent_change": 0.232741, "volume": 29207295, "vwap": 318.32 }, { "change": 0.74, "close": 320.06, "date": "2026-09-25", "high": 322.15, "low": 315.78, "open": 319.32, "percent_change": 0.2317425, "volume": 29207295, "vwap": 319.69 }, { "change": 0.74, "close": 321.43, "date": "2026-09-28", "high": 323.52, "low": 317.15, "open": 320.69, "percent_change": 0.2307524, "volume": 29207295, "vwap": 321.06 }, { "change": 0.74, "close": 322.8, "date": "2026-09-29", "high": 324.89, "low": 318.52, "open": 322.06, "percent_change": 0.2297709, "volume": 29207295, "vwap": 322.43 }, { "change": 0.74, "close": 324.17, "date": "2026-09-30", "high": 326.26, "low": 319.89, "open": 323.43, "percent_change": 0.2287976, "volume": 29207295, "vwap": 323.8 }, { "change": 0.74, "close": 325.54, "date": "2026-10-01", "high": 327.63, "low": 321.26, "open": 324.8, "percent_change": 0.2278325, "volume": 29207295, "vwap": 325.17 }, { "change": 0.74, "close": 326.91, "date": "2026-10-02", "high": 329.0, "low": 322.63, "open": 326.17, "percent_change": 0.2268756, "volume": 29207295, "vwap": 326.54 }, { "change": 0.74, "close": 328.28, "date": "2026-10-05", "high": 330.37, "low": 324.0, "open": 327.54, "percent_change": 0.2259266, "volume": 29207295, "vwap": 327.91 }, { "change": 0.74, "close": 329.65, "date": "2026-10-06", "high": 331.74, "low": 325.37, "open": 328.91, "percent_change": 0.2249856, "volume": 29207295, "vwap": 329.28 }, { "change": 0.74, "close": 331.02, "date": "2026-10-07", "high": 333.11, "low": 326.74, "open": 330.28, "percent_change": 0.2240523, "volume": 29207295, "vwap": 330.65 }, { "change": 0.74, "close": 332.39, "date": "2026-10-08", "high": 334.48, "low": 328.11, "open": 331.65, "percent_change": 0.2231268, "volume": 29207295, "vwap": 332.02 } ], "start_date": "2026-09-09", "symbol": "AAPL" } ``` ### Get income statement Get a company's income statements, newest first: revenue, gross profit, operating income, EBITDA, net income and EPS for each year or quarter, with every line under FMP's own names. The free plan returns 5 annual statements of a US company. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Period (`period`, text): Annual figures (fiscal years) or quarterly ones. The free plan only has annual figures; quarters need a paid plan. One of: `annual`, `quarter` (Quarterly). Default: `annual`. - Maximum periods (`limit`, number): How many periods to return, newest first. Leave blank for 5, which is the most the free plan returns; paid plans go back up to 30 years. At least 1. **Outputs** - `latest` (object): The newest one - `period` (text): annual or quarter - `statement_count` (number): How many statements there are - `statements` (list): The income statements, newest first - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "latest": { "all_fields": { "acceptedDate": "2025-10-31 06:01:26", "bottomLineNetIncome": 112010000000, "cik": "0000320193", "costAndExpenses": 283111000000, "costOfRevenue": 220960000000, "date": "2025-09-27", "depreciationAndAmortization": 11698000000, "ebit": 132729000000, "ebitda": 144427000000, "eps": 7.49, "epsDiluted": 7.46, "filingDate": "2025-10-31", "fiscalYear": "2025", "generalAndAdministrativeExpenses": 27601000000, "grossProfit": 195201000000, "incomeBeforeTax": 132729000000, "incomeTaxExpense": 20719000000, "interestExpense": 0, "interestIncome": 0, "netIncome": 112010000000, "netIncomeDeductions": 0, "netIncomeFromContinuingOperations": 112010000000, "netIncomeFromDiscontinuedOperations": 0, "netInterestIncome": 0, "nonOperatingIncomeExcludingInterest": 321000000, "operatingExpenses": 62151000000, "operatingIncome": 133050000000, "otherAdjustmentsToNetIncome": 0, "otherExpenses": 0, "period": "FY", "reportedCurrency": "USD", "researchAndDevelopmentExpenses": 34550000000, "revenue": 416161000000, "sellingAndMarketingExpenses": 0, "sellingGeneralAndAdministrativeExpenses": 27601000000, "symbol": "AAPL", "totalOtherIncomeExpensesNet": -321000000, "weightedAverageShsOut": 14948500000, "weightedAverageShsOutDil": 15004697000 }, "cost_of_revenue": 220960000000, "currency": "USD", "date": "2025-09-27", "ebit": 132729000000, "ebitda": 144427000000, "eps": 7.49, "eps_diluted": 7.46, "filing_date": "2025-10-31", "fiscal_year": "2025", "gross_profit": 195201000000, "income_before_tax": 132729000000, "income_tax_expense": 20719000000, "net_income": 112010000000, "operating_expenses": 62151000000, "operating_income": 133050000000, "period": "FY", "revenue": 416161000000, "shares_outstanding": 14948500000, "shares_outstanding_diluted": 15004697000 }, "period": "annual", "statement_count": 2, "statements": [ { "all_fields": { "acceptedDate": "2025-10-31 06:01:26", "bottomLineNetIncome": 112010000000, "cik": "0000320193", "costAndExpenses": 283111000000, "costOfRevenue": 220960000000, "date": "2025-09-27", "depreciationAndAmortization": 11698000000, "ebit": 132729000000, "ebitda": 144427000000, "eps": 7.49, "epsDiluted": 7.46, "filingDate": "2025-10-31", "fiscalYear": "2025", "generalAndAdministrativeExpenses": 27601000000, "grossProfit": 195201000000, "incomeBeforeTax": 132729000000, "incomeTaxExpense": 20719000000, "interestExpense": 0, "interestIncome": 0, "netIncome": 112010000000, "netIncomeDeductions": 0, "netIncomeFromContinuingOperations": 112010000000, "netIncomeFromDiscontinuedOperations": 0, "netInterestIncome": 0, "nonOperatingIncomeExcludingInterest": 321000000, "operatingExpenses": 62151000000, "operatingIncome": 133050000000, "otherAdjustmentsToNetIncome": 0, "otherExpenses": 0, "period": "FY", "reportedCurrency": "USD", "researchAndDevelopmentExpenses": 34550000000, "revenue": 416161000000, "sellingAndMarketingExpenses": 0, "sellingGeneralAndAdministrativeExpenses": 27601000000, "symbol": "AAPL", "totalOtherIncomeExpensesNet": -321000000, "weightedAverageShsOut": 14948500000, "weightedAverageShsOutDil": 15004697000 }, "cost_of_revenue": 220960000000, "currency": "USD", "date": "2025-09-27", "ebit": 132729000000, "ebitda": 144427000000, "eps": 7.49, "eps_diluted": 7.46, "filing_date": "2025-10-31", "fiscal_year": "2025", "gross_profit": 195201000000, "income_before_tax": 132729000000, "income_tax_expense": 20719000000, "net_income": 112010000000, "operating_expenses": 62151000000, "operating_income": 133050000000, "period": "FY", "revenue": 416161000000, "shares_outstanding": 14948500000, "shares_outstanding_diluted": 15004697000 }, { "all_fields": { "acceptedDate": "2024-10-31 06:01:26", "bottomLineNetIncome": 112010000000, "cik": "0000320193", "costAndExpenses": 283111000000, "costOfRevenue": 220960000000, "date": "2024-09-27", "depreciationAndAmortization": 11698000000, "ebit": 132729000000, "ebitda": 135761380000, "eps": 7.0406, "epsDiluted": 7.0124, "filingDate": "2024-10-31", "fiscalYear": "2024", "generalAndAdministrativeExpenses": 27601000000, "grossProfit": 183488940000, "incomeBeforeTax": 132729000000, "incomeTaxExpense": 20719000000, "interestExpense": 0, "interestIncome": 0, "netIncome": 105289400000, "netIncomeDeductions": 0, "netIncomeFromContinuingOperations": 112010000000, "netIncomeFromDiscontinuedOperations": 0, "netInterestIncome": 0, "nonOperatingIncomeExcludingInterest": 321000000, "operatingExpenses": 62151000000, "operatingIncome": 133050000000, "otherAdjustmentsToNetIncome": 0, "otherExpenses": 0, "period": "FY", "reportedCurrency": "USD", "researchAndDevelopmentExpenses": 34550000000, "revenue": 391191340000, "sellingAndMarketingExpenses": 0, "sellingGeneralAndAdministrativeExpenses": 27601000000, "symbol": "AAPL", "totalOtherIncomeExpensesNet": -321000000, "weightedAverageShsOut": 14948500000, "weightedAverageShsOutDil": 15004697000 }, "cost_of_revenue": 220960000000, "currency": "USD", "date": "2024-09-27", "ebit": 132729000000, "ebitda": 135761380000, "eps": 7.0406, "eps_diluted": 7.0124, "filing_date": "2024-10-31", "fiscal_year": "2024", "gross_profit": 183488940000, "income_before_tax": 132729000000, "income_tax_expense": 20719000000, "net_income": 105289400000, "operating_expenses": 62151000000, "operating_income": 133050000000, "period": "FY", "revenue": 391191340000, "shares_outstanding": 14948500000, "shares_outstanding_diluted": 15004697000 } ], "symbol": "AAPL" } ``` ### Get insider trades Get the shares a company's executives and directors bought, sold or were granted, newest first, from their SEC Form 4 filings, with each insider's role, the price and what they held afterwards. Needs the Starter plan or higher. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Maximum trades (`limit`, number): The most trades to return, newest first. Leave blank for 20. At least 1. **Outputs** - `symbol` (text): The stock symbol, e.g. AAPL - `trade_count` (number): How many trades there are - `trades` (list): The trades, newest first **Example output** ```json { "symbol": "AAPL", "trade_count": 3, "trades": [ { "acquired_or_disposed": "D", "filing_date": "2026-10-03", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000101/0000320193-26-000101-index.htm", "form_type": "4", "insider": "COOK TIMOTHY D", "insider_role": "officer: Chief Executive Officer", "price": 331.52, "security": "Common Stock", "shares": 108136, "shares_owned_after": 489625, "transaction_code": "S", "transaction_date": "2026-10-01", "transaction_type": "S-Sale" }, { "acquired_or_disposed": "D", "filing_date": "2026-10-03", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000101/0000320193-26-000101-index.htm", "form_type": "4", "insider": "COOK TIMOTHY D", "insider_role": "officer: Chief Executive Officer", "price": 331.52, "security": "Common Stock", "shares": 193410, "shares_owned_after": 597761, "transaction_code": "F", "transaction_date": "2026-10-01", "transaction_type": "F-InKind" }, { "acquired_or_disposed": "A", "filing_date": "2026-08-20", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000087/0000320193-26-000087-index.htm", "form_type": "4", "insider": "ADAMS KATHERINE L", "insider_role": "officer: General Counsel", "price": 0, "security": "Common Stock", "shares": 1608, "shares_owned_after": 62959, "transaction_code": "A", "transaction_date": "2026-08-18", "transaction_type": "A-Award" } ] } ``` ### Get key metrics Get a company's key metrics for each year or quarter, newest first: market cap, enterprise value and its multiples, returns on equity, assets and capital, earnings and free cash flow yields, working capital and the cash conversion cycle, plus every other metric FMP has. The free plan returns 5 annual periods of a US company. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Period (`period`, text): Annual figures (fiscal years) or quarterly ones. The free plan only has annual figures; quarters need a paid plan. One of: `annual`, `quarter` (Quarterly). Default: `annual`. - Maximum periods (`limit`, number): How many periods to return, newest first. Leave blank for 5, which is the most the free plan returns; paid plans go back up to 30 years. At least 1. **Outputs** - `latest` (object): The newest one - `metric_count` (number): How many metrics there are - `metrics` (list): The metrics for each period, newest first - `period` (text): annual or quarter - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "latest": { "all_metrics": { "acceptedDate": "2025-10-31 06:01:26", "averageInventory": 6502000000, "averagePayables": 69410000000, "averageReceivables": 69600000000, "capexToDepreciation": 1.0869379381090785, "capexToOperatingCashFlow": 0.11405428679069267, "capexToRevenue": 0.030553079216937677, "cashConversionCycle": -41.967071917298554, "currentRatio": 0.8932929222186667, "date": "2025-09-27", "daysOfInventoryOutstanding": 9.445465242577843, "daysOfPayablesOutstanding": 115.40052498189719, "daysOfSalesOutstanding": 63.9879878220208, "earningsYield": 0.029331635106467118, "enterpriseValue": 3895186810000, "evToEBITDA": 26.969935053694947, "evToFreeCashFlow": 39.43814037077161, "evToOperatingCashFlow": 34.94005139843203, "evToSales": 9.359807406268247, "filingDate": "2025-10-31", "fiscalYear": "2025", "freeCashFlowToEquity": 90284000000, "freeCashFlowToFirm": 98767000000, "freeCashFlowYield": 0.02586374077814872, "grahamNetNet": -11.588738000468274, "grahamNumber": 28.8371936709443, "incomeQuality": 0.995286135166503, "intangiblesToTotalAssets": 0, "interestBurden": 1, "investedCapital": 32160000000, "marketCap": 3818743810000, "netCurrentAssetValue": -137551000000, "netDebtToEBITDA": 0.5292846905357032, "operatingCycle": 73.43345306459864, "operatingReturnOnAssets": 0.36742927918411644, "period": "FY", "reportedCurrency": "USD", "researchAndDevelopementToRevenue": 0.08302075398703868, "returnOnAssets": 0.3117962593356549, "returnOnCapitalEmployed": 0.6872062393471412, "returnOnEquity": 1.5191, "returnOnInvestedCapital": 0.5196842110031786, "returnOnTangibleAssets": 0.3117962593356549, "salesGeneralAndAdministrativeToRevenue": 0.06632288945864702, "stockBasedCompensationToRevenue": 0.030908710811440764, "symbol": "AAPL", "tangibleAssetValue": 73733000000, "taxBurden": 0.8438999766441395, "workingCapital": -17674000000 }, "cash_conversion_cycle": -41.967071917298554, "currency": "USD", "current_ratio": 0.8932929222186667, "date": "2025-09-27", "days_inventory_outstanding": 9.445465242577843, "days_payables_outstanding": 115.40052498189719, "days_sales_outstanding": 63.9879878220208, "earnings_yield_percent": 2.9332, "enterprise_value": 3895186810000, "ev_to_ebitda": 26.969935053694947, "ev_to_free_cash_flow": 39.43814037077161, "ev_to_sales": 9.359807406268247, "filing_date": "2025-10-31", "fiscal_year": "2025", "free_cash_flow_yield_percent": 2.5864, "graham_number": 28.8371936709443, "market_cap": 3818743810000, "net_debt_to_ebitda": 0.5292846905357032, "period": "FY", "return_on_assets_percent": 31.1796, "return_on_equity_percent": 151.91, "return_on_invested_capital_percent": 51.9684, "working_capital": -17674000000 }, "metric_count": 2, "metrics": [ { "all_metrics": { "acceptedDate": "2025-10-31 06:01:26", "averageInventory": 6502000000, "averagePayables": 69410000000, "averageReceivables": 69600000000, "capexToDepreciation": 1.0869379381090785, "capexToOperatingCashFlow": 0.11405428679069267, "capexToRevenue": 0.030553079216937677, "cashConversionCycle": -41.967071917298554, "currentRatio": 0.8932929222186667, "date": "2025-09-27", "daysOfInventoryOutstanding": 9.445465242577843, "daysOfPayablesOutstanding": 115.40052498189719, "daysOfSalesOutstanding": 63.9879878220208, "earningsYield": 0.029331635106467118, "enterpriseValue": 3895186810000, "evToEBITDA": 26.969935053694947, "evToFreeCashFlow": 39.43814037077161, "evToOperatingCashFlow": 34.94005139843203, "evToSales": 9.359807406268247, "filingDate": "2025-10-31", "fiscalYear": "2025", "freeCashFlowToEquity": 90284000000, "freeCashFlowToFirm": 98767000000, "freeCashFlowYield": 0.02586374077814872, "grahamNetNet": -11.588738000468274, "grahamNumber": 28.8371936709443, "incomeQuality": 0.995286135166503, "intangiblesToTotalAssets": 0, "interestBurden": 1, "investedCapital": 32160000000, "marketCap": 3818743810000, "netCurrentAssetValue": -137551000000, "netDebtToEBITDA": 0.5292846905357032, "operatingCycle": 73.43345306459864, "operatingReturnOnAssets": 0.36742927918411644, "period": "FY", "reportedCurrency": "USD", "researchAndDevelopementToRevenue": 0.08302075398703868, "returnOnAssets": 0.3117962593356549, "returnOnCapitalEmployed": 0.6872062393471412, "returnOnEquity": 1.5191, "returnOnInvestedCapital": 0.5196842110031786, "returnOnTangibleAssets": 0.3117962593356549, "salesGeneralAndAdministrativeToRevenue": 0.06632288945864702, "stockBasedCompensationToRevenue": 0.030908710811440764, "symbol": "AAPL", "tangibleAssetValue": 73733000000, "taxBurden": 0.8438999766441395, "workingCapital": -17674000000 }, "cash_conversion_cycle": -41.967071917298554, "currency": "USD", "current_ratio": 0.8932929222186667, "date": "2025-09-27", "days_inventory_outstanding": 9.445465242577843, "days_payables_outstanding": 115.40052498189719, "days_sales_outstanding": 63.9879878220208, "earnings_yield_percent": 2.9332, "enterprise_value": 3895186810000, "ev_to_ebitda": 26.969935053694947, "ev_to_free_cash_flow": 39.43814037077161, "ev_to_sales": 9.359807406268247, "filing_date": "2025-10-31", "fiscal_year": "2025", "free_cash_flow_yield_percent": 2.5864, "graham_number": 28.8371936709443, "market_cap": 3818743810000, "net_debt_to_ebitda": 0.5292846905357032, "period": "FY", "return_on_assets_percent": 31.1796, "return_on_equity_percent": 151.91, "return_on_invested_capital_percent": 51.9684, "working_capital": -17674000000 }, { "all_metrics": { "acceptedDate": "2024-10-31 06:01:26", "averageInventory": 6502000000, "averagePayables": 69410000000, "averageReceivables": 69600000000, "capexToDepreciation": 1.0869379381090785, "capexToOperatingCashFlow": 0.11405428679069267, "capexToRevenue": 0.030553079216937677, "cashConversionCycle": -41.967071917298554, "currentRatio": 0.8932929222186667, "date": "2024-09-27", "daysOfInventoryOutstanding": 9.445465242577843, "daysOfPayablesOutstanding": 115.40052498189719, "daysOfSalesOutstanding": 63.9879878220208, "earningsYield": 0.029331635106467118, "enterpriseValue": 3661475601400, "evToEBITDA": 26.969935053694947, "evToFreeCashFlow": 39.43814037077161, "evToOperatingCashFlow": 34.94005139843203, "evToSales": 9.359807406268247, "filingDate": "2024-10-31", "fiscalYear": "2024", "freeCashFlowToEquity": 90284000000, "freeCashFlowToFirm": 98767000000, "freeCashFlowYield": 0.02586374077814872, "grahamNetNet": -11.588738000468274, "grahamNumber": 28.8371936709443, "incomeQuality": 0.995286135166503, "intangiblesToTotalAssets": 0, "interestBurden": 1, "investedCapital": 32160000000, "marketCap": 3589619181400, "netCurrentAssetValue": -137551000000, "netDebtToEBITDA": 0.5292846905357032, "operatingCycle": 73.43345306459864, "operatingReturnOnAssets": 0.36742927918411644, "period": "FY", "reportedCurrency": "USD", "researchAndDevelopementToRevenue": 0.08302075398703868, "returnOnAssets": 0.3117962593356549, "returnOnCapitalEmployed": 0.6872062393471412, "returnOnEquity": 1.428, "returnOnInvestedCapital": 0.5196842110031786, "returnOnTangibleAssets": 0.3117962593356549, "salesGeneralAndAdministrativeToRevenue": 0.06632288945864702, "stockBasedCompensationToRevenue": 0.030908710811440764, "symbol": "AAPL", "tangibleAssetValue": 73733000000, "taxBurden": 0.8438999766441395, "workingCapital": -17674000000 }, "cash_conversion_cycle": -41.967071917298554, "currency": "USD", "current_ratio": 0.8932929222186667, "date": "2024-09-27", "days_inventory_outstanding": 9.445465242577843, "days_payables_outstanding": 115.40052498189719, "days_sales_outstanding": 63.9879878220208, "earnings_yield_percent": 2.9332, "enterprise_value": 3661475601400, "ev_to_ebitda": 26.969935053694947, "ev_to_free_cash_flow": 39.43814037077161, "ev_to_sales": 9.359807406268247, "filing_date": "2024-10-31", "fiscal_year": "2024", "free_cash_flow_yield_percent": 2.5864, "graham_number": 28.8371936709443, "market_cap": 3589619181400, "net_debt_to_ebitda": 0.5292846905357032, "period": "FY", "return_on_assets_percent": 31.1796, "return_on_equity_percent": 142.8, "return_on_invested_capital_percent": 51.9684, "working_capital": -17674000000 } ], "period": "annual", "symbol": "AAPL" } ``` ### Get market holidays Get the days a stock exchange is closed or closes early between two dates, in date order, and the next one from today. Covers the next year unless you set dates. **Inputs** - Exchange (`exchange`, text): The stock exchange to check. Leave blank for Nasdaq. One of: `NASDAQ` (United States: Nasdaq), `NYSE` (United States: New York Stock Exchange), `AMEX` (United States: NYSE American), `TSX` (Canada: Toronto Stock Exchange), `LSE` (United Kingdom: London Stock Exchange), `EURONEXT` (Europe: Euronext), `XETRA` (Germany: Xetra), `SIX` (Switzerland: SIX Swiss Exchange), `ASX` (Australia: ASX), `HKSE` (Hong Kong: Hong Kong Stock Exchange), and 8 more. Default: `NASDAQ`. - Start date (`start_date`, date): The first day to include. Leave blank for today. - End date (`end_date`, date): The last day to include. Leave blank for a year after the start date. **Outputs** - `end_date` (text): The last day covered, YYYY-MM-DD - `exchange` (text): The exchange's code, e.g. NASDAQ - `exchange_name` (text): The exchange's name - `holiday_count` (number): How many holidays there are - `holidays` (list): The holidays, in date order - `next_holiday` (object): The next holiday from today - `start_date` (text): The first day covered, YYYY-MM-DD **Example output** ```json { "end_date": "2027-10-09", "exchange": "NASDAQ", "exchange_name": "Nasdaq", "holiday_count": 12, "holidays": [ { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2026-11-26", "name": "Thanksgiving Day" }, { "adjusted_close": "01:00 PM -05:00", "adjusted_open": "09:30 AM -05:00", "closed_all_day": false, "date": "2026-11-27", "name": "Day after Thanksgiving" }, { "adjusted_close": "01:00 PM -05:00", "adjusted_open": "09:30 AM -05:00", "closed_all_day": false, "date": "2026-12-24", "name": "Christmas Eve" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2026-12-25", "name": "Christmas Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-01-01", "name": "New Year's Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-01-18", "name": "Martin Luther King, Jr. Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-02-15", "name": "Presidents' Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-03-26", "name": "Good Friday" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-05-31", "name": "Memorial Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-06-18", "name": "Juneteenth National Independence Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-07-05", "name": "Independence Day" }, { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2027-09-06", "name": "Labor Day" } ], "next_holiday": { "adjusted_close": null, "adjusted_open": null, "closed_all_day": true, "date": "2026-11-26", "name": "Thanksgiving Day" }, "start_date": "2026-10-09" } ``` ### Get market hours Find out whether a stock exchange is open right now, and the hours it trades, in its own time zone. **Inputs** - Exchange (`exchange`, text): The stock exchange to check. Leave blank for Nasdaq. One of: `NASDAQ` (United States: Nasdaq), `NYSE` (United States: New York Stock Exchange), `AMEX` (United States: NYSE American), `TSX` (Canada: Toronto Stock Exchange), `LSE` (United Kingdom: London Stock Exchange), `EURONEXT` (Europe: Euronext), `XETRA` (Germany: Xetra), `SIX` (Switzerland: SIX Swiss Exchange), `ASX` (Australia: ASX), `HKSE` (Hong Kong: Hong Kong Stock Exchange), and 8 more. Default: `NASDAQ`. **Outputs** - `closing_hour` (text): When it closes, e.g. 04:00 PM -04:00 - `exchange` (text): The exchange's code, e.g. NASDAQ - `exchange_name` (text): The exchange's name - `is_open` (true/false): True while the market is open for trading - `opening_hour` (text): When it opens, with its UTC offset, e.g. 09:30 AM -04:00 - `timezone` (text): Its time zone, e.g. America/New_York **Example output** ```json { "closing_hour": "04:00 PM -04:00", "exchange": "NASDAQ", "exchange_name": "NASDAQ", "is_open": true, "opening_hour": "09:30 AM -04:00", "timezone": "America/New_York" } ``` ### Get market movers Get today's biggest gainers, biggest losers or most traded US stocks, each with its price and how much it moved. **Inputs** - List (`category`, text): Which of the day's lists to get. One of: `gainers` (Biggest gainers), `losers` (Biggest losers), `most_active` (Most traded). Default: `gainers`. **Outputs** - `category` (text): gainers, losers or most_active - `stock_count` (number): How many stocks are listed - `stocks` (list): The stocks, as FMP ranks them **Example output** ```json { "category": "gainers", "stock_count": 2, "stocks": [ { "change": 0.0001, "exchange": "OTC", "name": "Motus GI Holdings, Inc.", "percent_change": 100, "price": 0.0002, "symbol": "MOTS" }, { "change": 0.06, "exchange": "NASDAQ", "name": "Innovative Eyewear, Inc.", "percent_change": 3.35196, "price": 1.85, "symbol": "LUCY" } ] } ``` ### Get price targets Get analysts' price targets for a stock: the highest, lowest, average and median, and how many were published in the last month, quarter and year with their averages. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `all_time_average` (number): Their average - `all_time_count` (number): How many have ever been published - `last_month_average` (number): Their average - `last_month_count` (number): How many targets were published in the last month - `last_quarter_average` (number): Their average - `last_quarter_count` (number): How many were published in the last quarter - `last_year_average` (number): Their average - `last_year_count` (number): How many were published in the last year - `publishers` (list): Who published the targets - `symbol` (text): The stock symbol, e.g. AAPL - `target_consensus` (number): The average price target - `target_high` (number): The highest price target - `target_low` (number): The lowest price target - `target_median` (number): The median price target **Example output** ```json { "all_time_average": 230.51, "all_time_count": 254, "last_month_average": 333.75, "last_month_count": 8, "last_quarter_average": 332.95, "last_quarter_count": 20, "last_year_average": 304.86, "last_year_count": 67, "publishers": [ "StreetInsider", "TheFly", "Benzinga", "Pulse 2.0", "TipRanks Contributor", "MarketWatch", "Investing", "Barrons", "Investor's Business Daily" ], "symbol": "AAPL", "target_consensus": 337.67, "target_high": 400, "target_low": 250, "target_median": 340 } ``` ### Get quote Get the latest price of a stock, ETF, index, cryptocurrency, currency pair or commodity, with how much it moved since the previous close, the day's open, high and low, the year's high and low, and the 50 and 200 day averages. The free plan covers about 90 of the most traded US stocks and the major indexes, crypto and currency pairs. **Inputs** - Symbol (`symbol`, text, required): A stock or ETF symbol such as AAPL or SPY, an index such as ^GSPC, a crypto pair such as BTCUSD, a currency pair such as EURUSD or a commodity such as GCUSD for gold. **Outputs** - `average_200_day` (number): The average price over the last 200 days - `average_50_day` (number): The average price over the last 50 days - `change` (number): How much the price moved since the previous close - `exchange` (text): Where it trades, e.g. NASDAQ, CRYPTO or FOREX - `high` (number): The day's highest price - `low` (number): The day's lowest price - `market_cap` (number): The market capitalization, where there is one - `name` (text): What the symbol is, e.g. Apple Inc. - `open` (number): The day's opening price - `percent_change` (number): That move as a percentage, e.g. -1.87 for -1.87% - `previous_close` (number): The previous trading day's closing price - `price` (number): The latest price - `symbol` (text): The symbol, e.g. AAPL or BTCUSD - `updated_at` (text): When the price was last updated, as an ISO 8601 UTC time - `volume` (number): How much has traded today - `year_high` (number): The highest price in the last year - `year_low` (number): The lowest price in the last year **Example output** ```json { "average_200_day": 277.21344, "average_50_day": 308.5888, "change": -6.33498, "exchange": "NASDAQ", "high": 334.48, "low": 329.59, "market_cap": 4874072686740, "name": "Apple Inc.", "open": 333.13, "percent_change": -1.8732, "previous_close": 338.18999, "price": 331.85501, "symbol": "AAPL", "updated_at": "2026-07-30T17:00:12Z", "volume": 28718014, "year_high": 344.57, "year_low": 201.5 } ``` ### Get rating Get FMP's rating of a stock, A+ to F, and its scores from 1 to 5 on discounted cash flow, return on equity and assets, debt to equity, price to earnings and price to book. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. **Outputs** - `dcf_score` (number): The discounted cash flow score, 1 to 5 - `debt_to_equity_score` (number): The debt to equity score, 1 to 5 - `overall_score` (number): The overall score, 1 (worst) to 5 (best) - `pe_score` (number): The price to earnings score, 1 to 5 - `price_to_book_score` (number): The price to book score, 1 to 5 - `rating` (text): FMP's letter rating, A+ to F - `return_on_assets_score` (number): The return on assets score, 1 to 5 - `return_on_equity_score` (number): The return on equity score, 1 to 5 - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "dcf_score": 3, "debt_to_equity_score": 1, "overall_score": 3, "pe_score": 2, "price_to_book_score": 1, "rating": "B", "return_on_assets_score": 5, "return_on_equity_score": 5, "symbol": "AAPL" } ``` ### Get SEC filings Get a company's SEC filings between two dates, newest first, optionally only one form such as 10-K annual reports or 8-K event reports, with links to read each one. Covers the last 90 days unless you set dates. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Form (`form_type`, text): Only filings of this form. Leave blank for every form. One of: `10-K` (10-K: annual report), `10-Q` (10-Q: quarterly report), `8-K` (8-K: major event or earnings release), `4` (4: insider trade), `DEF 14A` (DEF 14A: proxy statement), `S-1` (S-1: IPO registration), `S-3` (S-3: shelf registration), `13F-HR` (13F-HR: fund holdings report), `SC 13D` (SC 13D: stake over 5%, active investor), `SC 13G` (SC 13G: stake over 5%, passive investor), `20-F` (20-F: annual report of a foreign company), `6-K` (6-K: current report of a foreign company). - Start date (`start_date`, date): Only filings on or after this day. Leave blank for 90 days before the end date. - End date (`end_date`, date): Only filings on or before this day. Leave blank for today. **Outputs** - `end_date` (text): The last day covered, YYYY-MM-DD - `filing_count` (number): How many filings there are - `filings` (list): The filings, newest first - `form_type` (text): The form asked for, if any - `start_date` (text): The first day covered, YYYY-MM-DD - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "end_date": "2026-10-09", "filing_count": 3, "filings": [ { "accepted_at": "2024-03-01T18:36:45", "cik": "0000320193", "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000039/xslF345X05/wk-form4_1709336196.xml", "filed_date": "2024-03-01", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000039/0000320193-24-000039-index.htm", "form_type": "4" }, { "accepted_at": "2024-02-02T06:03:19", "cik": "0000320193", "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000006/aapl-20231230.htm", "filed_date": "2024-02-02", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000006/0000320193-24-000006-index.htm", "form_type": "10-Q" }, { "accepted_at": "2024-02-01T16:30:55", "cik": "0000320193", "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000005/aapl-20240201.htm", "filed_date": "2024-02-01", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000005/0000320193-24-000005-index.htm", "form_type": "8-K" } ], "form_type": null, "start_date": "2026-07-11", "symbol": "AAPL" } ``` ### Get sector performance Get how much each sector of an exchange rose or fell on a trading day, best first, with the best and worst sectors picked out. Reads the latest day with figures unless you set a date; the free plan goes back a month. **Inputs** - Date (`date`, date): The trading day to read. Leave blank for the latest day with figures. The free plan goes back a month. - Exchange (`exchange`, text): The exchange whose sectors to read. Leave blank for Nasdaq. One of: `NASDAQ` (United States: Nasdaq), `NYSE` (United States: New York Stock Exchange), `AMEX` (United States: NYSE American), `TSX` (Canada: Toronto Stock Exchange), `LSE` (United Kingdom: London Stock Exchange), `EURONEXT` (Europe: Euronext), `XETRA` (Germany: Xetra), `SIX` (Switzerland: SIX Swiss Exchange), `ASX` (Australia: ASX), `HKSE` (Hong Kong: Hong Kong Stock Exchange), and 8 more. Default: `NASDAQ`. **Outputs** - `best_sector` (object): The sector that rose most - `date` (text): The trading day, YYYY-MM-DD - `exchange` (text): The exchange's code, e.g. NASDAQ - `sector_count` (number): How many sectors there are - `sectors` (list): Every sector, best performing first - `worst_sector` (object): The sector that fell most **Example output** ```json { "best_sector": { "average_change_percent": 1.2204, "sector": "Technology" }, "date": "2026-10-08", "exchange": "NASDAQ", "sector_count": 4, "sectors": [ { "average_change_percent": 1.2204, "sector": "Technology" }, { "average_change_percent": 0.4411, "sector": "Energy" }, { "average_change_percent": -0.31481377464310634, "sector": "Basic Materials" }, { "average_change_percent": null, "sector": "Utilities" } ], "worst_sector": { "average_change_percent": -0.31481377464310634, "sector": "Basic Materials" } } ``` ### Get stock news Get news articles about a company, newest first, with each headline, summary, publisher and link, optionally between two dates. Needs the Starter plan or higher. **Inputs** - Stock symbol (`symbol`, text, required): The company's stock symbol, such as AAPL for Apple or MSFT for Microsoft. Search companies finds one from a company name. - Start date (`start_date`, date): Only articles published on or after this day. Leave blank for the latest ones. - End date (`end_date`, date): Only articles published on or before this day. - Maximum articles (`limit`, number): The most articles to return, newest first. Leave blank for 10. At least 1. **Outputs** - `article_count` (number): How many articles there are - `articles` (list): The articles, newest first - `end_date` (text): The last day covered, if one was set - `start_date` (text): The first day covered, if one was set - `symbol` (text): The stock symbol, e.g. AAPL **Example output** ```json { "article_count": 2, "articles": [ { "image_url": "https://images.financialmodelingprep.com/news/tim-cooks-final-earnings-call-as-apple-ceo-heres-20260730.jpg", "published_at": "2026-07-30T12:36:38", "publisher": "CNBC Television", "site": "youtube.com", "summary": "CNBC's MacKenzie Sigalos joins 'Squawk on the Street' to discuss Tim Cook reporting his final quarter as CEO of Apple after 15 years.", "symbol": "AAPL", "title": "Tim Cook's final earnings call as Apple CEO: Here's what to watch", "url": "https://www.youtube.com/watch?v=ZKMD80U8dRM" }, { "image_url": null, "published_at": "2026-07-29T09:02:11", "publisher": "Reuters", "site": "reuters.com", "summary": "Shares of Apple's suppliers rose on Tuesday.", "symbol": "AAPL", "title": "Apple supplier shares rise ahead of results", "url": "https://www.reuters.com/technology/apple-suppliers-rise" } ], "end_date": null, "start_date": null, "symbol": "AAPL" } ``` ### Get treasury rates Get US treasury yields for every maturity from 1 month to 30 years, for each day between two dates, newest first. Covers the last 30 days unless you set dates. **Inputs** - Start date (`start_date`, date): The first day to include. Leave blank for 30 days before the end date. - End date (`end_date`, date): The last day to include. Leave blank for today. **Outputs** - `end_date` (text): The last day covered, YYYY-MM-DD - `latest` (object): The newest day's yields - `rate_count` (number): How many days there are - `rates` (list): Each day's yields, newest first - `start_date` (text): The first day covered, YYYY-MM-DD **Example output** ```json { "end_date": "2026-10-09", "latest": { "date": "2026-10-08", "month_1": 3.74, "month_2": 3.84, "month_3": 3.85, "month_6": 3.98, "year_1": 4.05, "year_10": 4.7, "year_2": 4.25, "year_20": 5.23, "year_3": 4.31, "year_30": 5.22, "year_5": 4.4, "year_7": 4.53 }, "rate_count": 2, "rates": [ { "date": "2026-10-08", "month_1": 3.74, "month_2": 3.84, "month_3": 3.85, "month_6": 3.98, "year_1": 4.05, "year_10": 4.7, "year_2": 4.25, "year_20": 5.23, "year_3": 4.31, "year_30": 5.22, "year_5": 4.4, "year_7": 4.53 }, { "date": "2026-10-07", "month_1": 3.73, "month_2": 3.83, "month_3": 3.83, "month_6": 3.97, "year_1": 4.04, "year_10": 4.67, "year_2": 4.22, "year_20": 5.21, "year_3": 4.29, "year_30": 5.2, "year_5": 4.37, "year_7": 4.51 } ], "start_date": "2026-09-09" } ``` ### Search companies Find a company's stock symbol from its name, or companies whose symbol starts with some letters, optionally on one exchange. The symbol is what the other actions take. **Inputs** - Search for (`query`, text, required): A company name, such as Apple, or the start of a symbol, such as AAP. - Search by (`search_by`, text): Whether the search text is a company name or a symbol. One of: `name` (Company name), `symbol`. Default: `name`. - Exchange (`exchange`, text): Only symbols listed on this exchange. Leave blank to search every exchange. One of: `NASDAQ` (United States: Nasdaq), `NYSE` (United States: New York Stock Exchange), `AMEX` (United States: NYSE American), `TSX` (Canada: Toronto Stock Exchange), `LSE` (United Kingdom: London Stock Exchange), `EURONEXT` (Europe: Euronext), `XETRA` (Germany: Xetra), `SIX` (Switzerland: SIX Swiss Exchange), `ASX` (Australia: ASX), `HKSE` (Hong Kong: Hong Kong Stock Exchange), and 8 more. - Maximum results (`limit`, number): The most matches to return. Leave blank for 10. At least 1. **Outputs** - `query` (text): What was searched for - `result_count` (number): How many companies matched - `results` (list): The matching companies, best match first - `search_by` (text): name or symbol **Example output** ```json { "query": "Apple", "result_count": 3, "results": [ { "currency": "USD", "exchange": "NASDAQ", "exchange_name": "NASDAQ Global Select", "name": "Apple Inc.", "symbol": "AAPL" }, { "currency": "USD", "exchange": "NYSE", "exchange_name": "New York Stock Exchange", "name": "Apple Hospitality REIT, Inc.", "symbol": "APLE" }, { "currency": "CAD", "exchange": "NEO", "exchange_name": "Cboe CA", "name": "Apple Inc.", "symbol": "AAPL.NE" } ], "search_by": "name" } ```