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

webull/trade/request/get_trade_instrument_detail_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class TradeInstrumentDetailRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/instrument", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trade/instrument", version='v3', method="GET", query_params={})
 
     def set_instrument_id(self, instrument_id):
         self.add_query_param("instrument_id", instrument_id)

webull/trade/request/get_trade_security_detail_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class TradeSecurityDetailRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/security", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trade/security", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/get_tradeable_instruments_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class TradeableInstrumentRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/instrument/tradable/list", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trade/instrument/tradable/list", version='v3', method="GET", query_params={})
 
     def set_last_instrument_id(self, last_security_id):
         self.add_query_param("last_security_id", last_security_id)

webull/trade/request/palce_order_request.py

@@ -22,7 +22,7 @@ class PlaceOrderRequest(ApiRequest):
     Deprecated. Use :class:`PlaceOrderRequestV2` instead.
     """
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/order/place", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trade/order/place", version='v3', method="POST", body_params={})
         self._stock_order = {}
         self.add_body_params("stock_order", self._stock_order)
 

webull/trade/request/place_order_request.py

@@ -24,7 +24,7 @@ class PlaceOrderRequest(ApiRequest):
     Deprecated. Use :class:`PlaceOrderRequestV2` instead.
     """
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/order/place", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trade/order/place", version='v3', method="POST", body_params={})
         self._stock_order = {}
         self.add_body_params("stock_order", self._stock_order)
 

webull/trade/request/place_order_request_v2.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class PlaceOrderRequestV2(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/order/place", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trade/order/place", version='v3', method="POST", body_params={})
         self._stock_order = {}
         self.add_body_params("stock_order", self._stock_order)
 

webull/trade/request/replace_order_request.py

@@ -21,7 +21,7 @@ class ReplaceOrderRequest(ApiRequest):
     Deprecated. Use :class:`ReplaceOrderRequestV2` instead.
     """
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/order/replace", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trade/order/replace", version='v3', method="POST", body_params={})
         self._stock_order = {}
         self.add_body_params("stock_order", self._stock_order)
 

webull/trade/request/replace_order_request_v2.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class ReplaceOrderRequestV2(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/trade/order/replace", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trade/order/replace", version='v3', method="POST", body_params={})
         self._stock_order = {}
         self.add_body_params("stock_order", self._stock_order)
 

webull/trade/request/v2/cancel_option_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class CancelOptionRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/option/order/cancel", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/option/order/cancel", version='v3', method="POST", body_params={})
 
     def set_client_order_id(self, client_order_id):
         self.add_body_params("client_order_id", client_order_id)

webull/trade/request/v2/cancel_order_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class CancelOrderRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/stock/order/cancel", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/openapi/trade/stock/order/cancel", version='v3', method="POST", body_params={})
 
     def set_account_id(self, account_id):
         self.add_body_params("account_id", account_id)

webull/trade/request/v2/get_account_balance_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class AccountBalanceRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/assets/balance", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/assets/balances/get", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v2/get_account_list.py

@@ -21,6 +21,4 @@ class GetAccountList(ApiRequest):
     Deprecated. Use :func:`get_account_list_request` instead.
     """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/account/list", version='v2', method="GET", query_params={})
-
-        
+        ApiRequest.__init__(self, "/openapi/account/list", version='v3', method="GET", query_params={})

webull/trade/request/v2/get_account_list_request.py

@@ -18,6 +18,4 @@ from webull.core.request import ApiRequest
 
 class GetAccountListRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/account/list", version='v2', method="GET", query_params={})
-
-        
+        ApiRequest.__init__(self, "/trading/accounts/list", version='v3', method="GET", query_params={})

webull/trade/request/v2/get_account_position_details_request.py

@@ -17,6 +17,10 @@ from webull.core.request import ApiRequest
 
 
 class AccountPositionDetailsRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`AccountPositionDetailsRequestV2` instead.
+    """
     def __init__(self):
         ApiRequest.__init__(self, "/openapi/assets/position/details", version='v2', method="GET", query_params={})
 

webull/trade/request/v2/get_account_position_details_request_v2.py

@@ -0,0 +1,31 @@
+# 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 AccountPositionDetailsRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/assets/positions/get", version='v3', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_instrument_id(self, instrument_id):
+        self.add_query_param("instrument_id", instrument_id)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/trade/request/v2/get_account_positions_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class AccountPositionsRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/assets/positions", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/assets/positions/list", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v2/get_order_detail_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class OrderDetailRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/detail", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/trade/order/detail", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v2/get_order_executions_request.py

@@ -16,6 +16,11 @@ from webull.core.request import ApiRequest
 
 
 class GetOrderExecutionsRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`GetOrderExecutionsRequestV2` instead.
+    """
+
     def __init__(self):
         ApiRequest.__init__(self, "/trading/orders/executions/list", version='v2', method="GET", query_params={})
 

