FMP Node API Documentation

Core API Wrapper

Mutual Fund Endpoints

The Mutual Fund Endpoints provide access to mutual fund holder data. This allows you to see which mutual funds hold a specific stock and their positions. For mutual fund quotes, use the general quote endpoint documented in the Quote Endpoints.

Available Methods

Method	Endpoint	Description
GET	/mutual-fund-holder/{symbol}	Get mutual fund holders of a specific stock

Get Mutual Fund Holders

Retrieve the mutual funds that hold a specific stock and their positions. This is essential for understanding which mutual funds are invested in particular stocks and their respective holdings.

1const holders = await fmp.mutualFund.getHolders('AAPL');

Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Stock symbol (e.g., "AAPL", "MSFT", "GOOGL")

Example Response

1{
2  success: true,
3  data: [
4    {
5      holder: 'Vanguard 500 Index Fund',
6      shares: 1234567,
7      dateReported: '2024-03-31',
8      change: 10000,
9      weightPercent: 12.34
10    },
11    {
12      holder: 'Fidelity Contrafund',
13      shares: 987654,
14      dateReported: '2024-03-31',
15      change: -5000,
16      weightPercent: 9.87
17    }
18  ]
19}

Usage Examples

1// Get mutual funds that hold Apple stock
2const appleHolders = await fmp.mutualFund.getHolders('AAPL');
3console.log(`${appleHolders.data.length} mutual funds hold AAPL`);
4
5// Get mutual funds that hold Microsoft stock
6const msftHolders = await fmp.mutualFund.getHolders('MSFT');
7
8// Find top mutual fund holders by shares
9const topHolders = msftHolders.data
10.sort((a, b) => (b.shares || 0) - (a.shares || 0))
11.slice(0, 10);
12console.log('Top 10 mutual fund holders by shares:');
13topHolders.forEach((holder, index) => {
14console.log(`${index + 1}. ${holder.holder}: ${holder.shares.toLocaleString()} shares`);
15});

Error Handling

Always check the success property before accessing data:

1const holders = await fmp.mutualFund.getHolders('INVALID');
2
3if (holders.success && holders.data) {
4console.log('Mutual Fund Holders:', holders.data);
5} else {
6console.error('Error:', holders.error);
7console.error('Status:', holders.status);
8}

Notes

The getHolders method returns the mutual funds that hold a given stock and their respective positions.
Use this endpoint to analyze which mutual funds are invested in particular stocks.
For mutual fund quotes, use the Quote Endpoints.
All mutual fund data is sourced from Financial Modeling Prep's comprehensive financial database.
Common stock symbols to analyze include:
- AAPL - Apple Inc.
- MSFT - Microsoft Corporation
- GOOGL - Alphabet Inc.

Next: Explore other endpoint categories like ETF Data or Stock Data.