FMP reference / 27 endpoints

Financial statements

Income statements, balance sheets, cash flows, ratios, key metrics, and growth — quarterly and annual, as reported and standardized.

Call these with cvApi.call('/fmp/stable/<endpoint>', params) in an app, GET /api/data/fmp/stable/<endpoint> over REST, or the fmp_request MCP tool from a coding agent. Available on every plan; requests count against your hourly limit.

Balance Sheet Statement

GET /api/data/fmp/stable/balance-sheet-statement

Access detailed balance sheet statements for publicly traded companies with the Balance Sheet Data API. Analyze assets, liabilities, and shareholder equity to gain insights into a company's financial health.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/balance-sheet-statement', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/balance-sheet-statement?symbol=AAPL"

MCP

fmp_request({ "endpoint": "balance-sheet-statement", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "date": "2024-09-28",
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "cik": "0000320193",
    "filingDate": "2024-11-01",
    "acceptedDate": "2024-11-01 06:01:36",
    "fiscalYear": "2024",
    "period": "FY",
    "cashAndCashEquivalents": 29943000000,
    "shortTermInvestments": 35228000000,
    "cashAndShortTermInvestments": 65171000000,
    "netReceivables": 66243000000,
    "accountsReceivables": 33410000000,
    "otherReceivables": 32833000000,
    "inventory": 7286000000,
    "prepaids": 0,
    "otherCurrentAssets": 14287000000,
    "totalCurrentAssets": 152987000000,
    "propertyPlantEquipmentNet": 45680000000,
    "goodwill": 0,
    "intangibleAssets": 0,
    "goodwillAndIntangibleAssets": 0,
    "longTermInvestments": 91479000000,
    "taxAssets": 19499000000,
    "otherNonCurrentAssets": 55335000000,
    "totalNonCurrentAssets": 211993000000,
    "otherAssets": 0,
    "totalAssets": 364980000000,
    "totalPayables": 95561000000,
    "accountPayables": 68960000000,
    "otherPayables": 26601000000,
    "accruedExpenses": 0,
    "shortTermDebt": 20879000000,
    "capitalLeaseObligationsCurrent": 1632000000,
    "taxPayables": 26601000000,
    "deferredRevenue": 8249000000,
    "otherCurrentLiabilities": 50071000000,
    "totalCurrentLiabilities": 176392000000,
…

As Reported Balance Statements

GET /api/data/fmp/stable/balance-sheet-statement-as-reported

Access balance sheets as reported by the company with the As Reported Balance Statements API. View detailed financial data on assets, liabilities, and equity directly from official filings.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/balance-sheet-statement-as-reported', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/balance-sheet-statement-as-reported?symbol=AAPL"

MCP

fmp_request({ "endpoint": "balance-sheet-statement-as-reported", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2024,
    "period": "FY",
    "reportedCurrency": null,
    "date": "2024-09-27",
    "data": {
      "cashandcashequivalentsatcarryingvalue": 29943000000,
      "marketablesecuritiescurrent": 35228000000,
      "accountsreceivablenetcurrent": 33410000000,
      "nontradereceivablescurrent": 32833000000,
      "inventorynet": 7286000000,
      "otherassetscurrent": 14287000000,
      "assetscurrent": 152987000000,
      "marketablesecuritiesnoncurrent": 91479000000,
      "propertyplantandequipmentnet": 45680000000,
      "otherassetsnoncurrent": 74834000000,
      "assetsnoncurrent": 211993000000,
      "assets": 364980000000,
      "accountspayablecurrent": 68960000000,
      "otherliabilitiescurrent": 78304000000,
      "contractwithcustomerliabilitycurrent": 8249000000,
      "commercialpaper": 10000000000,
      "longtermdebtcurrent": 10912000000,
      "liabilitiescurrent": 176392000000,
      "longtermdebtnoncurrent": 85750000000,
      "otherliabilitiesnoncurrent": 45888000000,
      "liabilitiesnoncurrent": 131638000000,
      "liabilities": 308030000000,
      "commonstocksharesoutstanding": 15116786000,
      "commonstocksharesissued": 15116786000,
      "commonstocksincludingadditionalpaidincapital": 83276000000,
      "retainedearningsaccumulateddeficit": -19154000000,
      "accumulatedothercomprehensiveincomelossnetoftax": -7172000000,
      "stockholdersequity": 56950000000,
      "liabilitiesandstockholdersequity": 364980000000,
      "commonstockparorstatedvaluepershare": 0.00001,
      "commonstocksharesauthorized": 50400000000
    }
…

Balance Sheet Statement Growth

GET /api/data/fmp/stable/balance-sheet-statement-growth

Analyze the growth of key balance sheet items over time with the Balance Sheet Statement Growth API. Track changes in assets, liabilities, and equity to understand the financial evolution of a company.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/balance-sheet-statement-growth', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/balance-sheet-statement-growth?symbol=AAPL"

MCP

fmp_request({ "endpoint": "balance-sheet-statement-growth", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "fiscalYear": "2024",
    "period": "FY",
    "reportedCurrency": "USD",
    "growthCashAndCashEquivalents": -0.0007341898882029034,
    "growthShortTermInvestments": 0.11516302627413738,
    "growthCashAndShortTermInvestments": 0.058744212492892536,
    "growthNetReceivables": 0.08621792243994425,
    "growthInventory": 0.15084504817564365,
    "growthOtherCurrentAssets": -0.02776454576386526,
    "growthTotalCurrentAssets": 0.06562138667929733,
    "growthPropertyPlantEquipmentNet": -0.15992349565984992,
    "growthGoodwill": 0,
    "growthIntangibleAssets": 0,
    "growthGoodwillAndIntangibleAssets": 0,
    "growthLongTermInvestments": -0.09015953214513049,
    "growthTaxAssets": 0.09225857046829487,
    "growthOtherNonCurrentAssets": 0.5266933370120016,
    "growthTotalNonCurrentAssets": 0.014238076328719674,
    "growthOtherAssets": 0,
    "growthTotalAssets": 0.035160515396374756,
    "growthAccountPayables": 0.1014039066617687,
    "growthShortTermDebt": 0.32087050041121024,
    "growthTaxPayables": 2.01632838190271,
    "growthDeferredRevenue": 0.023322168465450935,
    "growthOtherCurrentLiabilities": -0.1254584832500786,
    "growthTotalCurrentLiabilities": 0.21391802240757563,
    "growthLongTermDebt": -0.10003043628845205,
    "growthDeferredRevenueNonCurrent": 0,
    "growthDeferredTaxLiabilitiesNonCurrent": 0,
    "growthOtherNonCurrentLiabilities": -0.09048495373370312,
    "growthTotalNonCurrentLiabilities": -0.09295867814151548,
    "growthOtherLiabilities": 0,
    "growthTotalLiabilities": 0.060574238130816666,
    "growthPreferredStock": 0,
    "growthCommonStock": 0.12821763398905328,
    "growthRetainedEarnings": -88.50467289719626,
…

Balance Sheet Statements TTM

GET /api/data/fmp/stable/balance-sheet-statement-ttm

---

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/balance-sheet-statement-ttm', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/balance-sheet-statement-ttm?symbol=AAPL"

MCP

fmp_request({ "endpoint": "balance-sheet-statement-ttm", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "date": "2024-12-28",
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "cik": "0000320193",
    "filingDate": "2025-01-31",
    "acceptedDate": "2025-01-31 06:01:27",
    "fiscalYear": "2025",
    "period": "Q1",
    "cashAndCashEquivalents": 30299000000,
    "shortTermInvestments": 23476000000,
    "cashAndShortTermInvestments": 53775000000,
    "netReceivables": 59306000000,
    "accountsReceivables": 29639000000,
    "otherReceivables": 29667000000,
    "inventory": 6911000000,
    "prepaids": 0,
    "otherCurrentAssets": 13248000000,
    "totalCurrentAssets": 133240000000,
    "propertyPlantEquipmentNet": 46069000000,
    "goodwill": 0,
    "intangibleAssets": 0,
    "goodwillAndIntangibleAssets": 0,
    "longTermInvestments": 87593000000,
    "taxAssets": 0,
    "otherNonCurrentAssets": 77183000000,
    "totalNonCurrentAssets": 210845000000,
    "otherAssets": 0,
    "totalAssets": 344085000000,
    "totalPayables": 61910000000,
    "accountPayables": 61910000000,
    "otherPayables": 0,
    "accruedExpenses": 0,
    "shortTermDebt": 12843000000,
    "capitalLeaseObligationsCurrent": 0,
    "taxPayables": 0,
    "deferredRevenue": 8461000000,
    "otherCurrentLiabilities": 61151000000,
    "totalCurrentLiabilities": 144365000000,
…

Cash Flow Statement

GET /api/data/fmp/stable/cash-flow-statement

Gain insights into a company's cash flow activities with the Cash Flow Statements API. Analyze cash generated and used from operations, investments, and financing activities to evaluate the financial health and sustainability of a business.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/cash-flow-statement', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/cash-flow-statement?symbol=AAPL"

MCP

fmp_request({ "endpoint": "cash-flow-statement", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "date": "2024-09-28",
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "cik": "0000320193",
    "filingDate": "2024-11-01",
    "acceptedDate": "2024-11-01 06:01:36",
    "fiscalYear": "2024",
    "period": "FY",
    "netIncome": 93736000000,
    "depreciationAndAmortization": 11445000000,
    "deferredIncomeTax": 0,
    "stockBasedCompensation": 11688000000,
    "changeInWorkingCapital": 3651000000,
    "accountsReceivables": -5144000000,
    "inventory": -1046000000,
    "accountsPayables": 6020000000,
    "otherWorkingCapital": 3821000000,
    "otherNonCashItems": -2266000000,
    "netCashProvidedByOperatingActivities": 118254000000,
    "investmentsInPropertyPlantAndEquipment": -9447000000,
    "acquisitionsNet": 0,
    "purchasesOfInvestments": -48656000000,
    "salesMaturitiesOfInvestments": 62346000000,
    "otherInvestingActivities": -1308000000,
    "netCashProvidedByInvestingActivities": 2935000000,
    "netDebtIssuance": -5998000000,
    "longTermNetDebtIssuance": -9958000000,
    "shortTermNetDebtIssuance": 3960000000,
    "netStockIssuance": -94949000000,
    "netCommonStockIssuance": -94949000000,
    "commonStockIssuance": 0,
    "commonStockRepurchased": -94949000000,
    "netPreferredStockIssuance": 0,
    "netDividendsPaid": -15234000000,
    "commonDividendsPaid": -15234000000,
    "preferredDividendsPaid": 0,
    "otherFinancingActivities": -5802000000,
    "netCashProvidedByFinancingActivities": -121983000000,
…

As Reported Cashflow Statements

GET /api/data/fmp/stable/cash-flow-statement-as-reported

View cash flow statements as reported by the company with the As Reported Cash Flow Statements API. Analyze a company's cash flows related to operations, investments, and financing directly from official reports.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/cash-flow-statement-as-reported', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/cash-flow-statement-as-reported?symbol=AAPL"

MCP

fmp_request({ "endpoint": "cash-flow-statement-as-reported", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2024,
    "period": "FY",
    "reportedCurrency": null,
    "date": "2024-09-27",
    "data": {
      "cashcashequivalentsrestrictedcashandrestrictedcashequivalents": 29943000000,
      "netincomeloss": 93736000000,
      "depreciationdepletionandamortization": 11445000000,
      "sharebasedcompensation": 11688000000,
      "othernoncashincomeexpense": 2266000000,
      "increasedecreaseinaccountsreceivable": 3788000000,
      "increasedecreaseinotherreceivables": 1356000000,
      "increasedecreaseininventories": 1046000000,
      "increasedecreaseinotheroperatingassets": 11731000000,
      "increasedecreaseinaccountspayable": 6020000000,
      "increasedecreaseinotheroperatingliabilities": 15552000000,
      "netcashprovidedbyusedinoperatingactivities": 118254000000,
      "paymentstoacquireavailableforsalesecuritiesdebt": 48656000000,
      "proceedsfrommaturitiesprepaymentsandcallsofavailableforsalesecurities": 51211000000,
      "proceedsfromsaleofavailableforsalesecuritiesdebt": 11135000000,
      "paymentstoacquirepropertyplantandequipment": 9447000000,
      "paymentsforproceedsfromotherinvestingactivities": 1308000000,
      "netcashprovidedbyusedininvestingactivities": 2935000000,
      "paymentsrelatedtotaxwithholdingforsharebasedcompensation": 5600000000,
      "paymentsofdividends": 15234000000,
      "paymentsforrepurchaseofcommonstock": 94949000000,
      "repaymentsoflongtermdebt": 9958000000,
      "proceedsfromrepaymentsofcommercialpaper": 3960000000,
      "proceedsfrompaymentsforotherfinancingactivities": -361000000,
      "netcashprovidedbyusedinfinancingactivities": -121983000000,
      "cashcashequivalentsrestrictedcashandrestrictedcashequivalentsperiodincreasedecreaseincludingexchangerateeffect": -794000000,
      "incometaxespaidnet": 26102000000
    }
  }
]

Cashflow Statement Growth

GET /api/data/fmp/stable/cash-flow-statement-growth

Measure the growth rate of a company’s cash flow with the FMP Cashflow Statement Growth API. Determine how quickly a company’s cash flow is increasing or decreasing over time.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/cash-flow-statement-growth', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/cash-flow-statement-growth?symbol=AAPL"

MCP

fmp_request({ "endpoint": "cash-flow-statement-growth", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "fiscalYear": "2024",
    "period": "FY",
    "reportedCurrency": "USD",
    "growthNetIncome": -0.033599670086086914,
    "growthDepreciationAndAmortization": -0.006424168764649709,
    "growthDeferredIncomeTax": 0,
    "growthStockBasedCompensation": 0.07892550540016616,
    "growthChangeInWorkingCapital": 1.555116314429071,
    "growthAccountsReceivables": -2.0473933649289098,
    "growthInventory": 0.3535228677379481,
    "growthAccountsPayables": 4.1868713605082055,
    "growthOtherWorkingCapital": 2.4402563136072373,
    "growthOtherNonCashItems": -0.017512348450830714,
    "growthNetCashProvidedByOperatingActivites": 0.06975566069312394,
    "growthInvestmentsInPropertyPlantAndEquipment": 0.13796879277306323,
    "growthAcquisitionsNet": 0,
    "growthPurchasesOfInvestments": -0.6486294175448107,
    "growthSalesMaturitiesOfInvestments": 0.3698202750801951,
    "growthOtherInvestingActivites": 0.02169035153328347,
    "growthNetCashUsedForInvestingActivites": -0.2078272604588394,
    "growthDebtRepayment": -0.012662502110417018,
    "growthCommonStockIssued": 0,
    "growthCommonStockRepurchased": -0.2243584784010316,
    "growthDividendsPaid": -0.013910149750415973,
    "growthOtherFinancingActivites": 0.03493013972055888,
    "growthNetCashUsedProvidedByFinancingActivities": -0.12439163778482412,
    "growthEffectOfForexChangesOnCash": 0,
    "growthNetChangeInCash": -1.1378472222222222,
    "growthCashAtEndOfPeriod": -0.02583205908188828,
    "growthCashAtBeginningOfPeriod": 0.23061216319013492,
    "growthOperatingCashFlow": 0.06975566069312394,
    "growthCapitalExpenditure": 0.13796879277306323,
    "growthFreeCashFlow": 0.092615279562982,
    "growthNetDebtIssuance": 0.3942026057973942,
    "growthLongTermNetDebtIssuance": -0.6812426135404356,
    "growthShortTermNetDebtIssuance": 1.995475113122172,
…

Cashflow Statements TTM

GET /api/data/fmp/stable/cash-flow-statement-ttm

---

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/cash-flow-statement-ttm', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/cash-flow-statement-ttm?symbol=AAPL"

MCP

fmp_request({ "endpoint": "cash-flow-statement-ttm", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "date": "2024-12-28",
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "cik": "0000320193",
    "filingDate": "2025-01-31",
    "acceptedDate": "2025-01-31 06:01:27",
    "fiscalYear": "2025",
    "period": "Q1",
    "netIncome": 96150000000,
    "depreciationAndAmortization": 11677000000,
    "deferredIncomeTax": 0,
    "stockBasedCompensation": 11977000000,
    "changeInWorkingCapital": -8224000000,
    "accountsReceivables": -9505000000,
    "inventory": -694000000,
    "accountsPayables": 3891000000,
    "otherWorkingCapital": -1916000000,
    "otherNonCashItems": -3286000000,
    "netCashProvidedByOperatingActivities": 108294000000,
    "investmentsInPropertyPlantAndEquipment": -9995000000,
    "acquisitionsNet": 0,
    "purchasesOfInvestments": -45000000000,
    "salesMaturitiesOfInvestments": 67422000000,
    "otherInvestingActivities": -1627000000,
    "netCashProvidedByInvestingActivities": 10800000000,
    "netDebtIssuance": -10967000000,
    "longTermNetDebtIssuance": -10967000000,
    "shortTermNetDebtIssuance": 0,
    "netStockIssuance": -98416000000,
    "netCommonStockIssuance": -98416000000,
    "commonStockIssuance": 0,
    "commonStockRepurchased": -98416000000,
    "netPreferredStockIssuance": 0,
    "netDividendsPaid": -15265000000,
    "commonDividendsPaid": -15265000000,
    "preferredDividendsPaid": 0,
    "otherFinancingActivities": -6121000000,
    "netCashProvidedByFinancingActivities": -130769000000,
…

Enterprise Values

GET /api/data/fmp/stable/enterprise-values

Access a company's enterprise value using the Enterprise Values API. This metric offers a comprehensive view of a company's total market value by combining both its equity (market capitalization) and debt, providing a better understanding of its worth.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/enterprise-values', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/enterprise-values?symbol=AAPL"

MCP

fmp_request({ "endpoint": "enterprise-values", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "stockPrice": 227.79,
    "numberOfShares": 15343783000,
    "marketCapitalization": 3495160329570,
    "minusCashAndCashEquivalents": 29943000000,
    "addTotalDebt": 106629000000,
    "enterpriseValue": 3571846329570
  }
]

Financial Statement Growth

GET /api/data/fmp/stable/financial-growth

Analyze the growth of key financial statement items across income, balance sheet, and cash flow statements with the Financial Statement Growth API. Track changes over time to understand trends in financial performance.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/financial-growth', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/financial-growth?symbol=AAPL"

MCP

fmp_request({ "endpoint": "financial-growth", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "fiscalYear": "2024",
    "period": "FY",
    "reportedCurrency": "USD",
    "revenueGrowth": 0.020219940775141214,
    "grossProfitGrowth": 0.06819471705252206,
    "ebitgrowth": 0.07799581805933456,
    "operatingIncomeGrowth": 0.07799581805933456,
    "netIncomeGrowth": -0.033599670086086914,
    "epsgrowth": -0.008116883116883088,
    "epsdilutedGrowth": -0.008156606851549727,
    "weightedAverageSharesGrowth": -0.02543458616683152,
    "weightedAverageSharesDilutedGrowth": -0.02557791606880283,
    "dividendsPerShareGrowth": 0.040371570095532654,
    "operatingCashFlowGrowth": 0.06975566069312394,
    "receivablesGrowth": 0.08621792243994425,
    "inventoryGrowth": 0.15084504817564365,
    "assetGrowth": 0.035160515396374756,
    "bookValueperShareGrowth": -0.059693251557224776,
    "debtGrowth": -0.0401393489845888,
    "rdexpenseGrowth": 0.04863780712017383,
    "sgaexpensesGrowth": 0.04672709770575967,
    "freeCashFlowGrowth": 0.092615279562982,
    "tenYRevenueGrowthPerShare": 2.3937532854122625,
    "fiveYRevenueGrowthPerShare": 0.8093292228858464,
    "threeYRevenueGrowthPerShare": 0.163506592883552,
    "tenYOperatingCFGrowthPerShare": 2.1417809176982403,
    "fiveYOperatingCFGrowthPerShare": 1.051533221923415,
    "threeYOperatingCFGrowthPerShare": 0.23720294833900227,
    "tenYNetIncomeGrowthPerShare": 2.76381558093543,
    "fiveYNetIncomeGrowthPerShare": 1.0421744314966246,
    "threeYNetIncomeGrowthPerShare": 0.07761907162786884,
    "tenYShareholdersEquityGrowthPerShare": -0.19003774225234785,
    "fiveYShareholdersEquityGrowthPerShare": -0.24235004889283715,
    "threeYShareholdersEquityGrowthPerShare": -0.017459858915902907,
    "tenYDividendperShareGrowthPerShare": 1.1722201809466772,
    "fiveYDividendperShareGrowthPerShare": 0.29890046876764864,
…

Financial Reports Dates

GET /api/data/fmp/stable/financial-reports-dates

---

Query parameter	Type	Example
`symbol` required	string	`AAPL`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/financial-reports-dates', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/financial-reports-dates?symbol=AAPL"

MCP

fmp_request({ "endpoint": "financial-reports-dates", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2025,
    "period": "Q1",
    "linkXlsx": "https://financialmodelingprep.com/stable/financial-reports-json?symbol=AAPL&year=2025&period=Q1&apikey=YOUR_API_KEY",
    "linkJson": "https://financialmodelingprep.com/stable/financial-reports-xlsx?symbol=AAPL&year=2025&period=Q1&apikey=YOUR_API_KEY"
  }
]

Financial Reports Form 10-K JSON

GET /api/data/fmp/stable/financial-reports-json

Access comprehensive annual reports with the FMP Annual Reports on Form 10-K API. Obtain detailed information about a company’s financial performance, business operations, and risk factors as reported to the SEC.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`year` required	number	`2022`
`period` required	string	`Q1,Q2,Q3,Q4,FY`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/financial-reports-json', { symbol: 'AAPL', year: '2022', period: 'FY' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/financial-reports-json?symbol=AAPL&year=2022&period=FY"

MCP

fmp_request({ "endpoint": "financial-reports-json", "params": {"symbol":"AAPL","year":"2022","period":"FY"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "period": "FY",
    "year": "2022",
    "Cover Page": [
      {
        "Cover Page - USD ($) shares in Thousands, $ in Millions": [
          "12 Months Ended"
        ]
      },
      {
        "items": [
          "Sep. 24, 2022",
          "Oct. 14, 2022",
          "Mar. 25, 2022"
        ]
      },
      {
        "Entity Information [Line Items]": [
          " ",
          " ",
          " "
        ]
      }
    ],
    "Auditor Information": [
      {
        "Auditor Information": [
          "12 Months Ended"
        ]
      },
      {
        "items": [
          "Sep. 24, 2022"
        ]
      },
      {
        "Auditor Information [Abstract]": [
          " "
…

Financial Reports Form 10-K XLSX

GET /api/data/fmp/stable/financial-reports-xlsx

Download detailed 10-K reports in XLSX format with the Financial Reports Form 10-K XLSX API. Effortlessly access and analyze annual financial data for companies in a spreadsheet-friendly format.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`year` required	number	`2022`
`period` required	string	`Q1,Q2,Q3,Q4,FY`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/financial-reports-xlsx', { symbol: 'AAPL', year: '2022', period: 'FY' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/financial-reports-xlsx?symbol=AAPL&year=2022&period=FY"

MCP

fmp_request({ "endpoint": "financial-reports-xlsx", "params": {"symbol":"AAPL","year":"2022","period":"FY"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "period": "FY",
    "year": "2022",
    "Cover Page": [
      {
        "Cover Page - USD ($) shares in Thousands, $ in Millions": [
          "12 Months Ended"
        ]
      },
      {
        "items": [
          "Sep. 24, 2022",
          "Oct. 14, 2022",
          "Mar. 25, 2022"
        ]
      },
      {
        "Entity Information [Line Items]": [
          " ",
          " ",
          " "
        ]
      }
    ],
    "Auditor Information": [
      {
        "Auditor Information": [
          "12 Months Ended"
        ]
      },
      {
        "items": [
          "Sep. 24, 2022"
        ]
      },
      {
        "Auditor Information [Abstract]": [
          " "
…

Financial Scores

GET /api/data/fmp/stable/financial-scores

Assess a company's financial strength using the Financial Health Scores API. This API provides key metrics such as the Altman Z-Score and Piotroski Score, giving users insights into a company’s overall financial health and stability.

Query parameter	Type	Example
`symbol` required	string	`AAPL`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/financial-scores', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/financial-scores?symbol=AAPL"

MCP

fmp_request({ "endpoint": "financial-scores", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "altmanZScore": 9.322985825443649,
    "piotroskiScore": 8,
    "workingCapital": -11125000000,
    "totalAssets": 344085000000,
    "retainedEarnings": -11221000000,
    "ebit": 125675000000,
    "marketCap": 3259495258000,
    "totalLiabilities": 277327000000,
    "revenue": 395760000000
  }
]

As Reported Financial Statements

GET /api/data/fmp/stable/financial-statement-full-as-reported

Retrieve comprehensive financial statements as reported by companies with FMP As Reported Financial Statements API. Access complete data across income, balance sheet, and cash flow statements in their original form for detailed analysis.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/financial-statement-full-as-reported', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/financial-statement-full-as-reported?symbol=AAPL"

MCP

fmp_request({ "endpoint": "financial-statement-full-as-reported", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2024,
    "period": "FY",
    "reportedCurrency": null,
    "date": "2024-09-27",
    "data": {
      "documenttype": "10-K",
      "documentannualreport": "true",
      "currentfiscalyearenddate": "--09-28",
      "documentperiodenddate": "2024-09-28",
      "documenttransitionreport": "false",
      "entityfilenumber": "001-36743",
      "entityregistrantname": "Apple Inc.",
      "entityincorporationstatecountrycode": "CA",
      "entitytaxidentificationnumber": "94-2404110",
      "entityaddressaddressline1": "One Apple Park Way",
      "entityaddresscityortown": "Cupertino",
      "entityaddressstateorprovince": "CA",
      "entityaddresspostalzipcode": 95014,
      "cityareacode": 408,
      "localphonenumber": "996-1010",
      "security12btitle": "3.600% Notes due 2042",
      "tradingsymbol": "AAPL",
      "notradingsymbolflag": "true",
      "securityexchangename": "NASDAQ",
      "entitywellknownseasonedissuer": "Yes",
      "entityvoluntaryfilers": "No",
      "entitycurrentreportingstatus": "Yes",
      "entityinteractivedatacurrent": "Yes",
      "entityfilercategory": "Large Accelerated Filer",
      "entitysmallbusiness": "false",
      "entityemerginggrowthcompany": "false",
      "icfrauditorattestationflag": "true",
      "documentfinstmterrorcorrectionflag": "false",
      "entityshellcompany": "false",
      "amendmentflag": "false",
      "documentfiscalyearfocus": 2024,
      "documentfiscalperiodfocus": "FY",
…

Income Statement

GET /api/data/fmp/stable/income-statement

Access detailed income statement data for publicly traded companies with the Income Statements API. Track profitability, compare competitors, and identify business trends with up-to-date financial data.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/income-statement', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/income-statement?symbol=AAPL"

MCP

fmp_request({ "endpoint": "income-statement", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "date": "2024-09-28",
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "cik": "0000320193",
    "filingDate": "2024-11-01",
    "acceptedDate": "2024-11-01 06:01:36",
    "fiscalYear": "2024",
    "period": "FY",
    "revenue": 391035000000,
    "costOfRevenue": 210352000000,
    "grossProfit": 180683000000,
    "researchAndDevelopmentExpenses": 31370000000,
    "generalAndAdministrativeExpenses": 0,
    "sellingAndMarketingExpenses": 0,
    "sellingGeneralAndAdministrativeExpenses": 26097000000,
    "otherExpenses": 0,
    "operatingExpenses": 57467000000,
    "costAndExpenses": 267819000000,
    "netInterestIncome": 0,
    "interestIncome": 0,
    "interestExpense": 0,
    "depreciationAndAmortization": 11445000000,
    "ebitda": 134661000000,
    "ebit": 123216000000,
    "nonOperatingIncomeExcludingInterest": 0,
    "operatingIncome": 123216000000,
    "totalOtherIncomeExpensesNet": 269000000,
    "incomeBeforeTax": 123485000000,
    "incomeTaxExpense": 29749000000,
    "netIncomeFromContinuingOperations": 93736000000,
    "netIncomeFromDiscontinuedOperations": 0,
    "otherAdjustmentsToNetIncome": 0,
    "netIncome": 93736000000,
    "netIncomeDeductions": 0,
    "bottomLineNetIncome": 93736000000,
    "eps": 6.11,
    "epsDiluted": 6.08,
    "weightedAverageShsOut": 15343783000,
…

As Reported Income Statements

GET /api/data/fmp/stable/income-statement-as-reported

Retrieve income statements as they were reported by the company with the As Reported Income Statements API. Access raw financial data directly from official company filings, including revenue, expenses, and net income.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/income-statement-as-reported', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/income-statement-as-reported?symbol=AAPL"

MCP

fmp_request({ "endpoint": "income-statement-as-reported", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2024,
    "period": "FY",
    "reportedCurrency": null,
    "date": "2024-09-27",
    "data": {
      "revenuefromcontractwithcustomerexcludingassessedtax": 391035000000,
      "costofgoodsandservicessold": 210352000000,
      "grossprofit": 180683000000,
      "researchanddevelopmentexpense": 31370000000,
      "sellinggeneralandadministrativeexpense": 26097000000,
      "operatingexpenses": 57467000000,
      "operatingincomeloss": 123216000000,
      "nonoperatingincomeexpense": 269000000,
      "incomelossfromcontinuingoperationsbeforeincometaxesextraordinaryitemsnoncontrollinginterest": 123485000000,
      "incometaxexpensebenefit": 29749000000,
      "netincomeloss": 93736000000,
      "earningspersharebasic": 6.11,
      "earningspersharediluted": 6.08,
      "weightedaveragenumberofsharesoutstandingbasic": 15343783000,
      "weightedaveragenumberofdilutedsharesoutstanding": 15408095000,
      "othercomprehensiveincomelossforeigncurrencytransactionandtranslationadjustmentnetoftax": 395000000,
      "othercomprehensiveincomelossderivativeinstrumentgainlossbeforereclassificationaftertax": -832000000,
      "othercomprehensiveincomelossderivativeinstrumentgainlossreclassificationaftertax": 1337000000,
      "othercomprehensiveincomelossderivativeinstrumentgainlossafterreclassificationandtax": -2169000000,
      "othercomprehensiveincomeunrealizedholdinggainlossonsecuritiesarisingduringperiodnetoftax": 5850000000,
      "othercomprehensiveincomelossreclassificationadjustmentfromaociforsaleofsecuritiesnetoftax": -204000000,
      "othercomprehensiveincomelossavailableforsalesecuritiesadjustmentnetoftax": 6054000000,
      "othercomprehensiveincomelossnetoftaxportionattributabletoparent": 4280000000,
      "comprehensiveincomenetoftax": 98016000000
    }
  }
]

Income Statement Growth

GET /api/data/fmp/stable/income-statement-growth

Track key financial growth metrics with the Income Statement Growth API. Analyze how revenue, profits, and expenses have evolved over time, offering insights into a company’s financial health and operational efficiency.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/income-statement-growth', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/income-statement-growth?symbol=AAPL"

MCP

fmp_request({ "endpoint": "income-statement-growth", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "fiscalYear": "2024",
    "period": "FY",
    "reportedCurrency": "USD",
    "growthRevenue": 0.020219940775141214,
    "growthCostOfRevenue": -0.017675600199872046,
    "growthGrossProfit": 0.06819471705252206,
    "growthGrossProfitRatio": 0.04776303446712012,
    "growthResearchAndDevelopmentExpenses": 0.04863780712017383,
    "growthGeneralAndAdministrativeExpenses": 0,
    "growthSellingAndMarketingExpenses": 0,
    "growthOtherExpenses": -1,
    "growthOperatingExpenses": 0.04776924900176856,
    "growthCostAndExpenses": -0.004331112631234571,
    "growthInterestIncome": -1,
    "growthInterestExpense": -1,
    "growthDepreciationAndAmortization": -0.006424168764649709,
    "growthEBITDA": 0.07026704816404387,
    "growthOperatingIncome": 0.07799581805933456,
    "growthIncomeBeforeTax": 0.08571604417246959,
    "growthIncomeTaxExpense": 0.7770145152619318,
    "growthNetIncome": -0.033599670086086914,
    "growthEPS": -0.008116883116883088,
    "growthEPSDiluted": -0.008156606851549727,
    "growthWeightedAverageShsOut": -0.02543458616683152,
    "growthWeightedAverageShsOutDil": -0.02557791606880283,
    "growthEBIT": 0.0471407082579099,
    "growthNonOperatingIncomeExcludingInterest": 1,
    "growthNetInterestIncome": 1,
    "growthTotalOtherIncomeExpensesNet": 1.4761061946902654,
    "growthNetIncomeFromContinuingOperations": -0.033599670086086914,
    "growthOtherAdjustmentsToNetIncome": 0,
    "growthNetIncomeDeductions": 0
  }
]

Income Statements TTM

GET /api/data/fmp/stable/income-statement-ttm

---

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/income-statement-ttm', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/income-statement-ttm?symbol=AAPL"

MCP

fmp_request({ "endpoint": "income-statement-ttm", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "date": "2024-12-28",
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "cik": "0000320193",
    "filingDate": "2025-01-31",
    "acceptedDate": "2025-01-31 06:01:27",
    "fiscalYear": "2025",
    "period": "Q1",
    "revenue": 395760000000,
    "costOfRevenue": 211657000000,
    "grossProfit": 184103000000,
    "researchAndDevelopmentExpenses": 31942000000,
    "generalAndAdministrativeExpenses": 0,
    "sellingAndMarketingExpenses": 0,
    "sellingGeneralAndAdministrativeExpenses": 26486000000,
    "otherExpenses": 0,
    "operatingExpenses": 58428000000,
    "costAndExpenses": 270085000000,
    "netInterestIncome": 0,
    "interestIncome": 0,
    "interestExpense": 0,
    "depreciationAndAmortization": 11677000000,
    "ebitda": 137352000000,
    "ebit": 125675000000,
    "nonOperatingIncomeExcludingInterest": 0,
    "operatingIncome": 125675000000,
    "totalOtherIncomeExpensesNet": 71000000,
    "incomeBeforeTax": 125746000000,
    "incomeTaxExpense": 29596000000,
    "netIncomeFromContinuingOperations": 96150000000,
    "netIncomeFromDiscontinuedOperations": 0,
    "otherAdjustmentsToNetIncome": 0,
    "netIncome": 96150000000,
    "netIncomeDeductions": 0,
    "bottomLineNetIncome": 96150000000,
    "eps": 6.31,
    "epsDiluted": 6.3,
    "weightedAverageShsOut": 15081724000,
…

Key Metrics

GET /api/data/fmp/stable/key-metrics

Access essential financial metrics for a company with the FMP Financial Key Metrics API. Evaluate revenue, net income, P/E ratio, and more to assess performance and compare it to competitors.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/key-metrics', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/key-metrics?symbol=AAPL"

MCP

fmp_request({ "endpoint": "key-metrics", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "fiscalYear": "2024",
    "period": "FY",
    "reportedCurrency": "USD",
    "marketCap": 3495160329570,
    "enterpriseValue": 3571846329570,
    "evToSales": 9.134339201273542,
    "evToOperatingCashFlow": 30.204866893043786,
    "evToFreeCashFlow": 32.82735788662494,
    "evToEBITDA": 26.524727497716487,
    "netDebtToEBITDA": 0.5694744580836323,
    "currentRatio": 0.8673125765340832,
    "incomeQuality": 1.2615643936161134,
    "grahamNumber": 22.587017267616833,
    "grahamNetNet": -12.352478525015636,
    "taxBurden": 0.7590881483581001,
    "interestBurden": 1.0021831580314244,
    "workingCapital": -23405000000,
    "investedCapital": 22275000000,
    "returnOnAssets": 0.25682503150857583,
    "operatingReturnOnAssets": 0.3434290787011036,
    "returnOnTangibleAssets": 0.25682503150857583,
    "returnOnEquity": 1.6459350307287095,
    "returnOnInvestedCapital": 0.4430708117427921,
    "returnOnCapitalEmployed": 0.6533607652660827,
    "earningsYield": 0.026818798327209237,
    "freeCashFlowYield": 0.03113076074921754,
    "capexToOperatingCashFlow": 0.07988736110406414,
    "capexToDepreciation": 0.8254259501965924,
    "capexToRevenue": 0.02415896275269477,
    "salesGeneralAndAdministrativeToRevenue": 0,
    "researchAndDevelopementToRevenue": 0.08022299794136074,
    "stockBasedCompensationToRevenue": 0.02988990755303234,
    "intangiblesToTotalAssets": 0,
    "averageReceivables": 63614000000,
    "averagePayables": 65785500000,
    "averageInventory": 6808500000,
…

Key Metrics TTM

GET /api/data/fmp/stable/key-metrics-ttm

Retrieve a comprehensive set of trailing twelve-month (TTM) key performance metrics with the TTM Key Metrics API. Access data related to a company's profitability, capital efficiency, and liquidity, allowing for detailed analysis of its financial health over the past year.

Query parameter	Type	Example
`symbol` required	string	`AAPL`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/key-metrics-ttm', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/key-metrics-ttm?symbol=AAPL"

MCP

fmp_request({ "endpoint": "key-metrics-ttm", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "marketCap": 3149833928000,
    "enterpriseValueTTM": 3216333928000,
    "evToSalesTTM": 8.126980816656559,
    "evToOperatingCashFlowTTM": 29.70001965021146,
    "evToFreeCashFlowTTM": 32.71990486169747,
    "evToEBITDATTM": 23.41672438697653,
    "netDebtToEBITDATTM": 0.48415749315627005,
    "currentRatioTTM": 0.9229383853427077,
    "incomeQualityTTM": 1.1263026521060842,
    "grahamNumberTTM": 25.198029099282905,
    "grahamNetNetTTM": -11.64435843011051,
    "taxBurdenTTM": 0.7646366484818603,
    "interestBurdenTTM": 1.0005649492739208,
    "workingCapitalTTM": -11125000000,
    "investedCapitalTTM": 34944000000,
    "returnOnAssetsTTM": 0.27943676707790227,
    "operatingReturnOnAssetsTTM": 0.35448090090471257,
    "returnOnTangibleAssetsTTM": 0.27943676707790227,
    "returnOnEquityTTM": 1.4534598087751787,
    "returnOnInvestedCapitalTTM": 0.45208108089346594,
    "returnOnCapitalEmployedTTM": 0.6292559583416784,
    "earningsYieldTTM": 0.030404739849149914,
    "freeCashFlowYieldTTM": 0.03120767705439485,
    "capexToOperatingCashFlowTTM": 0.09229504866382256,
    "capexToDepreciationTTM": 0.855956153121521,
    "capexToRevenueTTM": 0.025255205174853447,
    "salesGeneralAndAdministrativeToRevenueTTM": 0,
    "researchAndDevelopementToRevenueTTM": 0.08071053163533455,
    "stockBasedCompensationToRevenueTTM": 0.030263290883363655,
    "intangiblesToTotalAssetsTTM": 0,
    "averageReceivablesTTM": 62774500000,
    "averagePayablesTTM": 65435000000,
    "averageInventoryTTM": 7098500000,
    "daysOfSalesOutstandingTTM": 54.69650798463715,
    "daysOfPayablesOutstandingTTM": 106.76306476988712,
    "daysOfInventoryOutstandingTTM": 11.917937984569374,
    "operatingCycleTTM": 66.61444596920653,
…

Latest Financial Statements

GET /api/data/fmp/stable/latest-financial-statements

---

Query parameter	Type	Example
`page`	number	`0`
`limit`	number	`250`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/latest-financial-statements', { page: '0', limit: '250' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/latest-financial-statements?page=0&limit=250"

MCP

fmp_request({ "endpoint": "latest-financial-statements", "params": {"page":"0","limit":"250"} })

Example response +

[
  {
    "symbol": "FGFI",
    "calendarYear": 2024,
    "period": "Q4",
    "date": "2024-12-31",
    "dateAdded": "2025-03-13 17:03:59"
  }
]

Owner Earnings

GET /api/data/fmp/stable/owner-earnings

Retrieve a company's owner earnings with the Owner Earnings API, which provides a more accurate representation of cash available to shareholders by adjusting net income. This metric is crucial for evaluating a company’s profitability from the perspective of investors.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/owner-earnings', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/owner-earnings?symbol=AAPL"

MCP

fmp_request({ "endpoint": "owner-earnings", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "reportedCurrency": "USD",
    "fiscalYear": "2025",
    "period": "Q1",
    "date": "2024-12-28",
    "averagePPE": 0.13969,
    "maintenanceCapex": -2279964750,
    "ownersEarnings": 27655035250,
    "growthCapex": -660035250,
    "ownersEarningsPerShare": 1.83
  }
]

Financial Ratios

GET /api/data/fmp/stable/ratios

Analyze a company's financial performance using the Financial Ratios API. This API provides detailed profitability, liquidity, and efficiency ratios, enabling users to assess a company's operational and financial health across various metrics.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`limit`	number	`5`
`period`	string	`Q1,Q2,Q3,Q4,FY,annual,quarter`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/ratios', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/ratios?symbol=AAPL"

MCP

fmp_request({ "endpoint": "ratios", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "date": "2024-09-28",
    "fiscalYear": "2024",
    "period": "FY",
    "reportedCurrency": "USD",
    "grossProfitMargin": 0.4620634981523393,
    "ebitMargin": 0.31510222870075566,
    "ebitdaMargin": 0.3443707085043538,
    "operatingProfitMargin": 0.31510222870075566,
    "pretaxProfitMargin": 0.3157901466620635,
    "continuousOperationsProfitMargin": 0.23971255769943867,
    "netProfitMargin": 0.23971255769943867,
    "bottomLineProfitMargin": 0.23971255769943867,
    "receivablesTurnover": 5.903038811648023,
    "payablesTurnover": 3.0503480278422272,
    "inventoryTurnover": 28.870710952511665,
    "fixedAssetTurnover": 8.560310858143607,
    "assetTurnover": 1.0713874732862074,
    "currentRatio": 0.8673125765340832,
    "quickRatio": 0.8260068483831466,
    "solvencyRatio": 0.3414634938155374,
    "cashRatio": 0.16975259648963673,
    "priceToEarningsRatio": 37.287278415656736,
    "priceToEarningsGrowthRatio": -45.93792700808932,
    "forwardPriceToEarningsGrowthRatio": -45.93792700808932,
    "priceToBookRatio": 61.37243774486391,
    "priceToSalesRatio": 8.93822887866815,
    "priceToFreeCashFlowRatio": 32.12256867269569,
    "priceToOperatingCashFlowRatio": 29.55638142954995,
    "debtToAssetsRatio": 0.29215025480848267,
    "debtToEquityRatio": 1.872326602282704,
    "debtToCapitalRatio": 0.6518501763673821,
    "longTermDebtToCapitalRatio": 0.6009110021023125,
    "financialLeverageRatio": 6.408779631255487,
    "workingCapitalTurnoverRatio": -31.099932397502684,
    "operatingCashFlowRatio": 0.6704045534944896,
    "operatingCashFlowSalesRatio": 0.3024128274962599,
    "freeCashFlowOperatingCashFlowRatio": 0.9201126388959359,
…

Financial Ratios TTM

GET /api/data/fmp/stable/ratios-ttm

Gain access to trailing twelve-month (TTM) financial ratios with the TTM Ratios API. This API provides key performance metrics over the past year, including profitability, liquidity, and efficiency ratios.

Query parameter	Type	Example
`symbol` required	string	`AAPL`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/ratios-ttm', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/ratios-ttm?symbol=AAPL"

MCP

fmp_request({ "endpoint": "ratios-ttm", "params": {"symbol":"AAPL"} })

Example response (truncated) +

[
  {
    "symbol": "AAPL",
    "grossProfitMarginTTM": 0.46518849807964424,
    "ebitMarginTTM": 0.3175535678188801,
    "ebitdaMarginTTM": 0.34705882352941175,
    "operatingProfitMarginTTM": 0.3175535678188801,
    "pretaxProfitMarginTTM": 0.31773296947645036,
    "continuousOperationsProfitMarginTTM": 0.24295027289266222,
    "netProfitMarginTTM": 0.24295027289266222,
    "bottomLineProfitMarginTTM": 0.24295027289266222,
    "receivablesTurnoverTTM": 6.673186524129093,
    "payablesTurnoverTTM": 3.4187853335486995,
    "inventoryTurnoverTTM": 30.626103313558097,
    "fixedAssetTurnoverTTM": 8.590592372311098,
    "assetTurnoverTTM": 1.1501809145995903,
    "currentRatioTTM": 0.9229383853427077,
    "quickRatioTTM": 0.8750666712845911,
    "solvencyRatioTTM": 0.3888081578786054,
    "cashRatioTTM": 0.20987774044955496,
    "priceToEarningsRatioTTM": 32.889608822880916,
    "priceToEarningsGrowthRatioTTM": 9.104441715061135,
    "forwardPriceToEarningsGrowthRatioTTM": 9.104441715061135,
    "priceToBookRatioTTM": 47.370141231313106,
    "priceToSalesRatioTTM": 7.958949686678795,
    "priceToFreeCashFlowRatioTTM": 32.04339747098139,
    "priceToOperatingCashFlowRatioTTM": 29.201395167968677,
    "debtToAssetsRatioTTM": 0.28132292892744526,
    "debtToEquityRatioTTM": 1.4499985020521886,
    "debtToCapitalRatioTTM": 0.5918364851397372,
    "longTermDebtToCapitalRatioTTM": 0.557055084464615,
    "financialLeverageRatioTTM": 5.154213727193745,
    "workingCapitalTurnoverRatioTTM": -22.92267593397046,
    "operatingCashFlowRatioTTM": 0.7501402694558931,
    "operatingCashFlowSalesRatioTTM": 0.2736355366889024,
    "freeCashFlowOperatingCashFlowRatioTTM": 0.9077049513361775,
    "debtServiceCoverageRatioTTM": 8.390251498870981,
    "interestCoverageRatioTTM": 0,
    "shortTermOperatingCashFlowCoverageRatioTTM": 8.432142022891847,
    "operatingCashFlowCoverageRatioTTM": 1.1187512267688715,
…

Revenue Geographic Segments

GET /api/data/fmp/stable/revenue-geographic-segmentation

Access detailed revenue breakdowns by geographic region with the Revenue Geographic Segments API. Analyze how different regions contribute to a company’s total revenue and identify key markets for growth.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`period`	string	`annual,quarter`
`structure`	string	`flat`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/revenue-geographic-segmentation', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/revenue-geographic-segmentation?symbol=AAPL"

MCP

fmp_request({ "endpoint": "revenue-geographic-segmentation", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2024,
    "period": "FY",
    "reportedCurrency": null,
    "date": "2024-09-28",
    "data": {
      "Americas Segment": 167045000000,
      "Europe Segment": 101328000000,
      "Greater China Segment": 66952000000,
      "Japan Segment": 25052000000,
      "Rest of Asia Pacific": 30658000000
    }
  }
]

Revenue Product Segmentation

GET /api/data/fmp/stable/revenue-product-segmentation

Access detailed revenue breakdowns by product line with the Revenue Product Segmentation API. Understand which products drive a company's earnings and get insights into the performance of individual product segments.

Query parameter	Type	Example
`symbol` required	string	`AAPL`
`period`	string	`annual,quarter`
`structure`	string	`flat`

cvApi (in-app)

const data = await cvApi.call('/fmp/stable/revenue-product-segmentation', { symbol: 'AAPL' });

curl (REST)

curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/revenue-product-segmentation?symbol=AAPL"

MCP

fmp_request({ "endpoint": "revenue-product-segmentation", "params": {"symbol":"AAPL"} })

Example response +

[
  {
    "symbol": "AAPL",
    "fiscalYear": 2024,
    "period": "FY",
    "reportedCurrency": null,
    "date": "2024-09-28",
    "data": {
      "Mac": 29984000000,
      "Service": 96169000000,
      "Wearables, Home and Accessories": 37005000000,
      "iPad": 26694000000,
      "iPhone": 201183000000
    }
  }
]

Get example prompts & new data guides

Occasional emails with prompts worth trying and what’s new in the data.