webull-openapi-python-sdk 1.0.7__py3-none-any.whl → 1.0.9__py3-none-any.whl

samples/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.7'
+__version__ = '1.0.9'

samples/data/data_client.py

@@ -74,6 +74,10 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get_tick:', res.json())
 
+    res = data_client.market_data.get_footprint("AAPL", Category.US_STOCK.name, Timespan.S5.name)
+    if res.status_code == 200:
+        print('get_footprint:', res.json())
+
     res = data_client.market_data.get_quotes("AAPL", Category.US_STOCK.name, depth=1, overnight_required=True)
     if res.status_code == 200:
         print('get_quotes:', res.json())
@@ -94,6 +98,10 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get_futures_snapshot:', res.json())
 
+    res = data_client.futures_market_data.get_futures_footprint("SILZ5,6BM6", Category.US_FUTURES.name, Timespan.S5.name)
+    if res.status_code == 200:
+        print('get_futures_footprint:', res.json())
+
     res = data_client.instrument.get_futures_products(Category.US_FUTURES.name)
     if res.status_code == 200:
         print('get_futures_products:', res.json())

samples/trade/trade_client_v3.py

@@ -208,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.7'
+__version__ = '1.0.9'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.0.7'
+__version__ = '1.0.9'
 
 import logging
 

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '1.0.7'
+__version__ = '1.0.9'

webull/data/common/timespan.py

@@ -16,6 +16,8 @@
 
 from webull.core.common.easy_enum import EasyEnum
 class Timespan(EasyEnum):
+    S5 = (12, "5 Second")
+    S15= (13, "15 Second")
     M1 = (1, "1 minute")
     M5 = (2, "5 minute")
     M15 = (3, "15 minute")

webull/data/quotes/futures_market_data.py

@@ -11,8 +11,8 @@
 # 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.
-
-
+from webull.data.common.category import Category
+from webull.data.request.get_futures_footprint_request import GetFuturesFootprintRequest
 from webull.data.request.get_futures_historical_bars_request import GetFuturesHistoricalBarsRequest
 from webull.data.request.get_futures_snapshot_request import GetFuturesSnapshotRequest
 from webull.data.request.get_futures_depth_request import GetFuturesDepthRequest
@@ -86,4 +86,26 @@ class FuturesMarketData:
         tick_request.set_category(category)
         tick_request.set_count(count)
         response = self.client.get_response(tick_request)
+        return response
+
+    def get_futures_footprint(self, symbols, category, timespan, count=None,
+                      real_time_required=None, trading_sessions=None):
+        """
+         Search the futures footprint based on the list of futures codes and futures types.
+
+        :param symbols: Futures Securities symbol, such as: BITH6,BITF26.
+        :param category: Security type, enumeration.
+        :param timespan: Time granularity.
+        :param count: Number of entries: 200 by default, maximum 1200.
+        :param real_time_required: Whether to include the latest data or candlestick charts that are not yet finalized. The default is false, meaning they are not included. This option is only used for minute candlestick charts.
+        :param trading_sessions: RTH: During trading hours, PRE: Before trading hours, ATH: After trading hours. Default: RTH.
+        """
+        footprint_request = GetFuturesFootprintRequest()
+        footprint_request.set_symbols(symbols)
+        footprint_request.set_category(category)
+        footprint_request.set_timespan(timespan)
+        footprint_request.set_count(count)
+        footprint_request.set_real_time_required(real_time_required)
+        footprint_request.set_trading_sessions(trading_sessions)
+        response = self.client.get_response(footprint_request)
         return response

webull/data/quotes/market_data.py

@@ -11,9 +11,11 @@
 # 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.
+from webull.data.common.category import Category
 from webull.data.request.get_batch_historical_bars_request import BatchHistoricalBarsRequest
 from webull.data.request.get_corp_action_request import GetCorpActionRequest
 from webull.data.request.get_eod_bars_request import GetEodBarsRequest
+from webull.data.request.get_footprint_request import GetFootprintRequest
 from webull.data.request.get_historical_bars_request import GetHistoricalBarsRequest
 from webull.data.request.get_quotes_request import GetQuotesRequest
 from webull.data.request.get_snapshot_request import GetSnapshotRequest
@@ -183,3 +185,25 @@ class MarketData:
             eod_corp_action_request.set_last_update_time(last_update_time)
         response = self.client.get_response(eod_corp_action_request)
         return response
