ETF Endpoints

1const profile = await fmp.etf.getProfile('SPY');

1{
2  success: true,
3  data: {
4    symbol: 'SPY',
5    name: 'SPDR S&P 500 ETF Trust',
6    assetClass: 'Equity',
7    aum: 500000000000,
8    avgVolume: 75000000,
9    cusip: '78462F103',
10    description: 'The SPDR S&P 500 ETF Trust tracks the S&P 500 Index',
11    domicile: 'United States',
12    etfCompany: 'State Street Global Advisors',
13    expenseRatio: 0.0945,
14    inceptionDate: '1993-01-29',
15    isin: 'US78462F1030',
16    nav: 450.25,
17    navCurrency: 'USD',
18    sectorsList: [
19      {
20        exposure: 'Technology',
21        industry: 'Software'
22      }
23    ],
24    website: 'https://www.ssga.com',
25    holdingsCount: 500
26  }
27}

1const holdingDates = await fmp.etf.getHoldingDates('SPY');

1{
2  success: true,
3  data: [
4    {
5      date: '2024-01-15'
6    },
7    {
8      date: '2024-01-08'
9    }
10  ]
11}

1const holdings = await fmp.etf.getHoldings({ 
2  symbol: 'SPY',
3  date: '2024-01-15'
4});

1{
2  success: true,
3  data: [
4    {
5      cik: '0000320193',
6      acceptanceTime: '2024-01-15T16:30:00.000Z',
7      date: '2024-01-15',
8      symbol: 'AAPL',
9      name: 'Apple Inc.',
10      lei: 'HWUPKR0MPOU8FGXBT394',
11      title: 'Common Stock',
12      cusip: '037833100',
13      isin: 'US0378331005',
14      balance: 1000000,
15      units: 'SHRS',
16      cur_cd: 'USD',
17      valUsd: 150000000,
18      pctVal: 7.5,
19      payoffProfile: 'Long',
20      assetCat: 'Equity',
21      issuerCat: 'Corporate',
22      invCountry: 'US',
23      isRestrictedSec: 'N',
24      fairValLevel: '1',
25      isCashCollateral: 'N',
26      isNonCashCollateral: 'N',
27      isLoanByFund: 'N'
28    }
29  ]
30}

1const holder = await fmp.etf.getHolder('SPY');

1{
2  success: true,
3  data: [
4    {
5      asset: 'AAPL',
6      name: 'Apple Inc.',
7      isin: 'US0378331005',
8      cusip: '037833100',
9      sharesNumber: 1000000,
10      weightPercentage: 7.5,
11      marketValue: 150000000,
12      updated: '2024-01-15'
13    }
14  ]
15}

1const sectorWeighting = await fmp.etf.getSectorWeighting('SPY');

1{
2  success: true,
3  data: [
4    {
5      sector: 'Technology',
6      weightPercentage: '32.62%'
7    },
8    {
9      sector: 'Financial Services',
10      weightPercentage: '12.48%'
11    },
12    {
13      sector: 'Healthcare',
14      weightPercentage: '12.1%'
15    }
16  ]
17}

1const countryWeighting = await fmp.etf.getCountryWeighting('SPY');

1{
2  success: true,
3  data: [
4    {
5      country: 'United States',
6      weightPercentage: '99.37%'
7    },
8    {
9      country: 'Switzerland',
10      weightPercentage: '0.3%'
11    },
12    {
13      country: 'Netherlands',
14      weightPercentage: '0.14%'
15    }
16  ]
17}

1const stockExposure = await fmp.etf.getStockExposure('AAPL');

1{
2  success: true,
3  data: [
4    {
5      etfSymbol: 'SPY',
6      assetExposure: 'AAPL',
7      sharesNumber: 1000000,
8      weightPercentage: 7.5,
9      marketValue: 150000000
10    },
11    {
12      etfSymbol: 'QQQ',
13      assetExposure: 'AAPL',
14      sharesNumber: 500000,
15      weightPercentage: 12.3,
16      marketValue: 75000000
17    }
18  ]
19}

1interface ETFProfile {
2  symbol: string;
3  assetClass: string;
4  aum: number;
5  avgVolume: number;
6  cusip: string;
7  description: string;
8  domicile: string;
9  etfCompany: string;
10  expenseRatio: number;
11  inceptionDate: string;
12  isin: string;
13  name: string;
14  nav: number;
15  navCurrency: string;
16  sectorsList: {
17    exposure: string;
18    industry: string;
19  }[];
20  website: string;
21  holdingsCount: number;
22}

1interface ETFHolding {
2  cik: string;
3  acceptanceTime: string;
4  date: string;
5  symbol: string;
6  name: string;
7  lei: string;
8  title: string;
9  cusip: string;
10  isin: string;
11  balance: number;
12  units: string;
13  cur_cd: string;
14  valUsd: number;
15  pctVal: number;
16  payoffProfile: string;
17  assetCat: string;
18  issuerCat: string;
19  invCountry: string;
20  isRestrictedSec: string;
21  fairValLevel: string;
22  isCashCollateral: string;
23  isNonCashCollateral: string;
24  isLoanByFund: string;
25}

1interface ETFHolder {
2  asset: string;
3  name: string;
4  isin: string;
5  cusip: string;
6  sharesNumber: number;
7  weightPercentage: number;
8  marketValue: number;
9  updated: string;
10}

1interface ETFWeighting {
2  sector: string;
3  weightPercentage: string;
4}

1interface ETFCountryWeighting {
2  country: string;
3  weightPercentage: string;
4}

1interface ETFStockExposure {
2  etfSymbol: string;
3  assetExposure: string;
4  sharesNumber: number;
5  weightPercentage: number;
6  marketValue: number;
7}

1const profile = await fmp.etf.getProfile('INVALID');
2
3if (profile.success && profile.data) {
4console.log('ETF Name:', profile.data.name);
5console.log('Expense Ratio:', profile.data.expenseRatio);
6} else {
7console.error('Error:', profile.error);
8console.error('Status:', profile.status);
9}