financal report api add param begin/end

Author: tigersk

tigeropen/__init__.py

@@ -4,4 +4,4 @@
 
 @author: gaoan
 """
-__VERSION__ = '2.1.8'
+__VERSION__ = '2.1.9'

tigeropen/fundamental/request/model.py

@@ -91,6 +91,8 @@ def __init__(self):
         self._market = None
         self._fields = None
         self._period_type = None
+        self._begin_date = None
+        self._end_date = None
 
     @property
     def symbols(self):
@@ -124,6 +126,22 @@ def period_type(self):
     def period_type(self, value):
         self._period_type = value
 
+    @property
+    def begin_date(self):
+        return self._begin_date
+
+    @begin_date.setter
+    def begin_date(self, value):
+        self._begin_date = value
+
+    @property
+    def end_date(self):
+        return self._end_date
+
+    @end_date.setter
+    def end_date(self, value):
+        self._end_date = value
+
     def to_openapi_dict(self):
         params = super().to_openapi_dict()
 
@@ -139,6 +157,12 @@ def to_openapi_dict(self):
         if self.period_type:
             params['period_type'] = self.period_type
 
+        if self.begin_date:
+            params['begin_date'] = self.begin_date
+
+        if self.end_date:
+            params['end_date'] = self.end_date
+
         return params
 
 

tigeropen/quote/quote_client.py

@@ -1232,14 +1232,16 @@ def get_financial_daily(self, symbols, market, fields, begin_date, end_date):
             else:
                 raise ApiException(response.code, response.message)
 
-    def get_financial_report(self, symbols, market, fields, period_type):
+    def get_financial_report(self, symbols, market, fields, period_type, begin_date=None, end_date=None):
         """
         获取财报数据
         :param symbols:
         :param market: 查询的市场. 可选的值为 common.consts.Market 枚举类型, 如 Market.US
         :param fields: 查询的字段列表. 可选的项为 common.consts 下的 Income, Balance, CashFlow, BalanceSheetRatio,
                         Growth, Leverage, Profitability 枚举类型. 如 Income.total_revenue
         :param period_type: 查询的周期类型. 可选的值为 common.consts.FinancialReportPeriodType 枚举类型
+        :param begin_date: specify range begin of period_end_date
+        :param end_date: specify range end of period_end_date
         :return: pandas.DataFrame, 各 column 的含义如下:
             symbol: 证券代码
             currency: 财报使用的币种
@@ -1254,6 +1256,8 @@ def get_financial_report(self, symbols, market, fields, period_type):
         params.fields = [get_enum_value(field) for field in fields]
         params.period_type = get_enum_value(period_type)
         params.lang = get_enum_value(self._lang)
+        params.begin_date = date_str_to_timestamp(begin_date, self._timezone)
+        params.end_date = date_str_to_timestamp(end_date, self._timezone)
         request = OpenApiRequest(FINANCIAL_REPORT, biz_model=params)
         response_content = self.__fetch_data(request)
         if response_content: