Docs navigation +
FMP reference  /  17 endpoints

Company information

Profiles, executives and compensation, market cap history, float, peers, and M&A.

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.

Company Notes

GET /api/data/fmp/stable/company-notes

Retrieve detailed information about company-issued notes with the FMP Company Notes API. Access essential data such as CIK number, stock symbol, note title, and the exchange where the notes are listed.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/company-notes', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/company-notes?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "company-notes", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "cik": "0000320193",
    "symbol": "AAPL",
    "title": "0.000% Notes due 2025",
    "exchange": "NASDAQ"
  }
]

Delisted Companies

GET /api/data/fmp/stable/delisted-companies

Stay informed with the FMP Delisted Companies API. Access a comprehensive list of companies that have been delisted from stock exchanges to avoid trading in risky stocks and identify potential financial troubles.

Query parameter Type Example
page number 0
limit number 100
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/delisted-companies', { page: '0', limit: '100' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/delisted-companies?page=0&limit=100"
MCP 
fmp_request({ "endpoint": "delisted-companies", "params": {"page":"0","limit":"100"} })
Example response + 
[
  {
    "symbol": "EDAP",
    "companyName": "Edap Tms S.a.",
    "exchange": "NASDAQ",
    "ipoDate": "1997-08-01",
    "delistedDate": "2026-06-01"
  }
]

Company Employee Count

GET /api/data/fmp/stable/employee-count

Retrieve detailed workforce information for companies, including employee count, reporting period, and filing date. The FMP Company Employee Count API also provides direct links to official SEC documents for further verification and in-depth research.

Query parameter Type Example
symbol required string AAPL
limit number 100
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/employee-count', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/employee-count?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "employee-count", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "cik": "0000320193",
    "acceptanceTime": "2025-10-31 06:01:26",
    "periodOfReport": "2025-09-27",
    "companyName": "Apple Inc.",
    "formType": "10-K",
    "filingDate": "2025-10-31",
    "employeeCount": 166000,
    "source": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm"
  }
]

Executive Compensation Benchmark

GET /api/data/fmp/stable/executive-compensation-benchmark

Gain access to average executive compensation data across various industries with the FMP Executive Compensation Benchmark API. This API provides essential insights for comparing executive pay by industry, helping you understand compensation trends and benchmarks.

Query parameter Type Example
year string 2024
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/executive-compensation-benchmark');
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/executive-compensation-benchmark"
MCP 
fmp_request({ "endpoint": "executive-compensation-benchmark" })
Example response + 
[
  {
    "industryTitle": "ABRASIVE, ASBESTOS & MISC NONMETALLIC MINERAL PRODS",
    "year": 2024,
    "averageCompensation": 784407.5555555555
  }
]

Executive Compensation

GET /api/data/fmp/stable/governance-executive-compensation

Retrieve comprehensive compensation data for company executives with the FMP Executive Compensation API. This API provides detailed information on salaries, stock awards, total compensation, and other relevant financial data, including filing details and links to official documents.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/governance-executive-compensation', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/governance-executive-compensation?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "governance-executive-compensation", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "cik": "0000320193",
    "symbol": "AAPL",
    "companyName": "Apple Inc.",
    "filingDate": "2026-01-08",
    "acceptedDate": "2026-01-08 16:31:36",
    "nameAndPosition": "Deirdre O’Brien Senior Vice President, Retail + People",
    "year": 2023,
    "salary": 1000000,
    "bonus": 0,
    "stockAward": 22323641,
    "optionAward": 0,
    "incentivePlanCompensation": 3571150,
    "allOtherCompensation": 42219,
    "total": 26937010,
    "link": "https://www.sec.gov/Archives/edgar/data/320193/000130817926000008/0001308179-26-000008-index.htm"
  }
]

Company Historical Employee Count

GET /api/data/fmp/stable/historical-employee-count

Access historical employee count data for a company based on specific reporting periods. The FMP Company Historical Employee Count API provides insights into how a company’s workforce has evolved over time, allowing users to analyze growth trends and operational changes.

Query parameter Type Example
symbol required string AAPL
limit number 100
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/historical-employee-count', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/historical-employee-count?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "historical-employee-count", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "cik": "0000320193",
    "acceptanceTime": "2025-10-31 06:01:26",
    "periodOfReport": "2025-09-27",
    "companyName": "Apple Inc.",
    "formType": "10-K",
    "filingDate": "2025-10-31",
    "employeeCount": 166000,
    "source": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm"
  }
]

