webull-openapi-python-sdk 1.0.0__py3-none-any.whl

webull/trade/request/v2/preview_order_request.py

@@ -0,0 +1,59 @@
+# 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 typing import List
+
+from webull.core.request import ApiRequest
+
+
+class CloseContract:
+    def __init__(self, contract_id: str, quantity: str):
+        self.contract_id = contract_id
+        self.quantity = quantity
+
+    def to_dict(self):
+        return {
+            "contract_id": self.contract_id,
+            "quantity": self.quantity
+        }
+
+
+class PreviewOrderRequest(ApiRequest):
+    def __init__(self):
+        super().__init__("/openapi/account/orders/preview", version='v2', method="POST", body_params={})
+        self._new_orders = []
+        self._current_order = {}
+        self.add_body_params("new_orders", self._new_orders)
+
+    def add_new_order_params(self, k, v):
+        self._current_order[k] = v
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_close_contracts(self, close_contracts: List[CloseContract]):
+        if not isinstance(close_contracts, list):
+            raise TypeError("close_contracts must be a list of CloseContract objects.")
+        self.add_new_order_params("close_contracts", [contract.to_dict() for contract in close_contracts])
+
+    def set_new_orders(self, current_order):
+        self._current_order.update({k: v for k, v in current_order.items() if v is not None and k != 'self'})
+        if 'close_contracts' in current_order and current_order['close_contracts'] is not None:
+            self.set_close_contracts(current_order['close_contracts'])
+
+    def finalize_order(self):
+        if self._current_order:
+            self._new_orders.append(self._current_order)
+            self._current_order = {}
+        else:
+            raise ValueError("No order fields have been set.")

webull/trade/request/v2/replace_option_request.py

@@ -0,0 +1,28 @@
+# 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 ReplaceOptionRequest(ApiRequest):
+    def __init__(self):
+        super().__init__("/openapi/account/orders/option/replace", version='v2', method="POST", body_params={})
+
+    def set_modify_orders(self, modify_orders):
+        self.add_body_params("modify_orders", modify_orders)
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)

webull/trade/request/v2/replace_order_request.py

@@ -0,0 +1,57 @@
+# 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 typing import List
+from webull.core.request import ApiRequest
+
+class CloseContract:
+    def __init__(self, contract_id: str, quantity: str):
+        self.contract_id = contract_id
+        self.quantity = quantity
+
+    def to_dict(self):
+        return {
+            "contract_id": self.contract_id,
+            "quantity": self.quantity
+        }
+
+class ReplaceOrderRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/account/orders/replace", version='v2', method="POST", body_params={})
+        self._modify_orders = []
+        self._current_order = {}
+        self.add_body_params("modify_orders", self._modify_orders)
+
+    def add_order_param(self, key, value):
+        self._current_order[key] = value
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_close_contracts(self, close_contracts: List[CloseContract]):
+        if not isinstance(close_contracts, list):
+            raise TypeError("close_contracts must be a list of CloseContract objects.")
+        self.add_order_param("close_contracts", [contract.to_dict() for contract in close_contracts])
+
+    def set_modify_orders(self, current_order):
+        self._current_order.update({k: v for k, v in current_order.items() if v is not None and k != 'self'})
+        if 'close_contracts' in current_order and current_order['close_contracts'] is not None:
+            self.set_close_contracts(current_order['close_contracts'])
+
+    def finalize_order(self):
+        if self._current_order:
+            self._modify_orders.append(self._current_order)
+            self._current_order = {}
+        else:
+            raise ValueError("No order fields have been set.")

webull/trade/trade/account_info.py

@@ -0,0 +1,83 @@
+# 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 json.tool import main
+from webull.trade.common.currency import Currency
+from webull.trade.request.get_account_balance_request import AccountBalanceRequest
+from webull.trade.request.get_account_positions_request import AccountPositionsRequest
+from webull.trade.request.get_account_profile_request import AccountProfileRequest
+from webull.trade.request.get_app_subscriptions import GetAppSubscriptions
+
+
+class Account:
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def get_account_profile(self, account_id):
+        """
+        Query account details according to account ID, which only contains static information.
+
+        :param account_id: Account ID
+        """
+        account_profile_request = AccountProfileRequest()
+        account_profile_request.set_account_id(account_id)
+        response = self.client.get_response(account_profile_request)
+        return response
+
+    def get_account_balance(self, account_id, total_asset_currency):
+        """
+        Query account assets according to account id.
+
+        :param account_id: Account ID
+        :param total_asset_currency: The currency in which the total assets are denominated: the value refers to Currency
+        in the dictionary value. If it is empty, it defaults to HKD
+        """
+        account_balance_request = AccountBalanceRequest()
+        account_balance_request.set_account_id(account_id)
+        account_balance_request.set_total_asset_currency(total_asset_currency)
+        response = self.client.get_response(account_balance_request)
+        return response
+
+    def get_account_position(self, account_id, page_size=10, last_instrument_id=None):
+        """
+        Query the account position list according to the account ID page.
+
+        :param account_id: Account ID
+        :param page_size: Number of entries per page: default value is 10,
+         and the maximum value is 100 with integers being filled.
+        :param last_instrument_id: The last target id of the previous page,if not passed,
+        the first page is checked by default
+        """
+        account_positions_request = AccountPositionsRequest()
+        account_positions_request.set_account_id(account_id)
+        account_positions_request.set_page_size(page_size)
+        if last_instrument_id is not None:
+            account_positions_request.set_last_instrument_id(last_instrument_id)
+        response = self.client.get_response(account_positions_request)
+        return response
+
+    def get_app_subscriptions(self, subscription_id=None):
+        """
+        Paginate to query the account list and return account information.
+
+        :param subscription_id: The order ID of the last piece of data, if no parameter is passed,
+        the first 100 pieces of data are queried by default
+        """
+        app_subscriptions = GetAppSubscriptions()
+        if subscription_id is not None:
+            app_subscriptions.set_subscription_id(subscription_id)
+        response = self.client.get_response(app_subscriptions)
+        return response

webull/trade/trade/order_operation.py

