mftool 2.8__tar.gz → 3.0__tar.gz

{mftool-2.8 → mftool-3.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: mftool
-Version: 2.8
+Version: 3.0
 Summary: Library for getting real time Mutual funds info
 Home-page: https://github.com/NayakwadiS/mftool
 Author: SujitN
 Author-email: nayakwadi_sujit@rediffmail.com
 License: MIT
-Description: mftool is a library for getting real time Mutual Funds data in India. It can be used in various types of projects which requires getting live quotes for a given mutual fund scheme or build large data sets for further data analytics.
+Description: mftool is a library getting publicly available Mutual Funds data in India. It can be used in various types of projects which requires getting live quotes for a given mutual fund scheme or build large data sets for further data analytics.
         
         Features
         =============

{mftool-2.8 → mftool-3.0}/README.md

@@ -1,4 +1,4 @@
-mftool is a library for getting real time Mutual Funds data in India. It can be used in various types of projects which requires getting live quotes for a given mutual fund scheme or build large data sets for further data analytics.
+mftool is a library getting publicly available Mutual Funds data in India. It can be used in various types of projects which requires getting live quotes for a given mutual fund scheme or build large data sets for further data analytics.
 
 Features
 =============

{mftool-2.8 → mftool-3.0}/mftool/__init__.py

@@ -1,7 +1,7 @@
 """
     The MIT License (MIT)
 
-    Copyright (c) 2024 Sujit Nayakwadi
+    Copyright (c) 2025 Sujit Nayakwadi
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
@@ -21,5 +21,5 @@
     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
     SOFTWARE.
 """
-__VERSION__='2.8'
+__VERSION__='3.0'
 from .mftool import Mftool

{mftool-2.8 → mftool-3.0}/mftool/const.json

@@ -2,58 +2,60 @@
 	"get_quote_url": "https://www.amfiindia.com/spages/NAVAll.txt",
 	"get_scheme_url": "https://api.mfapi.in/mf/",
 	"get_amc_details_url": "https://www.amfiindia.com/modules/AMCProfileDetail",
-	"get_open_ended_equity_scheme_url": "http://www.valueresearchonline.com/amfi/fund-performance-data/?end-type=1&primary-category=SEQ&category=CAT&amc=ALL",
+	"get_open_ended_equity_scheme_url": "https://www.amfiindia.com/gateway/pollingsebi/api/amfi/fundperformance",
 	"get_avg_aum_url": "https://www.amfiindia.com/modules/AverageAUMDetails",
 	"user_agent": {
 		"User-Agent": "Chrome/95.0.4638.69"
 	},
 	"open_ended_equity_category": {
-		"Large Cap": "SEQ_LC",
-		"Large & Mid Cap": "SEQ_LMC",
-		"Multi Cap": "SEQ_MLC",
-		"Mid Cap": "SEQ_MC",
-		"Small Cap": "SEQ_SC",
-		"Value": "SEQ_VAL",
-		"ELSS": "SEQ_ELSS",
-		"Contra": "SEQ_CONT",
-		"Dividend Yield": "SEQ_DIVY",
-		"Focused": "SEQ_FOC"
+		"1": "Large Cap",
+		"2": "Large & Mid Cap",
+		"3": "Flexi Cap",
+		"4": "Multi Cap",
+		"5": "Mid Cap",
+		"6": "Small Cap",
+		"7": "Value",
+		"8": "ELSS",
+		"9": "Contra",
+		"10": "Dividend Yield",
+		"11": "Focused",
+		"12": "Sectoral / Thematic"
 	},
 	"open_ended_debt_category": {
-		"Long Duration": "SDT_LND",
-		"Medium to Long Duration": "SDT_MLD",
-		"Medium Duration": "SDT_MD",
-		"Short Duration": "SDT_SD",
-		"Low Duration": "SDT_LWD",
-		"Ultra Short Duration": "SDT_USD",
-		"Liquid": "SDT_LIQ",
-		"Money Market": "SDT_MM",
-		"Overnight": "SDT_OVNT",
-		"Dynamic Bond": "SDT_DB",
-		"Corporate Bond": "SDT_CB",
-		"Credit Risk": "SDT_CR",
-		"Banking and PSU": "SDT_BPSU",
-		"Floater": "SDT_FL",
-		"FMP": "SDT_FMP",
-		"Gilt": "SDT_GL",
-		"Gilt with 10 year constant duration": "SDT_GL10CD"
+		"13":"Long Duration",
+		"14":"Medium to Long Duration",
+		"16":"Medium Duration",
+		"15":"Short Duration",
+		"18":"Low Duration",
+		"19":"Ultra Short Duration",
+		"20":"Liquid",
+		"17":"Money Market",
+		"21":"Overnight",
+		"22":"Dynamic Bond",
+		"23":"Corporate Bond",
+		"24":"Credit Risk",
+		"25":"Banking and PSU",
+		"26":"Floater",
+		"27":"FMP",
+		"28":"Gilt",
+		"29":"Gilt with 10 year constant duration"
 	},
 	"open_ended_hybrid_category": {
-		"Aggressive Hybrid": "SHY_AH",
-		"Balanced Hybrid": "SHY_BH",
-		"Conservative Hybrid": "SHY_CH",
-		"Equity Savings": "SHY_EQS",
-		"Arbitrage": "SHY_AR",
-		"Multi Asset Allocation": "SHY_MAA"
+		"30":"Aggressive Hybrid",
+		"40":"Balanced Hybrid",
+		"31":"Conservative Hybrid",
+		"32":"Equity Savings",
+		"33":"Arbitrage",
+		"34":"Multi Asset Allocation"
 	},
 	"open_ended_solution_category": {
-		"Children's": "SSO_CHILD",
-		"Retirement": "SSO_RETR"
+		"36":"Children's",
+		"37":"Retirement"
 
 	},
 	"open_ended_other_category": {
-		"Index Funds/ETFs": "SOTH_IXETF",
-		"FoFs(Oversease/Domestic)": "SOTH_FOFS"
+		"38":"Index Funds/ETFs",
+		"39":"FoFs(Oversease/Domestic)"
 
 	},
 	"amc": [3, 53, 1, 4, 59, 46, 32, 6, 47, 54, 27, 9, 37, 20, 57, 48, 68, 62, 65, 63, 42, 70, 16, 17, 56, 18, 69, 45, 55, 21, 58, 64, 10, 13, 35,
@@ -20060,4 +20062,4 @@
 		}, {
 			"0P00019W5W": "Indiabulls Blue Chip Fund Direct Plan Quarterly Dividend Payout Option"
 		}]
