F
FMP Node Wrapper

Financial Endpoints

The Financial Endpoints provide access to financial statements, ratios, and fundamental data for companies.

Available Methods

MethodEndpointDescription
GET/income-statement/{symbol}Get income statement data
GET/balance-sheet-statement/{symbol}Get balance sheet data
GET/cash-flow-statement/{symbol}Get cash flow statement data
GET/key-metrics/{symbol}Get key financial metrics
GET/ratios/{symbol}Get financial ratios
GET/enterprise-value/{symbol}Get enterprise value data
GET/cash-flow-statement-growth/{symbol}Get cash flow growth metrics
GET/income-statement-growth/{symbol}Get income statement growth metrics
GET/balance-sheet-statement-growth/{symbol}Get balance sheet growth metrics
GET/financial-growth/{symbol}Get general financial growth metrics
GET/historical/earning_calendar/{symbol}Get historical earnings calendar
GET/earnings-surprises/{symbol}Get earnings surprises data

Get Income Statement

Retrieve income statement data including revenue, expenses, and profit metrics.

1const incomeStatement = await fmp.financial.getIncomeStatement({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      reportedCurrency: 'USD',
8      cik: '0000320193',
9      fillingDate: '2023-10-27',
10      acceptedDate: '2023-10-27T16:30:00.000+00:00',
11      calendarYear: '2023',
12      period: 'FY',
13      revenue: 383285000000,
14      costOfRevenue: 214137000000,
15      grossProfit: 169148000000,
16      grossProfitRatio: 0.4414,
17      researchAndDevelopmentExpenses: 29915000000,
18      generalAndAdministrativeExpenses: 0,
19      sellingAndMarketingExpenses: 0,
20      sellingGeneralAndAdministrativeExpenses: 24809000000,
21      otherExpenses: 0,
22      operatingExpenses: 54724000000,
23      costAndExpenses: 268861000000,
24      interestExpense: 3933000000,
25      depreciationAndAmortization: 11104000000,
26      ebitda: 130000000000,
27      ebitdaratio: 0.3392,
28      operatingIncome: 114301000000,
29      operatingIncomeRatio: 0.2983,
30      totalOtherIncomeExpensesNet: -1000000000,
31      incomeBeforeTax: 113301000000,
32      incomeBeforeTaxRatio: 0.2957,
33      incomeTaxExpense: 16741000000,
34      netIncome: 96995000000,
35      netIncomeRatio: 0.2531,
36      eps: 6.16,
37      epsDiluted: 6.13,
38      ebit: 114301000000,
39      ebitRatio: 0.2983,
40      link: 'https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm',
41      finalLink: 'https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm'
42    }
43  ]
44}

Get Balance Sheet

Retrieve balance sheet data including assets, liabilities, and equity.

