Mutual Funds API
Receive an API key immediately and have access to the Mutual Funds data right away
Mutual Fund Holdings API - Features
Mutual Fund Holdings API is a useful tool to get publicly available mutual fund holdings data including the stock prices and other securities in the MFHs, stock ticker symbols and identifiers, exchange names, the number of holdings, the percentage of portfolio, the value of holdings and more, all in one in a single API response. The data is collected directly from official mutual funds websites and SEC reports and accessed in JSON format. The data is available historically and updated in real-time allowing you to track the changes in the portfolio (and the value of each item in it) of the mutual fund holdings you are interested in.
Use Mutual Funds Data to Build Your Platform
The data provided with the Mutual Fund Holdings API is used for viewing and analyzing the stocks and other securities in publicly available mutual fund holdings item by item. Access Finnworlds Mutual Fund Holdings Database and determine if a MFH is worth investing in. Build a platform for your clients on which they can do the same efficiently.
Mutual Fund Data for Businesses of All Sizes
Find out what stocks and securities a mutual fund holding consists of, and get data about the entire portfolio of a MFH through the API system.
Historical Data via the Fund Holdings API
Add a particular date as a filtering parameter in the Mutual Fund Holdings API endpoint, so that you can view the case of the mutual fund. By obtaining mutual fund holding data of a certain past period that keeps being up-to-date through the API, you are able to spot and analyze trends in the MFH. Such data can be used for predicting if a mutual fund is worth investing in, or giving ideas on the spotted trends of mutual funds.
Code Examples for the Mutual Fund Holdings API
Code Examples for the Mutual Fund Holdings API
https://api.finnworlds.com/api/v1/etfinfo
?key=API-KEY
&cik=1137095
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "111438858.600000000000",
"total_liabilities": "1741129.050000000000",
"net_assets": "109697729.550000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "591000.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "2545141.120000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
},
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Navigator Fund",
"series_id": "S000058976",
"series_lei": "549300CS0EIS27ZLBG68",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "44290035.570000000000",
"total_liabilities": "208427.160000000000",
"net_assets": "44081608.410000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "0.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "34462732.210000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfinfo
?key=API-KEY
&cik=1137095
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"general": {
"fund_name": "USA Mutuals",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93",
"country": "US",
"state": "US-TX",
"city": "Dallas",
"zip": "75201",
"street": "700 N. Pearl Street",
"phone": "866-264-8783"
},
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"fund_info": {
"total_assets": "111438858.600000000000",
"total_liabilities": "1741129.050000000000",
"net_assets": "109697729.550000000000",
"assets_attr_misc_sec": "0.000000000000",
"invested_assets": "0.000000000000",
"one_yr_banks_borr": "591000.000000000000",
"one_yr_ctrld_comp": "0.000000000000",
"one_yr_oth_affil": "0.000000000000",
"one_yr_other": "0.000000000000",
"aft_one_yr_banks_borr": "0.000000000000",
"aft_one_yr_ctrld_comp": "0.000000000000",
"aft_one_yr_oth_affil": "0.000000000000",
"aft_one_yr_other": "0.000000000000",
"delivery_delay": "0.000000000000",
"standby_commit": "0.000000000000",
"liquid_pref": "0.000000000000",
"cash_not_reported_in_cor_d": "2545141.120000000000",
"non_cash_collateral": "N",
"currency": "Null"
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfreturns
?key=API-KEY
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"signature": {
"date_signed": "2021-02-09",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "Richard Sapio",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "-6.820000000000",
"rtn2": "15.030000000000",
"rtn3": "4.540000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "-6.780000000000",
"rtn2": "15.000000000000",
"rtn3": "4.530000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "-6.850000000000",
"rtn2": "14.920000000000",
"rtn3": "4.520000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "-6.780000000000",
"rtn2": "15.060000000000",
"rtn3": "4.560000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "1047242.290000000000",
"net_unrealized_appreciation": "-8495540.410000000000"
},
"other_monthly2": {
"net_realized_gain": "682677.450000000000",
"net_unrealized_appreciation": "14452752.560000000000"
},
"other_monthly3": {
"net_realized_gain": "81689.110000000000",
"net_unrealized_appreciation": "4566807.660000000000"
},
"month_1_flow": {
"redemption": "-2555820.560000000000",
"reinvestment": ".000000000000",
"sales": "127367.110000000000"
},
"month_2_flow": {
"redemption": "-3177883.990000000000",
"reinvestment": ".000000000000",
"sales": "769141.370000000000"
},
"month_3_flow": {
"redemption": "-3281011.540000000000",
"reinvestment": "4079781.690000000000",
"sales": "240630.130000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "-68969.790000000000",
"net_unrealized_appreciation": "455219.160000000000"
},
"month2": {
"net_realized_gain": "-107563.080000000000",
"net_unrealized_appreciation": "-708108.530000000000"
},
"month3": {
"net_realized_gain": "162179.700000000000",
"net_unrealized_appreciation": "2346.670000000000"
},
"future_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon2": {
"net_realized_gain": "102949.590000000000",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "199347.040000000000",
"net_unrealized_appreciation": "51156.750000000000"
}
},
"option_category": {
"instrmon1": {
"net_realized_gain": "-68969.790000000000",
"net_unrealized_appreciation": "455219.160000000000"
},
"instrmon2": {
"net_realized_gain": "-210512.670000000000",
"net_unrealized_appreciation": "-708108.530000000000"
},
"instrmon3": {
"net_realized_gain": "-37167.340000000000",
"net_unrealized_appreciation": "-48810.080000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "1.610000000000",
"rtn2": "5.250000000000",
"rtn3": "-3.730000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "1.580000000000",
"rtn2": "5.280000000000",
"rtn3": "-3.750000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "1.500000000000",
"rtn2": "5.220000000000",
"rtn3": "-3.810000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "1.590000000000",
"rtn2": "5.310000000000",
"rtn3": "-3.740000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "17728.310000000000",
"net_unrealized_appreciation": "2149139.690000000000"
},
"other_monthly2": {
"net_realized_gain": "425818.750000000000",
"net_unrealized_appreciation": "5464610.260000000000"
},
"other_monthly3": {
"net_realized_gain": "-1692066.620000000000",
"net_unrealized_appreciation": "-2557720.590000000000"
},
"month_1_flow": {
"redemption": "-3327168.330000000000",
"reinvestment": ".000000000000",
"sales": "382606.240000000000"
},
"month_2_flow": {
"redemption": "-3852681.050000000000",
"reinvestment": ".000000000000",
"sales": "120353.170000000000"
},
"month_3_flow": {
"redemption": "-2077752.460000000000",
"reinvestment": ".000000000000",
"sales": "118110.300000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"month3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-417175.900000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-337050.000000000000"
},
"instrmon3": {
"net_realized_gain": "-431129.000000000000",
"net_unrealized_appreciation": "538894.960000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-06-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-08-11",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "11.730000000000",
"rtn2": "5.690000000000",
"rtn3": "-1.100000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "11.710000000000",
"rtn2": "5.690000000000",
"rtn3": "-1.110000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "11.610000000000",
"rtn2": "5.620000000000",
"rtn3": "-1.130000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "11.730000000000",
"rtn2": "5.720000000000",
"rtn3": "-1.080000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "-2130751.400000000000",
"net_unrealized_appreciation": "13968148.260000000000"
},
"other_monthly2": {
"net_realized_gain": "52361.540000000000",
"net_unrealized_appreciation": "6134166.550000000000"
},
"other_monthly3": {
"net_realized_gain": "-314956.190000000000",
"net_unrealized_appreciation": "-1040043.970000000000"
},
"month_1_flow": {
"redemption": "-2606649.580000000000",
"reinvestment": ".000000000000",
"sales": "436922.980000000000"
},
"month_2_flow": {
"redemption": "-3384584.510000000000",
"reinvestment": ".000000000000",
"sales": "699109.070000000000"
},
"month_3_flow": {
"redemption": "-3494245.050000000000",
"reinvestment": ".000000000000",
"sales": "408949.640000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "163161.150000000000"
},
"option_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "163161.150000000000"
}
}
}
}
}
},
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-03-31",
"end_report_period": "2020-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-05-28",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"return_info": {
"monthly_total_returns": [
{
"class_id": "C000014988",
"0": {
"rtn1": "-1.380000000000",
"rtn2": "-8.420000000000",
"rtn3": "-18.560000000000"
}
},
{
"class_id": "C000106574",
"0": {
"rtn1": "-1.390000000000",
"rtn2": "-8.430000000000",
"rtn3": "-18.530000000000"
}
},
{
"class_id": "C000106575",
"0": {
"rtn1": "-1.390000000000",
"rtn2": "-8.540000000000",
"rtn3": "-18.570000000000"
}
},
{
"class_id": "C000129812",
"0": {
"rtn1": "-1.400000000000",
"rtn2": "-8.400000000000",
"rtn3": "-18.510000000000"
}
}
],
"other_monthly1": {
"net_realized_gain": "-1536818.810000000000",
"net_unrealized_appreciation": "-263003.810000000000"
},
"other_monthly2": {
"net_realized_gain": "-253.590000000000",
"net_unrealized_appreciation": "-11963363.090000000000"
},
"other_monthly3": {
"net_realized_gain": "2889957.560000000000",
"net_unrealized_appreciation": "-27422527.950000000000"
},
"month_1_flow": {
"redemption": "-2904481.300000000000",
"reinvestment": ".000000000000",
"sales": "596938.080000000000"
},
"month_2_flow": {
"redemption": "-2857512.430000000000",
"reinvestment": ".000000000000",
"sales": "600369.900000000000"
},
"month_3_flow": {
"redemption": "-4990773.570000000000",
"reinvestment": ".000000000000",
"sales": "689616.070000000000"
},
"monthly_return_categories": {
"equity": {
"month1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-749.980000000000"
},
"month2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"month3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"warrant_category": {
"instrmon1": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "-749.980000000000"
},
"instrmon2": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
},
"instrmon3": {
"net_realized_gain": "N/A",
"net_unrealized_appreciation": "N/A"
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfholdings
?key=API-KEY
&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "Altria Group Inc",
"lei": "XSGZFLO9YTNO9VCQV219",
"isin": "US02209S1033",
"cusip": "02209S103",
"balance": "40000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1545600.000000000000",
"percent_value": "1.4645203739",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "469194.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "2918159.280000000000",
"percent_value": "2.7650774585",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Boeing Co/The",
"lei": "RVHJWBXLJ1RFUBSY1F30",
"isin": "US0970231058",
"cusip": "097023105",
"balance": "17000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "2809420.000000000000",
"percent_value": "2.6620424618",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5169450.000000000000",
"percent_value": "4.8982691816",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5050000.000000000000",
"percent_value": "4.7850853315",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3600690.000000000000",
"percent_value": "3.4118037430",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5437570.000000000000",
"percent_value": "5.1523240487",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5884000.000000000000",
"percent_value": "5.5753350674",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "607103.830000000000",
"units": "NS",
"currency": "USD",
"value_usd": "607103.830000000000",
"percent_value": "0.5752561647",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
ETC
}
]
}
]
}
}
https://api.finnworlds.com/api/v1/etfreturns
?key=API-KEY
&series_id=S000005505
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-12-31",
"end_report_period": "2021-03-31",
"final_filing": 1
},
"signature": {
"date_signed": "2021-02-09",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "Richard Sapio",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "477704.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "3193142.180000000000",
"percent_value": "2.9108553049",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5361070.000000000000",
"percent_value": "4.8871294073",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "6700000.000000000000",
"percent_value": "6.1076924996",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "4161950.000000000000",
"percent_value": "3.7940165371",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "6272995.000000000000",
"percent_value": "5.7184364943",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Direxion Russell 1000 Value Ov",
"lei": "5493003NCTXSFN4SD519",
"isin": "US25460E4558",
"cusip": "25460E455",
"balance": "7000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "343727.300000000000",
"percent_value": "0.3133403958",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "4656000.000000000000",
"percent_value": "4.2443904893",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "851.730000000000",
"units": "NS",
"currency": "USD",
"value_usd": "851.730000000000",
"percent_value": "0.0007764336",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Gaming and Leisure Properties",
"lei": "5493006GWRDBCZYWTM57",
"isin": "US36467J1088",
"cusip": "36467J108",
"balance": "28322.427000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1200870.900000000000",
"percent_value": "1.0947089834",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
ETC
}
}
}
}
}
}
]
}
}
https://api.finnworlds.com/api/v1/etfreturns
?key=API-KEY
&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"fund_name": "USA Mutuals",
"file_number": "811-10319",
"cik": "0001137095",
"reg_lei": "549300IJ0KFT977YGX93"
},
"output": [
{
"attributes": {
"series_name": "USA Mutuals Vitium Global Fund",
"series_id": "S000005505",
"series_lei": "549300GX5CPIZQ5PDX31",
"date_report_period": "2020-09-30",
"end_report_period": "2021-03-31",
"final_filing": 0
},
"signature": {
"date_signed": "2020-11-23",
"name_of_applicant": "USA Mutuals",
"signature": "/s/ Richard Sapio",
"signer_name": "USA Mutuals",
"title": "President"
},
"holdings": [
{
"investment_security": {
"name": "Altria Group Inc",
"lei": "XSGZFLO9YTNO9VCQV219",
"isin": "US02209S1033",
"cusip": "02209S103",
"balance": "40000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1545600.000000000000",
"percent_value": "1.4645203739",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "BAE Systems PLC",
"lei": "8SVCSVKSGDWMW2QHOH83",
"isin": "GB0002634946",
"cusip": "G06940103",
"balance": "469194.000000000000",
"units": "NS",
"currency": "GBP",
"value_usd": "2918159.280000000000",
"percent_value": "2.7650774585",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Boeing Co/The",
"lei": "RVHJWBXLJ1RFUBSY1F30",
"isin": "US0970231058",
"cusip": "097023105",
"balance": "17000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "2809420.000000000000",
"percent_value": "2.6620424618",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "British American Tobacco PLC",
"lei": "213800FKA5MF17RJKT63",
"isin": "US1104481072",
"cusip": "110448107",
"balance": "143000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5169450.000000000000",
"percent_value": "4.8982691816",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "Cameco Corp",
"lei": "N4BHALMXL3GMZKCUON55",
"isin": "CA13321L1085",
"cusip": "13321L108",
"balance": "500000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5050000.000000000000",
"percent_value": "4.7850853315",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "CA",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Constellation Brands Inc",
"lei": "5493005GKEG8QCVY7037",
"isin": "US21036P1084",
"cusip": "21036P108",
"balance": "19000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3600690.000000000000",
"percent_value": "3.4118037430",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Diageo PLC",
"lei": "213800ZVIELEA55JMJ32",
"isin": "US25243Q2057",
"cusip": "25243Q205",
"balance": "39500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5437570.000000000000",
"percent_value": "5.1523240487",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "GB",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "DraftKings Inc",
"lei": "5493008P45UYYL683Z97",
"isin": "US26142R1041",
"cusip": "26142R104",
"balance": "100000.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "5884000.000000000000",
"percent_value": "5.5753350674",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "Y"
}
},
{
"investment_security": {
"name": "First American Treasury Obliga",
"lei": "N/A",
"isin": "US31846V3289",
"cusip": "31846V328",
"balance": "607103.830000000000",
"units": "NS",
"currency": "USD",
"value_usd": "607103.830000000000",
"percent_value": "0.5752561647",
"payoff_profile": "Long",
"asset_category": "STIV",
"issuer_category": "RF",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "Gaming and Leisure Properties",
"lei": "5493006GWRDBCZYWTM57",
"isin": "US36467J1088",
"cusip": "36467J108",
"balance": "27936.930000000000",
"units": "NS",
"currency": "USD",
"value_usd": "1031710.820000000000",
"percent_value": "0.9775889725",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
"name": "General Dynamics Corp",
"lei": "9C1X8XOOTYY2FNYTVH06",
"isin": "US3695501086",
"cusip": "369550108",
"balance": "26500.000000000000",
"units": "NS",
"currency": "USD",
"value_usd": "3668395.000000000000",
"percent_value": "3.4759570504",
"payoff_profile": "Long",
"asset_category": "EC",
"issuer_category": "CORP",
"invested_country": "US",
"restricted_sec": "N",
"fair_value_level": "1",
"cash_collateral": "N",
"non_cash_collateral": "N",
"loan_by_fund": "N"
}
},
{
"investment_security": {
ETC
}
}
]
}
]
}
}
| Response Objects | Description |
| name | Name of the security |
| lei | lei of the security |
| isin | ISIN of the security |
| cusip | Cusip of the security |
| balance | balance held in this security |
| units | Number of units held in this security |
| currency | The currency of this security |
| value_usd | The value in USD of this security holding |
| percent_value | Percentage of the total value of the security |
| payoff_profile | Payoff profile of security, for example “long” |
Mutul Funds API
Integrating the Mutual Funds API into your product will allow your end-users to get updated data on mutual fund holdings on a daily basis. They will be able to keep up with the changes in the mutual funds based on new weekly, monthly, quarterly or annually reports made available by the mutual funds themselves and also through SEC. Since mutual funds are not always publicly available to invest in, unlike exchange traded funds, we gather data on mutual funds that have been publicly announced, and store and maintain it in the Mutual Holdings Funds Database.
You can get mutual fund data based on the identifier of the mutual fund itself, or focus on a specific stock or securities and examine in which mutual funds that stock or securities are available. Since mutual funds are more actively managed unlike ETFs, it is important to keep updated with the changes in the funds to be able to benefit from this advantage early, and possibly beat the market. For this reason, the Mutual Funds API provides details such as how many holdings the mutual fund holds, their percent of portfolio, and current total value, all asset by asset (for example, stock by stock), and makes sure that every time you make a new API call, this data is up-to-date.
Mutual Funds Data
The Mutual Funds Data is useful for keeping a track of daily or periodical buys and sells with its updated data on how the value of stocks in the mutual funds change. You can do analysis on certain periods you consider important and create charts or even an algorithm based on the data. You can also meet investment objectives and track the trends in the market based on the results you get. As mutual funds are known for investing in a pretty vast number of securities, tracking their performance and the market cap can be important. Finnworlds Mutual Funds Database was created in such a way to provide you with this data without having to build and maintain one yourself. Access historical and real-time mutual funds data easily and focus on your core business instead.
Sources
Mutual funds data is sourced from the websites of mutual funds and from SEC on a daily, weekly, monthly, quarterly and yearly basis. Furthermore, the data is updated from the reports that mutual funds disclose. In this way, we ensure data quality as we gather it accurately from credible sources.
The SEC Filings
Every quarter, many mutual funds, report to the SEC, we will have our database updated based on this.
Directly From the Mutual Fund Reports
We obtain reports from mutual funds directly as they update their holdings daily, weekly, monthly, etc..
Mutual Fund Websites
As a mutual fund updates their holding details on their website, we will update our database. This is not always available.
Formats to Download the Data
The mutual funds data is accessible in three main formats. In this way, Finnworlds fully addresses your needs for data delivery formats. Request your data format and get mutual funds data instantly. No matter the format of your choice, you obtain mutual funds data without any differences in the data transfer time. Please, contact support@finnworlds.com for notifying which data format you prefer. You can always change the data delivery format.
Excel and CSV
If you choose this data format, you will access mutual funds data through database downloads formatted as either Excel or CSV files.
E-mail link
If you choose this data format, you will receive an email containing a link through which you can download mutual funds data.
Pdf Report
If you choose this data format, you will get mutual funds data in a downloadable PDF report.
Developer Notes
The Mutual Funds API returns raw data in JSON format. It is compatible with all major SDKs to develop the optimal tool, app or website for all platforms. It is important that your clients are able to use the product you build without delays and downtimes. The API covers this requirement with 99.5% server uptime rates and fast response times at around 0.3 depending on the data load of the API call.The Mutual Funds API is compatible to build any kind of project, either for personal or commercial use. You can use the API with any programming and script languages to build iOS apps, Android apps, web apps, online tools, software, perform analysis to create documentation, charts, algorithms, and more.
SDKs and Devkits
The API works with: Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift and Scala
REST JSON and XML
Data output can be requested in REST Json format or XML format
Excel and CSV
In case you do not want the data through our API, request it in Excel or CSV format.
Mutual Fund Holdings API – Get Started
Getting started is easy by setting up a subscription within a minute. Choose the best subscription plan for you below and receive your API key to your email automatically. Use the API right away with no further authorization. Start testing with the super-reduced trial prices for the first month. Depending on how your tests go, cancel or upgrade your plan anytime.
Control the Data
/mutualfundholdings&stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT
stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT