webull-openapi-python-sdk 2.0.18__py3-none-any.whl → 3.0.0__py3-none-any.whl

webull/data/quotes/screener.py

@@ -15,11 +15,17 @@
 # coding=utf-8
 
 from webull.data.request.screener.get_gainers_losers_request import GetGainersLosersRequest
+from webull.data.request.screener.get_gainers_losers_request_v2 import GetGainersLosersRequestV2
 from webull.data.request.screener.get_most_active_request import GetMostActiveRequest
+from webull.data.request.screener.get_most_active_request_v2 import GetMostActiveRequestV2
 from webull.data.request.screener.get_market_sectors_request import GetMarketSectorsRequest
+from webull.data.request.screener.get_market_sectors_request_v2 import GetMarketSectorsRequestV2
 from webull.data.request.screener.get_market_sectors_detail_request import GetMarketSectorsDetailRequest
+from webull.data.request.screener.get_market_sectors_detail_request_v2 import GetMarketSectorsDetailRequestV2
 from webull.data.request.screener.get_high_dividend_request import GetHighDividendRequest
+from webull.data.request.screener.get_high_dividend_request_v2 import GetHighDividendRequestV2
 from webull.data.request.screener.get_52whl_request import Get52WHLRequest
+from webull.data.request.screener.get_52whl_request_v2 import Get52WHLRequestV2
 
 
 class Screener:
@@ -36,6 +42,9 @@ class Screener:
 
     def get_gainers_losers(self, rank_type, category, sort_by, page_index=None, page_size=None, direction=None):
         """
+        .. deprecated::
+            Use :meth:`list_gainers_losers` instead.
+
         Get stock top gainers or losers ranking by price change percentage.
         
         This API returns stocks ranked by price change over different time periods.
@@ -76,8 +85,50 @@ class Screener:
         response = self.client.get_response(request)
         return response
 
+    def list_gainers_losers(self, rank_type, category, sort_by, direction=None):
+        """
+        Get stock top gainers or losers ranking by price change percentage.
+
+        This API returns stocks ranked by price change over different time periods.
+        Use direction='DESC' for gainers (top performers) and direction='ASC' for losers.
+        The ranking is not paginated and returns the top 200 results.
+
+        :param rank_type: Time period for ranking. Required.
+            Enum values:
+            - PRE_MARKET: Pre-market session
+            - AFTER_MARKET: After-market session
+            - MIN_3: 3 minutes
+            - MIN_5: 5 minutes
+            - DAY_1: 1 day
+            - DAY_5: 5 days
+            - MONTH_1: 1 month
+            - MONTH_3: 3 months
+            - WEEK_52: 52 weeks
+        :param category: Security market category. Required. (e.g., 'US_STOCK')
+        :param sort_by: Secondary sort field. Required.
+            Enum values: CHANGE_RATIO, RELATIVE_VOLUME_10D, MARKET_VALUE, CLOSE,
+            PRICE, PE_TTM, HIGH, LOW, AMPLITUDE, TURNOVER, VOLUME
+        :param direction: Sort direction. Optional (defaults to DESC).
+            - ASC: Ascending (for losers)
+            - DESC: Descending (for gainers)
+        :return: Response containing a list of ranked stocks with instrument_id,
+            symbol, name, exchange_code, currency_code, pre_close, open, high, low,
+            close, price, change, change_ratio, volume, turnover_rate, market_value,
+            amplitude, relative_volume_10d, pe_ttm.
+        """
+        request = GetGainersLosersRequestV2()
+        request.set_rank_type(rank_type)
+        request.set_category(category)
+        request.set_sort_by(sort_by)
+        request.set_direction(direction)
+        response = self.client.get_response(request)
+        return response
+
     def get_most_active(self, category, rank_type=None, sort_by=None, page_index=None, page_size=None, direction=None):
         """
+        .. deprecated::
+            Use :meth:`list_most_active` instead.
+
         Get most actively traded stocks ranking.
         
         This API returns stocks ranked by trading activity metrics such as volume,