@@ -0,0 +1,246 @@
+# 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.context.request_context_holder import RequestContextHolder
+# coding=utf-8
+from webull.trade.request.cancel_order_request import CancelOrderRequest
+from webull.trade.request.get_open_orders_request import OpenOrdersListRequest
+from webull.trade.request.get_order_detail_request import OrderDetailRequest
+from webull.trade.request.get_today_orders_request import TodayOrdersListRequest
+from webull.trade.request.palce_order_request import PlaceOrderRequest
+from webull.trade.request.place_order_request_v2 import PlaceOrderRequestV2
+from webull.trade.request.replace_order_request import ReplaceOrderRequest
+from webull.trade.request.replace_order_request_v2 import ReplaceOrderRequestV2
+from webull.trade.request.v2.cancel_option_request import CancelOptionRequest
+from webull.trade.request.v2.place_option_request import PlaceOptionRequest
+from webull.trade.request.v2.preview_option_request import PreviewOptionRequest
+from webull.trade.request.v2.replace_option_request import ReplaceOptionRequest
+
+
+class OrderOperation:
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def place_order(self, account_id, qty, instrument_id, side, client_order_id, order_type,
+                    extended_hours_trading, tif, limit_price=None, stop_price=None,
+                    trailing_type=None, trailing_stop_step=None):
+        """
+        This interface is used by customers in Hong Kong to place orders, and supports placing orders in two markets:
+        Hong Kong stocks, and A shares (China Connect).
+
+        :param account_id: Account ID
+        :param qty: The amount of the equities to place an order, integer, the maximum value supported is 1000000 shares
+        :param instrument_id: Instrument ID.
+        :param side: Buy and sell direction.
+        :param client_order_id: Third-party order ID, and the maximum length of this field is 40.
+        :param order_type: Order Type.
+        :param extended_hours_trading: Whether to allow pre-market and post-market trading.
+        Market orders can only be false, and limit orders can be true or false..
+        :param tif: Order validity period.
+        :param limit_price: Order_type is LIMIT, STOP_LOSS_LIMIT, ENHANCED_LIMIT,
+         AT_AUCTION_LIMIT (at-auction limit order) and needs to be passed.
+        :param stop_price: When order_type is STOP_LOSS (stop-loss order), STOP_LOSS_LIMIT (stop-loss limit price),
+        it needs to pass.
+        :param trailing_type: Spread type of trailing stop order, trailing stop order to be transmitted.
+        :param trailing_stop_step: Spread value of trailing stop order, trailing stop order to be transmitted
+        """
+        place_order_request = PlaceOrderRequest()
+        place_order_request.set_account_id(account_id)
+        place_order_request.set_stock_order(client_order_id=client_order_id, instrument_id=instrument_id, qty=qty,
+                                            side=side, tif=tif, extended_hours_trading=extended_hours_trading,
+                                            order_type=order_type, limit_price=limit_price, stop_price=stop_price,
+                                            trailing_type=trailing_type, trailing_stop_step=trailing_stop_step)
+        place_order_request.add_custom_headers_from_context()
+        response = self.client.get_response(place_order_request)
+        return response
+
+    def replace_order(self, account_id, qty, instrument_id, side, client_order_id, order_type,
+                      extended_hours_trading, tif, limit_price=None, stop_price=None,
+                      trailing_type=None, trailing_stop_step=None):
+        """
+        Modify order.
+
+        :param account_id: Account ID
+        :param qty: The amount of the equities to place an order, integer, the maximum value supported is 1000000 shares
+        :param instrument_id: Instrument ID.
+        :param side: Buy and sell direction.
+        :param client_order_id: Third-party order ID, and the maximum length of this field is 40.
+        :param order_type: Order Type.
+        :param extended_hours_trading: Whether to allow pre-market and post-market trading.
+         Market orders can only be false, and limit orders can be true or false..
+        :param tif: Order validity period.
+        :param limit_price: Order_type is LIMIT, STOP_LOSS_LIMIT, ENHANCED_LIMIT,
+        AT_AUCTION_LIMIT (at-auction limit order) and needs to be passed.
+        :param stop_price: When order_type is STOP_LOSS (stop-loss order),
+        STOP_LOSS_LIMIT (stop-loss limit price), it needs to pass.
+        :param trailing_type: Spread type of trailing stop order, trailing stop order to be transmitted.
+        :param trailing_stop_step: Spread value of trailing stop order, trailing stop order to be transmitted
+        """
+        replace_order_request = ReplaceOrderRequest()
+        replace_order_request.set_account_id(account_id)
+        replace_order_request.set_stock_order(client_order_id=client_order_id, instrument_id=instrument_id, qty=qty,
+                                              side=side, tif=tif, extended_hours_trading=extended_hours_trading,
+                                              order_type=order_type, limit_price=limit_price, stop_price=stop_price,
+                                              trailing_type=trailing_type, trailing_stop_step=trailing_stop_step)
+        response = self.client.get_response(replace_order_request)
+        return response
+
+    def place_order_v2(self, account_id, stock_order):
+        place_order_request = PlaceOrderRequestV2()
+        place_order_request.set_account_id(account_id)
+        place_order_request.set_stock_order(stock_order)
+        place_order_request.add_custom_headers_from_context()
+        response = self.client.get_response(place_order_request)
+        return response
+
+    def replace_order_v2(self, account_id, stock_order):
+        replace_order_request = ReplaceOrderRequestV2()
+        replace_order_request.set_account_id(account_id)
+        replace_order_request.set_stock_order(stock_order)
+        response = self.client.get_response(replace_order_request)
+        return response
+
+    def cancel_order(self, account_id, client_order_id):
+        """
+        Cancel order.
+
+        :param account_id: Account ID
+        :param client_order_id: Third-party order ID, and the maximum length of this field is 40.
+        """
+        cancel_order_request = CancelOrderRequest()
+        cancel_order_request.set_account_id(account_id)
+        cancel_order_request.set_client_order_id(client_order_id)
+        response = self.client.get_response(cancel_order_request)
+        return response
+
+    def list_today_orders(self, account_id, page_size=10, last_client_order_id=None):
+        """
+        Paging query all orders of the day, the number of data returned each time can be specified,
+        the maximum value is 100.
+
+        :param account_id: Account ID
+        :param page_size: For the number of entries per page, the default value is 10,
+        and the maximum value is 100. Integers can be filled.
+
+        :param last_client_order_id: The 3rd party order ID is not passed,
+         and the default check is conducted on the first page.
+        """
+        today_orders_list_request = TodayOrdersListRequest()
+        today_orders_list_request.set_account_id(account_id)
+        today_orders_list_request.set_page_size(page_size)
+        if last_client_order_id is not None:
+            today_orders_list_request.set_last_client_order_id(last_client_order_id)
+        response = self.client.get_response(today_orders_list_request)
+        return response
+
+    def list_open_orders(self, account_id, page_size=10, last_client_order_id=None):
+        """
+        Paging query pending orders.
+
+        :param account_id: Account ID
+        :param page_size: For the number of entries per page, the default value is 10, and the maximum value is 100.
+         Integers can be filled.
+        :param last_client_order_id: The 3rd party order ID is not passed,
+        and the default check is conducted on the first page.
+        """
+        open_orders_list_request = OpenOrdersListRequest()
+        open_orders_list_request.set_account_id(account_id)
+        open_orders_list_request.set_page_size(page_size)
+        if last_client_order_id is not None:
+            open_orders_list_request.set_last_client_order_id(last_client_order_id)
+        response = self.client.get_response(open_orders_list_request)
+        return response
+
+    def query_order_detail(self, account_id, client_order_id):
+        """
+        Paging query pending orders.
+
+        :param account_id: Account ID
+        :param client_order_id: The 3rd party order ID.
+        """
+        order_detail_request = OrderDetailRequest()
+        order_detail_request.set_account_id(account_id)
+        order_detail_request.set_client_order_id(client_order_id)
+        response = self.client.get_response(order_detail_request)
+        return response
+
+    def preview_option(self, account_id, new_orders):
+        """
+        This interface is exclusively available for Webull Hong Kong brokerage clients.
+        Currently, it does not support Webull Japan or Webull U.S. clients,
+        but support will be gradually introduced in the future.
+        """
+        preview_option_request = PreviewOptionRequest()
+        preview_option_request.set_new_orders(new_orders)
+        preview_option_request.set_account_id(account_id)
+        response = self.client.get_response(preview_option_request)
+        return response
+
+    def place_option(self, account_id, new_orders):
+        """
+        This interface is exclusively available for Webull Hong Kong brokerage clients.
+        Currently, it does not support Webull Japan or Webull U.S. clients,
+        but support will be gradually introduced in the future.
+        """
+        place_option_request = PlaceOptionRequest()
+        place_option_request.set_new_orders(new_orders)
+        place_option_request.set_account_id(account_id)
+        place_option_request.add_custom_headers_from_order(new_orders)
+        place_option_request.add_custom_headers_from_context()
+        response = self.client.get_response(place_option_request)
+        return response
+
+    def replace_option(self, account_id, modify_orders):
+        """
+        This interface is exclusively available for Webull Hong Kong brokerage clients.
+        Currently, it does not support Webull Japan or Webull U.S. clients,
+        but support will be gradually introduced in the future.
+        """
+        replace_option_request = ReplaceOptionRequest()
+        replace_option_request.set_modify_orders(modify_orders)
+        replace_option_request.set_account_id(account_id)
+        response = self.client.get_response(replace_option_request)
+        return response
+
+    def cancel_option(self, account_id, client_order_id):
+        """
+        This interface is exclusively available for Webull Hong Kong brokerage clients.
+        Currently, it does not support Webull Japan or Webull U.S. clients,
+        but support will be gradually introduced in the future.
+        """
+        cancel_option_request = CancelOptionRequest()
+        cancel_option_request.set_client_order_id(client_order_id)
+        cancel_option_request.set_account_id(account_id)
+        response = self.client.get_response(cancel_option_request)
+        return response
+
+    def add_custom_headers(self, headers_map: dict):
+        """
+        This is an optional feature; you can still make a request without setting it.
+        If set, you can specify certain headers to perform specific operations.
+        Note: If you set a header, call remove_custom_headers to clean up the header after the request is completed.
+
+        Currently supported header keys and functions:
+            Key：category {See Also: category}
+            Function: Frequency limit rules, please refer to the document for details. currently only supports Hong Kong
+        """
+        if not headers_map or len(headers_map) == 0:
+            return
+
+        RequestContextHolder.get().update(headers_map)
+
+    def remove_custom_headers(self):
+        """
+        Clearing headers after the request is completed.
+        """
+        RequestContextHolder.clear()