-}
+}

{mftool-2.8 → mftool-3.0}/mftool/mftool.py

@@ -1,6 +1,6 @@
 """
     The MIT License (MIT)
-    Copyright (c) 2024 Sujit Nayakwadi
+    Copyright (c) 2025 Sujit Nayakwadi
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
     in the Software without restriction, including without limitation the rights
@@ -24,7 +24,9 @@ from bs4 import BeautifulSoup
 import yfinance as yf
 import datetime
 from deprecated import deprecated
+from matplotlib import pyplot as plt
 from .utils import Utilities, is_holiday, get_today, get_friday, render_response
+import pandas as pd
 
 
 class Mftool:
@@ -173,7 +175,6 @@ class Mftool:
             scheme_info = {}
             url = self._get_scheme_url + code
             response = self._session.get(url).json()
-
             scheme_data = response['meta']
             scheme_info['fund_house'] = scheme_data['fund_house']
             scheme_info['scheme_type'] = scheme_data['scheme_type']
@@ -236,58 +237,25 @@ class Mftool:
         else:
             return None
 
-    @deprecated(version='2.7',
-                reason="This function will be in deprecated from next release, use mf.history() to get data")
-    def get_scheme_historical_nav_year(self, code, year, as_json=False):
-        """
-        gets the scheme historical data of given year for a given scheme code
-        :param code: scheme-code
-        :param year: year
-        :param as_json: default false
-        :return: dict or None
-        :raises: HTTPError, URLError
-        """
-        code = str(code)
-        if self.is_valid_code(code):
-            scheme_info = {}
-            data = []
-            url = self._get_scheme_url + code
-            response = self._session.get(url).json()
-            nav = self.get_scheme_historical_nav(code)
-            scheme_info = self.get_scheme_details(code)
-            for dat in nav['data']:
-                navDate = dat['date']
-                d = datetime.datetime.strptime(navDate, '%d-%m-%Y')
-                if d.year == int(year):
-                    data.append(dat)
-            if len(data) == 0:
-                data.append({'Error': 'For Year '+str(year)+' Data is NOT available'})
-
-            scheme_info.update(data=data)
-            return render_response(scheme_info, as_json)
-        else:
-            return None
-
-    @deprecated(version='2.7',
+    @deprecated(version='3.1',
                 reason="This function will be in deprecated from next release, use mf.history() to get data")
-    def get_scheme_historical_nav_for_dates(self, code, start_date, end_date, as_json=False):
+    def get_scheme_historical_nav_for_dates(self, code, start_date, end_date, as_json=False, as_dataframe=False):
         """
         gets the scheme historical data between start_date and end_date for a given scheme code
         :param start_date: string '%Y-%m-%d'
         :param end_date: string '%Y-%m-%d'
         :param code: scheme code
         :param as_json: default false
