mftool 2.9__tar.gz → 3.1__tar.gz

{mftool-2.9 → mftool-3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mftool
-Version: 2.9
+Version: 3.1
 Summary: Library for getting real time Mutual funds info
 Home-page: https://github.com/NayakwadiS/mftool
 Author: SujitN

{mftool-2.9 → mftool-3.1}/mftool/__init__.py

@@ -1,7 +1,7 @@
 """
     The MIT License (MIT)
 
-    Copyright (c) 2025 Sujit Nayakwadi
+    Copyright (c) 2026 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.9'
+__VERSION__='3.1'
 from .mftool import Mftool

{mftool-2.9 → mftool-3.1}/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.9 → mftool-3.1}/mftool/mftool.py

@@ -1,6 +1,6 @@
 """
     The MIT License (MIT)
-    Copyright (c) 2025 Sujit Nayakwadi
+    Copyright (c) 2026 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
@@ -25,7 +25,7 @@ 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
+from .utils import Utilities, is_holiday, get_today, get_friday, render_response, get_52_week_friday
 import pandas as pd
 
 
@@ -175,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']
@@ -183,6 +182,9 @@ class Mftool:
             scheme_info['scheme_code'] = scheme_data['scheme_code']
             scheme_info['scheme_name'] = scheme_data['scheme_name']
             scheme_info['scheme_start_date'] = response['data'][int(len(response['data']) - 1)]
+            result = self.get_52_week_high_low(response['data'])
+            scheme_info['52_week_high'] = result['52_week_high']
+            scheme_info['52_week_low'] = result['52_week_low']
             if response['data']:
                 scheme_info['data'] = response['data']
             else:
@@ -191,6 +193,14 @@ class Mftool:
         else:
             return None
 
+    def get_52_week_high_low(self, data):
+        friday = pd.to_datetime(get_52_week_friday())
+        df = pd.DataFrame.from_records(data)
+        df['date'] = pd.to_datetime(df['date'], dayfirst=True)
+        df_high = df[df['date'] >= friday].sort_values(by='nav', ascending=False).head(1)
+        df_low = df[df['date'] >= friday].sort_values(by='nav', ascending=True).head(1)
+        return {"52_week_high": df_high['nav'].values[0], "52_week_low": df_low['nav'].values[0]}
+
     def calculate_balance_units_value(self, code, balance_units, as_json=False):
         """
         gets the market value of your balance units for a given scheme code
@@ -238,39 +248,7 @@ class Mftool:
         else:
             return None
 
-    @deprecated(version='2.8',
-                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, as_dataframe=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
-        :param as_dataframe: default false
-        :return: dict or None
-        :raises: HTTPError, URLError
-        """
-        code = str(code)
-        if self.is_valid_code(code):
-            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, as_dataframe)
-        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, as_dataframe=False):
         """
@@ -289,8 +267,6 @@ class Mftool:
             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']:
@@ -306,110 +282,103 @@ class Mftool:
         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, use mf.history() to get data")
     def get_all_amc_profiles(self, as_json=True):
         """
         gets profiles for all Fund houses
@@ -479,7 +448,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')

{mftool-2.9 → mftool-3.1}/mftool/utils.py

@@ -22,6 +22,10 @@ def get_today():
     return (date.today() - timedelta(days=1)).strftime("%d-%b-%Y")
 
 
+def get_52_week_friday():
+    return (date.today() - timedelta(weeks=52)).strftime("%d-%m-%Y")
+
+
 def render_response(data, as_json=False, as_Dataframe=False):
     if as_json is True:
         return json.dumps(data)
@@ -40,4 +44,4 @@ class Utilities:
     def __init__(self):
         self._filepath = str(os.path.dirname(os.path.abspath(__file__))) + '/const.json'
         with open(self._filepath, 'r') as f:
-            self.values = json.load(f)
+            self.values = json.load(f)

{mftool-2.9 → mftool-3.1}/mftool.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mftool
-Version: 2.9
+Version: 3.1
 Summary: Library for getting real time Mutual funds info
 Home-page: https://github.com/NayakwadiS/mftool
 Author: SujitN

{mftool-2.9 → mftool-3.1}/mftool.egg-info/requires.txt

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

{mftool-2.9 → mftool-3.1}/setup.py

@@ -7,13 +7,13 @@ with open(path.join(this_directory, 'README.md'), encoding='utf-8') as f:
 
 setup(
     name="mftool",
-    version="2.9",
+    version="3.1",
     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','deprecated'],
     url="https://github.com/NayakwadiS/mftool",
     packages=find_packages(),
     long_description=long_description,