webull-openapi-python-sdk 1.0.6__py3-none-any.whl → 1.0.8__py3-none-any.whl

samples/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.6'
+__version__ = '1.0.8'

samples/account/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

samples/account/account_client.py

@@ -0,0 +1,42 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import uuid
+from time import sleep
+
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    res = trade_client.account_v2.get_account_list()
+    if res.status_code == 200:
+        print('get account list:', res.json())

samples/assets/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

samples/assets/assets_client.py

@@ -0,0 +1,47 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import uuid
+from time import sleep
+
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    res = trade_client.account_v2.get_account_balance(account_id)
+    if res.status_code == 200:
+        print('get account balance info:', res.json())
+
+    res = trade_client.account_v2.get_account_position(account_id)
+    if res.status_code == 200:
+        print('get account positions info:', res.json())
+

samples/data/data_client.py

@@ -24,9 +24,16 @@ optional_api_endpoint = "<api_endpoint>"
 your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 
+
 if __name__ == '__main__':
     data_client = DataClient(api_client)
 

samples/data/data_streaming_client.py

@@ -27,6 +27,11 @@ your_app_secret = "</your_app_secret>"
 optional_api_endpoint = "</optional_quotes_endpoint>"
 optional_quotes_endpoint = "</optional_quotes_endpoint>"
 region_id = '<region_id>'
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# data_streaming_client.set_token_dir(token_dir)
 
 session_id = uuid.uuid4().hex
 data_streaming_client = DataStreamingClient(your_app_key, your_app_secret, region_id, session_id,

samples/data/data_streaming_client_async.py

@@ -27,6 +27,11 @@ your_app_secret = "</your_app_secret>"
 optional_api_endpoint = "</optional_quotes_endpoint>"
 optional_quotes_endpoint = "</optional_quotes_endpoint>"
 region_id = '<region_id>'
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# data_streaming_client.set_token_dir(token_dir)
 
 session_id = uuid.uuid4().hex
 data_streaming_client = DataStreamingClient(your_app_key, your_app_secret, region_id, session_id,

samples/order/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

samples/order/order_option_client.py

@@ -0,0 +1,92 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import uuid
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    # Options
+    # For option order inquiries, please use the V2 query interface: api.order_v2.get_order_detail(account_id, client_order_id).
+    client_order_id = uuid.uuid4().hex
+    option_new_orders = [
+        {
+            "client_order_id": client_order_id,
+            "combo_type": "NORMAL",
+            "order_type": "LIMIT",
+            "quantity": "1",
+            "limit_price": "21.25",
+            "option_strategy": "SINGLE",
+            "side": "BUY",
+            "time_in_force": "GTC",
+            "entrust_type": "QTY",
+            "legs": [
+                {
+                    "side": "BUY",
+                    "quantity": "1",
+                    "symbol": "TSLA",
+                    "strike_price": "400",
+                    "option_expire_date": "2025-12-26",
+                    "instrument_type": "OPTION",
+                    "option_type": "CALL",
+                    "market": "US"
+                }
+            ]
+        }
+    ]
+
+    # preview
+    res = trade_client.order_v2.preview_option(account_id, option_new_orders)
+    if res.status_code == 200:
+        print("preview option res:", res.json())
+
+    # place
+    res = trade_client.order_v2.place_option(account_id, option_new_orders)
+    if res.status_code == 200:
+        print("place option res:" , res.json())
+
+    option_modify_orders = [
+        {
+            "client_order_id": client_order_id,
+            "quantity": "2",
+            "limit_price": "21.25"
+        }
+    ]
+    res = trade_client.order_v2.replace_option(account_id, option_modify_orders)
+    if res.status_code == 200:
+        print("Replace option order res:" , res.json())
+
+    res = trade_client.order_v2.cancel_option(account_id, client_order_id)
+    if res.status_code == 200:
+        print("Cancel option order res:" , res.json())
+
+    res = trade_client.order_v2.get_order_detail(account_id, client_order_id)
+    if res.status_code == 200:
+        print("Option order detail order res:" , res.json())

samples/order/order_stock_client.py

@@ -0,0 +1,95 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import uuid
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+
+    # simple order
+    client_order_id = uuid.uuid4().hex
+    print('client order id:', client_order_id)
+    new_simple_orders = [
+        {
+            "client_order_id": client_order_id,
+            "symbol": "BULL",
+            "instrument_type": "EQUITY",
+            "market": "US",
+            "order_type": "LIMIT",
+            "limit_price": "26",
+            "quantity": "1",
+            "support_trading_session": "CORE",
+            "side": "BUY",
+            "time_in_force": "DAY",
+            "entrust_type": "QTY"
+        }
+    ]
+    new_hk_stock_simple_orders = [
+        {
+            "client_order_id": client_order_id,
+            "symbol": "00700",
+            "instrument_type": "EQUITY",
+            "market": "HK",
+            "order_type": "ENHANCED_LIMIT",
+            "limit_price": "612",
+            "quantity": "100",
+            "side": "BUY",
+            "time_in_force": "DAY",
+            "entrust_type": "QTY"
+        }
+    ]
+    res = trade_client.order_v2.preview_order(account_id, new_simple_orders)
+    if res.status_code == 200:
+        print('preview order res:', res.json())
+
+    res = trade_client.order_v2.place_order(account_id, new_simple_orders)
+    if res.status_code == 200:
+        print('place order res:', res.json())
+
+    modify_simple_orders = [
+        {
+            "client_order_id": client_order_id,
+            "quantity": "2",
+            "limit_price": "25"
+        }
+    ]
+    res = trade_client.order_v2.replace_order(account_id, modify_simple_orders)
+    if res.status_code == 200:
+        print('replace order res:', res.json())
+
+    res = trade_client.order_v2.cancel_order(account_id, client_order_id)
+    if res.status_code == 200:
+        print('cancel order res:', res.json())
+
+    res = trade_client.order_v2.get_order_detail(account_id, client_order_id)
+    if res.status_code == 200:
+        print('order detail:', res.json())

samples/trade/trade_client.py

@@ -25,6 +25,12 @@ your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
 account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 

samples/trade/trade_client_v2.py

@@ -24,10 +24,15 @@ your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
 account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 
-
 if __name__ == '__main__':
     trade_client = TradeClient(api_client)
 

samples/trade/trade_client_v3.py

@@ -24,6 +24,12 @@ your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
 account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 
@@ -202,7 +208,38 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get master order detail res:', res.json())
 
-
+    # batch place order
+    batch_place_orders = [
+        {
+            "combo_type": "NORMAL",
+            "client_order_id": uuid.uuid4().hex,
+            "instrument_type": "EQUITY",
+            "market": "US",
+            "symbol": "AAPL",
+            "order_type": "MARKET",
+            "entrust_type": "QTY",
+            "support_trading_session": "CORE",
+            "time_in_force": "DAY",
+            "side": "BUY",
+            "quantity": "1"
+        },
+        {
+            "combo_type": "NORMAL",
+            "client_order_id": uuid.uuid4().hex,
+            "instrument_type": "EQUITY",
+            "market": "US",
+            "symbol": "TESL",
+            "order_type": "MARKET",
+            "entrust_type": "QTY",
+            "support_trading_session": "CORE",
+            "time_in_force": "DAY",
+            "side": "BUY",
+            "quantity": "1"
+        }
+    ]
+    res = trade_client.order_v3.batch_place_order(account_id, batch_place_orders)
+    if res.status_code == 200:
+        print('batch place normal equity order res:', res.json())
 
 
     # ============================================================

webull/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.6'
+__version__ = '1.0.8'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.0.6'
+__version__ = '1.0.8'
 
 import logging
 

webull/core/client.py

@@ -122,6 +122,7 @@ class ApiClient:
         self._token_check_duration_seconds = token_check_duration_seconds
         validation.assert_integer_positive(token_check_interval_seconds, "token_check_interval_seconds")
         self._token_check_interval_seconds = token_check_interval_seconds
+        self._token_dir = None
 
     def get_region_id(self):
         return self._region_id
@@ -164,6 +165,12 @@ class ApiClient:
     def get_token_check_interval_seconds(self):
         return self._token_check_interval_seconds
 
+    def set_token_dir(self, token_dir):
+        self._token_dir = token_dir
+
+    def get_token_dir(self):
+        return self._token_dir
+
     @staticmethod
     def user_agent_header():
         base = '%s (%s %s;%s)' \

webull/core/http/initializer/client_initializer.py

@@ -62,7 +62,7 @@ class ClientInitializer:
             if not ClientInitializer._check_token_enable(api_client):
                 return
 
-        token_manager = TokenManager()
+        token_manager = TokenManager(api_client.get_token_dir())
         token_manager.init_token(api_client)
 
     @staticmethod

webull/core/http/initializer/token/token_manager.py

@@ -34,11 +34,10 @@
 # coding=utf-8
 
 import logging
-import os
 import time
-from pathlib import Path
 
 from webull.core import compat
+from webull.core.http.initializer.token.token_storage import TokenStorage
 from webull.core.utils import desensitize
 from webull.core.exception.exceptions import ClientException
 from webull.core.http.initializer.token.bean.access_token import AccessToken
@@ -47,13 +46,10 @@ from webull.core.http.initializer.token.token_operation import TokenOperation
 logger = logging.getLogger(__name__)
 
 class TokenManager:
-    TOKEN_FILE_NAME = "conf/token.txt"
-    CONF_ENV_TOKEN_DIR = os.getenv("WEBULL_OPENAPI_TOKEN_DIR")
-    DEFAULT_ENV_TOKEN_DIR = os.getcwd()
 
-    def __init__(self):
-        dir_path = Path(self.CONF_ENV_TOKEN_DIR) if self.CONF_ENV_TOKEN_DIR else Path(self.DEFAULT_ENV_TOKEN_DIR)
-        self.token_file_path = dir_path / self.TOKEN_FILE_NAME
+    def __init__(self, custom_token_dir=None):
+        token_storage = TokenStorage(custom_token_dir=custom_token_dir)
+        self.token_file_path = token_storage.get_token_file_path()
 
     def init_token(self, api_client):
         local_access_token = self.load_token_from_local()
@@ -100,7 +96,7 @@ class TokenManager:
     def save_token_to_local(self, server_access_token):
         try:
             logger.info("save_token_to_local writing token to local file. token:%s expires:%s status:%s",
-                        server_access_token.get("token"), server_access_token.get("expires"), server_access_token.get("status"))
+                        desensitize.desensitize_token(server_access_token.get("token")), server_access_token.get("expires"), server_access_token.get("status"))
             self.token_file_path.parent.mkdir(parents=True, exist_ok=True)
             with open(self.token_file_path, "w", encoding="utf-8") as f:
                 f.write(server_access_token.get("token") + "\n")

webull/core/http/initializer/token/token_storage.py

@@ -0,0 +1,140 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# coding=utf-8
+
+import logging
+import os
+import platform
+import re
+from pathlib import Path
+
+from webull.core.exception.exceptions import ClientException
+
+logger = logging.getLogger(__name__)
+
+class TokenStorage:
+
+    DEFAULT_TOKEN_PATH = "conf"
+    DEFAULT_TOKEN_FILE = "token.txt"
+    DEFAULT_ENV_TOKEN_DIR = "WEBULL_OPENAPI_TOKEN_DIR"
+
+    _INVALID_CHARS = {
+        "windows": re.compile(r'[<>"|?*]'),
+        "posix": re.compile(r'[\0]')
+    }
+
+    def __init__(self, custom_token_dir=None):
+        # Resolve the final storage directory (priority: custom direction > environment variable > default).
+        self.storage_token_dir = self._resolve_dir(custom_token_dir)
+        # Full path validation
+        self._validate_path()
+        # Ensure the directory exists
+        self._ensure_dir_exists()
+        # Full path
+        self.token_file = self.storage_token_dir / self.DEFAULT_TOKEN_FILE
+        logger.info("storage_token initialized path:%s.",self.token_file)
+        # Check file exists
+        self._check_file_exists()
+
+    def _resolve_dir(self, custom_token_dir=None) -> Path:
+        if custom_token_dir and custom_token_dir.strip():
+            # custom direction
+            raw_dir = custom_token_dir.strip()
+            logger.info("storage_token uses the custom configuration, token_dir:%s.", raw_dir)
+        elif env_dir := os.getenv(self.DEFAULT_ENV_TOKEN_DIR):
+            # environment variable
+            raw_dir = env_dir.strip()
+            logger.info("storage_token uses environment variable configuration, %s:%s.", self.DEFAULT_ENV_TOKEN_DIR, raw_dir)
+        else:
+            # default
+            raw_dir = self.DEFAULT_TOKEN_PATH
+            logger.info("storage_token uses the default configuration, %s.", raw_dir)
+
+        # Resolve path
+        normalized_token_dir = Path(raw_dir).expanduser().absolute()
+        return normalized_token_dir
+
+    def _validate_path(self):
+
+        dir_path = self.storage_token_dir
+        os_type = platform.system().lower()
+
+        self._validate_path_syntax(dir_path, os_type)
+        self._validate_path_access(dir_path)
+
+    def _validate_path_syntax(self, path: Path, os_type: str):
+        """Syntax validity check"""
+        invalid_pattern = self._INVALID_CHARS["windows"] if "windows" in os_type else self._INVALID_CHARS["posix"]
+        if invalid_pattern.search(str(path)):
+            msg = ("storage_token path contains illegal characters, path:%s." % (str(path)))
+            logger.warning(msg)
+
+    def _validate_path_access(self, path: Path):
+        """Accessibility/permission check"""
+        if path.exists():
+            if not path.is_dir():
+                msg = ("storage_token path already exists but is not a directory, path:%s." % (str(path)))
+                logger.warning(msg)
+                return
+            if not os.access(path, os.R_OK | os.W_OK):
+                msg = ("storage_token directory has no read/write permission. Please check the configuration, path:%s." % (str(path)))
+                logger.warning(msg)
+        else:
+            parent_dir = path.parent
+            if not parent_dir.exists():
+                msg = ("storage_token parent directory does not exist, unable to create directory. Please check the configuration, parent path:%s." % (str(parent_dir)))
+                logger.warning(msg)
+                return
+            if not os.access(parent_dir, os.R_OK | os.W_OK | os.X_OK):
+                msg = ("storage_token parent directory has no read/write permission. Please check the configuration, parent path:%s." % (str(parent_dir)))
+                logger.warning(msg)
+
+    def _ensure_dir_exists(self):
+        """Ensure the directory exists"""
+        try:
+            self.storage_token_dir.mkdir(parents=True, exist_ok=True)
+        except Exception as e:
+            msg = ("storage_token failed to create directory, file:%s." % (str(self.storage_token_dir)))
+            logger.error(msg)
+            raise ClientException("ERROR_STORAGE_TOKEN", str(e)) from e
+
+    def _check_file_exists(self):
+        """Check file exists"""
+        full_path = Path(self.token_file)
+        if full_path.is_file():
+            msg = ("storage_token Note: The token file already exists, the latest token configuration will be overwritten and written to the token file after successful 2FA verification. path:%s." % self.token_file)
+            logger.warning(msg)
+
+    def get_token_file_path(self):
+        return self.token_file

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '1.0.6'
+__version__ = '1.0.8'

webull/data/internal/quotes_client.py

@@ -69,6 +69,7 @@ class QuotesClient(mqttc.Client):
         self._http_host = http_host
         self._mqtt_host = mqtt_host
         self._mqtt_port = mqtt_port
+        self._token_dir = None
         self._quotes_decoder = QuotesDecoder()
 
         api_client = ApiClient(app_key, app_secret, region_id)
@@ -158,6 +159,11 @@ class QuotesClient(mqttc.Client):
     def on_quotes_message(self, func):
         with self._callback_mutex:
             self._on_quotes_message = func
+    
+    def set_token_dir(self, token_dir):
+        self._token_dir = token_dir
+        if token_dir:
+            self.api_client.set_token_dir(token_dir)
 
     def register_payload_decoder(self, type, decoder):
         with self._callback_mutex:

webull/data/quotes/subscribe/message_pb2.py

@@ -13,7 +13,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\rmessage.proto\"Z\n\x05\x42\x61sic\x12\x0e\n\x06symbol\x18\x01 \x01(\t\x12\x15\n\rinstrument_id\x18\x02 \x01(\t\x12\x11\n\ttimestamp\x18\x03 \x01(\t\x12\x17\n\x0ftrading_session\x18\x04 \x01(\t\"\xb6\x01\n\x08Snapshot\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x12\n\ntrade_time\x18\x02 \x01(\t\x12\r\n\x05price\x18\x03 \x01(\t\x12\x0c\n\x04open\x18\x04 \x01(\t\x12\x0c\n\x04high\x18\x05 \x01(\t\x12\x0b\n\x03low\x18\x06 \x01(\t\x12\x11\n\tpre_close\x18\x07 \x01(\t\x12\x0e\n\x06volume\x18\x08 \x01(\t\x12\x0e\n\x06\x63hange\x18\t \x01(\t\x12\x14\n\x0c\x63hange_ratio\x18\n \x01(\t\"L\n\x05Quote\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x15\n\x04\x61sks\x18\x02 \x03(\x0b\x32\x07.AskBid\x12\x15\n\x04\x62ids\x18\x03 \x03(\x0b\x32\x07.AskBid\"X\n\x04Tick\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x0c\n\x04time\x18\x02 \x01(\t\x12\r\n\x05price\x18\x03 \x01(\t\x12\x0e\n\x06volume\x18\x04 \x01(\t\x12\x0c\n\x04side\x18\x05 \x01(\t\"U\n\x06\x41skBid\x12\r\n\x05price\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\x12\x15\n\x05order\x18\x03 \x03(\x0b\x32\x06.Order\x12\x17\n\x06\x62roker\x18\x04 \x03(\x0b\x32\x07.Broker\"#\n\x05Order\x12\x0c\n\x04mpid\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\"#\n\x06\x42roker\x12\x0b\n\x03\x62id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\tb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\rmessage.proto\"Z\n\x05\x42\x61sic\x12\x0e\n\x06symbol\x18\x01 \x01(\t\x12\x15\n\rinstrument_id\x18\x02 \x01(\t\x12\x11\n\ttimestamp\x18\x03 \x01(\t\x12\x17\n\x0ftrading_session\x18\x04 \x01(\t\"\xd6\x03\n\x08Snapshot\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x12\n\ntrade_time\x18\x02 \x01(\t\x12\r\n\x05price\x18\x03 \x01(\t\x12\x0c\n\x04open\x18\x04 \x01(\t\x12\x0c\n\x04high\x18\x05 \x01(\t\x12\x0b\n\x03low\x18\x06 \x01(\t\x12\x11\n\tpre_close\x18\x07 \x01(\t\x12\x0e\n\x06volume\x18\x08 \x01(\t\x12\x0e\n\x06\x63hange\x18\t \x01(\t\x12\x14\n\x0c\x63hange_ratio\x18\n \x01(\t\x12\x16\n\x0e\x65xt_trade_time\x18\x0b \x01(\t\x12\x11\n\text_price\x18\x0c \x01(\t\x12\x10\n\x08\x65xt_high\x18\r \x01(\t\x12\x0f\n\x07\x65xt_low\x18\x0e \x01(\t\x12\x12\n\next_volume\x18\x0f \x01(\t\x12\x12\n\next_change\x18\x10 \x01(\t\x12\x18\n\x10\x65xt_change_ratio\x18\x11 \x01(\t\x12\x16\n\x0eovn_trade_time\x18\x12 \x01(\t\x12\x11\n\tovn_price\x18\x13 \x01(\t\x12\x10\n\x08ovn_high\x18\x14 \x01(\t\x12\x0f\n\x07ovn_low\x18\x15 \x01(\t\x12\x12\n\novn_volume\x18\x16 \x01(\t\x12\x12\n\novn_change\x18\x17 \x01(\t\x12\x18\n\x10ovn_change_ratio\x18\x18 \x01(\t\"L\n\x05Quote\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x15\n\x04\x61sks\x18\x02 \x03(\x0b\x32\x07.AskBid\x12\x15\n\x04\x62ids\x18\x03 \x03(\x0b\x32\x07.AskBid\"X\n\x04Tick\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x0c\n\x04time\x18\x02 \x01(\t\x12\r\n\x05price\x18\x03 \x01(\t\x12\x0e\n\x06volume\x18\x04 \x01(\t\x12\x0c\n\x04side\x18\x05 \x01(\t\"U\n\x06\x41skBid\x12\r\n\x05price\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\x12\x15\n\x05order\x18\x03 \x03(\x0b\x32\x06.Order\x12\x17\n\x06\x62roker\x18\x04 \x03(\x0b\x32\x07.Broker\"#\n\x05Order\x12\x0c\n\x04mpid\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\"#\n\x06\x42roker\x12\x0b\n\x03\x62id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\tb\x06proto3')
 
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'message_pb2', globals())
@@ -23,15 +23,15 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _BASIC._serialized_start=17
   _BASIC._serialized_end=107
   _SNAPSHOT._serialized_start=110
