ETFs & mutual funds
ETF holdings, sector and country weightings, plus mutual fund disclosures and holders.
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.
ETF Asset Exposure
GET /api/data/fmp/stable/etf/asset-exposure
Discover which ETFs hold specific stocks with the FMP ETF Asset Exposure API. Access detailed information on market value, share numbers, and weight percentages for assets within ETFs.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | AAPL |
const data = await cvApi.call('/fmp/stable/etf/asset-exposure', { symbol: 'AAPL' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/etf/asset-exposure?symbol=AAPL"fmp_request({ "endpoint": "etf/asset-exposure", "params": {"symbol":"AAPL"} })Example response +
[
{
"symbol": "ZPDT.DE",
"asset": "AAPL",
"sharesNumber": 1170753,
"weightPercentage": 17.56283,
"marketValue": 316188722.3272
}
] ETF & Fund Country Allocation
GET /api/data/fmp/stable/etf/country-weightings
Gain insight into how ETFs and mutual funds distribute assets across different countries with the FMP ETF & Fund Country Allocation API. This tool provides detailed information on the percentage of assets allocated to various regions, helping you make informed investment decisions.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | SPY |
const data = await cvApi.call('/fmp/stable/etf/country-weightings', { symbol: 'SPY' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/etf/country-weightings?symbol=SPY"fmp_request({ "endpoint": "etf/country-weightings", "params": {"symbol":"SPY"} })Example response +
[
{
"country": "United States",
"weightPercentage": "97.82%"
}
] ETF & Fund Holdings
GET /api/data/fmp/stable/etf/holdings
Get a detailed breakdown of the assets held within ETFs and mutual funds using the FMP ETF & Fund Holdings API. Access real-time data on the specific securities and their weights in the portfolio, providing insights into asset composition and fund strategies.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | SPY |
const data = await cvApi.call('/fmp/stable/etf/holdings', { symbol: 'SPY' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/etf/holdings?symbol=SPY"fmp_request({ "endpoint": "etf/holdings", "params": {"symbol":"SPY"} })Example response +
[
{
"symbol": "SPY",
"asset": "NVDA",
"name": "NVIDIA CORP",
"isin": "US67066G1040",
"securityCusip": "67066G104",
"sharesNumber": 294624332,
"weightPercentage": 8.16350993,
"marketValue": 64429253531,
"updatedAt": "2026-06-06 05:06:19"
}
] ETF & Mutual Fund Information
GET /api/data/fmp/stable/etf/info
Access comprehensive data on ETFs and mutual funds with the FMP ETF & Mutual Fund Information API. Retrieve essential details such as ticker symbol, fund name, expense ratio, assets under management, and more.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | SPY |
const data = await cvApi.call('/fmp/stable/etf/info', { symbol: 'SPY' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/etf/info?symbol=SPY"fmp_request({ "endpoint": "etf/info", "params": {"symbol":"SPY"} })Example response +
[
{
"symbol": "SPY",
"name": "State Street SPDR S&P 500 ETF Trust",
"description": "The State Street SPDR S&P 500 ETF Trust seeks to provide investment results that, before expenses, correspond generally to the price and yield performance of the S&P 500 Index (the “Index”)The S&P 500 Index is a diversified large cap U.S. index that holds companies across all eleven GICS sectorsLaunched in January 1993, SPY was the very first exchange traded fund listed in the United States",
"isin": "US78462F1030",
"assetClass": "Equity",
"securityCusip": "78462F103",
"domicile": "US",
"website": "https://www.ssga.com/us/en/institutional/etfs/state-street-spdr-sp-500-etf-trust-spy",
"etfCompany": "SPDR",
"expenseRatio": 0.09,
"assetsUnderManagement": 789870290000,
"avgVolume": 73651172,
"inceptionDate": "1993-01-22",
"nav": 756.92,
"navCurrency": "USD",
"holdingsCount": 504,
"isActivelyTrading": true,
"updatedAt": "2026-06-06T07:46:00.054Z",
"sectorsList": [
{
"industry": "Basic Materials",
"exposure": 1.8
},
{
"industry": "Communication Services",
"exposure": 11.35
},
{
"industry": "Consumer Cyclical",
"exposure": 10.25
}
]
}
] ETF Sector Weighting
GET /api/data/fmp/stable/etf/sector-weightings
The FMP ETF Sector Weighting API provides a breakdown of the percentage of an ETF's assets that are invested in each sector. For example, an investor may want to invest in an ETF that has a high exposure to the technology sector if they believe that the technology sector is poised for growth.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | SPY |
const data = await cvApi.call('/fmp/stable/etf/sector-weightings', { symbol: 'SPY' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/etf/sector-weightings?symbol=SPY"fmp_request({ "endpoint": "etf/sector-weightings", "params": {"symbol":"SPY"} })Example response +
[
{
"symbol": "SPY",
"sector": "Basic Materials",
"weightPercentage": 1.8
}
] Mutual Fund Disclosures
GET /api/data/fmp/stable/funds/disclosure
Access comprehensive disclosure data for mutual funds with the FMP Mutual Fund Disclosures API. Analyze recent filings, balance sheets, and financial reports to gain insights into mutual fund portfolios.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | VWO |
year required | string | 2023 |
quarter required | string | 4 |
cik | string | 0000857489 |
const data = await cvApi.call('/fmp/stable/funds/disclosure', { symbol: 'VWO', year: '2023', quarter: '4' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/funds/disclosure?symbol=VWO&year=2023&quarter=4"fmp_request({ "endpoint": "funds/disclosure", "params": {"symbol":"VWO","year":"2023","quarter":"4"} })Example response +
[
{
"cik": "0000857489",
"date": "2023-10-31",
"acceptedDate": "2023-12-28 09:26:13",
"symbol": "000089.SZ",
"name": "Shenzhen Airport Co Ltd",
"lei": "3003009W045RIKRBZI44",
"title": "SHENZ AIRPORT-A",
"cusip": "N/A",
"isin": "CNE000000VK1",
"balance": 2438784,
"units": "NS",
"cur_cd": "CNY",
"valUsd": 2255873.6,
"pctVal": 0.0023838966190458206,
"payoffProfile": "Long",
"assetCat": "EC",
"issuerCat": "CORP",
"invCountry": "CN",
"isRestrictedSec": "N",
"fairValLevel": "2",
"isCashCollateral": "N",
"isNonCashCollateral": "N",
"isLoanByFund": "N"
}
] Fund & ETF Disclosures by Date
GET /api/data/fmp/stable/funds/disclosure-dates
Retrieve detailed disclosures for mutual funds and ETFs based on filing dates with the FMP Fund & ETF Disclosures by Date API. Stay current with the latest filings and track regulatory updates effectively.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | VWO |
cik | string | 0000036405 |
const data = await cvApi.call('/fmp/stable/funds/disclosure-dates', { symbol: 'VWO' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/funds/disclosure-dates?symbol=VWO"fmp_request({ "endpoint": "funds/disclosure-dates", "params": {"symbol":"VWO"} })Example response +
[
{
"date": "2026-01-31",
"year": 2026,
"quarter": 1
}
] Mutual Fund & ETF Disclosure
GET /api/data/fmp/stable/funds/disclosure-holders-latest
Access the latest disclosures from mutual funds and ETFs with the FMP Mutual Fund & ETF Disclosure API. This API provides updates on filings, changes in holdings, and other critical disclosure data for mutual funds and ETFs.
| Query parameter | Type | Example |
|---|---|---|
symbol required | string | AAPL |
const data = await cvApi.call('/fmp/stable/funds/disclosure-holders-latest', { symbol: 'AAPL' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/funds/disclosure-holders-latest?symbol=AAPL"fmp_request({ "endpoint": "funds/disclosure-holders-latest", "params": {"symbol":"AAPL"} })Example response +
[
{
"cik": "0000071958",
"holder": "NICHOLAS FUND, INC.",
"securityCusip": "037833100",
"shares": 659910,
"dateReported": "2026-04-30",
"change": 0,
"weightPercent": 0.56338049
}
] Mutual Fund & ETF Disclosure Name Search
GET /api/data/fmp/stable/funds/disclosure-holders-search
Easily search for mutual fund and ETF disclosures by name using the Mutual Fund & ETF Disclosure Name Search API. This API allows you to find specific reports and filings based on the fund or ETF name, providing essential details like CIK number, entity information, and reporting file number.
| Query parameter | Type | Example |
|---|---|---|
name required | string | Federated Hermes Government Income Securities, Inc. |
const data = await cvApi.call('/fmp/stable/funds/disclosure-holders-search', { name: 'Federated' });curl -H "Authorization: Bearer cv_live_..." \
"https://tap.convexvalue.com/api/data/fmp/stable/funds/disclosure-holders-search?name=Federated"fmp_request({ "endpoint": "funds/disclosure-holders-search", "params": {"name":"Federated"} })Example response +
[
{
"symbol": "FGOAX",
"cik": "0000355691",
"classId": "C000024574",
"seriesId": "S000009042",
"entityName": "Federated Hermes Government Income Securities, Inc.",
"entityOrgType": "30",
"seriesName": "Federated Hermes Government Income Securities, Inc.",
"className": "Class A Shares",
"reportingFileNumber": "811-03266",
"address": "4000 ERICSSON DRIVE",
"city": "WARRENDALE",
"zipCode": "15086-7561",
"state": "PA"
}
] Get example prompts & new data guides
Occasional emails with prompts worth trying and what’s new in the data.