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

webull/data/request/get_financials_balance_sheet_request.py

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

webull/data/request/get_financials_cashflow_request.py

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

webull/data/request/get_financials_income_request.py

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

webull/data/request/get_financials_indicators_request.py

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

webull/data/request/get_footprint_request.py

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

webull/data/request/get_forecast_eps_request.py

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

webull/data/request/get_fund_allocation_request.py

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

webull/data/request/get_fund_brief_request.py

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

webull/data/request/get_fund_dividends_request.py

@@ -18,8 +18,12 @@ from webull.core.request import ApiRequest
 
 
 class GetFundDividendsRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`GetFundDividendsRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/fundamentals/fund/dividends", version='v2', method="GET",
+        ApiRequest.__init__(self, "/openapi/fundamentals/fund/dividends", version='v3', method="GET",
                            query_params={})
 
     def set_symbol(self, symbol):

webull/data/request/get_fund_dividends_request_v2.py

@@ -0,0 +1,35 @@
+# 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 GetFundDividendsRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/fundamentals/fund-dividends/get", version='v3', method="GET",
+                           query_params={})
+
+    def set_symbol(self, symbol):
+        if symbol:
+            self.add_query_param("symbol", symbol)
+
+    def set_category(self, category):
+        if category:
+            self.add_query_param("category", category)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/get_fund_files_request.py

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

webull/data/request/get_fund_holdings_request.py

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

webull/data/request/get_fund_net_value_request.py

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

webull/data/request/get_fund_performance_request.py

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

webull/data/request/get_fund_rating_request.py

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

webull/data/request/get_fund_splits_request.py

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

webull/data/request/get_futures_depth_request.py

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

webull/data/request/get_futures_footprint_request.py

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

webull/data/request/get_futures_historical_bars_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class GetFuturesHistoricalBarsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/futures/bars", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/futures/bars/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbol):
         self.add_query_param("symbols", symbol)

webull/data/request/get_futures_instruments_by_code_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class GetFuturesInstrumentsByCodeRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/futures/by-code", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/instrument/futures/by-code", version='v3', method="GET", query_params={})
 
     def set_codes(self, code):
         self.add_query_param("code", code)

webull/data/request/get_futures_instruments_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetFuturesInstrumentsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/futures/list", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/instruments/futures/contracts/list", version='v3', method="GET",
+                            query_params={})
 
     def set_symbols(self, symbols):
         if isinstance(symbols, str):

webull/data/request/get_futures_product_class.py

@@ -18,7 +18,8 @@ from webull.core.request import ApiRequest
 
 class GetFuturesProductClassRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/futures/product-classes", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/instruments/futures/product-classes/list", version='v3', method="GET",
+                            query_params={})
 
     def set_category(self, category):
         self.add_query_param("category", category)

webull/data/request/get_futures_products_request.py

@@ -19,7 +19,8 @@ from webull.core.request import ApiRequest
 
 class GetFuturesProductsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/futures/products", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/instruments/futures/product-codes/list", version='v3', method="GET",
+                            query_params={})
 
     def set_category(self, category):
         self.add_query_param("category", category)

webull/data/request/get_futures_snapshot_request.py

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

webull/data/request/get_futures_tick_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class GetFuturesTickRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/futures/tick", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/futures/ticks/list", version='v3', method="GET", query_params={})
 
     def set_symbol(self, symbol):
         self.add_query_param("symbol", symbol)

webull/data/request/get_historical_bars_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class GetHistoricalBarsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/stock/bars", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/stocks/bars/get", version='v3', method="GET", query_params={})
 
     def set_symbol(self, symbol):
         self.add_query_param("symbol", symbol)

webull/data/request/get_industry_comparison_request.py

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

webull/data/request/get_instruments_request.py

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

webull/data/request/get_instruments_request_v2.py

@@ -0,0 +1,44 @@
+# 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 GetInstrumentsRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/instruments/stocks/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):
+        self.add_query_param("category", category)
+
+    def set_status(self, status):
+        if status:
+            self.add_query_param("status", status)
+
+    def set_sub_category(self, sub_category):
+        if sub_category:
+            self.add_query_param("sub_category", sub_category)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/get_noii_bars_request.py

@@ -26,7 +26,7 @@ class GetNoiiBarsRequest(ApiRequest):
     """
 
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/stock/noii/bars", version="v2", method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/stocks/noii-bars/list", version="v3", method="GET", query_params={})
 
     def set_symbol(self, symbol):
         """

webull/data/request/get_noii_snapshot_request.py

@@ -30,7 +30,8 @@ class GetNoiiSnapshotRequest(ApiRequest):
     """
 
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/stock/noii/snapshot", version="v2", method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/stocks/noii-snapshots/list", version="v3", method="GET",
+                            query_params={})
 
     def set_symbol(self, symbol):
         """

webull/data/request/get_option_bars_request.py

@@ -25,7 +25,7 @@ class GetOptionBarsRequest(ApiRequest):
     """
 
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/option/bars", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/options/bars/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbols):
         """

webull/data/request/get_option_contracts_request.py

@@ -18,8 +18,12 @@ from webull.core.request import ApiRequest
 
 
 class GetOptionContractsRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`GetOptionContractsRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/instrument/option/contracts", version="v2", method="GET",