-  _SNAPSHOT._serialized_end=292
-  _QUOTE._serialized_start=294
-  _QUOTE._serialized_end=370
-  _TICK._serialized_start=372
-  _TICK._serialized_end=460
-  _ASKBID._serialized_start=462
-  _ASKBID._serialized_end=547
-  _ORDER._serialized_start=549
-  _ORDER._serialized_end=584
-  _BROKER._serialized_start=586
-  _BROKER._serialized_end=621
+  _SNAPSHOT._serialized_end=580
+  _QUOTE._serialized_start=582
+  _QUOTE._serialized_end=658
+  _TICK._serialized_start=660
+  _TICK._serialized_end=748
+  _ASKBID._serialized_start=750
+  _ASKBID._serialized_end=835
+  _ORDER._serialized_start=837
+  _ORDER._serialized_end=872
+  _BROKER._serialized_start=874
+  _BROKER._serialized_end=909
 # @@protoc_insertion_point(module_scope)

webull/data/quotes/subscribe/snapshot_result.py

@@ -21,22 +21,40 @@ from webull.data.quotes.subscribe.basic_result import BasicResult
 class SnapshotResult:
     def __init__(self, pb_snapshot):
         self.basic = BasicResult(pb_snapshot.basic)
+        self.last_trade_time = int(pb_snapshot.trade_time) if pb_snapshot.trade_time else None
+        self.price = Decimal(pb_snapshot.price) if pb_snapshot.price else None
         self.open = Decimal(pb_snapshot.open) if pb_snapshot.open else None
         self.high = Decimal(pb_snapshot.high) if pb_snapshot.high else None
         self.low = Decimal(pb_snapshot.low) if pb_snapshot.low else None