+        :param as_dataframe: default false
         :return: dict or None
         :raises: HTTPError, URLError
         """
         code = str(code)
         if self.is_valid_code(code):
-            scheme_info = {}
+            # scheme_info = {}
             data = []
             start_date = datetime.datetime.strptime(start_date, '%d-%m-%Y').date()
             end_date = datetime.datetime.strptime(end_date, '%d-%m-%Y').date()
-            url = self._get_scheme_url + code
-            response = self._session.get(url).json()
             nav = self.get_scheme_historical_nav(code)
             scheme_info = self.get_scheme_details(code)
             for dat in nav['data']:
@@ -299,114 +267,107 @@ class Mftool:
                 data.append({'Data is NOT available for selected range'})
 
             scheme_info.update(data=data)
-            return render_response(scheme_info, as_json)
+            return render_response(scheme_info, as_json, as_dataframe)
         else:
             return None
 
-    def get_open_ended_equity_scheme_performance(self, as_json=False):
+    def get_open_ended_equity_scheme_performance(self, report_date=None,as_json=False):
         """
         gets the daily performance of open-ended equity schemes for all AMCs
+        :param report_date: date in 'DD-MMM-YYYY' format, if None then it will take last working day
         :return: json format
         :raises: HTTPError, URLError
         """
         scheme_performance = {}
-        for key in self._open_ended_equity_category.keys():
-            scheme_performance_url = self._get_open_ended_equity_scheme_url.replace('CAT', self._open_ended_equity_category[key])
-            scheme_performance[key] = self._get_daily_scheme_performance(scheme_performance_url)
+        subCategory = self._open_ended_equity_category
+        for key in subCategory:
+            scheme_performance[subCategory[key]] = self._get_daily_scheme_performance(self._get_open_ended_equity_scheme_url,report_date,1, key)
         return render_response(scheme_performance, as_json)
 
-    def get_open_ended_debt_scheme_performance(self, as_json=False):
+    def get_open_ended_debt_scheme_performance(self, report_date=None, as_json=False):
         """
         gets the daily performance of open-ended debt schemes for all AMCs
+        :param report_date: date in 'DD-MMM-YYYY' format, if None then it will take last working day
         :return: json format
         :raises: HTTPError, URLError
         """
-        get_open_ended_debt_scheme_url = self._get_open_ended_equity_scheme_url.replace('SEQ', 'SDT')
+        subCategory = self._open_ended_debt_category
         scheme_performance = {}
-        for key in self._open_ended_debt_category.keys():
-            scheme_performance_url = get_open_ended_debt_scheme_url.replace('CAT', self._open_ended_debt_category[key])
-            scheme_performance[key] = self._get_daily_scheme_performance(scheme_performance_url)
+        for key in subCategory:
+            scheme_performance[subCategory[key]] = self._get_daily_scheme_performance(self._get_open_ended_equity_scheme_url,report_date,2,key)
         return render_response(scheme_performance, as_json)
 
-    def get_open_ended_hybrid_scheme_performance(self, as_json=False):
+    def get_open_ended_hybrid_scheme_performance(self, report_date=None, as_json=False):
         """
         gets the daily performance of open-ended hybrid schemes for all AMCs
+        :param report_date: date in 'DD-MMM-YYYY' format, if None then it will take last working day
         :return: json format
         :raises: HTTPError, URLError
         """
-        get_open_ended_debt_scheme_url = self._get_open_ended_equity_scheme_url.replace('SEQ', 'SHY')
+        subCategory = self._open_ended_hybrid_category
         scheme_performance = {}
-        for key in self._open_ended_hybrid_category.keys():
-            scheme_performance_url = get_open_ended_debt_scheme_url.replace('CAT',self._open_ended_hybrid_category[key])
-            scheme_performance[key] = self._get_daily_scheme_performance(scheme_performance_url)
+        for key in subCategory:
+            scheme_performance[subCategory[key]] = self._get_daily_scheme_performance(
+                self._get_open_ended_equity_scheme_url,report_date, 3, key)
         return render_response(scheme_performance, as_json)
 
-    def get_open_ended_solution_scheme_performance(self, as_json=False):
+    def get_open_ended_solution_scheme_performance(self, report_date=None, as_json=False):
         """
         gets the daily performance of open-ended Solution-Oriented schemes for all AMCs
+        :param report_date: date in 'DD-MMM-YYYY' format, if None then it will take last working day
         :return: json format
         :raises: HTTPError, URLError
         """
-        get_open_ended_solution_scheme_url = self._get_open_ended_equity_scheme_url.replace('SEQ', 'SSO')
+        subCategory = self._open_ended_solution_category
         scheme_performance = {}
-        for key in self._open_ended_solution_category.keys():
-            scheme_performance_url = get_open_ended_solution_scheme_url.replace('CAT',
-                                                                                self._open_ended_solution_category[key])
-            scheme_performance[key] = self._get_daily_scheme_performance(scheme_performance_url)
+        for key in subCategory:
+            scheme_performance[subCategory[key]] = self._get_daily_scheme_performance(
+                self._get_open_ended_equity_scheme_url, report_date,4, key)
         return render_response(scheme_performance, as_json)
 
-    def get_open_ended_other_scheme_performance(self, as_json=False):
+    def get_open_ended_other_scheme_performance(self, report_date=None, as_json=False):
         """
         gets the daily performance of open-ended index and FoF schemes for all AMCs
+        :param report_date: date in 'DD-MMM-YYYY' format, if None then it will take last working day
         :return: json format
         :raises: HTTPError, URLError
         """
-        get_open_ended_other_scheme_url = self._get_open_ended_equity_scheme_url.replace('SEQ', 'SOTH')
+        subCategory = self._open_ended_other_category
         scheme_performance = {}
-        for key in self._open_ended_other_category.keys():
-            scheme_performance_url = get_open_ended_other_scheme_url.replace('CAT', self._open_ended_other_category[key])
-            scheme_performance[key] = self._get_daily_scheme_performance(scheme_performance_url)
+        for key in subCategory:
+            scheme_performance[subCategory[key]] = self._get_daily_scheme_performance(
+                self._get_open_ended_equity_scheme_url, report_date,5, key)
         return render_response(scheme_performance, as_json)
 
-    def _get_daily_scheme_performance(self, performance_url, as_json=False):
+    def _get_daily_scheme_performance(self, performance_url,report_date, category,key, as_json=False):
         fund_performance = []
-        if is_holiday():
-            url = performance_url + '&nav-date=' + get_friday()
-        else:
-            url = performance_url + '&nav-date=' + get_today()
-        # html = requests.get(url, headers=self._user_agent)
-        html = httpx.get(url, headers=self._user_agent,timeout=25)
-        soup = BeautifulSoup(html.text, 'html.parser')
-        rows = soup.select("table tbody tr")
+        if not report_date:
+            if is_holiday():
+                report_date = get_friday()
+            else:
+                report_date = get_today()
         try:
-            for tr in rows:
+            data = {"maturityType": 1,"category": category,"subCategory": int(key),"mfid": 0,"reportDate": report_date}
+            html = httpx.post(performance_url,headers={"User-Agent":"Mozilla/5.0"},timeout=25, json=data)
+            for result in html.json()['data']:
                 scheme_details = {}
-                cols = tr.select("td.nav.text-right")
-                scheme_details['scheme_name'] = tr.select("td")[0].get_text()
-                scheme_details['benchmark'] = tr.select("td")[1].get_text()
-
-                scheme_details['latest NAV- Regular'] = tr.select("td")[2].get_text().strip()
-                scheme_details['latest NAV- Direct'] = tr.select("td")[3].get_text().strip()
-
-                regData = tr.find_all("td", recursive=False,class_="text-right period-return-reg", limit=1)
-                dirData = tr.find_all("td", recursive=False, class_="text-right period-return-dir", limit=1)
-
-                scheme_details['1-Year Return(%)- Regular'] = regData[0]['data-1y']
-                scheme_details['1-Year Return(%)- Direct'] = dirData[0]['data-1y']
-
-                scheme_details['3-Year Return(%)- Regular'] = regData[0]['data-3y']
-                scheme_details['3-Year Return(%)- Direct'] = dirData[0]['data-3y']
-
-                scheme_details['5-Year Return(%)- Regular'] = regData[0]['data-5y']
-                scheme_details['5-Year Return(%)- Direct'] = dirData[0]['data-5y']
-
+                scheme_details['scheme_name'] = result['schemeName']
+                scheme_details['benchmark'] = result['benchmark']
+                scheme_details['latest NAV- Regular'] = result['navRegular']
+                scheme_details['latest NAV- Direct'] = result['navDirect']
+                scheme_details['1-Year Return(%)- Regular'] = result['return1YearRegular']
+                scheme_details['1-Year Return(%)- Direct'] = result['return1YearDirect']
+                scheme_details['3-Year Return(%)- Regular'] = result['return3YearRegular']
+                scheme_details['3-Year Return(%)- Direct'] = result['return3YearDirect']
+                scheme_details['5-Year Return(%)- Regular'] = result['return5YearRegular']
+                scheme_details['5-Year Return(%)- Direct'] = result['return5YearDirect']
                 fund_performance.append(scheme_details)
-
         except Exception:
             return render_response(['The underlying data is unavailable for Today'], as_json)
-
         return render_response(fund_performance, as_json)
 
+    @deprecated(version='3.1',
+                reason="This function will be in deprecated from next release")
     def get_all_amc_profiles(self, as_json=True):
         """
         gets profiles for all Fund houses
@@ -476,7 +437,7 @@ class Mftool:
         code = str(code)
         if self.is_code(code):
             def get_Dataframe(df, as_dataframe):
-                df = df.drop(columns=['Open', 'High', 'Low','Adj Close','Volume'])
+                df = df.drop(columns=['Open', 'High', 'Low','Volume'])
                 df = df.rename(columns={'Close': 'nav'})
                 df['dayChange'] = df['nav'].diff()
                 df = df.rename_axis('date')
@@ -510,3 +471,31 @@ class Mftool:
             mf = yf.Ticker(code)
             response = mf.info
             return render_response(response, as_json)
+
+    def compare_trend(self, codes, start_date, end_date):
+        """
+        plot and Compare trend of mutual funds
+        :param start_date: string '%Y-%m-%d'
+        :param end_date: string '%Y-%m-%d'
+        :param code: scheme code
+        :param as_json: default false
+        :param as_dataframe: default false
+        :return: dict or None
+        :raises: HTTPError, URLError
+        """
+        all_mf = pd.DataFrame()
+        for code in codes:
+            mf_data = self.get_scheme_historical_nav_for_dates(code, start_date, end_date, as_dataframe=True)
+            mf_data = mf_data.drop(columns=['dayChange'])
+            mf_name = self.get_scheme_details(code)['scheme_name']
+            mf_data[mf_name] = mf_data['nav'].astype(float)
+            mf_data['date'] = mf_data.index
+            all_mf[mf_name] = mf_data[mf_name]
+            all_mf['date'] = mf_data['date']
+
+        all_mf = all_mf[::-1]
+        all_mf.plot(x='date')
+        plt.title("Compare mutual funds")
+        plt.xlabel("Date")
+        plt.ylabel("NAV")
+        plt.show()

{mftool-2.8 → mftool-3.0}/mftool.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.1
 Name: mftool
-Version: 2.8
+Version: 3.0
 Summary: Library for getting real time Mutual funds info
 Home-page: https://github.com/NayakwadiS/mftool
 Author: SujitN
 Author-email: nayakwadi_sujit@rediffmail.com
 License: MIT
-Description: mftool is a library for getting real time Mutual Funds data in India. It can be used in various types of projects which requires getting live quotes for a given mutual fund scheme or build large data sets for further data analytics.
+Description: mftool is a library getting publicly available Mutual Funds data in India. It can be used in various types of projects which requires getting live quotes for a given mutual fund scheme or build large data sets for further data analytics.
         
         Features
         =============

{mftool-2.8 → mftool-3.0}/mftool.egg-info/requires.txt

@@ -3,4 +3,4 @@ bs4
 httpx
 pandas
 yfinance
-Deprecated
+matplotlib

{mftool-2.8 → mftool-3.0}/setup.py

@@ -7,13 +7,13 @@ with open(path.join(this_directory, 'README.md'), encoding='utf-8') as f:
 
 setup(
     name="mftool",
-    version="2.8",
+    version="3.0",
     author="SujitN",
     author_email="nayakwadi_sujit@rediffmail.com",
     description="Library for getting real time Mutual funds info",
     license="MIT",
     keywords="amfi, quote, mutual-funds, funds, bse, nse, market, stock, stocks",
-    install_requires=['requests', 'bs4', 'httpx','pandas','yfinance','Deprecated'],
+    install_requires=['requests', 'bs4', 'httpx', 'pandas', 'yfinance', 'matplotlib'],
     url="https://github.com/NayakwadiS/mftool",
     packages=find_packages(),
     long_description=long_description,