@@ -119,8 +170,51 @@ class Screener:
         response = self.client.get_response(request)
         return response
 
+    def list_most_active(self, category, rank_type=None, sort_by=None, direction=None):
+        """
+        Get most actively traded stocks ranking.
+
+        This API returns stocks ranked by trading activity metrics such as volume,
+        relative volume, turnover amount, turnover rate, or amplitude.
+        The ranking is not paginated and returns the top 200 results.
+
+        Default sort: rank_type=VOLUME, sort_by=VOLUME, direction=DESC
+
+        The relative_volume_10d field is unique to this endpoint compared to
+        the gainers/losers endpoint.
+
+        :param category: Security market category. Required. (e.g., 'US_STOCK')
+        :param rank_type: Activity metric for ranking. Optional (defaults to VOLUME).
+            Enum values:
+            - VOLUME: Trading volume
+            - RELATIVE_VOLUME_10D: 10-day relative volume
+            - TURNOVER: Turnover amount
+            - TURNOVER_RATE: Turnover rate
+            - AMPLITUDE: Price amplitude
+        :param sort_by: Secondary sort field. Optional.
+            Enum values: CHANGE_RATIO, RELATIVE_VOLUME_10D, MARKET_VALUE, CLOSE,
+            PRICE, PE_TTM, HIGH, LOW, AMPLITUDE, TURNOVER, VOLUME
+        :param direction: Sort direction. Optional (defaults to DESC).
+            - ASC: Ascending order
+            - DESC: Descending order
+        :return: Response containing a list of ranked stocks with instrument_id,
+            symbol, name, exchange_code, currency_code, pre_close, open, high, low,
+            close, price, change, change_ratio, volume, turnover_rate, market_value,
+            amplitude, relative_volume_10d.
+        """
+        request = GetMostActiveRequestV2()
+        request.set_category(category)
+        request.set_rank_type(rank_type)
+        request.set_sort_by(sort_by)
+        request.set_direction(direction)
+        response = self.client.get_response(request)
+        return response
+
     def get_market_sectors(self, category, agg_type=None, period=None, page_index=None, page_size=None, direction=None):
         """
+        .. deprecated::
+            Use :meth:`list_market_sectors` instead.
+
         Get all sector overview data.
 
         :param category: Security category. Required. (e.g., 'US_STOCK')
@@ -140,8 +234,30 @@ class Screener:
         response = self.client.get_response(request)
         return response
 
+    def list_market_sectors(self, category, agg_type=None, period=None, direction=None, pagination_key=None):
+        """
+        Get all sector overview data.
+
+        :param category: Security category. Required. (e.g., 'US_STOCK')
+        :param agg_type: Statistics type, default is MARKET_VALUE. Enum: MARKET_VALUE, VOLUME.
+        :param period: Statistics period, default is D1. Enum: D1, D5, M01, M03.
+        :param direction: Sorting direction. Enum: ASC (ascending), DESC (descending).
+        :param pagination_key: Pagination key from the previous page response; not returned on the last page.
+        """
+        request = GetMarketSectorsRequestV2()
+        request.set_category(category)
+        request.set_agg_type(agg_type)
+        request.set_period(period)
+        request.set_direction(direction)
+        request.set_pagination_key(pagination_key)
+        response = self.client.get_response(request)
+        return response
+
     def get_market_sectors_detail(self, sector_id, category, period=None, page_index=None, page_size=None, sort_by=None, direction=None):
         """
+        .. deprecated::
+            Use :meth:`list_market_sectors_detail` instead.
+
         Get stock list and statistics for a specific sector.
 
         :param sector_id: Sector ID. Required.
@@ -163,8 +279,32 @@ class Screener:
         response = self.client.get_response(request)
         return response
 