-        self.price = Decimal(pb_snapshot.price) if pb_snapshot.price else None
-        self.pre_close = Decimal(
-            pb_snapshot.pre_close) if pb_snapshot.pre_close else None
-        self.volume = Decimal(
-            pb_snapshot.volume) if pb_snapshot.volume else None
-        self.change = Decimal(
-            pb_snapshot.change) if pb_snapshot.change else None
-        self.change_ratio = Decimal(
-            pb_snapshot.change_ratio) if pb_snapshot.change_ratio else None
+        self.pre_close = Decimal(pb_snapshot.pre_close) if pb_snapshot.pre_close else None
+        self.close = Decimal(pb_snapshot.open) if pb_snapshot.open else None
+        self.volume = Decimal(pb_snapshot.volume) if pb_snapshot.volume else None
+        self.change = Decimal(pb_snapshot.change) if pb_snapshot.change else None
+        self.change_ratio = Decimal(pb_snapshot.change_ratio) if pb_snapshot.change_ratio else None
+        self.ext_trade_time = int(pb_snapshot.ext_trade_time) if pb_snapshot.ext_trade_time else None
+        self.ext_price = Decimal(pb_snapshot.ext_price) if pb_snapshot.ext_price else None
+        self.ext_high = Decimal(pb_snapshot.ext_high) if pb_snapshot.ext_high else None
+        self.ext_low = Decimal(pb_snapshot.ext_low) if pb_snapshot.ext_low else None
+        self.ext_volume = Decimal(pb_snapshot.ext_volume) if pb_snapshot.ext_volume else None
+        self.ext_change = Decimal(pb_snapshot.ext_change) if pb_snapshot.ext_change else None
+        self.ext_change_ratio = Decimal(pb_snapshot.ext_change_ratio) if pb_snapshot.ext_change_ratio else None
+        self.ovn_trade_time = int(pb_snapshot.ovn_trade_time) if pb_snapshot.ovn_trade_time else None
+        self.ovn_price = Decimal(pb_snapshot.ovn_price) if pb_snapshot.ovn_price else None
+        self.ovn_high = Decimal(pb_snapshot.ovn_high) if pb_snapshot.ovn_high else None
+        self.ovn_low = Decimal(pb_snapshot.ovn_low) if pb_snapshot.ovn_low else None
+        self.ovn_volume = Decimal(pb_snapshot.ovn_volume) if pb_snapshot.ovn_volume else None
+        self.ovn_change = Decimal(pb_snapshot.ovn_change) if pb_snapshot.ovn_change else None
+        self.ovn_change_ratio = Decimal(pb_snapshot.ovn_change_ratio) if pb_snapshot.ovn_change_ratio else None
 
     def get_basic(self):
         return self.basic
 
