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 Asset Allocation Data
Mutual Fund Holdings API is a useful tool to get detailed JSON data on mutual funds using their unique identifier codes. Each API response delivers comprehensive data for the mutual fund, including fundamentals, asset allocation and their weights, performance metrics, NAVs and other key financial indicators such as asset categories. This allows you to compare the asset allocation with the fund and diversity across industries and see if the mutual fund is in line with the current investment trends. Furthermore, you can track current and historical periodical returns of the mutual fund to analyze whether the fund is a good investment choice.
Complete mutual fund holdings, fundamentals and investment returns data at the tip of your fingers!
Mutual Fund Fundamentals and NAVs
Fundamentals data features key identifiers allocated to the fund such as CIK, ISIN, LEI, and ticker, along with net assets, total assets, and liabilities, providing insight into the ETF’s structure and financial position. Furthermore, metrics like expense ratio, holdings breakdown, and asset weights allow you to feed your analysis with fundamental mutual fund data.
Use Mutual Funds Data to Build Mutual Fund Performance Tools
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 MF is worth investing in. Build effective mutual fund performance tools that rely on data to make give insights into a mutual fund’s current and historical performance.
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 mutual fund through the API system. Create the right investment strategies for powered by mutual fund performance data and get ahead of the competition.
Historical Fund Data via the Mutual Fund Analysis 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 mutual fund analysis 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” |
Real-time and Historical Mutual Funds API
Integrating the Mutual Funds API into your product provides access to up-to-date mutual fund holdings data and help track changes based on weekly, monthly, quarterly, or annual reports from funds and the SEC. We collect and maintain data on publicly disclosed mutual funds in our internal Mutual Funds Holdings Database, ensuring continuous access to a comprehensive dataset for in-depth analysis.
Having historical mutual fund holdings data adds significant value by allowing users to track changes in a fund’s portfolio over time. Everything we offer as a real-time mutual fund data feed is also available as historical datasets going back years. This helps coming up with investment strategies, identify trends in asset allocation, and how the mutual fund reacts to current trends. Mutual funds are typically long-term investment types and analyzing performance of a fund based on historical data is a great asset in chooosing the right fund to maximize profitts.
Mutual Funds Periodical Returns Data
Tracking a mutual fund’s periodical returns with the Mutual Fund API—both current and historical—provides a clear picture of its performance over time. It helps see trends, measure consistency, and compare the fund to benchmarks to gauge whether it’s a good fit for an investor’s goals. By utilizing mutual fund periodical returns data, you can spot patterns in how the fund reacts to different market conditions, making it easier to manage risk and make smarter portfolio decisions.
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 its holding details on its website, we will update our mutual funds database (subject to availability).
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