Merge branch 'feat_future_fields' into 'master'

future add fields

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

Author: tigersk

CHANGELOG.md

@@ -1,3 +1,12 @@
+## 3.4.2 (2025-07-18)
+### New
+订单工具函数支持 time_in_force 参数
+QuoteClient 期货合约接口增加字段 合约规模 product_worth，交割方式 delivery_mode，合约类型 product_type
+QuoteClient 期货实时行情接口增加字段 `open_interest_change`
+
+### Breaking
+订单/成交记录支持 page token;
+
 ## 3.4.1 (2025-06-26)
 ### New
 - `QuoteClient.get_option_timeline` 期权分时接口

tigeropen/__init__.py

@@ -4,4 +4,4 @@
 
 @author: gaoan
 """
-__VERSION__ = '3.4.1'
+__VERSION__ = '3.4.2'

tigeropen/quote/quote_client.py

@@ -1295,7 +1295,7 @@ def get_future_brief(self, identifiers):
             response = FutureBriefsResponse()
             response.parse_response_content(response_content)
             if response.is_success():
-                return response.briefs
+                return response.result
             else:
                 raise ApiException(response.code, response.message)
 

tigeropen/quote/response/future_briefs_response.py

@@ -7,45 +7,30 @@
 import pandas as pd
 
 from tigeropen.common.response import TigerResponse
+from tigeropen.common.util.string_utils import camel_to_underline
 
-COLUMNS = ['identifier', 'ask_price', 'ask_size', 'bid_price', 'bid_size', 'pre_close', 'latest_price', 'latest_size',
-           'latest_time', 'volume', 'open_interest', 'open', 'high', 'low', 'limit_up', 'limit_down', 'settlement',
-           'settle_date']
-BRIEF_FIELD_MAPPINGS = {'askPrice': 'ask_price', 'askSize': 'ask_size', 'bidPrice': 'bid_price', 'bidSize': 'bid_size',
-                        'latestPrice': 'latest_price', 'openInterest': 'open_interest', 'preClose': 'pre_close',
-                        'right': 'put_call', 'latestTime': 'latest_time', 'latestSize': 'latest_size',
-                        'limitUp': 'limit_up', 'limitDown': 'limit_down', 'contractCode': 'identifier',
-                        'settleDate': 'settle_date'}
+BRIEF_FIELD_MAPPINGS = {'right': 'put_call', 'contractCode': 'identifier'}
 
 
 class FutureBriefsResponse(TigerResponse):
     def __init__(self):
         super(FutureBriefsResponse, self).__init__()
-        self.briefs = None
+        self.result = None
         self._is_success = None
 
     def parse_response_content(self, response_content):
         response = super(FutureBriefsResponse, self).parse_response_content(response_content)
         if 'is_success' in response:
             self._is_success = response['is_success']
 
-        brief_data = []
-        if self.data and isinstance(self.data, list):
-            for item in self.data:
-                item_values = {}
-                for key, value in item.items():
-                    if value is None:
-                        continue
-                    tag = BRIEF_FIELD_MAPPINGS[key] if key in BRIEF_FIELD_MAPPINGS else key
-                    item_values[tag] = value
-                brief_data.append([item_values.get(tag) for tag in COLUMNS])
-        elif isinstance(self.data, dict):
-            item_values = {}
-            for key, value in self.data.items():
-                if value is None:
-                    continue
-                tag = BRIEF_FIELD_MAPPINGS[key] if key in BRIEF_FIELD_MAPPINGS else key
-                item_values[tag] = value
-            brief_data.append([item_values.get(tag) for tag in COLUMNS])
-
-        self.briefs = pd.DataFrame(brief_data, columns=COLUMNS)
+        if self.data:
+            if isinstance(self.data, list):
+                fields_map = {origin: camel_to_underline(origin) for origin in self.data[0].keys()}
+                df = pd.DataFrame(self.data)
+            else:
+                fields_map = {origin: camel_to_underline(origin) for origin in self.data.keys()}
+                df = pd.DataFrame([self.data])
+            fields_map.update(BRIEF_FIELD_MAPPINGS)
+            self.result = df.rename(columns=fields_map)
+        else:
+            self.result = pd.DataFrame()