1const balanceSheet = await fmp.financial.getBalanceSheet({
2  symbol: 'AAPL',
3  period: 'quarter',
4  limit: 4,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      reportedCurrency: 'USD',
8      cik: '0000320193',
9      fillingDate: '2023-10-27',
10      acceptedDate: '2023-10-27T16:30:00.000+00:00',
11      calendarYear: '2023',
12      period: 'FY',
13      cashAndCashEquivalents: 29965000000,
14      shortTermInvestments: 31592000000,
15      cashAndShortTermInvestments: 61557000000,
16      netReceivables: 29508000000,
17      inventory: 6331000000,
18      totalCurrentAssets: 143713000000,
19      propertyPlantEquipmentNet: 43663000000,
20      goodwill: 0,
21      intangibleAssets: 0,
22      goodwillAndIntangibleAssets: 0,
23      longTermInvestments: 100544000000,
24      taxAssets: 0,
25      otherNonCurrentAssets: 0,
26      totalNonCurrentAssets: 144226000000,
27      otherAssets: 0,
28      totalAssets: 352755000000,
29      accountPayables: 62611000000,
30      shortTermDebt: 9598000000,
31      taxPayables: 0,
32      deferredRevenue: 8091000000,
33      otherCurrentLiabilities: 0,
34      totalCurrentLiabilities: 145308000000,
35      longTermDebt: 95057000000,
36      deferredRevenueNonCurrent: 0,
37      deferredTaxLiabilitiesNonCurrent: 0,
38      otherNonCurrentLiabilities: 0,
39      totalNonCurrentLiabilities: 95057000000,
40      otherLiabilities: 0,
41      capitalLeaseObligations: 0,
42      totalLiabilities: 240365000000,
43      preferredStock: 0,
44      commonStock: 64849000000,
45      retainedEarnings: 21400000000,
46      accumulatedOtherComprehensiveIncomeLoss: -1100000000,
47      othertotalStockholdersEquity: 0,
48      totalStockholdersEquity: 112390000000,
49      totalEquityGrossMinorityInterest: 0,
50      minorityInterest: 0,
51      totalEquity: 112390000000,
52      totalLiabilitiesAndStockholdersEquity: 352755000000,
53      minorityInterest: 0,
54      totalLiabilitiesAndTotalEquity: 352755000000,
55      totalInvestments: 100544000000,
56      totalDebt: 104655000000,
57      netDebt: 74698000000,
58      link: 'https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm',
59      finalLink: 'https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm'
60    }
61  ]
62}

Get Cash Flow Statement

Retrieve cash flow statement data including operating, investing, and financing activities.

1const cashFlow = await fmp.financial.getCashFlowStatement({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      reportedCurrency: 'USD',
8      cik: '0000320193',
9      fillingDate: '2023-10-27',
10      acceptedDate: '2023-10-27T16:30:00.000+00:00',
11      calendarYear: '2023',
12      period: 'FY',
13      netIncome: 96995000000,
14      depreciationAndAmortization: 11104000000,
15      deferredIncomeTax: 0,
16      stockBasedCompensation: 0,
17      changeInWorkingCapital: 0,
18      accountsReceivables: 0,
19      inventory: 0,
20      accountsPayables: 0,
21      otherWorkingCapital: 0,
22      otherNonCashItems: 0,
23      netCashProvidedByOperatingActivities: 110543000000,
24      investmentsInPropertyPlantAndEquipment: -10955900000,
25      acquisitionsNet: 0,
26      purchasesOfInvestments: 0,
27      salesMaturitiesOfInvestments: 0,
28      otherInvestingActivites: 0,
29      netCashUsedForInvestingActivites: -10955900000,
30      debtRepayment: -9500000000,
31      commonStockIssued: 0,
32      commonStockRepurchased: -77550000000,
33      dividendsPaid: -15000000000,
34      otherFinancingActivites: 0,
35      netCashUsedProvidedByFinancingActivities: -99550000000,
36      effectOfForexChangesOnCash: 0,
37      netChangeInCash: 0,
38      cashAtEndOfPeriod: 29965000000,
39      cashAtBeginningOfPeriod: 29965000000,
40      operatingCashFlow: 110543000000,
41      capitalExpenditure: -10955900000,
42      freeCashFlow: 99587000000,
43      link: 'https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm',
44      finalLink: 'https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm'
45    }
46  ]
47}

Get Financial Ratios

Retrieve key financial ratios and metrics for analysis.