+    def list_market_sectors_detail(self, sector_id, category, period=None, sort_by=None, direction=None, pagination_key=None):
+        """
+        Get stock list and statistics for a specific sector.
+
+        :param sector_id: Sector ID. Required.
+        :param category: Security category. Required. (e.g., 'US_STOCK')
+        :param period: Statistics period, default is D1. Enum: D1, D5, M01, M03.
+        :param sort_by: Sort field, default is CHANGE_RATIO. Enum: CHANGE_RATIO, RELATIVE_VOLUME_10D, MARKET_VALUE, CLOSE, PRICE, PE_TTM, HIGH, LOW, AMPLITUDE, TURNOVER, VOLUME, YIELD, DIVIDEND.
+        :param direction: Sorting direction. Enum: ASC (ascending), DESC (descending).
+        :param pagination_key: Pagination key from the previous page response; not returned on the last page.
+        """
+        request = GetMarketSectorsDetailRequestV2()
+        request.set_sector_id(sector_id)
+        request.set_category(category)
+        request.set_period(period)
+        request.set_sort_by(sort_by)
+        request.set_direction(direction)
+        request.set_pagination_key(pagination_key)
+        response = self.client.get_response(request)
+        return response
+
     def get_high_dividend(self, category, sort_by=None, page_index=None, page_size=None, direction=None):
         """
+        .. deprecated::
+            Use :meth:`list_high_dividend` instead.
+
         Get high dividend rank list.
 
         :param category: Security category. Required. (e.g., 'US_STOCK')
@@ -182,8 +322,28 @@ class Screener:
         response = self.client.get_response(request)
         return response
 
+    def list_high_dividend(self, category, sort_by=None, direction=None):
+        """
+        Get high dividend rank list.
+
+        The ranking is not paginated and returns the top 200 results.
+
+        :param category: Security category. Required. (e.g., 'US_STOCK')
+        :param sort_by: Sort field, default is YIELD. Enum: CHANGE_RATIO, RELATIVE_VOLUME_10D, MARKET_VALUE, CLOSE, PRICE, PE_TTM, HIGH, LOW, AMPLITUDE, TURNOVER, VOLUME, YIELD, DIVIDEND.
+        :param direction: Sorting direction, default is DESC. Enum: ASC (ascending), DESC (descending).
+        """
+        request = GetHighDividendRequestV2()
+        request.set_category(category)
+        request.set_sort_by(sort_by)
+        request.set_direction(direction)
+        response = self.client.get_response(request)
+        return response
+
     def get_52whl(self, category, rank_type=None, sort_by=None, page_index=None, page_size=None, direction=None):
         """
+        .. deprecated::
+            Use :meth:`list_52whl` instead.
+
         Get 52 week high/low rank list.
 
         :param category: Security category. Required. (e.g., 'US_STOCK')
@@ -202,3 +362,22 @@ class Screener:
         request.set_direction(direction)
         response = self.client.get_response(request)
         return response
+
+    def list_52whl(self, category, rank_type=None, sort_by=None, direction=None):
+        """
+        Get 52 week high/low rank list.
+
+        The ranking is not paginated and returns the top 200 results.
+
+        :param category: Security category. Required. (e.g., 'US_STOCK')
+        :param rank_type: Index code. Enum: NEW_HIGH, NEAR_HIGH, NEW_LOW, NEAR_LOW.
+        :param sort_by: Sort field, default is CHANGE_RATIO_52W. Enum: CHANGE_RATIO, RELATIVE_VOLUME_10D, MARKET_VALUE, CLOSE, PRICE, PE_TTM, HIGH, LOW, AMPLITUDE, TURNOVER, VOLUME, YIELD, DIVIDEND.
+        :param direction: Sorting direction. Enum: ASC (ascending), DESC (descending).
+        """
+        request = Get52WHLRequestV2()
+        request.set_rank_type(rank_type)
+        request.set_category(category)
+        request.set_sort_by(sort_by)
+        request.set_direction(direction)
+        response = self.client.get_response(request)
+        return response

webull/data/quotes/subscribe/notice_decoder.py