webull/trade/request/v2/get_order_executions_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.
+
+from webull.core.request import ApiRequest
+
+
+class GetOrderExecutionsRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/orders/executions/list", version='v3', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_client_order_id(self, client_order_id):
+        self.add_query_param("client_order_id", client_order_id)
+
+    def set_start_date(self, start_date):
+        self.add_query_param("start_date", start_date)
+
+    def set_end_date(self, end_date):
+        self.add_query_param("end_date", end_date)
+
+    def set_pagination_key(self, pagination_key):
+        self.add_query_param("pagination_key", pagination_key)

webull/trade/request/v2/get_order_history_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class OrderHistoryRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/history", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/trade/order/history", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v2/get_order_open_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class OrderOpenRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/open", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/openapi/trade/order/open", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v2/palce_order_request.py

@@ -21,7 +21,7 @@ class PlaceOrderRequest(ApiRequest):
     Deprecated. Use :func:`place_order_request` instead.
     """
     def __init__(self):
-        super().__init__("/openapi/trade/stock/order/place", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/stock/order/place", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v2/place_option_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class PlaceOptionRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/option/order/place", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/option/order/place", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v2/place_order_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class PlaceOrderRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/stock/order/place", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/stock/order/place", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v2/preview_option_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class PreviewOptionRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/option/order/preview", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/option/order/preview", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v2/preview_order_request.py

@@ -16,7 +16,7 @@ from webull.core.request import ApiRequest
 
 class PreviewOrderRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/stock/order/preview", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/stock/order/preview", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v2/replace_option_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class ReplaceOptionRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/option/order/replace", version='v2', method="POST", body_params={})
+        super().__init__("/openapi/trade/option/order/replace", version='v3', method="POST", body_params={})
 
     def set_modify_orders(self, modify_orders):
         self.add_body_params("modify_orders", modify_orders)

webull/trade/request/v2/replace_order_request.py

@@ -16,7 +16,7 @@ from webull.core.request import ApiRequest
 
 class ReplaceOrderRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/stock/order/replace", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/openapi/trade/stock/order/replace", version='v3', method="POST", body_params={})
 
     def set_modify_orders(self, modify_orders):
         self.add_body_params("modify_orders", modify_orders)

webull/trade/request/v3/batch_place_order_request.py

@@ -19,7 +19,7 @@ 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={})
+        super().__init__("/trading/orders/batch-place", version='v3', method="POST", body_params={})
 
     def set_account_id(self, account_id):
         self.add_body_params("account_id", account_id)

webull/trade/request/v3/cancel_order_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class CancelOrderRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/cancel", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trading/orders/cancel", version='v3', method="POST", body_params={})
 
     def set_account_id(self, account_id):
         self.add_body_params("account_id", account_id)

webull/trade/request/v3/get_order_detail_request.py

@@ -17,7 +17,7 @@ from webull.core.request import ApiRequest
 
 class OrderDetailRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/detail", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/orders/get", version='v3', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v3/get_order_history_request.py

@@ -16,8 +16,12 @@ from webull.core.request import ApiRequest
 
 
 class OrderHistoryRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`OrderHistoryRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/history", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/orders/historical-orders/list", version='v2', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v3/get_order_history_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.
+
+from webull.core.request import ApiRequest
+
+
+class OrderHistoryRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/orders/historical-orders/list", version='v3', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_start_time(self, start_time):
+        if start_time is not None:
+            self.add_query_param("start_time", start_time)
+
+    def set_end_time(self, end_time):
+        if end_time is not None:
+            self.add_query_param("end_time", end_time)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/trade/request/v3/get_order_open_request.py

@@ -16,8 +16,12 @@ from webull.core.request import ApiRequest
 
 
 class OrderOpenRequest(ApiRequest):
+    """
+    .. deprecated::
+        Use :class:`OrderOpenRequestV2` instead.
+    """
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/open", version='v2', method="GET", query_params={})
+        ApiRequest.__init__(self, "/trading/orders/open-orders/list", version='v2', method="GET", query_params={})
 
     def set_account_id(self, account_id):
         self.add_query_param("account_id", account_id)

webull/trade/request/v3/get_order_open_request_v2.py

@@ -0,0 +1,27 @@
+# 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.
+
+from webull.core.request import ApiRequest
+
+
+class OrderOpenRequestV2(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/orders/open-orders/list", version='v3', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_pagination_key(self, pagination_key):
+        if pagination_key:
+            self.add_query_param("pagination_key", pagination_key)

webull/trade/request/v3/place_order_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class PlaceOrderRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/order/place", version='v2', method="POST", body_params={})
+        super().__init__("/trading/orders/place", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v3/preview_order_request.py

@@ -19,7 +19,7 @@ from webull.core.request import ApiRequest
 
 class PreviewOrderRequest(ApiRequest):
     def __init__(self):
-        super().__init__("/openapi/trade/order/preview", version='v2', method="POST", body_params={})
+        super().__init__("/trading/orders/preview", version='v3', method="POST", body_params={})
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)

webull/trade/request/v3/replace_order_request.py

@@ -18,7 +18,7 @@ from webull.core.request import ApiRequest
 
 class ReplaceOrderRequest(ApiRequest):
     def __init__(self):
-        ApiRequest.__init__(self, "/openapi/trade/order/replace", version='v2', method="POST", body_params={})
+        ApiRequest.__init__(self, "/trading/orders/replace", version='v3', method="POST", body_params={})
 
     def set_modify_orders(self, modify_orders):
         self.add_body_params("modify_orders", modify_orders)

webull/trade/trade/activity.py

@@ -15,6 +15,7 @@
 # coding=utf-8
 
 from webull.trade.request.get_activities_request import GetActivitiesRequest
+from webull.trade.request.get_activities_request_v2 import GetActivitiesRequestV2
 
 
 class Activity:
@@ -24,6 +25,11 @@ class Activity:
     def get_activities(self, account_id, activity_types=None, start_time=None, end_time=None,
                        last_activity_id=None, page_size=10):
         """