1const ratios = await fmp.financial.getFinancialRatios({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      period: 'FY',
8      currentRatio: 0.99,
9      quickRatio: 0.95,
10      cashRatio: 0.42,
11      daysOfSalesOutstanding: 22.11,
12      daysOfInventoryOutstanding: 6.02,
13      operatingCycle: 28.13,
14      daysOfPayablesOutstanding: 106.67,
15      cashConversionCycle: -78.54,
16      grossProfitMargin: 0.44,
17      operatingProfitMargin: 0.30,
18      pretaxProfitMargin: 0.30,
19      netProfitMargin: 0.25,
20      effectiveTaxRate: 0.15,
21      returnOnAssets: 0.27,
22      returnOnEquity: 0.86,
23      returnOnCapitalEmployed: 0.32,
24      netIncomePerEBT: 0.85,
25      ebtPerEbit: 0.99,
26      ebitPerRevenue: 0.30,
27      debtRatio: 0.68,
28      debtEquityRatio: 2.14,
29      longTermDebtToCapitalization: 0.46,
30      totalDebtToCapitalization: 0.48,
31      interestCoverage: 29.07,
32      cashFlowToDebtRatio: 1.06,
33      companyEquityMultiplier: 3.14,
34      receivablesTurnover: 16.51,
35      payablesTurnover: 3.42,
36      inventoryTurnover: 60.67,
37      fixedAssetTurnover: 8.78,
38      assetTurnover: 1.09,
39      operatingCashFlowPerShare: 7.00,
40      freeCashFlowPerShare: 6.31,
41      cashPerShare: 1.90,
42      payoutRatio: 0.15,
43      operatingCashFlowSalesRatio: 0.29,
44      freeCashFlowOperatingCashFlowRatio: 0.90,
45      cashFlowCoverageRatios: 1.06,
46      shortTermCoverageRatios: 1.06,
47      capitalExpenditureCoverageRatio: 10.09,
48      dividendPaidAndCapexCoverageRatio: 8.77,
49      dividendPayoutRatio: 0.15,
50      priceBookValueRatio: 35.73,
51      priceToBookRatio: 35.73,
52      priceToSalesRatio: 8.95,
53      priceEarningsRatio: 31.44,
54      priceToFreeCashFlowsRatio: 23.82,
55      priceToOperatingCashFlowsRatio: 21.46,
56      priceCashFlowRatio: 21.46,
57      priceEarningsToGrowthRatio: 2.62,
58      priceSalesRatio: 8.95,
59      dividendYield: 0.48,
60      enterpriseValueMultiple: 26.89,
61      priceFairValue: 35.73
62    }
63  ]
64}

Get Key Metrics

Retrieve key financial metrics including valuation ratios, profitability metrics, and efficiency ratios.

1const keyMetrics = await fmp.financial.getKeyMetrics({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      period: 'FY',
8      revenuePerShare: 24.16,
9      netIncomePerShare: 6.16,
10      operatingCashFlowPerShare: 7.00,
11      freeCashFlowPerShare: 6.31,
12      cashPerShare: 1.90,
13      bookValuePerShare: 3.58,
14      tangibleBookValuePerShare: 3.58,
15      shareholdersEquityPerShare: 3.58,
16      interestDebtPerShare: 6.65,
17      marketCap: 3000000000000,
18      enterpriseValue: 3100000000000,
19      peRatio: 31.44,
20      priceToSalesRatio: 8.95,
21      pocfratio: 21.46,
22      pfcfRatio: 23.82,
23      pbRatio: 35.73,
24      ptbRatio: 35.73,
25      evToSales: 8.95,
26      enterpriseValueOverEBITDA: 26.89,
27      evToOperatingCashFlow: 21.46,
28      evToFreeCashFlow: 23.82,
29      earningsYield: 0.032,
30      freeCashFlowYield: 0.042,
31      debtToEquity: 2.14,
32      debtToAssets: 0.68,
33      netDebtToEBITDA: 0.57,
34      currentRatio: 0.99,
35      interestCoverage: 29.07,
36      incomeQuality: 1.14,
37      dividendYield: 0.0048,
38      payoutRatio: 0.15,
39      salesGeneralAndAdministrativeToRevenue: 0.065,
40      researchAndDevelopmentToRevenue: 0.078,
41      intangiblesToTotalAssets: 0,
42      capexToOperatingCashFlow: 0.099,
43      capexToRevenue: 0.029,
44      capexToDepreciation: 0.99,
45      stockBasedCompensationToRevenue: 0.065,
46      grahamNumber: 15.23,
47      roic: 0.32,
48      returnOnTangibleAssets: 0.27,
49      grahamNetNet: 2.68,
50      workingCapital: -1600000000,
51      tangibleAssetValue: 352755000000,
52      netCurrentAssetValue: -96695000000,
53      investedCapital: 245000000000,
54      averageReceivables: 29508000000,
55      averagePayables: 62611000000,
56      averageInventory: 6331000000,
57      daysSalesOutstanding: 22.11,
58      daysPayablesOutstanding: 106.67,
59      daysOfInventoryOnHand: 6.02,
60      receivablesTurnover: 16.51,
61      payablesTurnover: 3.42,
62      inventoryTurnover: 60.67,
63      roe: 0.86,
64      capexPerShare: 0.69
65    }
66  ]
67}