@@ -0,0 +1,34 @@
+# 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
+
+import json
+
+from webull.data.internal.quotes_payload_decoder import BaseQuotesPayloadDecoder
+
+
+class NoticeDecoder(BaseQuotesPayloadDecoder):
+    """Decoder for notice messages from the server.
+
+    Notice messages are JSON-encoded and include:
+    - type '1001': status message with rtt, drop, sent fields
+    - type '1002': permission preemption with content field
+    """
+
+    def __init__(self):
+        super().__init__()
+
+    def parse(self, payload):
+        return json.loads(payload.decode("utf-8"))

webull/data/quotes/subscribe/payload_type.py

@@ -19,4 +19,5 @@ PAYLOAD_TYPE_SHAPSHOT = 'snapshot'
 PAYLOAD_TYPE_TICK = 'tick'
 PAYLOAD_TYPE_EVENT_DEPTH = 'event-quote'
 PAYLOAD_TYPE_EVENT_SHAPSHOT = 'event-snapshot'
-PAYLOAD_TYPE_EVENT_TICK = 'event-tick'
+PAYLOAD_TYPE_EVENT_TICK = 'event-tick'
+PAYLOAD_TYPE_NOTICE = 'notice'

webull/data/request/get_analyst_rating_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetAnalystRatingRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/analyst/rating", version="v2", method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/fundamentals/analysis/ratings/get", version="v3", method="GET",
+                            query_params={})
 
     def set_symbol(self, symbol):
         """

webull/data/request/get_analyst_target_price_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetAnalystTargetPriceRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/analyst/target-price", version="v2", method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/fundamentals/analysis/target-prices/get", version="v3", method="GET",
+                            query_params={})
 
     def set_symbol(self, symbol):
         """

webull/data/request/get_batch_historical_bars_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class BatchHistoricalBarsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/stock/batch-bars", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/market-data/stocks/bars/list", version='v3', method="POST", body_params={})
 
     def set_symbols(self, symbol):
         self.add_body_params("symbols", symbol)

webull/data/request/get_capital_flow_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class GetCapitalFlowRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/fundamentals/stock/capital-flow", version='v2', method="GET",
+        ApiRequest.__init__(self, "/market-data/fundamentals/capital-flows/get", version='v3', method="GET",
                            query_params={})
 
     def set_symbol(self, symbol):