+
+    def get_footprint(self, symbols, category, timespan, count=None,
+                      real_time_required=None, trading_sessions=None):
+        """
+         Search the footprint based on the list of security codes and security types.
+
+        :param symbols: Securities symbol, such as: 00700,00981.
+        :param category: Security type, enumeration.
+        :param timespan: Time granularity.
+        :param count: Number of entries: 200 by default, maximum 1200.
+        :param real_time_required: Whether to include the latest data or candlestick charts that are not yet finalized. The default is false, meaning they are not included. This option is only used for minute candlestick charts.
+        :param trading_sessions: RTH: During trading hours, PRE: Before trading hours, ATH: After trading hours. Default: RTH.
+        """
+        footprint_request = GetFootprintRequest()
+        footprint_request.set_symbols(symbols)
+        footprint_request.set_category(category)
+        footprint_request.set_timespan(timespan)
+        footprint_request.set_count(count)
+        footprint_request.set_real_time_required(real_time_required)
+        footprint_request.set_trading_sessions(trading_sessions)
+        response = self.client.get_response(footprint_request)
+        return response

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/data/request/get_footprint_request.py

@@ -0,0 +1,45 @@
+# 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.
+
+# coding=utf-8
+from webull.core.request import ApiRequest
+
+class GetFootprintRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/stock/footprint", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_timespan(self, timespan):
+        if timespan:
+            self.add_query_param("timespan", timespan)
+
+    def set_count(self, count):
+        if count:
+            self.add_query_param("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_query_param("real_time_required", real_time_required)
+
+    def set_trading_sessions(self, trading_sessions):
+        if trading_sessions:
+            self.add_query_param("trading_sessions", trading_sessions)

webull/data/request/get_futures_footprint_request.py

@@ -0,0 +1,45 @@
+# 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.
+
+# coding=utf-8
+from webull.core.request import ApiRequest
+
+class GetFuturesFootprintRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/futures/footprint", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_timespan(self, timespan):
+        if timespan:
+            self.add_query_param("timespan", timespan)
+
+    def set_count(self, count):
+        if count:
+            self.add_query_param("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_query_param("real_time_required", real_time_required)
+
+    def set_trading_sessions(self, trading_sessions):
+        if trading_sessions:
+            self.add_query_param("trading_sessions", trading_sessions)

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.7'
+__version__ = '1.0.9'

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.7.dist-info → webull_openapi_python_sdk-1.0.9.dist-info}/METADATA

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

{webull_openapi_python_sdk-1.0.7.dist-info → webull_openapi_python_sdk-1.0.9.dist-info}/RECORD

@@ -1,10 +1,10 @@
-samples/__init__.py,sha256=Th6FPUfmw3s94879QiaD_OgzmQyEFPOnYrMVoQqee8Y,22
+samples/__init__.py,sha256=mg2kb865UYMe9zOkU2VcRPfv-5zzU182OL3t45SXXWk,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=rH91Yj7oIF6dBOOzF99cUn_12cgDLkw02SNIQM2nB1o,4868
+samples/data/data_client.py,sha256=8FR5ZOY8jWCGfN3XohzyvLdFxYv-TdqfWRKw3E827WY,5248
 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
@@ -13,10 +13,10 @@ samples/order/order_stock_client.py,sha256=hYwVwVFVERk-YS7gRcW-LuGfAvcF8VJHZs1qw
 samples/trade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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=JcgblJMYL4X5P8BP0TQEgP3nqDBQWGor2WzhU96f_h8,15464
+samples/trade/trade_client_v3.py,sha256=70f4VJYWcSJP3ppA8mRAoftJqjRTn5GTeGZck8eLCTg,16526
 samples/trade/trade_event_client.py,sha256=uOx9EwFaves2yaTNm13BHpYC0IHXSoBL8BWPbDLeFw4,2469
-webull/__init__.py,sha256=Th6FPUfmw3s94879QiaD_OgzmQyEFPOnYrMVoQqee8Y,22
-webull/core/__init__.py,sha256=JOXhdxQYuIkQibSKfZ3BBnLJJfch1qMGlPwyIVRRq1k,225
+webull/__init__.py,sha256=mg2kb865UYMe9zOkU2VcRPfv-5zzU182OL3t45SXXWk,22
+webull/core/__init__.py,sha256=MSNIk2XHGC6pQer-Z5tjWyHUXb0Wi1O1Vnn93JEPa5A,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
@@ -186,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=qJOTnMZHsC7a5W3ojnkVnl82XCnV6QdQQDpZO3aEy2Y,38
+webull/data/__init__.py,sha256=16Et8WoO5VLLeKZR62v51Ah41JMXVyb5jk5AlVyFpvU,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
@@ -200,7 +200,7 @@ webull/data/common/expiration_cycle.py,sha256=f1yyOVBnw8jQX16t_QIhyWgfAsaQn8asjd
 webull/data/common/instrument_status.py,sha256=T8lMZxvhwV-19XprrvbajEfGQ9gaWVjf0p0UASrCxSQ,789
 webull/data/common/option_type.py,sha256=E4lzZJS-6iX167l6b3mMhWUbNVD0joPxwqGL_mnOGRI,705
 webull/data/common/subscribe_type.py,sha256=2EpBsPXCDjx5q25GonbUur2upQFfGvT6dcSYQ3BolyY,745
-webull/data/common/timespan.py,sha256=Mg-dnvIWclVZRhIkjDiGzRlnOK457PWZ8sY5I8NXRBA,938
+webull/data/common/timespan.py,sha256=Yjr35Zjhj6qyW1k_pnXkDjm6fWWZ-vs44F_gMWCYCKU,991
 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
@@ -210,21 +210,21 @@ webull/data/internal/quotes_payload_decoder.py,sha256=x2XGYDu4wSdc1LLrcIo3BXeb5j
 webull/data/internal/quotes_topic.py,sha256=kG4RZTjj01U0e54qoOrJHlLrPeBzXekySasm2uoyXVo,1138
 webull/data/quotes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/data/quotes/crypto_market_data.py,sha256=UQlxUz0GntvwcRS-Vh_h7cXbhQ045MqPlG5AhWUoQI4,3063
-webull/data/quotes/futures_market_data.py,sha256=cS_VMbVsqz8JGF1zM3Hc5fQBR-30yoRM30jIw8HBD3A,4131
+webull/data/quotes/futures_market_data.py,sha256=fc9giYNy1LcdLHOJV31zMbPBKtWDH8kBW5xRFgHzQUA,5596
 webull/data/quotes/instrument.py,sha256=4mrL8VEftiPmbEl_7qdpnrgFDuty54tb6C9j_Hh8iME,5089
-webull/data/quotes/market_data.py,sha256=6Md4a30byQiJuglKP0EJW28LCYPCHgJmD1NEAkNocUA,9907
+webull/data/quotes/market_data.py,sha256=5HjzLQje1F7OxasRrjNPZ2d-tkuYJ-aDMZj3fVEO6cI,11329
 webull/data/quotes/market_streaming_data.py,sha256=cI9xxGpKV_KDS8cgh9azHifBji0yeSuKmH7Jxaqij38,3139
 webull/data/quotes/subscribe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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
@@ -234,7 +234,9 @@ webull/data/request/get_crypto_historical_bars_request.py,sha256=FKIp2hB2fPbkMLx
 webull/data/request/get_crypto_instruments_request.py,sha256=GwOA9oPBH4qNg7yR-lVjrRSGZDF5zfRUBS4PegKLcjk,1549
 webull/data/request/get_crypto_snapshot_request.py,sha256=W-z9nuBu2RaXqy07zFVHMQs9GP5Hc55vOWWYKoibWVA,1136
 webull/data/request/get_eod_bars_request.py,sha256=CwbyXeAE-iPKu43zNxcekSw5qOlfEwZsztFxCQvAXuQ,1234
+webull/data/request/get_footprint_request.py,sha256=MnbKhhe7QMkKqyTxmXl-ztDl5l_3kkFhT1vtql82K3Y,1664
 webull/data/request/get_futures_depth_request.py,sha256=d6Tl-75pcJlvX6-beAdko15o8hDhdB-486uxH8AeGIk,1083
+webull/data/request/get_futures_footprint_request.py,sha256=I0l-SlXBKqY61Oxq1zn1EWwLY79euuEoUcrvCzPJlA8,1673
 webull/data/request/get_futures_historical_bars_request.py,sha256=QwvJq33wkJ-_KLZutkh3Z55gQyCDTRkCPwc9UyYcvKU,1330
 webull/data/request/get_futures_instruments_by_code_request.py,sha256=9WjmisgOtzSim-3umKu_2NaATPZBFQxU-3HQ-jBHU1U,1319
 webull/data/request/get_futures_instruments_request.py,sha256=3i1B0v0jhQxx3ETN2Jiu-3aoitUWFN6QfwGNnBfK8eo,1136
@@ -248,7 +250,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=GIukrVnl8Ykjex2rUbxdz2Ov1PRc_MomFmxwSzRJH9w,21
+webull/trade/__init__.py,sha256=mu4LFHUATfA8gJh1jUgMKeIXEjlhbQqTC5UyMGu-2Gs,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
@@ -310,6 +312,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
@@ -326,10 +329,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.7.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
-webull_openapi_python_sdk-1.0.7.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
-webull_openapi_python_sdk-1.0.7.dist-info/METADATA,sha256=oSynjgWvR3nGCvWHQRUO10aUeW6zUHrwEYsZNW3O4a0,702
-webull_openapi_python_sdk-1.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-webull_openapi_python_sdk-1.0.7.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
-webull_openapi_python_sdk-1.0.7.dist-info/RECORD,,
+webull/trade/trade/v3/order_opration_v3.py,sha256=_L10--m_XhoMe8YeYjQXVvRoTAWoRRzLU59UeneyMrU,7428
+webull_openapi_python_sdk-1.0.9.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
+webull_openapi_python_sdk-1.0.9.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
+webull_openapi_python_sdk-1.0.9.dist-info/METADATA,sha256=I4Ohkx7rljnJeBfQ0goKx42vBTbF48Kp4aSWQF3xEcM,702
+webull_openapi_python_sdk-1.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+webull_openapi_python_sdk-1.0.9.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
+webull_openapi_python_sdk-1.0.9.dist-info/RECORD,,