webull/trade/trade/trade_calendar.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.
+from webull.trade.request.get_trade_calendar_request import TradeCalendarRequest
+
+
+class TradeCalendar:
+
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def get_trade_calendar(self, market, start, end):
+        """
+        Get the trading calendar for the specified market.
+        Trading days are obtained by excluding weekends and holidays, and the dates of temporary market closures are
+        not excluded.
+
+        :param market: Markets, enumeration
+        :param start: Start date
+        :param end: End date
+        """
+        trade_calendar_request = TradeCalendarRequest()
+        trade_calendar_request.set_market(market)
+        trade_calendar_request.set_start(start)
+        trade_calendar_request.set_end(end)
+        response = self.client.get_response(trade_calendar_request)
+        return response

webull/trade/trade/trade_instrument.py

@@ -0,0 +1,72 @@
+# 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.trade.request.get_trade_instrument_detail_request import TradeInstrumentDetailRequest
+from webull.trade.request.get_trade_security_detail_request import TradeSecurityDetailRequest
+from webull.trade.request.get_tradeable_instruments_request import TradeableInstrumentRequest
+
+
+class TradeInstrument:
+
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def get_trade_instrument_detail(self, instrument_id):
+        """
+        Query the information of traded symbol.
+
+        :param instrument_id: Symbol ID
+        """
+        instrument_detail_request = TradeInstrumentDetailRequest()
+        instrument_detail_request.set_instrument_id(instrument_id)
+        response = self.client.get_response(instrument_detail_request)
+        return response
+
+    def get_trade_security_detail(self, symbol, market, instrument_super_type, instrument_type, strike_price, init_exp_date):
+        """
+        Query the information of traded symbol.
+
+        :param symbol: The ticker symbol or code representing a specific financial instrument or security.
+        :param market: e.g. US, HK.
+        :param instrument_super_type: Asset Class (e.g. EQUITY, OPTION.)
+        :param instrument_type: Type of underlying equity，required when querying for options information (e.g., WARRANT, UNITS, ETF, CALL_OPTION, PUT_OPTION).
+        :param strike_price: Option Strike Price, required when querying for options information.
+        :param init_exp_date: Option Expiration Date, Format: yyyy-MM-dd, required when querying for options information.
+        """
+        security_detail_request = TradeSecurityDetailRequest()
+        security_detail_request.set_symbol(symbol)
+        security_detail_request.set_market(market)
+        security_detail_request.set_instrument_super_type(instrument_super_type)
+        security_detail_request.set_instrument_type(instrument_type)
+        security_detail_request.set_strike_price(strike_price)
+        security_detail_request.set_init_exp_date(init_exp_date)
+        response = self.client.get_response(security_detail_request)
+        return response
+
+    def get_tradeable_instruments(self, last_instrument_id=None, page_size=10):
+        """
+        Only for Webull JP
+
+        Paging query tradable instruments.
+
+        :param last_security_id: Pagination-specific id, if not passed, the first page will be searched by default
+
+        :param page_size: Number of entries per page: default value is 10,
+        and the maximum value is 100 with integers being filled.
+        """
+        tradeable_instruments_request = TradeableInstrumentRequest()
+        if last_instrument_id is not None:
+            tradeable_instruments_request.set_last_instrument_id(last_instrument_id)
+        tradeable_instruments_request.set_page_size(page_size)
+        response = self.client.get_response(tradeable_instruments_request)
+        return response