+        .. deprecated::
+            Use :meth:`list_activities` instead.
+
+        The x-version header distinguishes the legacy and new pagination protocols for this path.
+
         Query cash activities by type with pagination support.
         This interface is currently supported only for Webull US.
 
@@ -47,3 +53,30 @@ class Activity:
         get_activities_request.set_page_size(page_size)
         response = self.client.get_response(get_activities_request)
         return response
+
+    def list_activities(self, account_id, activity_types=None, start_time=None, end_time=None,
+                        pagination_key=None):
+        """
+        The x-version header distinguishes the legacy and new pagination protocols for this path.
+
+        Query cash activities by type with pagination support.
+        This interface is currently supported only for Webull US.
+
+        :param account_id: Account ID
+        :param activity_types: Activity types filter, comma-separated string (optional)
+        :param start_time: Start time filter (optional)
+        :param end_time: End time filter (optional)
+        :param pagination_key: Pagination key from the previous page response; not returned on the last page.
+        """
+        get_activities_request = GetActivitiesRequestV2()
+        get_activities_request.set_account_id(account_id)
+        if activity_types is not None:
+            get_activities_request.set_activity_types(activity_types)
+        if start_time is not None:
+            get_activities_request.set_start_time(start_time)
+        if end_time is not None:
+            get_activities_request.set_end_time(end_time)
+        if pagination_key is not None:
+            get_activities_request.set_pagination_key(pagination_key)
+        response = self.client.get_response(get_activities_request)
+        return response

webull/trade/trade/v2/account_info_v2.py

@@ -16,6 +16,7 @@
 from webull.trade.request.v2.get_account_balance_request import AccountBalanceRequest
 from webull.trade.request.v2.get_account_list_request import GetAccountListRequest
 from webull.trade.request.v2.get_account_position_details_request import AccountPositionDetailsRequest
+from webull.trade.request.v2.get_account_position_details_request_v2 import AccountPositionDetailsRequestV2
 from webull.trade.request.v2.get_account_positions_request import AccountPositionsRequest
 
 
@@ -54,6 +55,11 @@ class AccountV2:
 
     def get_account_position_details(self, account_id, instrument_id, page_size=None, last_id=None):
         """
+        .. deprecated::
+            Use :meth:`list_position_details` instead.
+
+        The x-version header distinguishes the legacy and new pagination protocols for this path.
+
         This interface is currently supported only for Webull JP.
         Support for other regions will be available in future updates.
         """
@@ -64,3 +70,21 @@ class AccountV2:
         account_position_details_request.set_last_id(last_id)
         response = self.client.get_response(account_position_details_request)
         return response
+
+    def list_position_details(self, account_id, instrument_id, pagination_key=None):
+        """
+        The x-version header distinguishes the legacy and new pagination protocols for this path.
+
+        This interface is currently supported only for Webull JP.
+        Support for other regions will be available in future updates.
+
+        :param account_id: Account ID
+        :param instrument_id: Instrument ID
+        :param pagination_key: Pagination key from the previous page response; not returned on the last page.
+        """
+        account_position_details_request = AccountPositionDetailsRequestV2()
+        account_position_details_request.set_account_id(account_id)
+        account_position_details_request.set_instrument_id(instrument_id)
+        account_position_details_request.set_pagination_key(pagination_key)
+        response = self.client.get_response(account_position_details_request)
+        return response