webull-openapi-python-sdk 2.0.0__tar.gz → 2.0.2__tar.gz

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/PKG-INFO

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

webull_openapi_python_sdk-2.0.2/samples/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.2'

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/samples/data/data_client_event.py

@@ -11,6 +11,7 @@
 # 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.timespan import Timespan
 
 # coding=utf-8
 
@@ -35,11 +36,19 @@ api_client.add_endpoint(region_id, optional_api_endpoint)
 if __name__ == '__main__':
     data_client = DataClient(api_client)
 
+    res = data_client.instrument.get_event_categories()
+    if res.status_code == 200:
+        print('get_event_categories:', res.json())
+
     res = data_client.instrument.get_event_series("ECONOMICS")
     if res.status_code == 200:
         print('get_event_series:', res.json())
 
-    res = data_client.instrument.get_event_instrument("KXGDP")
+    res = data_client.instrument.get_event_events("KXRATECUTCOUNT")
+    if res.status_code == 200:
+        print('get_event_events:', res.json())
+
+    res = data_client.instrument.get_event_instrument("KXRATECUTCOUNT")
     if res.status_code == 200:
         print('get_event_instrument:', res.json())
 
@@ -49,4 +58,12 @@ if __name__ == '__main__':
 
     res = data_client.event_market_data.get_event_depth("KXRATECUTCOUNT-25DEC31-T10", Category.US_EVENT.name)
     if res.status_code == 200:
-        print('get_event_depth:', res.json())
+        print('get_event_depth:', res.json())
+
+    res = data_client.event_market_data.get_event_bars("KXRATECUTCOUNT-25DEC31-T10", Timespan.M1, Category.US_EVENT.name, 200, False)
+    if res.status_code == 200:
+        print('get_event_bars:', res.json())
+
+    res = data_client.event_market_data.get_event_tick("KXRATECUTCOUNT-25DEC31-T10", Category.US_EVENT.name, 30)
+    if res.status_code == 200:
+        print('get_event_tick:', res.json())

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/samples/data/data_streaming_client_event.py

@@ -43,7 +43,7 @@ if __name__ == '__main__':
         print("connect success with session_id:%s" % quotes_session_id)
         # subscribe
         symbols = ['KXNHLGAME-26JAN21ANACOL-ANA', 'KXNBAGAME-26JAN20LACCHI-LAC']
-        sub_types = [SubscribeType.QUOTE.name, SubscribeType.SNAPSHOT.name]
+        sub_types = [SubscribeType.QUOTE.name, SubscribeType.SNAPSHOT.name, SubscribeType.TICK.name]
         client.subscribe(symbols, Category.US_EVENT.name, sub_types)
 
     def my_quotes_message_func(client, topic, quotes):

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/samples/trade/trade_client_v3.py

@@ -247,6 +247,7 @@ if __name__ == '__main__':
     # ============================================================
 
     # normal option order