webull/trade/trade/v2/account_info_v2.py

@@ -0,0 +1,55 @@
+# 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.trade.request.v2.get_account_balance_request import AccountBalanceRequest
+from webull.trade.request.v2.get_account_list import GetAccountList
+from webull.trade.request.v2.get_account_positions_request import AccountPositionsRequest
+
+
+class AccountV2:
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def get_account_list(self):
+        """
+        This interface is currently available only to individual brokerage customers in Webull Japan
+        and institutional brokerage clients in Webull Hong Kong. It is not yet available to
+        Webull US brokerage customers, but support will be introduced progressively in the future.
+        """
+        account_list = GetAccountList()
+        response = self.client.get_response(account_list)
+        return response
+
+    def get_account_balance(self, account_id):
+        """
+        This interface is currently available only to individual brokerage customers in Webull Japan
+        and institutional brokerage clients in Webull Hong Kong. It is not yet available to
+        Webull US brokerage customers, but support will be introduced progressively in the future.
+        """
+        account_balance_request = AccountBalanceRequest()
+        account_balance_request.set_account_id(account_id)
+        response = self.client.get_response(account_balance_request)
+        return response
+
+    def get_account_position(self, account_id):
+        """
+        This interface is currently available only to individual brokerage customers in Webull Japan
+        and institutional brokerage clients in Webull Hong Kong. It is not yet available to
+        Webull US brokerage customers, but support will be introduced progressively in the future.
+        """
+        account_positions_request = AccountPositionsRequest()
+        account_positions_request.set_account_id(account_id)
+        response = self.client.get_response(account_positions_request)
+        return response