Historical Market Cap

GET /api/data/fmp/stable/historical-market-capitalization

Access historical market capitalization data for a company using the FMP Historical Market Capitalization API. This API helps track the changes in market value over time, enabling long-term assessments of a company's growth or decline.

Query parameter Type Example
symbol required string AAPL
limit number 100
from date 2026-01-27
to date 2026-04-27
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/historical-market-capitalization', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/historical-market-capitalization?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "historical-market-capitalization", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "date": "2026-06-05",
    "marketCap": 4521192070120
  }
]

Company Executives

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

Retrieve detailed information on company executives with the FMP Company Executives API. This API provides essential data about key executives, including their name, title, compensation, and other demographic details such as gender and year of birth.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/key-executives', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/key-executives?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "key-executives", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "title": "Senior Vice President of Worldwide Marketing",
    "name": "Greg Joswiak",
    "pay": null,
    "currencyPay": "USD",
    "gender": "male",
    "yearBorn": null,
    "titleSince": null,
    "active": true
  }
]

Company Market Cap

GET /api/data/fmp/stable/market-capitalization

Retrieve the market capitalization for a specific company on any given date using the FMP Company Market Capitalization API. This API provides essential data to assess the size and value of a company in the stock market, helping users gauge its overall market standing.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/market-capitalization', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/market-capitalization?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "market-capitalization", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "date": "2025-10-24",
    "marketCap": 3900351299800
  }
]

Batch Market Cap

GET /api/data/fmp/stable/market-capitalization-batch

Retrieve market capitalization data for multiple companies in a single request with the FMP Batch Market Capitalization API. This API allows users to compare the market size of various companies simultaneously, streamlining the analysis of company valuations.

Query parameter Type Example
symbols required string AAPL,MSFT,GOOG
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/market-capitalization-batch', { symbols: 'AAPL,MSFT,GOOG' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/market-capitalization-batch?symbols=AAPL%2CMSFT%2CGOOG"
MCP 
fmp_request({ "endpoint": "market-capitalization-batch", "params": {"symbols":"AAPL,MSFT,GOOG"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "date": "2025-10-24",
    "marketCap": 3900351299800
  }
]

Latest Mergers & Acquisitions

GET /api/data/fmp/stable/mergers-acquisitions-latest

Access real-time data on the latest mergers and acquisitions with the FMP Latest Mergers and Acquisitions API. This API provides key information such as the transaction date, company names, and links to detailed filing information for further analysis.

Query parameter Type Example
page number 0
limit number 100
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/mergers-acquisitions-latest', { page: '0', limit: '100' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/mergers-acquisitions-latest?page=0&limit=100"
MCP 
fmp_request({ "endpoint": "mergers-acquisitions-latest", "params": {"page":"0","limit":"100"} })
Example response + 
[
  {
    "symbol": "GNL-PE",
    "companyName": "Global Net Lease, Inc.",
    "cik": "0001526113",
    "targetedCompanyName": "Modiv Industrial, Inc.",
    "targetedCik": "0001645873",
    "targetedSymbol": "MDV",
    "transactionDate": "2026-06-01",
    "acceptedDate": "2026-06-01 07:09:29",
    "link": "https://www.sec.gov/Archives/edgar/data/1526113/000110465926068543/tm2615734-1_s4.htm"
  }
]

Company Profile Data

GET /api/data/fmp/stable/profile

Access detailed company profile data with the FMP Company Profile Data API. This API provides key financial and operational information for a specific stock symbol, including the company's market capitalization, stock price, industry, and much more.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/profile', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/profile?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "profile", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "price": 262.82,
    "marketCap": 3900351299800,
    "beta": 1.086,
    "lastDividend": 1.05,
    "range": "169.21-265.29",
    "change": 3.24,
    "changePercentage": 1.24817,
    "volume": 36725325,
    "averageVolume": 44645993,
    "companyName": "Apple Inc.",
    "currency": "USD",
    "cik": "0000320193",
    "isin": "US0378331005",
    "cusip": "037833100",
    "exchangeFullName": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "industry": "Consumer Electronics",
    "website": "https://www.apple.com",
    "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a line of multi-purpose tablets; and wearables, home, and accessories comprising AirPods, Apple TV, Apple Watch, Beats products, and HomePod. It also provides AppleCare support and cloud services; and operates various platforms, including the App Store that allow customers to discov...",
    "ceo": "Timothy D. Cook",
    "sector": "Technology",
    "country": "US",
    "fullTimeEmployees": "164000",
    "phone": "(408) 996-1010",
    "address": "One Apple Park Way",
    "city": "Cupertino",
    "state": "CA",
    "zip": "95014",
    "image": "https://images.financialmodelingprep.com/symbol/AAPL.png",
    "ipoDate": "1980-12-12",
    "defaultImage": false,
    "isEtf": false,
    "isActivelyTrading": true,
    "isAdr": false,
    "isFund": false
  }
]

Company Profile by CIK

GET /api/data/fmp/stable/profile-cik

Retrieve detailed company profile data by CIK (Central Index Key) with the FMP Company Profile by CIK API. This API allows users to search for companies using their unique CIK identifier and access a full range of company data, including stock price, market capitalization, industry, and much more.

Query parameter Type Example
cik required string 320193
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/profile-cik', { cik: '320193' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/profile-cik?cik=320193"
MCP 
fmp_request({ "endpoint": "profile-cik", "params": {"cik":"320193"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "price": 262.82,
    "marketCap": 3900351299800,
    "beta": 1.086,
    "lastDividend": 1.05,
    "range": "169.21-265.29",
    "change": 3.24,
    "changePercentage": 1.24817,
    "volume": 36725325,
    "averageVolume": 44645993,
    "companyName": "Apple Inc.",
    "currency": "USD",
    "cik": "0000320193",
    "isin": "US0378331005",
    "cusip": "037833100",
    "exchangeFullName": "NASDAQ Global Select",
    "exchange": "NASDAQ",
    "industry": "Consumer Electronics",
    "website": "https://www.apple.com",
    "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a line of multi-purpose tablets; and wearables, home, and accessories comprising AirPods, Apple TV, Apple Watch, Beats products, and HomePod. It also provides AppleCare support and cloud services; and operates various platforms, including the App Store that allow customers to discov...",
    "ceo": "Timothy D. Cook",
    "sector": "Technology",
    "country": "US",
    "fullTimeEmployees": "164000",
    "phone": "(408) 996-1010",
    "address": "One Apple Park Way",
    "city": "Cupertino",
    "state": "CA",
    "zip": "95014",
    "image": "https://images.financialmodelingprep.com/symbol/AAPL.png",
    "ipoDate": "1980-12-12",
    "defaultImage": false,
    "isEtf": false,
    "isActivelyTrading": true,
    "isAdr": false,
    "isFund": false
  }
]

Company Share Float & Liquidity

GET /api/data/fmp/stable/shares-float

Understand the liquidity and volatility of a stock with the FMP Company Share Float and Liquidity API. Access the total number of publicly traded shares for any company to make informed investment decisions.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/shares-float', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/shares-float?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "shares-float", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "AAPL",
    "date": "2026-06-05 08:13:10",
    "freeFloat": 99.83099999754891,
    "floatShares": 14662534368,
    "outstandingShares": 14687356000,
    "source": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/aapl-20260328.htm"
  }
]

All Shares Float

GET /api/data/fmp/stable/shares-float-all

Access comprehensive shares float data for all available companies with the FMP All Shares Float API. Retrieve critical information such as free float, float shares, and outstanding shares to analyze liquidity across a wide range of companies.

Query parameter Type Example
limit number 1000
page number 0
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/shares-float-all', { page: '0', limit: '1000' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/shares-float-all?page=0&limit=1000"
MCP 
fmp_request({ "endpoint": "shares-float-all", "params": {"page":"0","limit":"1000"} })
Example response + 
[
  {
    "symbol": "000001.SZ",
    "date": "2026-06-06 09:23:35",
    "freeFloat": 41.40900000201062,
    "floatShares": 8035796667,
    "outstandingShares": 19405918198
  }
]

Stock Peer Comparison

GET /api/data/fmp/stable/stock-peers

Identify and compare companies within the same sector and market capitalization range using the FMP Stock Peer Comparison API. Gain insights into how a company stacks up against its peers on the same exchange.

Query parameter Type Example
symbol required string AAPL
cvApi (in-app) 
const data = await cvApi.call('/fmp/stable/stock-peers', { symbol: 'AAPL' });
curl (REST) 
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/stock-peers?symbol=AAPL"
MCP 
fmp_request({ "endpoint": "stock-peers", "params": {"symbol":"AAPL"} })
Example response + 
[
  {
    "symbol": "GOOGL",
    "companyName": "Alphabet Inc.",
    "price": 368.53,
    "mktCap": 4457322549079
  }
]

Get example prompts & new data guides

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