+    # position_intent: Currently, only the US market is supported, and only options orders are allowed.
     normal_option_client_order_id = uuid.uuid4().hex
     new_normal_option_orders = [
         {
@@ -259,6 +260,7 @@ if __name__ == '__main__':
             "side": "BUY",
             "time_in_force": "GTC",
             "entrust_type": "QTY",
+            "position_intent": "BUY_TO_OPEN",
             "legs": [
                 {
                     "side": "BUY",

webull_openapi_python_sdk-2.0.2/webull/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.2'

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '2.0.0'
+__version__ = '2.0.2'
 
 import logging
 

webull_openapi_python_sdk-2.0.2/webull/data/__init__.py

@@ -0,0 +1,3 @@
+# coding=utf-8
+
+__version__ = '2.0.2'

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/data/data_streaming_client.py

@@ -18,8 +18,9 @@ from webull.data.internal.quotes_client import QuotesClient, LOG_ERR
 from webull.data.quotes.market_streaming_data import MarketDataStreaming
 from webull.data.quotes.subscribe.event_depth_decoder import EventDepthDecoder
 from webull.data.quotes.subscribe.event_snapshot_decoder import EventSnapshotDecoder
+from webull.data.quotes.subscribe.event_tick_decoder import EventTickDecoder
 from webull.data.quotes.subscribe.payload_type import PAYLOAD_TYPE_QUOTE, PAYLOAD_TYPE_SHAPSHOT, PAYLOAD_TYPE_TICK, \
-    PAYLOAD_TYPE_EVENT_SHAPSHOT, PAYLOAD_TYPE_EVENT_DEPTH
+    PAYLOAD_TYPE_EVENT_SHAPSHOT, PAYLOAD_TYPE_EVENT_DEPTH, PAYLOAD_TYPE_EVENT_TICK
 from webull.data.quotes.subscribe.quote_decoder import QuoteDecoder
 from webull.data.quotes.subscribe.snapshot_decoder import SnapshotDecoder
 from webull.data.quotes.subscribe.tick_decoder import TickDecoder
@@ -44,6 +45,7 @@ class DataStreamingClient(QuotesClient):
         self.register_payload_decoder(PAYLOAD_TYPE_TICK, TickDecoder())
         self.register_payload_decoder(PAYLOAD_TYPE_EVENT_DEPTH, EventDepthDecoder())
         self.register_payload_decoder(PAYLOAD_TYPE_EVENT_SHAPSHOT, EventSnapshotDecoder())
+        self.register_payload_decoder(PAYLOAD_TYPE_EVENT_TICK, EventTickDecoder())
 
     @property
     def on_connect_success(self):

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/data/quotes/event_market_data.py

@@ -12,8 +12,11 @@
 # 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_event_bars_request import GetEventBarsRequest
 from webull.data.request.get_event_depth_request import GetEventDepthRequest
 from webull.data.request.get_event_snapshot_request import GetEventSnapshotRequest
+from webull.data.request.get_event_tick_request import GetEventTickRequest
+
 
 class EventMarketData:
     def __init__(self, api_client):
@@ -47,4 +50,43 @@ class EventMarketData:
         quote_request.set_category(category)
         quote_request.set_depth(depth)
         response = self.client.get_response(quote_request)
+        return response
+
+    def get_event_bars(self, symbols, timespan, category=Category.US_EVENT.name, count=200, real_time_required=False):
+        """
+        Get the current order book for a specific event instrument.
+        The order book shows all active bid orders for both yes and no sides of a binary market.
+        It returns yes bids and no bids only (no asks are returned). Price unit is based on usd_cent.
+
+        :param symbols: Symbol of the event market, supports JSON array format, multiple symbols separated by commas; maximum 100 symbols per query.
+        :param timespan:K-line time granularity.
+        :param category: default is US_EVENT, currently only US_EVENT is supported.
+        :param count: Number of entries, default 200 entries, maximum 1200 entries.
+        :param real_time_required: Does it include the latest data? The k-line that has not been finalized is not included by default. It is false and only used for minutes.
+        """
+        quote_request = GetEventBarsRequest()
+        quote_request.set_symbols(symbols)
+        quote_request.set_category(category)
+        quote_request.set_timespan(timespan)
+        quote_request.set_count(count)
+        quote_request.set_real_time_required(real_time_required)
+        response = self.client.get_response(quote_request)
+        return response
+
+
+    def get_event_tick(self, symbol, category=Category.US_EVENT.name, count=30):
+        """
+        Detailed transaction records, including transaction time, price, quantity,
+        and transaction direction. Data is sorted in reverse chronological order,
+        with the most recent transaction record first.
+
+        :param symbol:Symbol of the event market.
+        :param category: default is US_EVENT, currently only US_EVENT is supported.
+        :param count: Number of entries, default 30 entries, maximum 1200 entries.
+        """
+        quote_request = GetEventTickRequest()
+        quote_request.set_symbol(symbol)
+        quote_request.set_category(category)
+        quote_request.set_count(count)
+        response = self.client.get_response(quote_request)
         return response

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/data/quotes/instrument.py

@@ -12,7 +12,9 @@
 # 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_event_events_request import GetEventEventsRequest
 from webull.data.request.get_event_instrument_request import GetEventInstrumentRequest
+from webull.data.request.get_event_series_categories import GetEventCategoriesRequest
 from webull.data.request.get_event_series_request import GetEventSeriesRequest
 from webull.data.request.get_instruments_request import GetInstrumentsRequest
 from webull.data.request.get_crypto_instruments_request import GetCryptoInstrumentsRequest
@@ -111,7 +113,15 @@ class Instrument:
         response = self.client.get_response(futures_instrument_request)
         return response
 
-    def get_event_series(self, category, last_instrument_id=None, page_size=500):
+    def get_event_categories(self):
+        """
+        Query event contract categories
+        """
+        event_categories_request = GetEventCategoriesRequest()
+        response = self.client.get_response(event_categories_request)
+        return response
+
+    def get_event_series(self, category=None, symbols=None, last_series_id=None, page_size=500):
         """
         Retrieve multiple series with specified filters.
         A series represents a template for recurring events that follow the same format and rules (e.g., “Monthly Jobs Report” ).
@@ -120,30 +130,57 @@ class Instrument:
         :param category: The category which this series belongs to.Allowed values:
                         ECONOMICS, FINANCIALS, POLITICS, ENTERTAINMENT, SCIENCE_TECHNOLOGY,
                         CLIMATE_WEATHER, TRANSPORTATION, CRYPTO, SPORTS
-        :param last_instrument_id: Last series id for pagination.
+        :param symbols: Symbol of the event series, supports JSON array format, multiple symbols separated by commas; maximum 100 symbols per query.
+        :param last_series_id: Last series id for pagination.
         :param page_size: Page size, default 500.
         """
 
         event_series_request = GetEventSeriesRequest()
-        event_series_request.set_category(category)
-        if last_instrument_id:
-            event_series_request.set_last_instrument_id(last_instrument_id)
+        if category:
+            event_series_request.set_category(category)
+        if symbols:
+            event_series_request.set_symbols(symbols)
+        if last_series_id:
+            event_series_request.set_last_series_id(last_series_id)
         event_series_request.set_page_size(page_size)
         response = self.client.get_response(event_series_request)
         return response
 
-    def get_event_instrument(self, series_symbol, expiration_date_after=None, last_instrument_id=None, page_size=500):
+    def get_event_events(self, series_symbol, symbols=None, status=None):
+        """
+        Query event contract events
+
+        :param series_symbol: Series Symbol that identifies this series.
+        :param symbols: Symbol of the event events, supports JSON array format, multiple symbols separated by commas; maximum 100 symbols per query.
+        :param status: Event status (optional, defaults to querying tradable/valid events).
+        """
+        event_events_request = GetEventEventsRequest()
+        event_events_request.set_series_symbol(series_symbol)
+        if symbols:
+            event_events_request.set_symbols(symbols)
+        if status:
+            event_events_request.set_status(status)
+        response = self.client.get_response(event_events_request)
+        return response
+
+    def get_event_instrument(self, series_symbol, event_symbol=None, symbols=None, expiration_date_after=None, last_instrument_id=None, page_size=500):
         """
         Retrieve profile information for event contract markets based on the series symbol.
 
         :param series_symbol: Symbol that identifies this series.
+        :param event_symbol: Symbol of the event events.
+        :param symbols: Symbol of the event market, supports JSON array format, multiple symbols separated by commas; maximum 100 symbols per query.
         :param expiration_date_after: Used to filter items whose expiration date is later than a specified date; the default selection is the current day (inclusive).
-        :param last_instrument_id: Last series id for pagination.
+        :param last_instrument_id: Last instrument id for pagination.
         :param page_size: Page size, default 500.
         """
 
         event_instrument_request = GetEventInstrumentRequest()
         event_instrument_request.set_series_symbol(series_symbol)
+        if event_symbol:
+            event_instrument_request.set_event_symbol(event_symbol)
+        if symbols:
+            event_instrument_request.set_symbols(symbols)
         if expiration_date_after:
             event_instrument_request.set_expiration_date_after(expiration_date_after)
         if last_instrument_id:

webull_openapi_python_sdk-2.0.2/webull/data/quotes/subscribe/event_tick_decoder.py

@@ -0,0 +1,30 @@
+# 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.data.quotes.subscribe.message_pb2 import EventTick
+from webull.data.quotes.subscribe.event_tick_result import EventTickResult
+
+from webull.data.internal.quotes_payload_decoder import BaseQuotesPayloadDecoder
+
+
+
+class EventTickDecoder(BaseQuotesPayloadDecoder):
+    def __init__(self):
+        super().__init__()
+
+    def parse(self, payload):
+        eventTick = EventTick()
+        eventTick.ParseFromString(payload)
+        return EventTickResult(eventTick)

webull_openapi_python_sdk-2.0.2/webull/data/quotes/subscribe/event_tick_result.py

@@ -0,0 +1,56 @@
+# 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 decimal import Decimal
+from webull.data.quotes.subscribe.basic_result import BasicResult
+
+
+class EventTickResult:
+    def __init__(self, pb_event_tick):
+        self.basic = BasicResult(pb_event_tick.basic)
+        self.time = pb_event_tick.time
+        self.yes_price = Decimal(pb_event_tick.yes_price) if pb_event_tick.yes_price else None
+        self.no_price = Decimal(pb_event_tick.no_price) if pb_event_tick.no_price else None
+        self.volume = pb_event_tick.volume
+        self.side = pb_event_tick.side
+        self.trade_id = pb_event_tick.trade_id
+
+    def get_basic(self):
+        return self.basic
+
+    def get_time(self):
+        return self.time
+
+    def get_yes_price(self):
+        return self.yes_price
+
+    def get_no_price(self):
+        return self.no_price
+
+    def get_volume(self):
+        return self.volume
+
+    def get_side(self):
+        return self.side
+
+    def get_trade_id(self):
+        return self.trade_id
+
+    def __repr__(self):
+        return "basic: %s,time: %s,yes_price: %s,no_price:%s,volume:%s,side:%s,trade_id:%s" % (self.basic, self.time, self.yes_price, self.no_price, self.volume, self.side, self.trade_id)
+
+    def __str__(self):
+        return self.__repr__()

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/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\"\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(\t\"\x8d\x02\n\rEventSnapshot\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\r\n\x05price\x18\x02 \x01(\t\x12\x0e\n\x06volume\x18\x03 \x01(\t\x12\x17\n\x0flast_trade_time\x18\x04 \x01(\t\x12\x15\n\ropen_interest\x18\x05 \x01(\t\x12\x0f\n\x07yes_ask\x18\x06 \x01(\t\x12\x0f\n\x07yes_bid\x18\x07 \x01(\t\x12\x14\n\x0cyes_ask_size\x18\x08 \x01(\t\x12\x14\n\x0cyes_bid_size\x18\t \x01(\t\x12\x0e\n\x06no_ask\x18\n \x01(\t\x12\x0e\n\x06no_bid\x18\x0b \x01(\t\x12\x13\n\x0bno_ask_size\x18\x0c \x01(\t\x12\x13\n\x0bno_bid_size\x18\r \x01(\t\"b\n\nEventQuote\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x1e\n\x08yes_bids\x18\x02 \x03(\x0b\x32\x0c.EventAskBid\x12\x1d\n\x07no_bids\x18\x03 \x03(\x0b\x32\x0c.EventAskBid\"*\n\x0b\x45ventAskBid\x12\r\n\x05price\x18\x01 \x01(\t\x12\x0c\n\x04size\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(\t\"\x8d\x02\n\rEventSnapshot\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\r\n\x05price\x18\x02 \x01(\t\x12\x0e\n\x06volume\x18\x03 \x01(\t\x12\x17\n\x0flast_trade_time\x18\x04 \x01(\t\x12\x15\n\ropen_interest\x18\x05 \x01(\t\x12\x0f\n\x07yes_ask\x18\x06 \x01(\t\x12\x0f\n\x07yes_bid\x18\x07 \x01(\t\x12\x14\n\x0cyes_ask_size\x18\x08 \x01(\t\x12\x14\n\x0cyes_bid_size\x18\t \x01(\t\x12\x0e\n\x06no_ask\x18\n \x01(\t\x12\x0e\n\x06no_bid\x18\x0b \x01(\t\x12\x13\n\x0bno_ask_size\x18\x0c \x01(\t\x12\x13\n\x0bno_bid_size\x18\r \x01(\t\"b\n\nEventQuote\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x1e\n\x08yes_bids\x18\x02 \x03(\x0b\x32\x0c.EventAskBid\x12\x1d\n\x07no_bids\x18\x03 \x03(\x0b\x32\x0c.EventAskBid\"*\n\x0b\x45ventAskBid\x12\r\n\x05price\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\"\x85\x01\n\tEventTick\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x11\n\tyes_price\x18\x02 \x01(\t\x12\x10\n\x08no_price\x18\x03 \x01(\t\x12\x0e\n\x06volume\x18\x04 \x01(\t\x12\x0c\n\x04side\x18\x05 \x01(\t\x12\x10\n\x08trade_id\x18\x06 \x01(\t\x12\x0c\n\x04time\x18\x07 \x01(\tb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -40,4 +40,6 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _globals['_EVENTQUOTE']._serialized_end=1281
   _globals['_EVENTASKBID']._serialized_start=1283
   _globals['_EVENTASKBID']._serialized_end=1325
+  _globals['_EVENTTICK']._serialized_start=1328
+  _globals['_EVENTTICK']._serialized_end=1461
 # @@protoc_insertion_point(module_scope)

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/data/quotes/subscribe/payload_type.py

@@ -18,4 +18,5 @@ PAYLOAD_TYPE_QUOTE = 'quote'
 PAYLOAD_TYPE_SHAPSHOT = 'snapshot'
 PAYLOAD_TYPE_TICK = 'tick'
 PAYLOAD_TYPE_EVENT_DEPTH = 'event-quote'
-PAYLOAD_TYPE_EVENT_SHAPSHOT = 'event-snapshot'
+PAYLOAD_TYPE_EVENT_SHAPSHOT = 'event-snapshot'
+PAYLOAD_TYPE_EVENT_TICK = 'event-tick'

webull_openapi_python_sdk-2.0.2/webull/data/request/get_event_bars_request.py

@@ -0,0 +1,43 @@
+# 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 GetEventBarsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/event/bars", 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)

webull_openapi_python_sdk-2.0.2/webull/data/request/get_event_events_request.py

@@ -0,0 +1,33 @@
+# 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 GetEventEventsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/event/events", version='v2', method="GET", query_params={})
+
+    def set_series_symbol(self, series_symbol):
+        self.add_query_param("series_symbol", series_symbol)
+
+    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_status(self, status):
+        self.add_query_param("status", status)

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/data/request/get_event_instrument_request.py

@@ -23,6 +23,15 @@ class GetEventInstrumentRequest(ApiRequest):
     def set_series_symbol(self, series_symbol):
         self.add_query_param("series_symbol", series_symbol)
 
+    def set_event_symbol(self, event_symbol):
+        self.add_query_param("event_symbol", event_symbol)
+
+    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_expiration_date_after(self, expiration_date_after):
         self.add_query_param("expiration_date_after", expiration_date_after)
 

webull_openapi_python_sdk-2.0.2/webull/data/request/get_event_series_categories.py

@@ -0,0 +1,21 @@
+# 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 GetEventCategoriesRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/event/categories", version='v2', method="GET", query_params={})

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/data/request/get_event_series_request.py

@@ -23,8 +23,14 @@ class GetEventSeriesRequest(ApiRequest):
     def set_category(self, category):
         self.add_query_param("category", category)
 
-    def set_last_instrument_id(self, last_instrument_id):
-        self.add_query_param("last_instrument_id", last_instrument_id)
+    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_last_series_id(self, last_series_id):
+            self.add_query_param("last_series_id", last_series_id)
 
     def set_page_size(self, page_size):
         self.add_query_param("page_size", page_size)

webull_openapi_python_sdk-2.0.2/webull/data/request/get_event_tick_request.py

@@ -0,0 +1,32 @@
+# 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 GetEventTickRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/event/tick", version='v2', method="GET", query_params={})
+
+    def set_symbol(self, symbol):
+        self.add_query_param("symbol", symbol)
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_count(self, count):
+        if count:
+            self.add_query_param("count", count)

webull_openapi_python_sdk-2.0.2/webull/trade/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.2'

webull_openapi_python_sdk-2.0.2/webull/trade/common/position_intent.py

@@ -0,0 +1,24 @@
+# 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.common.easy_enum import EasyEnum
+
+
+class OrderStatus(EasyEnum):
+    BUY_TO_OPEN = (1, "BUY_TO_OPEN")
+    BUY_TO_CLOSE = (2, "BUY_TO_CLOSE")
+    SELL_TO_OPEN = (3, "SELL_TO_OPEN")
+    SELL_TO_CLOSE = (4, "SELL_TO_CLOSE")

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull/trade/trade_events_client.py

@@ -68,8 +68,12 @@ class TradeEventsClient():
         self._on_log = None
 
     def _build_request(self, app_key, app_secret, accounts):
+        if self._region_id == 'us':
+            subscribeType = 3
+        else:
+            subscribeType = 1
         request = pb.SubscribeRequest(
-            subscribeType= 3,  # only 1、2 allowed now
+            subscribeType= subscribeType, # 1、2、3 allowed now
             timestamp=int(time.time() * 1000),  # millis
             accounts=accounts,
         )

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull_openapi_python_sdk.egg-info/PKG-INFO

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

{webull_openapi_python_sdk-2.0.0 → webull_openapi_python_sdk-2.0.2}/webull_openapi_python_sdk.egg-info/SOURCES.txt

@@ -128,6 +128,8 @@ webull/data/quotes/subscribe/event_depth_decoder.py
 webull/data/quotes/subscribe/event_depth_result.py
 webull/data/quotes/subscribe/event_snapshot_decoder.py
 webull/data/quotes/subscribe/event_snapshot_result.py
+webull/data/quotes/subscribe/event_tick_decoder.py
+webull/data/quotes/subscribe/event_tick_result.py
 webull/data/quotes/subscribe/message_pb2.py
 webull/data/quotes/subscribe/order_result.py
 webull/data/quotes/subscribe/payload_type.py
@@ -144,10 +146,14 @@ webull/data/request/get_crypto_historical_bars_request.py
 webull/data/request/get_crypto_instruments_request.py
 webull/data/request/get_crypto_snapshot_request.py
 webull/data/request/get_eod_bars_request.py
+webull/data/request/get_event_bars_request.py
 webull/data/request/get_event_depth_request.py
+webull/data/request/get_event_events_request.py
 webull/data/request/get_event_instrument_request.py
+webull/data/request/get_event_series_categories.py
 webull/data/request/get_event_series_request.py
 webull/data/request/get_event_snapshot_request.py
+webull/data/request/get_event_tick_request.py
 webull/data/request/get_footprint_request.py
 webull/data/request/get_futures_depth_request.py
 webull/data/request/get_futures_footprint_request.py
@@ -181,6 +187,7 @@ webull/trade/common/order_side.py
 webull/trade/common/order_status.py
 webull/trade/common/order_tif.py
 webull/trade/common/order_type.py
+webull/trade/common/position_intent.py
 webull/trade/common/trade_policy.py
 webull/trade/common/trading_date_type.py
 webull/trade/common/trailing_type.py

webull_openapi_python_sdk-2.0.0/samples/__init__.py

@@ -1 +0,0 @@
-__version__ = '2.0.0'

webull_openapi_python_sdk-2.0.0/webull/__init__.py

@@ -1 +0,0 @@
-__version__ = '2.0.0'