Get Enterprise Value

Retrieve enterprise value data including market capitalization, debt, and cash calculations.

1const enterpriseValue = await fmp.financial.getEnterpriseValue({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      stockPrice: 175.43,
8      numberOfShares: 15728775000,
9      marketCapitalization: 3000000000000,
10      minusCashAndCashEquivalents: 61557000000,
11      addTotalDebt: 104655000000,
12      enterpriseValue: 3100000000000
13    }
14  ]
15}

Get Cashflow Growth

Retrieve cash flow growth metrics showing period-over-period changes in cash flow components.

1const cashflowGrowth = await fmp.financial.getCashflowGrowth({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      calendarYear: '2023',
8      period: 'FY',
9      growthNetIncome: 0.028,
10      growthDepreciationAndAmortization: 0.089,
11      growthDeferredIncomeTax: 0,
12      growthStockBasedCompensation: 0,
13      growthChangeInWorkingCapital: 0,
14      growthAccountsReceivables: 0,
15      growthInventory: 0,
16      growthAccountsPayables: 0,
17      growthOtherWorkingCapital: 0,
18      growthOtherNonCashItems: 0,
19      growthNetCashProvidedByOperatingActivites: 0.013,
20      growthInvestmentsInPropertyPlantAndEquipment: -0.089,
21      growthAcquisitionsNet: 0,
22      growthPurchasesOfInvestments: 0,
23      growthSalesMaturitiesOfInvestments: 0,
24      growthOtherInvestingActivites: 0,
25      growthNetCashUsedForInvestingActivites: -0.089,
26      growthDebtRepayment: -0.095,
27      growthCommonStockIssued: 0,
28      growthCommonStockRepurchased: -0.089,
29      growthDividendsPaid: 0.071,
30      growthOtherFinancingActivites: 0,
31      growthNetCashUsedProvidedByFinancingActivities: -0.089,
32      growthEffectOfForexChangesOnCash: 0,
33      growthNetChangeInCash: 0,
34      growthCashAtEndOfPeriod: 0,
35      growthCashAtBeginningOfPeriod: 0,
36      growthOperatingCashFlow: 0.013,
37      growthCapitalExpenditure: -0.089,
38      growthFreeCashFlow: 0.028
39    }
40  ]
41}

Get Income Growth

Retrieve income statement growth metrics showing period-over-period changes in revenue, expenses, and profitability.

1const incomeGrowth = await fmp.financial.getIncomeGrowth({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      calendarYear: '2023',
8      period: 'FY',
9      growthRevenue: -0.028,
10      growthCostOfRevenue: -0.032,
11      growthGrossProfit: -0.023,
12      growthGrossProfitRatio: 0.005,
13      growthResearchAndDevelopmentExpenses: 0.134,
14      growthGeneralAndAdministrativeExpenses: 0,
15      growthSellingAndMarketingExpenses: 0,
16      growthOtherExpenses: 0,
17      growthOperatingExpenses: 0.134,
18      growthCostAndExpenses: -0.028,
19      growthInterestExpense: 0.089,
20      growthDepreciationAndAmortization: 0.089,
21      growthEBITDA: -0.023,
22      growthEBITDARatio: 0.005,
23      growthOperatingIncome: -0.023,
24      growthOperatingIncomeRatio: 0.005,
25      growthTotalOtherIncomeExpensesNet: 0,
26      growthIncomeBeforeTax: -0.023,
27      growthIncomeBeforeTaxRatio: 0.005,
28      growthIncomeTaxExpense: -0.023,
29      growthNetIncome: -0.023,
30      growthNetIncomeRatio: 0.005,
31      growthEPS: -0.023,
32      growthEPSDiluted: -0.023,
33      growthWeightedAverageShsOut: 0,
34      growthWeightedAverageShsOutDil: 0
35    }
36  ]
37}