webull/data/request/get_company_profile_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetCompanyProfileRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/company/profile", version="v2", method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/fundamentals/company-profiles/get", version="v3", method="GET",
+                            query_params={})
 
     def set_symbol(self, symbol):
         """

webull/data/request/get_corp_action_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class GetCorpActionRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/instrument/corp-action", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/instrument/corp-action", version='v3', method="GET", query_params={})
 
     def set_instrument_ids(self, instrument_ids):
         if isinstance(instrument_ids, str):

webull/data/request/get_crypto_historical_bars_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class GetCryptoHistoricalBarsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/crypto/bars", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/crypto/bars/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbols):
         if isinstance(symbols, str):

webull/data/request/get_crypto_instruments_request.py

@@ -18,8 +18,12 @@ from webull.core.request import ApiRequest
 
 
 class GetCryptoInstrumentsRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`GetCryptoInstrumentsRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/crypto/list", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/instrument/crypto/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbols):
         if isinstance(symbols, str):

webull/data/request/get_crypto_instruments_request_v2.py

@@ -0,0 +1,41 @@
+# 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 GetCryptoInstrumentsRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/instruments/crypto/profiles/list", version='v3', 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):
+        if category:
+            self.add_query_param("category", category)
+
+    def set_status(self, status):
+        if status:
+            self.add_query_param("status", status)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/get_crypto_snapshot_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class GetCryptoSnapshotRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/crypto/snapshot", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/crypto/snapshots/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbols):
         if isinstance(symbols, str):

webull/data/request/get_dividend_calendar_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class GetDividendCalendarRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/fundamentals/stock/dividend-calendar", version='v2', method="GET",
+        ApiRequest.__init__(self, "/market-data/fundamentals/dividend-calendars/list", version='v3', method="GET",
                            query_params={})
 
     def set_symbol(self, symbol):

webull/data/request/get_earnings_calendar_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class GetEarningsCalendarRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/fundamentals/stock/earnings-calendar", version='v2', method="GET",
+        ApiRequest.__init__(self, "/market-data/fundamentals/earnings-calendars/list", version='v3', method="GET",
                            query_params={})
 
     def set_symbol(self, symbol):

webull/data/request/get_eod_bars_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class GetEodBarsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/market-data/eod-bars", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/eod-bars", version='v3', method="GET", query_params={})
 
     def set_instrument_ids(self, instrument_ids):
         if isinstance(instrument_ids, str):

webull/data/request/get_event_bars_request.py

@@ -19,7 +19,7 @@ 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={})
+        ApiRequest.__init__(self, "/market-data/event-contracts/bars/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbols):
         if isinstance(symbols, str):

webull/data/request/get_event_depth_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetEventDepthRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/event/depth", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/event-contracts/depths/list", version='v3', method="GET",
+                            query_params={})
 
     def set_symbol(self, symbol):
         self.add_query_param("symbol", symbol)

webull/data/request/get_event_events_request.py

@@ -18,7 +18,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={})
+        ApiRequest.__init__(self, "/trading/instruments/event-contracts/events/list", version='v3', method="GET",
+                            query_params={})
 
     def set_series_symbol(self, series_symbol):
         self.add_query_param("series_symbol", series_symbol)

webull/data/request/get_event_instrument_request.py

@@ -17,8 +17,12 @@
 from webull.core.request import ApiRequest
 
 class GetEventInstrumentRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`GetEventInstrumentRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/event/market/list", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/instrument/event/market/list", version='v3', method="GET", query_params={})
 
     def set_series_symbol(self, series_symbol):
         self.add_query_param("series_symbol", series_symbol)

webull/data/request/get_event_instrument_request_v2.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 GetEventInstrumentRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/instruments/event-contracts/markets/list", version='v3', method="GET",
+                            query_params={})
+
+    def set_series_symbol(self, series_symbol):
+        if series_symbol:
+            self.add_query_param("series_symbol", series_symbol)
+
+    def set_event_symbol(self, event_symbol):
+        if 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):
+        if expiration_date_after:
+            self.add_query_param("expiration_date_after", expiration_date_after)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/get_event_series_categories.py

@@ -18,4 +18,5 @@ 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={})
+        ApiRequest.__init__(self, "/trading/instruments/event-contracts/categories/list", version='v3', method="GET",
+                            query_params={})

webull/data/request/get_event_series_request.py

@@ -17,8 +17,12 @@
 from webull.core.request import ApiRequest
 
 class GetEventSeriesRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`GetEventSeriesRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/event/series/list", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/instrument/event/series/list", version='v3', method="GET", query_params={})
 
     def set_category(self, category):
         self.add_query_param("category", category)

webull/data/request/get_event_series_request_v2.py

@@ -0,0 +1,37 @@
+# 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 GetEventSeriesRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/instruments/event-contracts/series/list", version='v3', method="GET",
+                            query_params={})
+
+    def set_category(self, category):
+        if category:
+            self.add_query_param("category", category)
+
+    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_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/get_event_snapshot_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetEventSnapshotRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/event/snapshot", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/event-contracts/snapshots/list", version='v3', method="GET",
+                            query_params={})
 
     def set_symbols(self, symbols):
         if isinstance(symbols, str):

webull/data/request/get_event_tick_request.py

@@ -19,7 +19,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={})
+        ApiRequest.__init__(self, "/market-data/event-contracts/ticks/list", version='v3', method="GET",
+                            query_params={})
 
     def set_symbol(self, symbol):
         self.add_query_param("symbol", symbol)

webull/data/request/get_financials_alert_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class GetFinancialsAlertRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/fundamentals/financial/alert", version='v2', method="GET",
+        ApiRequest.__init__(self, "/market-data/fundamentals/financial-alerts/get", version='v3', method="GET",
                            query_params={})
 
     def set_symbol(self, symbol):