+        ApiRequest.__init__(self, "/openapi/instrument/option/contracts", version="v3", method="GET",
                            query_params={})
 
     def set_category(self, category):

webull/data/request/get_option_contracts_request_v2.py

@@ -0,0 +1,78 @@
+# 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 GetOptionContractsRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/instruments/options/contracts/list", version="v3", method="GET",
+                           query_params={})
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_option_symbols(self, option_symbols):
+        if option_symbols:
+            self.add_query_param("option_symbols", option_symbols)
+
+    def set_underlying_symbols(self, underlying_symbols):
+        if underlying_symbols:
+            self.add_query_param("underlying_symbols", underlying_symbols)
+
+    def set_status(self, status):
+        if status:
+            self.add_query_param("status", status)
+
+    def set_start_date(self, start_date):
+        if start_date:
+            self.add_query_param("start_date", start_date)
+
+    def set_end_date(self, end_date):
+        if end_date:
+            self.add_query_param("end_date", end_date)
+
+    def set_root_symbol(self, root_symbol):
+        if root_symbol:
+            self.add_query_param("root_symbol", root_symbol)
+
+    def set_option_type(self, option_type):
+        if option_type:
+            self.add_query_param("option_type", option_type)
+
+    def set_style(self, style):
+        if style:
+            self.add_query_param("style", style)
+
+    def set_strike_price_gte(self, strike_price_gte):
+        if strike_price_gte is not None:
+            self.add_query_param("strike_price_gte", strike_price_gte)
+
+    def set_strike_price_lte(self, strike_price_lte):
+        if strike_price_lte is not None:
+            self.add_query_param("strike_price_lte", strike_price_lte)
+
+    def set_ppind(self, ppind):
+        if ppind is not None:
+            self.add_query_param("ppind", ppind)
+
+    def set_show_deliverables(self, show_deliverables):
+        if show_deliverables is not None:
+            self.add_query_param("show_deliverables", show_deliverables)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/get_option_snapshot_request.py

@@ -25,7 +25,7 @@ class GetOptionSnapshotRequest(ApiRequest):
     """
 
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/option/snapshot", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/options/snapshots/list", version='v3', method="GET", query_params={})
 
     def set_symbols(self, symbols):
         """

webull/data/request/get_option_tick_request.py

@@ -25,7 +25,7 @@ class GetOptionTickRequest(ApiRequest):
     """
 
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/option/tick", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/options/ticks/list", version='v3', method="GET", query_params={})
 
     def set_symbol(self, symbol):
         """

webull/data/request/get_quotes_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class GetQuotesRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/stock/quotes", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/stocks/depths/list", version='v3', method="GET", query_params={})
 
     def set_symbol(self, symbol):
         self.add_query_param("symbol", symbol)

webull/data/request/get_sec_filings_request.py

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

webull/data/request/get_snapshot_request.py

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

webull/data/request/get_tick_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class GetTickRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/market-data/stock/tick", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/market-data/stocks/ticks/list", version='v3', method="GET", query_params={})
 
     def set_symbol(self, symbol):
         self.add_query_param("symbol", symbol)

webull/data/request/screener/get_52whl_request.py

@@ -18,6 +18,10 @@ from webull.core.request import ApiRequest
 
 
 class Get52WHLRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`Get52WHLRequestV2` instead.
+    """
     def __init__(self):
         ApiRequest.__init__(self, "/openapi/market-data/screener/52whl", version='v2', method="GET",
                            query_params={})

webull/data/request/screener/get_52whl_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 Get52WHLRequestV2(ApiRequest):
+    """
+    Request class for 52 Week High/Low Rank API.
+
+    The ranking is not paginated and returns the top 200 results.
+    """
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/screeners/week52-high-low/list", version='v3', method="GET",
+                            query_params={})
+
+    def set_rank_type(self, rank_type):
+        if rank_type:
+            self.add_query_param("rank_type", rank_type)
+
+    def set_category(self, category):
+        if category:
+            self.add_query_param("category", category)
+
+    def set_sort_by(self, sort_by):
+        if sort_by:
+            self.add_query_param("sort_by", sort_by)
+
+    def set_direction(self, direction):
+        if direction:
+            self.add_query_param("direction", direction)