Get Balance Sheet Growth

Retrieve balance sheet growth metrics showing period-over-period changes in assets, liabilities, and equity.

1const balanceSheetGrowth = await fmp.financial.getBalanceSheetGrowth({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      calendarYear: '2023',
8      period: 'FY',
9      growthCashAndCashEquivalents: -0.089,
10      growthShortTermInvestments: -0.089,
11      growthCashAndShortTermInvestments: -0.089,
12      growthNetReceivables: -0.089,
13      growthInventory: -0.089,
14      growthOtherCurrentAssets: 0,
15      growthTotalCurrentAssets: -0.089,
16      growthPropertyPlantEquipmentNet: 0.089,
17      growthGoodwill: 0,
18      growthIntangibleAssets: 0,
19      growthGoodwillAndIntangibleAssets: 0,
20      growthLongTermInvestments: 0.089,
21      growthTaxAssets: 0,
22      growthOtherNonCurrentAssets: 0,
23      growthTotalNonCurrentAssets: 0.089,
24      growthOtherAssets: 0,
25      growthTotalAssets: 0,
26      growthAccountPayables: -0.089,
27      growthShortTermDebt: -0.089,
28      growthTaxPayables: 0,
29      growthDeferredRevenue: -0.089,
30      growthOtherCurrentLiabilities: 0,
31      growthTotalCurrentLiabilities: -0.089,
32      growthLongTermDebt: -0.089,
33      growthDeferredRevenueNonCurrent: 0,
34      growthDeferrredTaxLiabilitiesNonCurrent: 0,
35      growthOtherNonCurrentLiabilities: 0,
36      growthTotalNonCurrentLiabilities: -0.089,
37      growthOtherLiabilities: 0,
38      growthTotalLiabilities: -0.089,
39      growthCommonStock: 0,
40      growthRetainedEarnings: 0.089,
41      growthAccumulatedOtherComprehensiveIncomeLoss: 0,
42      growthOthertotalStockholdersEquity: 0,
43      growthTotalStockholdersEquity: 0.089,
44      growthTotalLiabilitiesAndStockholdersEquity: 0,
45      growthTotalInvestments: 0.089,
46      growthTotalDebt: -0.089,
47      growthNetDebt: -0.089
48    }
49  ]
50}

Get Financial Growth

Retrieve comprehensive financial growth metrics including revenue, earnings, and cash flow growth over multiple time periods.

1const financialGrowth = await fmp.financial.getFinancialGrowth({
2  symbol: 'AAPL',
3  period: 'annual',
4  limit: 5,
5});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
periodstringNoPeriod type: "annual" or "quarter" (default: "annual")
limitnumberNoNumber of periods to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2023-09-30',
6      symbol: 'AAPL',
7      calendarYear: '2023',
8      period: 'FY',
9      revenueGrowth: -0.028,
10      grossProfitGrowth: -0.023,
11      ebitgrowth: -0.023,
12      operatingIncomeGrowth: -0.023,
13      netIncomeGrowth: -0.023,
14      epsgrowth: -0.023,
15      epsdilutedGrowth: -0.023,
16      weightedAverageSharesGrowth: 0,
17      weightedAverageSharesDilutedGrowth: 0,
18      dividendsperShareGrowth: 0.071,
19      operatingCashFlowGrowth: 0.013,
20      freeCashFlowGrowth: 0.028,
21      tenYRevenueGrowthPerShare: 0.089,
22      fiveYRevenueGrowthPerShare: 0.089,
23      threeYRevenueGrowthPerShare: 0.089,
24      tenYOperatingCFGrowthPerShare: 0.089,
25      fiveYOperatingCFGrowthPerShare: 0.089,
26      threeYOperatingCFGrowthPerShare: 0.089,
27      tenYNetIncomeGrowthPerShare: 0.089,
28      fiveYNetIncomeGrowthPerShare: 0.089,
29      threeYNetIncomeGrowthPerShare: 0.089,
30      tenYShareholdersEquityGrowthPerShare: 0.089,
31      fiveYShareholdersEquityGrowthPerShare: 0.089,
32      threeYShareholdersEquityGrowthPerShare: 0.089,
33      tenYDividendperShareGrowthPerShare: 0.089,
34      fiveYDividendperShareGrowthPerShare: 0.089,
35      threeYDividendperShareGrowthPerShare: 0.089,
36      receivablesGrowth: -0.089,
37      inventoryGrowth: -0.089,
38      assetGrowth: 0,
39      bookValueperShareGrowth: 0.089,
40      debtGrowth: -0.089,
41      rdexpenseGrowth: 0.134,
42      sgaexpensesGrowth: 0.134
43    }
44  ]
45}

Get Earnings Historical

Retrieve historical and upcoming earnings announcements for a specific company, including estimated and actual earnings per share (EPS) and revenue data.

1const earningsHistorical = await fmp.financial.getEarningsHistorical({
2  symbol: 'AAPL',
3  limit: 5,
4});

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol
limitnumberNoNumber of earnings announcements to retrieve (default: 5)

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2024-01-25',
6      symbol: 'AAPL',
7      eps: 2.18,
8      epsEstimated: 2.10,
9      time: 'AMC',
10      revenue: 119575000000,
11      revenueEstimated: 117910000000,
12      updatedFromDate: '2024-01-25',
13      fiscalDateEnding: '2023-12-31'
14    },
15    {
16      date: '2023-10-26',
17      symbol: 'AAPL',
18      eps: 1.46,
19      epsEstimated: 1.39,
20      time: 'AMC',
21      revenue: 89498000000,
22      revenueEstimated: 89280000000,
23      updatedFromDate: '2023-10-26',
24      fiscalDateEnding: '2023-09-30'
25    }
26  ]
27}

Get Earnings Surprises

Retrieve earnings surprises data showing the difference between estimated and actual earnings per share (EPS) for companies.

1const earningsSurprises = await fmp.financial.getEarningsSurprises('AAPL');

Parameters

ParameterTypeRequiredDescription
symbolstringYesStock symbol

Example Response

1{
2  success: true,
3  data: [
4    {
5      date: '2024-01-25',
6      symbol: 'AAPL',
7      actualEarningResult: 2.18,
8      estimatedEarning: 2.10
9    },
10    {
11      date: '2023-10-26',
12      symbol: 'AAPL',
13      actualEarningResult: 1.46,
14      estimatedEarning: 1.39
15    },
16    {
17      date: '2023-07-27',
18      symbol: 'AAPL',
19      actualEarningResult: 1.26,
20      estimatedEarning: 1.19
21    }
22  ]
23}

Error Handling

Always check the success property before accessing data:

1const incomeStatement = await fmp.financial.getIncomeStatement({ symbol: 'INVALID' });
2
3if (incomeStatement.success) {
4console.log('Revenue:', incomeStatement.data[0].revenue);
5} else {
6console.error('Error:', incomeStatement.error);
7console.error('Status:', incomeStatement.status);
8}

Data Availability

Financial statement data availability depends on:

  • Company filing schedule - Quarterly and annual reports
  • Data processing time - FMP processes filings after SEC release
  • Subscription tier - Some data may require premium plans

Next Steps

Explore other endpoint categories:

Ready to explore stock data? Check out the Stock Endpoints for real-time quotes and market information.