Merge branch 'feat_scanner_page' into 'master'

scanner support cursor_id

See merge request server/openapi/openapi-python-sdk!249

Author: tigersk

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 3.4.4 (2025-07-31)
+### New
+选股器支持分页 cursor_id 参数
+
 ## 3.4.3 (2025-07-22)
 ### Fix
 下单返回 orders 属性处理

tigeropen/__init__.py

@@ -4,4 +4,4 @@
 
 @author: gaoan
 """
-__VERSION__ = '3.4.3'
+__VERSION__ = '3.4.4'

tigeropen/quote/domain/filter.py

@@ -154,7 +154,7 @@ def __repr__(self):
 
 
 class ScannerResult:
-    def __init__(self, page, page_size, total_page, total_count, items):
+    def __init__(self, page, page_size, total_page, total_count, items, cursor_id=None):
         """
         {'page': 0, 'total_page': 668, 'total_count': 6678, 'page_size': 10,
         'items': [
@@ -175,6 +175,7 @@ def __init__(self, page, page_size, total_page, total_count, items):
         self.total_page = total_page
         self.total_count = total_count
         self.page_size = page_size
+        self.cursor_id = cursor_id
         self.items = list()
         self.symbols = list()
         self._build_items(items)

tigeropen/quote/quote_client.py

@@ -1586,7 +1586,7 @@ def get_stock_industry(self, symbol, market=Market.US):
             else:
                 raise ApiException(response.code, response.message)
 
-    def market_scanner(self, market=Market.US, filters=None, sort_field_data=None, page=0, page_size=100):
+    def market_scanner(self, market=Market.US, filters=None, sort_field_data=None, page=0, page_size=100, cursor_id=None):
         """
         screen stocks
         :param market: tigeropen.common.consts.Market
@@ -1617,6 +1617,7 @@ def market_scanner(self, market=Market.US, filters=None, sort_field_data=None, p
             params.sort_field_data = sort_field_data
         params.page = page
         params.page_size = page_size
+        params.cursor_id = cursor_id
         request = OpenApiRequest(MARKET_SCANNER, biz_model=params)
         response_content = self.__fetch_data(request)
         if response_content:

tigeropen/quote/request/model.py

@@ -956,6 +956,7 @@ def __init__(self):
         self._page = None
         self._page_size = None
         self._multi_tags_fields = None
+        self._cursor_id = None
 
     @property
     def market(self):
@@ -1029,6 +1030,14 @@ def multi_tags_fields(self):
     def multi_tags_fields(self, value):
         self._multi_tags_fields = value
 
+    @property
+    def cursor_id(self):
+        return self._cursor_id
+
+    @cursor_id.setter
+    def cursor_id(self, value):
+        self._cursor_id = value
+
     def to_openapi_dict(self):
         """
         example
@@ -1064,6 +1073,8 @@ def to_openapi_dict(self):
             params['page'] = self.page
         if self.page_size is not None:
             params['page_size'] = self.page_size
+        if self.cursor_id is not None:
+            params['cursor_id'] = self.cursor_id
         if self.multi_tags_fields:
             params['multi_tag_field_list'] = [f.field_request_name for f in self.multi_tags_fields]
         return params

tigeropen/quote/response/market_scanner_response.py

@@ -25,6 +25,7 @@ def parse_response_content(self, response_content):
                                         page_size=data.get('page_size'),
                                         total_page=data.get('total_page'),
                                         total_count=data.get('total_count'),
+                                        cursor_id=data.get('cursor_id'),
                                         items=data.get('items'))
         return self.result