+    def get_last_trade_time(self):
+        return self.last_trade_time
+
+    def get_price(self):
+        return self.price
+
     def get_open(self):
         return self.open
 
@@ -46,12 +64,12 @@ class SnapshotResult:
     def get_low(self):
         return self.low
 
-    def get_price(self):
-        return self.price
-
     def get_pre_close(self):
         return self.pre_close
 
+    def get_close(self):
+        return self.close
+
     def get_volume(self):
         return self.volume
 
@@ -61,9 +79,55 @@ class SnapshotResult:
     def get_change_ratio(self):
         return self.change_ratio
 
+    def get_ext_trade_time(self):
+        return self.ext_trade_time
+
+    def get_ext_price(self):
+        return self.ext_price
+
+    def get_ext_high(self):
+        return self.ext_high
+
+    def get_ext_low(self):
+        return self.ext_low
+
+    def get_ext_volume(self):
+        return self.ext_volume
+
+    def get_ext_change(self):
+        return self.ext_change
+
+    def get_ext_change_ratio(self):
+        return self.ext_change_ratio
+
+    def get_ovn_trade_time(self):
+        return self.ovn_trade_time
+
+    def get_ovn_price(self):
+        return self.ovn_price
+
+    def get_ovn_high(self):
+        return self.ovn_high
+
+    def get_ovn_low(self):
+        return self.ovn_low
+
+    def get_ovn_volume(self):
+        return self.ovn_volume
+
+    def get_ovn_change(self):
+        return self.ovn_change
+
+    def get_ovn_change_ratio(self):
+        return self.ovn_change_ratio
+
     def __repr__(self):
-        return "%s, open:%s, high:%s, low:%s, price:%s, pre_close:%s, volume:%s, change:%s, change_ratio:%s" \
-            % (self.basic, self.open, self.high, self.low, self.price, self.pre_close, self.volume, self.change, self.change_ratio)
+        attrs = ['last_trade_time', 'price', 'open', 'high', 'low', 'pre_close', 'close', 'volume', 'change', 'change_ratio']
+        ext_attrs = [f"ext_{name}" for name in ['trade_time', 'price', 'high', 'low', 'volume', 'change', 'change_ratio']]
+        ovn_attrs = [f"ovn_{name}" for name in ['trade_time', 'price', 'high', 'low', 'volume', 'change', 'change_ratio']]
+        all_attrs = attrs + ext_attrs + ovn_attrs
+        attr_str = ', '.join(f"{name}:{getattr(self, name)}" for name in all_attrs)
+        return f"{self.basic}, {attr_str}"
 
     def __str__(self):
         return self.__repr__()

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.6'
+__version__ = '1.0.8'

webull/trade/request/v3/batch_place_order_request.py

@@ -0,0 +1,52 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+# coding=utf-8
+
+from webull.core.request import ApiRequest
+
+
+class BatchPlaceOrderRequest(ApiRequest):
+    def __init__(self):
+        super().__init__("/openapi/trade/order/batch-place", version='v2', method="POST", body_params={})
+
+    def set_account_id(self, account_id):
+        self.add_body_params("account_id", account_id)
+
+    def set_batch_orders(self, batch_orders):
+        self.add_body_params("batch_orders", batch_orders)
+
+    def add_custom_headers_from_order(self, batch_orders):
+        if not batch_orders:
+            return
+
+        if isinstance(batch_orders, list) and batch_orders[0]:
+            first_order = batch_orders[0]
+            leg_list = first_order.get("legs")
+            if leg_list is not None and isinstance(leg_list, list):
+                for sub_leg in leg_list:
+                    if (sub_leg and isinstance(sub_leg, dict)
+                            and sub_leg.get("instrument_type") == "OPTION"):
+                        instrument_type = sub_leg.get("instrument_type")
+                        market = sub_leg.get("market")
+                        category = market + "_" + instrument_type
+                        if category is not None:
+                            self.add_header("category", category)
+                return
+
+            market = first_order.get("market")
+            instrument_type = first_order.get("instrument_type")
+            category = market + "_" + instrument_type
+            if category is not None:
+                self.add_header("category", category)

webull/trade/trade/v3/order_opration_v3.py

@@ -14,6 +14,7 @@
 # coding=utf-8
 from webull.trade.request.v3.preview_order_request import PreviewOrderRequest
 from webull.trade.request.v3.place_order_request import PlaceOrderRequest
+from webull.trade.request.v3.batch_place_order_request import BatchPlaceOrderRequest
 from webull.trade.request.v3.replace_order_request import ReplaceOrderRequest
 from webull.trade.request.v3.cancel_order_request import CancelOrderRequest
 from webull.trade.request.v3.get_order_detail_request import OrderDetailRequest
@@ -50,6 +51,18 @@ class OrderOperationV3:
         response = self.client.get_response(place_order_request)
         return response
 
+    def batch_place_order(self, account_id, batch_orders):
+        """
+        This interface is currently supported only for Webull US.
+        Support for other regions will be available in future updates.
+        """
+        batch_place_order_request = BatchPlaceOrderRequest()
+        batch_place_order_request.set_account_id(account_id=account_id)
+        batch_place_order_request.set_batch_orders(batch_orders=batch_orders)
+        batch_place_order_request.add_custom_headers_from_order(batch_orders)
+        response = self.client.get_response(batch_place_order_request)
+        return response
+
     def replace_order(self, account_id, modify_orders, client_combo_order_id=None):
         """
         This interface is currently supported only for Webull US.

{webull_openapi_python_sdk-1.0.6.dist-info → webull_openapi_python_sdk-1.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webull-openapi-python-sdk
-Version: 1.0.6
+Version: 1.0.8
 Summary: Webull Python SDK.
 Home-page: 
 Author: Webull

{webull_openapi_python_sdk-1.0.6.dist-info → webull_openapi_python_sdk-1.0.8.dist-info}/RECORD

@@ -1,16 +1,23 @@
-samples/__init__.py,sha256=iNeZ6LZ9iCV_ugsqAh5K1fFqbKkfU8o3NbLYBWI3m1I,22
+samples/__init__.py,sha256=mFFUUCx5TqyW1TTFRrWDhXXVMJDMRxXWrkHanVtp9oY,22
+samples/account/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
+samples/account/account_client.py,sha256=vwh-nI_JnjwcIeOr1sQPMzG8pAqZwliUusE49ZmYE3s,1796
+samples/assets/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
+samples/assets/assets_client.py,sha256=p9LS2Td3gbUMkHn4LD_9RMCFuaQRUbsKvG4PhZBGJDc,1974
 samples/data/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
-samples/data/data_client.py,sha256=a2LBi1KqakA01KR-y0nsB9HqUsH0Hj3nAsk0tP5KhlI,4287
-samples/data/data_streaming_client.py,sha256=EILzTCTQ0WkPymdq7V3OW_-JQdfRSZ8aBBYkbpujwqg,3498
-samples/data/data_streaming_client_async.py,sha256=7KyODfZLBFLFRJcux6BtacS05cPKDn78G4lZa978Qgo,3853
+samples/data/data_client.py,sha256=rH91Yj7oIF6dBOOzF99cUn_12cgDLkw02SNIQM2nB1o,4868
+samples/data/data_streaming_client.py,sha256=IdCUNdfo2_dR9OLgWZuIc9U9s-0-uNjwqkf9aLoG-44,4088
+samples/data/data_streaming_client_async.py,sha256=o_u1ch8JdbcYnLCvDCCUzO-Z1IG7BUKncu_GB_kCbOs,4443
+samples/order/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
+samples/order/order_option_client.py,sha256=njxr1QZc69_VbHsp9D9cOv1_-AekO2uNYKiY7o0-1Eg,3602
+samples/order/order_stock_client.py,sha256=hYwVwVFVERk-YS7gRcW-LuGfAvcF8VJHZs1qwLcFhYU,3529
 samples/trade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-samples/trade/trade_client.py,sha256=bXX3onGK6aRFpopeE3yDQAx4Xo9dDc-k9gGbwB9El0A,5678
-samples/trade/trade_client_v2.py,sha256=qKlAhalnB770PyVRvPxnLOTW7PvXXfr0WIoJphY4jG4,10192
-samples/trade/trade_client_v3.py,sha256=4lR6AAFmfpp440XQFPG30oIqUz_PpicUGvrpWoMQ8lU,14884
+samples/trade/trade_client.py,sha256=LyWSvZJH4ByCkRORqP9WdkXfx65A2b6fhc9_GzL8DOM,6258
+samples/trade/trade_client_v2.py,sha256=IO-zmRiUnCmIetTdiYunPh8jVK2VaPrOR77Dwvz1auY,10771
+samples/trade/trade_client_v3.py,sha256=70f4VJYWcSJP3ppA8mRAoftJqjRTn5GTeGZck8eLCTg,16526
 samples/trade/trade_event_client.py,sha256=uOx9EwFaves2yaTNm13BHpYC0IHXSoBL8BWPbDLeFw4,2469
-webull/__init__.py,sha256=iNeZ6LZ9iCV_ugsqAh5K1fFqbKkfU8o3NbLYBWI3m1I,22
-webull/core/__init__.py,sha256=x2CgEC54GYD2NVdrqypNOZ9qo3nqJK4EfI78rCpttAU,225
-webull/core/client.py,sha256=1xH9XS92AKdUiVUPJYtzeaIl88bwa_ChDALJAxrXWQ0,16229
+webull/__init__.py,sha256=mFFUUCx5TqyW1TTFRrWDhXXVMJDMRxXWrkHanVtp9oY,22
+webull/core/__init__.py,sha256=l5SgEaJNDBxUASBJsNGBJYu3AocnG4Mr89RIOokPiTA,225
+webull/core/client.py,sha256=OE_ghPA558eE85MmaU_I3Tg0j-osCQFChTk-6dy4OW0,16398
 webull/core/compat.py,sha256=HDis0D271oQ6OCpA7ViX10NJdhfXdoBfzx6nuV3vrnI,3114
 webull/core/headers.py,sha256=7aMt3_YtaL9Yhqj2T1g7ESQgkI78SAXIk7hMX5U5FgE,2019
 webull/core/request.py,sha256=BMR9kv3KDpaX2hh9BX7qPn5hhTB7XqJkMj2OSXPvoUk,8340
@@ -50,14 +57,15 @@ webull/core/http/protocol_type.py,sha256=DIPZ3i_r8nxaW5hVRVTyjwpKtWWTSHoGN_nA1SB
 webull/core/http/request.py,sha256=GUrxb5n2ozVtb45-yBXe9iT0E61guez_udluMKF1k1w,3769
 webull/core/http/response.py,sha256=Q4W2azXn9hqYuR1NVt8NlHmIaFAi0lmD3ejXRygk2KA,5868
 webull/core/http/initializer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-webull/core/http/initializer/client_initializer.py,sha256=olKBWcloSpGOSoMkHez0wQ9arwsqxGTQN5-YQAetcQk,4171
+webull/core/http/initializer/client_initializer.py,sha256=2Uya5T2i9qqwW0JTzjSk7HWsoHW1AOiEduAnx4Zu8k8,4197
 webull/core/http/initializer/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/core/http/initializer/config/config_operation.py,sha256=_1MILnzVu61XSV74yLsEzqLAt4GQNiJ9QpLN3kws9Q0,1766
 webull/core/http/initializer/config/bean/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/core/http/initializer/config/bean/query_config_request.py,sha256=WOLYv06KD6l47LH0VKs7_Npm3AmyPKj3b6nY9OrA7n0,1569
 webull/core/http/initializer/token/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-webull/core/http/initializer/token/token_manager.py,sha256=nc9F14uJ5iwqi2MK9R7QvhU9SqBIlWr8wr2jYrmtxRM,11197
+webull/core/http/initializer/token/token_manager.py,sha256=_5AFmiAtBBVgDf0VUaplZMyf74qbQ5o0N88XKEmGOis,11110
 webull/core/http/initializer/token/token_operation.py,sha256=iI2H1cKfAe3gpVptHCniZso77kuPnf3jyg5b4QYQD5E,2577
+webull/core/http/initializer/token/token_storage.py,sha256=ncGOBxR-Mtt-DFk29DTCv9T92PRRC6Ud1bVMTa46NE8,5834
 webull/core/http/initializer/token/bean/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/core/http/initializer/token/bean/access_token.py,sha256=wK5UrTnAMacO_vkhym-BcmbJdkHJcYHIpFcXJrQp1r8,1529
 webull/core/http/initializer/token/bean/check_token_request.py,sha256=mYuwJPiwlnNGHxlgBMqkzGji9ZOOJ9c-o_hRwfFx0vA,1658
@@ -178,7 +186,7 @@ webull/core/vendored/requests/packages/urllib3/util/ssl_.py,sha256=aRUKc1WIyS-sU
 webull/core/vendored/requests/packages/urllib3/util/timeout.py,sha256=sAyiBBds7eOk1oM3ulvVMWZiqx1B743puHqK92XwBcY,10325
 webull/core/vendored/requests/packages/urllib3/util/url.py,sha256=_CgqbyNrQWubrv_y5aWhuutz3mnbj1cvTUe4VYbGYWA,7367
 webull/core/vendored/requests/packages/urllib3/util/wait.py,sha256=0FHS8R3OrMU-97XWt8AxuUStkSGXTct9CfOwY_fWn7U,5971
-webull/data/__init__.py,sha256=LXH5atFzj-GoZQ4-tPUfhhOIAT61DA8dpVqg6ZwaGmk,38
+webull/data/__init__.py,sha256=s8jHH-qZ5jY8Rsk-YS41NY0gFUU5YjdRBlDw0egN2-4,38
 webull/data/data_client.py,sha256=JGouoFd37-sxpP6GyOJ0rRw7UuBmXqoIcis0jiRGJPQ,1871
 webull/data/data_streaming_client.py,sha256=hYqrdKTeIB3Xmp7LMjMwN1XE6Y7bKXX0y-lGX1ty6W4,3870
 webull/data/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -196,7 +204,7 @@ webull/data/common/timespan.py,sha256=Mg-dnvIWclVZRhIkjDiGzRlnOK457PWZ8sY5I8NXRB
 webull/data/internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/data/internal/default_retry_policy.py,sha256=g94o5LKtbB5XoDiZWHp7yKGOWTTTOT89bz1ZSlT79mI,3307
 webull/data/internal/exceptions.py,sha256=qtInXjns6ce6KQTtJOxz8M4bywuOJe2sNSAwGJqTWDs,1800
-webull/data/internal/quotes_client.py,sha256=9cg6FS_vUgaQTuC5Eb0ASau6A0yyCrBDj5Q1FXden1M,12822
+webull/data/internal/quotes_client.py,sha256=PCOIteRz1QzwAva9D1DenrGOHOjm_XLrB250Qeqq1Fk,13009
 webull/data/internal/quotes_decoder.py,sha256=Y849H41h-cnKPjFe9xDsvG3bWD3l7FnMcCM16yu5RuM,1420
 webull/data/internal/quotes_payload_decoder.py,sha256=x2XGYDu4wSdc1LLrcIo3BXeb5jgqylFK7_8pfWv_xFU,998
 webull/data/internal/quotes_topic.py,sha256=kG4RZTjj01U0e54qoOrJHlLrPeBzXekySasm2uoyXVo,1138
@@ -210,13 +218,13 @@ webull/data/quotes/subscribe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NM
 webull/data/quotes/subscribe/ask_bid_result.py,sha256=EWu5dFMb_BwFGYPLe-f9uCD8_Ftl1wguhpU1qXi2zaY,1552
 webull/data/quotes/subscribe/basic_result.py,sha256=l9pxGlt8HLHwE3plq_6J0OPZ_X4ZjjRfa1f9nExu2dE,1450
 webull/data/quotes/subscribe/broker_result.py,sha256=E6pM0Ydr6tU_bPSOeyu1KJf7oYgbO-lIXLIdJQANH4I,1013
-webull/data/quotes/subscribe/message_pb2.py,sha256=I6scR0qacKJWWhBdZq9tvCzSYUXZ9-TuPwpAmnp-FgY,2570
+webull/data/quotes/subscribe/message_pb2.py,sha256=JimxZN9hCEvt_NF0eYRNZJttEsCAc3bWAelE5Tva7yM,3136
 webull/data/quotes/subscribe/order_result.py,sha256=bqLjRzCDK0jpQBMm00QxfgV-SPg04lOLYxc8SgpkFDw,912
 webull/data/quotes/subscribe/payload_type.py,sha256=nacQubAzKjutfddNdilckpsbamCUt6nrBnzrxgMOrWQ,674
 webull/data/quotes/subscribe/quote_decoder.py,sha256=vTDKi3TaQ79ODTydVcEEiJR2g0fQLPf5hUOqo7Mi1gw,1016
 webull/data/quotes/subscribe/quote_result.py,sha256=2SoRzSGANphAut1jleNnfZtUhpqqbELRcs1biu440p8,1442
 webull/data/quotes/subscribe/snapshot_decoder.py,sha256=dukBHXa971LHp9oPkgQ4mqL_8yIAU5XSlUIUjpMz2NY,1045
-webull/data/quotes/subscribe/snapshot_result.py,sha256=T46uw-hxmWDCJdhXfFsdSn3UtE50Bsc3oYJ9rYS1f6o,2311
+webull/data/quotes/subscribe/snapshot_result.py,sha256=U-YPGAVklcCsXZsp-9TPUUIfvqEgbPsou4Mhkkbxzp8,5077
 webull/data/quotes/subscribe/tick_decoder.py,sha256=Qb__nJth2vsDMk2bWfNxY-mUGTUPzSZPO-ukHVxq80g,1008
 webull/data/quotes/subscribe/tick_result.py,sha256=i2-4ZD1GK5EI3NhxkhSmUXfKnkBMjrwVBzLoDUY95OU,1467
 webull/data/request/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -240,7 +248,7 @@ webull/data/request/get_snapshot_request.py,sha256=OD2PiaxmBCboFDaU8DFTwvfNd2zOb
 webull/data/request/get_tick_request.py,sha256=rUHhQgC8Z_6ensLyCkg3DDK55SlEi0Bc_dhpCIIspDs,1366
 webull/data/request/subscribe_request.py,sha256=dm93Q5Q4gigAMqAobolaYYSs3wM6QddPUZOjEtJsX-8,1471
 webull/data/request/unsubscribe_request.py,sha256=hQA4mYM64PgmQEA2otl47-3nCXqjsSY_weFA3_wNbMM,1446
-webull/trade/__init__.py,sha256=iNeZ6LZ9iCV_ugsqAh5K1fFqbKkfU8o3NbLYBWI3m1I,22
+webull/trade/__init__.py,sha256=iCEPnhz-knfGRAO4Ep2uQaYf4xwhPIjjcgAcNjga8kc,21
 webull/trade/trade_client.py,sha256=_6lH4KO-jKgKWU28fWNsc9-KEHto-WvaP0gT96BJ_dw,2184
 webull/trade/trade_events_client.py,sha256=4a7qupeT3dKJRKBQqXNhCai6ENzX6PA4yjTDHHxPR0w,8892
 webull/trade/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -302,6 +310,7 @@ webull/trade/request/v2/preview_order_request.py,sha256=gRld4FcpBFQk7X24hzgs5lmM
 webull/trade/request/v2/replace_option_request.py,sha256=0S86ToPdfZlZmf85jBQ39a1RkQ8wY7FJZA4hdxmyjN0,1189
 webull/trade/request/v2/replace_order_request.py,sha256=rptKekCa6uSj1rzg8TT7jnuMVCDquhev6naPESqpihU,1193
 webull/trade/request/v3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webull/trade/request/v3/batch_place_order_request.py,sha256=QW6EZ-mZVTdLVbzJsr0VxA5Bca4hRgAq9_x6N9xVjnk,2115
 webull/trade/request/v3/cancel_order_request.py,sha256=x3_5w-0_qwN6CjW2yuM4oLd51QuuTtXNVKZQ23MYscs,1024
 webull/trade/request/v3/get_order_detail_request.py,sha256=jYuU8vHdE0fkXZdHqyuZ-rnhHUlQ9Qo5r7FvzmCfEKE,1000
 webull/trade/request/v3/get_order_history_request.py,sha256=iCZEUs6JHOlRuA-u1zL1QvfD8h7gaEg1TR0X4mWxIVo,1304
@@ -318,10 +327,10 @@ webull/trade/trade/v2/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 webull/trade/trade/v2/account_info_v2.py,sha256=IGY_BGTrZ0h7yQ_nDodNtmKen9gXW6heUFb7VLRQ9bY,2142
 webull/trade/trade/v2/order_operation_v2.py,sha256=m54RH2j45CBBWEnqe4KxrsltAF44XKtPMT4kv8t7djQ,12745
 webull/trade/trade/v3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-webull/trade/trade/v3/order_opration_v3.py,sha256=4OTodBrcfyRuZOMXodNNHjCtsQxCV-5JQXEFBB1S_cE,6738
-webull_openapi_python_sdk-1.0.6.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
-webull_openapi_python_sdk-1.0.6.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
-webull_openapi_python_sdk-1.0.6.dist-info/METADATA,sha256=sGda_Dr-h3X5GSFfTa1RIpbcZrVk8I7M4EPEr1DW6V8,702
-webull_openapi_python_sdk-1.0.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-webull_openapi_python_sdk-1.0.6.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
-webull_openapi_python_sdk-1.0.6.dist-info/RECORD,,
+webull/trade/trade/v3/order_opration_v3.py,sha256=_L10--m_XhoMe8YeYjQXVvRoTAWoRRzLU59UeneyMrU,7428
+webull_openapi_python_sdk-1.0.8.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
+webull_openapi_python_sdk-1.0.8.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
+webull_openapi_python_sdk-1.0.8.dist-info/METADATA,sha256=jcAKegwV60urTKWSWSD1BhcsnEPVUU49Cz22cpSAKU8,702
+webull_openapi_python_sdk-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+webull_openapi_python_sdk-1.0.8.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
+webull_openapi_python_sdk-1.0.8.dist-info/RECORD,,