Find Out How You Can Use the Mutual Funds API by Finnworlds

In this article, we want you to meet our Mutual Funds API which is a powerful JSON REST API that focuses on real-time and historical mutual fund data, along with the assets in them individually. It is a reliable and one-in-all data source for developers in finance. Whether you already provide a data-driven solution on mutual funds or looking to build one, seeing the details of our mutual fund data will convince you that your business can benefit from it a lot!

---

Why Focus on Mutual Funds Data Solutions?

Focusing on mutual funds data will get your business ahead of the competition. But why exactly is that in the modern investment scene where there are basically countless opportunities to invest?

Well, as far as the numbers speak, mutual fund investment is actually one of the most important aspects of personal finance as it provides an opportunity for investors to diversify their portfolios and minimize risk. By pooling together money from multiple investors, mutual funds are able to invest in a wide range of assets such as stocks, bonds, and other securities. This diversification helps to reduce the risk of loss in any single investment, while potentially providing higher returns than a single investment might.

Mutual fund investment also provides access to professional money managers. These can be more reliable for investors who seek portfolio management services. All parties that take place in the mutual fund investment need one thing in common for the most professional approach: and that is accurate, up-to-date, historical and real-time mutual fund holdings data.

---

Which Details Will the Mutual Funds API Provide For You?

The Mutual Funds API basically has 3 endpoints that focus on different aspects of mutual funds: general information about funds, periodical returns of mutual funds and holdings of the given mutual fund. Below, you will find an example 200 OK output for each endpoint to give you a better idea about the mutual fund data it offers.

1) /mutualfundinfo: You can use cik, series_id and series_lei as a filter.

{
  "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"
      },
      "results": [
        {
          "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.0000000000000",
            "liquid_pref": "0.000000000000",
            "cash_not_reported_in_cor_d": "2545141.120000000000",
            "non_cash_collateral": "N",
            "currency": "Null"
          }
        }
      ]
    }
  }
}

2) /mutualfundreturns: You can use series_id, series_lei as filters and date_from and date_to parameters to set a date or date range.

{
  "status": {
    "code": "200",
    "message": "OK",
    "details": ""
  },
  "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",
        "rtn": {
          "rtn1": "-6.820000000000",
          "rtn2": "15.030000000000",
          "rtn3": "4.540000000000"
        }
      },
      "other_monthly1": {
        "net_realized_gain": "1047242.290000000000",
        "net_unrealized_appreciation": "-8495540.41"
      },
      "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"
            }
          }
        }
      }
    }
  }
}

3) /mutualfundholdings: You can again use series_id, series_lei to filter mutual funds by codes and date_from and date_to parameters to set a specific date or date range.

{
  "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": "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_leve\"": "1",
          "cash_collateral": "N",
          "non_cash_collateral": "N",
          "loan_by_fund": "N"
        }
      }
    }
  }
}

---

Want to find out more? Visit our full documentation here.

---

Which Businesses Will Find the Mutual Fund Holdings API Useful?

Researchers and financial analysts

The Mutual Fund Holdings API can be a useful tool for researchers and financial analysts. Especially the historical data they can fetch by using the /mutualfundreturns endpoint, they can compare different funds' performance. The mutual fund holding data will also include monthly total returns, net realized gains, net unrealized appreciation, and other monthly flows. Financial analysts and researchers can integrate this API into their products to automate the process of data collection and analysis, saving them time and effort.

Fintechs

Fintechs can benefit from our Mutual Fund Holdings API by using it to provide investors with detailed information about mutual funds, fund returns, and more. As a use case example on the more innovative side, a robo-advisor or financial planning app can use the API to give users insights into the performance of specific mutual funds and make investment recommendations. They can also use the real-time Mutual Fund Holdings API to build tools that display fund attributes, such as total assets, total liabilities, and net assets.

Financial institutions

Financial organizations like banks, asset managers, and financial advisers can use the historical mutual funds data the API provides to fetch and compare detailed information on a fund's investment strategy, risk, and asset allocation. This also helps analysing the performance of a fund over time. For example, these organizations can build an investment dashboard that provides real-time updates on the mutual funds they are invested in. The historical and real-time data the API offers allows offering the most personalized solutions for their clients in mutual fund investment, or themselves.

---

Access the Real-time and Historical Mutual Fund Holdings Data Right Away

Access to the Mutual Fund Holdings Data along with many other great financial APIs (check out our Hashnode blog to read more about our other APIs!) you need to get an API key. You can create an API subscription within a minute on this link and your key will be sent to you immediately. No commitments, cancel or upgrade your plan anytime depending on how your project goes!

Got any questions? Contact us here and we will get back to you!