finmind 2.0.2__tar.gz → 2.0.4__tar.gz

{finmind-2.0.2 → finmind-2.0.4}/FinMind/data/data_loader.py

@@ -2918,6 +2918,68 @@ class DataLoader(FinMindApi):
         )
         return taiwan_stock_day_trading_borrowing_fee_rate
 
+    def taiwan_stock_convertible_bond_monthly_analysis(
+        self,
+        cb_id: str = "",
+        start_date: str = "",
+        end_date: str = "",
+        timeout: int = None,
+    ) -> pd.DataFrame:
+        """get 可轉換公司債月份分析表
+        :param cb_id (str): 可轉債代號("11011")
+        :param start_date (str): 起始日期("2026-05-01")
+        :param end_date (str): 結束日期("2026-05-02")
+        :param timeout (int): timeout seconds, default None
+
+        :return: 可轉換公司債月份分析表 TaiwanStockConvertibleBondMonthlyAnalysis
+        :rtype pd.DataFrame
+        :rtype column cb_id (str): 可轉債代號
+        :rtype column cb_name (str): 可轉債名稱
+        :rtype column cb_name_en (str): 可轉債英文名稱
+        :rtype column custody_balance (int): 保管餘額
+        :rtype column last_month_balance (int): 上月餘額
+        :rtype column change (int): 增減
+        :rtype column change_percent (float): 增減百分比
+        :rtype column issued_units (int): 發行單位數
+        :rtype column custody_accounts (int): 保管戶數
+        :rtype column pledged_units (int): 設質單位數
+        :rtype column date (str): 日期
+        """
+        taiwan_stock_convertible_bond_monthly_analysis = self.get_data(
+            dataset=Dataset.TaiwanStockConvertibleBondMonthlyAnalysis,
+            data_id=cb_id,
+            start_date=start_date,
+            end_date=end_date,
+            timeout=timeout,
+        )
+        return taiwan_stock_convertible_bond_monthly_analysis
+
+    def taiwan_option_vix(
+        self,
+        start_date: str = "",
+        end_date: str = "",
+        timeout: int = None,
+    ) -> pd.DataFrame:
+        """get 臺指選擇權波動率指數
+        :param start_date (str): 起始日期("2024-01-01")
+        :param end_date (str): 結束日期("2024-12-31")
+        :param timeout (int): timeout seconds, default None
+
+        :return: 臺指選擇權波動率指數 TaiwanOptionVix
+        :rtype pd.DataFrame
+        :rtype column date (str): 日期
+        :rtype column time (str): 時間
+        :rtype column vix (float): 波動率指數
+        """
+        taiwan_option_vix = self.get_data(
+            dataset=Dataset.TaiwanOptionVix,
+            data_id="",
+            start_date=start_date,
+            end_date=end_date,
+            timeout=timeout,
+        )
+        return taiwan_option_vix
+
     def _get_stock_id_list(
         self, date: str, timeout: int = None
     ) -> typing.List[str]:

{finmind-2.0.2 → finmind-2.0.4}/FinMind/data/finmind_api.py

@@ -144,22 +144,24 @@ class FinMindApi:
         :param params: finmind api參數
         :return:
         """
-        if use_async:
-            if securities_trader_id_list:
-                return self._get_data_with_async_with_securities_trader_id(
-                    dataset=dataset,
-                    securities_trader_id_list=securities_trader_id_list,
-                    start_date=start_date,
-                    end_date=end_date,
-                )
-            elif data_id_list:
-                return self._get_data_with_async(
-                    dataset=dataset,
-                    data_id_list=data_id_list,
-                    start_date=start_date,
-                    end_date=end_date,
-                    max_retry_times=max_retry_times,
-                )
+        # 只要傳入 id 列表就走非同步批次下載，不再依賴 use_async 旗標。
+        # 過去 use_async 預設 False 時 sync 分支會忽略 data_id_list、
+        # 只用空的 data_id 查詢，導致回傳空 DataFrame。
+        if securities_trader_id_list:
+            return self._get_data_with_async_with_securities_trader_id(
+                dataset=dataset,
+                securities_trader_id_list=securities_trader_id_list,
+                start_date=start_date,
+                end_date=end_date,
+            )
+        elif data_id_list:
+            return self._get_data_with_async(
+                dataset=dataset,
+                data_id_list=data_id_list,
+                start_date=start_date,
+                end_date=end_date,
+                max_retry_times=max_retry_times,
+            )
         else:
             logger.info(f"download {dataset}, data_id: {data_id}")
             params = dict(

{finmind-2.0.2 → finmind-2.0.4}/FinMind/schema/data.py

@@ -137,6 +137,10 @@ class Dataset(str, Enum):
     TaiwanOptionFinalSettlementPrice = "TaiwanOptionFinalSettlementPrice"
     TaiwanStockBlockTrade = "TaiwanStockBlockTrade"
     TaiwanStockLoanCollateralBalance = "TaiwanStockLoanCollateralBalance"
+    TaiwanStockConvertibleBondMonthlyAnalysis = (
+        "TaiwanStockConvertibleBondMonthlyAnalysis"
+    )
+    TaiwanOptionVix = "TaiwanOptionVix"
 
 
 class Version(str, Enum):

{finmind-2.0.2/finmind.egg-info → finmind-2.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finmind
-Version: 2.0.2
+Version: 2.0.4
 Summary: financial mining
 Author-email: linsam <finmind.tw@gmail.com>
 License:                                  Apache License

{finmind-2.0.2 → finmind-2.0.4/finmind.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finmind
-Version: 2.0.2
+Version: 2.0.4
 Summary: financial mining
 Author-email: linsam <finmind.tw@gmail.com>
 License:                                  Apache License