webull-openapi-python-sdk 3.0.1__py3-none-any.whl → 3.0.3__py3-none-any.whl

samples/__init__.py

@@ -1 +1 @@
-__version__ = '3.0.1'
+__version__ = '3.0.3'

samples/data/community.py

@@ -0,0 +1,62 @@
+# 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.client import ApiClient
+from webull.data.common.category import Category
+from webull.data.data_client import DataClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>"
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    data_client = DataClient(api_client)
+
+    response = data_client.community.create_post(
+        "Hello, this is a test post from OpenAPI!",
+        symbol="NVDA",
+        category=Category.US_STOCK.name,
+    )
+    if response.status_code == 200:
+        print('create_post:', response.json())
+
+    response = data_client.community.create_comment(
+        "995005758239301632",
+        "Hello, this is a test comment from OpenAPI!",
+    )
+    if response.status_code == 200:
+        print('create_comment:', response.json())
+
+    response = data_client.community.list_hot_stocks()
+    if response.status_code == 200:
+        print('list_hot_stocks:', response.json())
+
+    response = data_client.community.list_posts_by_symbol("NVDA", Category.US_STOCK.name)
+    if response.status_code == 200:
+        print('list_posts_by_symbol:', response.json())
+
+    response = data_client.community.get_post("995005758239301632")
+    if response.status_code == 200:
+        print('get_post:', response.json())
+
+    response = data_client.community.list_my_posts()
+    if response.status_code == 200:
+        print('list_my_posts:', response.json())

samples/trade/trade_client_v3.py

@@ -18,6 +18,7 @@ from time import sleep
 
 from webull.core.client import ApiClient
 from webull.trade.trade_client import TradeClient
+from webull.trade.common.transfer_activities_param import TransferActivitiesParam
 
 optional_api_endpoint = "<api_endpoint>"
 your_app_key = "<your_app_key>"
@@ -888,3 +889,40 @@ if __name__ == '__main__':
     res = trade_client.order_v3.get_order_detail(account_id, trailing_stop_loss_limit_client_order_id)
     if res.status_code == 200:
         print('get trailing stop loss limit order detail res:', res.json())
+
+    # ============================================================
+    # Position Transfers Example (US only)
+    # ============================================================
+
+    # First page: pass no pagination_key and no filters.
+    res = trade_client.activity.list_transfers_activities(TransferActivitiesParam(account_id))
+    if res.status_code == 200:
+        print('list transfers activities res:', res.json())
+
+    # Iterate all pages using the returned pagination_key until it is absent.
+    pagination_key = (res.json() or {}).get('pagination_key') if res.status_code == 200 else None
+    while pagination_key:
+        res = trade_client.activity.list_transfers_activities(
+            TransferActivitiesParam(account_id, pagination_key=pagination_key))
+        if res.status_code != 200:
+            break
+        print('list transfers activities next page res:', res.json())
+        pagination_key = (res.json() or {}).get('pagination_key')
+
+    # Filtered query: ACATS/crypto incoming transfers, FULL type, within a time range.
+    res = trade_client.activity.list_transfers_activities(
+        TransferActivitiesParam(
+            account_id,
+            transfer_method="ACATS,CRYPTO_TRANSFER",
+            direction="INCOMING",
+            status="PENDING,COMPLETED",
+            acats_transfer_types="FULL",
+            start_time="2026-08-01T00:00:00Z",
+            end_time="2026-08-31T23:59:59Z"))
+    if res.status_code == 200:
+        print('list transfers activities filtered res:', res.json())
+
+    # Get a single transfer record by account_id and transfer_id.
+    res = trade_client.activity.get_transfer_activity_detail(account_id, transfer_id="<your_transfer_id>")
+    if res.status_code == 200:
+        print('get transfer activity res:', res.json())

webull/__init__.py

@@ -1 +1 @@
-__version__ = '3.0.1'
+__version__ = '3.0.3'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '3.0.1'
+__version__ = '3.0.3'
 
 import logging
 

webull/core/utils/validation.py

@@ -46,4 +46,11 @@ def assert_integer_positive(integer, name):
     if isinstance(integer, int) and integer > 0:
         return
     raise ClientException(error_code.SDK_INVALID_PARAMETER,
-                          "{0} should be a positive integer.".format(name))
+                          "{0} should be a positive integer.".format(name))
+
+
+def assert_string_not_empty(value, name):
+    if isinstance(value, str) and value.strip():
+        return
+    raise ClientException(error_code.SDK_INVALID_PARAMETER,
+                          "{0} should not be empty.".format(name))

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '3.0.1'
+__version__ = '3.0.3'

webull/data/data_client.py

@@ -27,6 +27,7 @@ from webull.data.quotes.option_market_data import OptionMarketData
 from webull.data.quotes.fundamentals import Fundamentals
 from webull.data.quotes.screener import Screener
 from webull.data.quotes.watchlist import Watchlist
+from webull.data.quotes.community import Community
 
 
 class DataClient:
@@ -42,6 +43,7 @@ class DataClient:
         self.fundamentals = Fundamentals(api_client)
         self.screener = Screener(api_client)
         self.watchlist = Watchlist(api_client)
+        self.community = Community(api_client)
 
     def _init_logger(self, api_client):
         # No logger configured, using default console and local file logging.

webull/data/quotes/community.py

@@ -0,0 +1,105 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# coding=utf-8
+
+from webull.data.request.create_comment_request import CreateCommentRequest
+from webull.data.request.create_post_request import CreatePostRequest
+from webull.data.request.get_post_request import GetPostRequest
+from webull.data.request.list_hot_stocks_request import ListHotStocksRequest
+from webull.data.request.list_my_posts_request import ListMyPostsRequest
+from webull.data.request.list_posts_by_symbol_request import ListPostsBySymbolRequest
+
+
+class Community:
+    """Community API operations."""
+
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def create_post(self, text, symbol=None, category=None):
+        """
+        Create a plain-text community post.
+
+        :param text: Post content.
+        :param symbol: Optional ticker symbol. Provide it with category.
+        :param category: Optional ticker market category. Provide it with symbol.
+        :return: Response containing the created post identifier.
+        """
+        request = CreatePostRequest()
+        request.set_text(text)
+        request.set_symbol(symbol)
+        request.set_category(category)
+        return self.client.get_response(request)
+
+    def create_comment(self, post_id, text):
+        """
+        Create a plain-text comment on an existing community post.
+
+        :param post_id: Parent post identifier.
+        :param text: Comment content.
+        :return: Response containing the created comment identifier.
+        """
+        request = CreateCommentRequest()
+        request.set_post_id(post_id)
+        request.set_text(text)
+        return self.client.get_response(request)
+
+    def list_hot_stocks(self):
+        """
+        List stocks ranked by community activity.
+
+        :return: Response containing hot stock ranking entries.
+        """
+        request = ListHotStocksRequest()
+        return self.client.get_response(request)
+
+    def list_posts_by_symbol(self, symbol, category, keyword=None, pagination_key=None):
+        """
+        List community posts associated with a symbol.
+
+        :param symbol: Stock symbol.
+        :param category: Market category.
+        :param keyword: Optional search keyword.
+        :param pagination_key: Optional key from the previous response.
+        :return: Paginated post list response.
+        """
+        request = ListPostsBySymbolRequest()
+        request.set_symbol(symbol)
+        request.set_category(category)
+        request.set_keyword(keyword)
+        request.set_pagination_key(pagination_key)
+        return self.client.get_response(request)
+
+    def get_post(self, post_id):
+        """
+        Get detailed information for a community post.
+
+        :param post_id: Post identifier.
+        :return: Post detail response.
+        """
+        request = GetPostRequest()
+        request.set_post_id(post_id)
+        return self.client.get_response(request)
+
+    def list_my_posts(self, pagination_key=None):
+        """
+        List posts created by the current user.
+
+        :param pagination_key: Optional key from the previous response.
+        :return: Paginated post list response.
+        """
+        request = ListMyPostsRequest()
+        request.set_pagination_key(pagination_key)
+        return self.client.get_response(request)

webull/data/request/create_comment_request.py

@@ -0,0 +1,33 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# coding=utf-8
+
+from webull.core.request import ApiRequest
+
+
+class CreateCommentRequest(ApiRequest):
+    """Request for creating a plain-text comment on a community post."""
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/communities/comments/create", version="v3", method="POST",
+                            body_params={})
+
+    def set_post_id(self, post_id):
+        """Set the parent post identifier."""
+        self.add_body_params("post_id", post_id)
+
+    def set_text(self, text):
+        """Set the comment text."""
+        self.add_body_params("text", text)

webull/data/request/create_post_request.py

@@ -0,0 +1,39 @@
+# 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 CreatePostRequest(ApiRequest):
+    """Request for creating a plain-text community post."""
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/communities/posts/create", version="v3", method="POST",
+                            body_params={})
+
+    def set_text(self, text):
+        """Set the post text."""
+        self.add_body_params("text", text)
+
+    def set_symbol(self, symbol):
+        """Set the optional ticker symbol."""
+        if symbol is not None:
+            self.add_body_params("symbol", symbol)
+
+    def set_category(self, category):
+        """Set the optional ticker market category."""
+        if category is not None:
+            self.add_body_params("category", category)

webull/data/request/get_post_request.py

@@ -0,0 +1,29 @@
+# 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 GetPostRequest(ApiRequest):
+    """Request for retrieving a community post by identifier."""
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/communities/posts/get", version="v3", method="GET",
+                            query_params={})
+
+    def set_post_id(self, post_id):
+        """Set the post identifier."""
+        self.add_query_param("post_id", post_id)

webull/data/request/list_hot_stocks_request.py

@@ -0,0 +1,25 @@
+# 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 ListHotStocksRequest(ApiRequest):
+    """Request for listing stocks ranked by community activity."""
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/communities/stock-rankings/list", version="v3", method="GET",
+                            query_params={})

webull/data/request/list_my_posts_request.py

@@ -0,0 +1,30 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# coding=utf-8
+
+from webull.core.request import ApiRequest
+
+
+class ListMyPostsRequest(ApiRequest):
+    """Request for listing posts created by the current user."""
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/communities/my-posts/list", version="v3", method="GET",
+                            query_params={})
+
+    def set_pagination_key(self, pagination_key):
+        """Set the optional pagination key from the previous response."""
+        if pagination_key is not None:
+            self.add_query_param("pagination_key", pagination_key)

webull/data/request/list_posts_by_symbol_request.py

@@ -0,0 +1,43 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# coding=utf-8
+
+from webull.core.request import ApiRequest
+
+
+class ListPostsBySymbolRequest(ApiRequest):
+    """Request for listing community posts associated with a symbol."""
+
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/communities/posts/symbols/list", version="v3", method="GET",
+                            query_params={})
+
+    def set_symbol(self, symbol):
+        """Set the stock symbol."""
+        self.add_query_param("symbol", symbol)
+
+    def set_category(self, category):
+        """Set the market category."""
+        self.add_query_param("category", category)
+
+    def set_keyword(self, keyword):
+        """Set the optional search keyword."""
+        if keyword is not None:
+            self.add_query_param("keyword", keyword)
+
+    def set_pagination_key(self, pagination_key):
+        """Set the optional pagination key from the previous response."""
+        if pagination_key is not None:
+            self.add_query_param("pagination_key", pagination_key)

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '3.0.1'
+__version__ = '3.0.3'

webull/trade/common/transfer_activities_param.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.utils import validation
+
+
+class TransferActivitiesParam:
+    """
+    Parameter object for :meth:`Activity.list_transfers_activities`.
+
+    :param account_id: Account ID (required).
+    :param transfer_method: Transfer method filter, comma-separated (e.g. ACATS,CRYPTO_TRANSFER) (optional).
+    :param direction: Direction filter: INCOMING or OUTGOING (optional).
+    :param status: Status filter, comma-separated: PENDING, COMPLETED, REJECTED, FAILED, CANCELLED (optional).
+    :param acats_transfer_types: ACATS transfer types filter, comma-separated: FULL, PARTIAL, RESIDUAL, RECLAIM, OTHER (optional).
+    :param start_time: ISO8601 UTC start time of transfer create time (optional).
+    :param end_time: ISO8601 UTC end time of transfer create time (optional).
+    :param pagination_key: Pagination key from the previous page response; not returned on the last page (optional).
+    """
+
+    def __init__(self, account_id, transfer_method=None, direction=None, status=None,
+                 acats_transfer_types=None, start_time=None, end_time=None, pagination_key=None):
+        validation.assert_string_not_empty(account_id, "account_id")
+        self.account_id = account_id
+        self.transfer_method = transfer_method
+        self.direction = direction
+        self.status = status
+        self.acats_transfer_types = acats_transfer_types
+        self.start_time = start_time
+        self.end_time = end_time
+        self.pagination_key = pagination_key

webull/trade/request/v3/get_transfer_activities_detail_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 TransferActivitiesDetailRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/activities/transfer-activities/get", version='v3', method="GET",
+                            query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_transfer_id(self, transfer_id):
+        self.add_query_param("transfer_id", transfer_id)

webull/trade/request/v3/get_transfer_activities_request.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.core.request import ApiRequest
+from webull.core.utils import validation
+
+
+class TransferActivitiesRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trading/activities/transfer-activities/list", version='v3', method="GET",
+                            query_params={})
+
+    def set_account_id(self, account_id):
+        validation.assert_string_not_empty(account_id, "account_id")
+        self.add_query_param("account_id", account_id)
+
+    def set_transfer_method(self, transfer_method):
+        if transfer_method is not None:
+            self.add_query_param("transfer_method", transfer_method)
+
+    def set_direction(self, direction):
+        if direction is not None:
+            self.add_query_param("direction", direction)
+
+    def set_status(self, status):
+        if status is not None:
+            self.add_query_param("status", status)
+
+    def set_acats_transfer_types(self, acats_transfer_types):
+        if acats_transfer_types is not None:
+            self.add_query_param("acats_transfer_types", acats_transfer_types)
+
+    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/trade/activity.py

@@ -14,14 +14,28 @@
 
 # coding=utf-8
 
+from webull.core.common.region import Region
+from webull.core.exception import error_code
+from webull.core.exception.exceptions import ClientException
 from webull.trade.request.get_activities_request import GetActivitiesRequest
 from webull.trade.request.get_activities_request_v2 import GetActivitiesRequestV2
+from webull.trade.request.v3.get_transfer_activities_request import TransferActivitiesRequest
+from webull.trade.request.v3.get_transfer_activities_detail_request import TransferActivitiesDetailRequest
+from webull.trade.common.transfer_activities_param import TransferActivitiesParam
 
 
 class Activity:
     def __init__(self, api_client):
         self.client = api_client
 
+    def _assert_us_region(self, operation):
+        region_id = self.client.get_region_id()
+        if region_id != Region.US.value:
+            raise ClientException(
+                error_code.SDK_NOT_SUPPORT,
+                "%s is currently supported only for Webull US region, current region is %s." % (
+                    operation, region_id))
+
     def get_activities(self, account_id, activity_types=None, start_time=None, end_time=None,
                        last_activity_id=None, page_size=10):
         """
@@ -80,3 +94,62 @@ class Activity:
             get_activities_request.set_pagination_key(pagination_key)
         response = self.client.get_response(get_activities_request)
         return response
+
+    def list_transfers_activities(self, param):
+        """
+        Query transfer records with pagination support. Results are ordered by create time descending.
+        Routes to ACATS or crypto transfer downstream by account type.
+        This interface is currently supported only for Webull US.
+
+        Each record is a summary view containing: account_id, transfer_method, transfer_id, direction,
+        status, failure_reason, acats_associated_number, acats_transfer_types, create_time, update_time,
+        transfer_settlement_date. Detailed fields (acats_control_number, contra_broker, crypto_transaction_hash,
+        crypto_from_address, crypto_to_address, cash, positions) are returned only by get_transfer_activity.
+
+        :param param: A :class:`TransferActivitiesParam` object carrying account_id and optional filters.
+        """
+        self._assert_us_region("list_transfers_activities")
+        if not isinstance(param, TransferActivitiesParam):
+            raise ClientException(
+                error_code.SDK_INVALID_PARAMETER,
+                "param should be a TransferActivitiesParam object.")
+        get_transfers_request = TransferActivitiesRequest()
+        get_transfers_request.set_account_id(param.account_id)
+        if param.transfer_method is not None:
+            get_transfers_request.set_transfer_method(param.transfer_method)
+        if param.direction is not None:
+            get_transfers_request.set_direction(param.direction)
+        if param.status is not None:
+            get_transfers_request.set_status(param.status)
+        if param.acats_transfer_types is not None:
+            get_transfers_request.set_acats_transfer_types(param.acats_transfer_types)
+        if param.start_time is not None:
+            get_transfers_request.set_start_time(param.start_time)
+        if param.end_time is not None:
+            get_transfers_request.set_end_time(param.end_time)
+        if param.pagination_key is not None:
+            get_transfers_request.set_pagination_key(param.pagination_key)
+        response = self.client.get_response(get_transfers_request)
+        return response
+
+    def get_transfer_activity_detail(self, account_id, transfer_id):
+        """
+        Get a single transfer record by account ID and transfer ID.
+        This interface is currently supported only for Webull US.
+
+        Returns the full detail view. In addition to the summary fields from list_transfers_activities,
+        it also includes: acats_control_number, contra_broker (broker_name, dtc_number, account_type,
+        account_number), crypto_transaction_hash, crypto_from_address, crypto_to_address, cash
+        (amount, currency, settlement_date) and positions (asset_type is one of EQUITY, OPTION, FUTURES,
+        CRYPTO, EVENT, MUTUAL_FUND, BOND; plus symbol, name, cusip, quantity, fee_quantity, total_quantity,
+        transfer_price, settlement_date).
+
+        :param account_id: Account ID
+        :param transfer_id: Transfer record ID
+        """
+        self._assert_us_region("get_transfer_activity_detail")
+        get_transfer_request = TransferActivitiesDetailRequest()
+        get_transfer_request.set_account_id(account_id)
+        get_transfer_request.set_transfer_id(transfer_id)
+        response = self.client.get_response(get_transfer_request)
+        return response

{webull_openapi_python_sdk-3.0.1.dist-info → webull_openapi_python_sdk-3.0.3.dist-info}/METADATA

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

{webull_openapi_python_sdk-3.0.1.dist-info → webull_openapi_python_sdk-3.0.3.dist-info}/RECORD

@@ -1,9 +1,10 @@
-samples/__init__.py,sha256=Ys8n4as2Wcnr8Aq6OV-e59RKmKVeyh9Oh2nzJ2FZPFk,22
+samples/__init__.py,sha256=f3vNGrLTgOxbJH5qxemKyIWl-KEbqvz66qZKwIM1iw8,22
 samples/account/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
 samples/account/account_client.py,sha256=vwh-nI_JnjwcIeOr1sQPMzG8pAqZwliUusE49ZmYE3s,1796
 samples/assets/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
 samples/assets/assets_client.py,sha256=p9LS2Td3gbUMkHn4LD_9RMCFuaQRUbsKvG4PhZBGJDc,1974
 samples/data/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
+samples/data/community.py,sha256=rwt_Gm9so3CbwYb5yxleVBIPrEevSQU_g9lpYDYu1tk,2154
 samples/data/data_client.py,sha256=IIrOWT74yMNC0CUGm2Ycel7ca38OFHOHWGYilNlXDZs,12886
 samples/data/data_client_event.py,sha256=u6Bebo2hTE0Ri1bQHa8nhFEe-fBbdxfNwLpTZh3E1WY,3046
 samples/data/data_streaming_client.py,sha256=2da21SE_Mneo7zbM_l1rkpdBBbI4avrpnSPMxsZIalw,4085
@@ -17,13 +18,13 @@ samples/screener/screener_client.py,sha256=R9LApEv9gZhn0RU3Jy4u3b-64FdvoMRf3gZpp
 samples/trade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 samples/trade/trade_client.py,sha256=LyWSvZJH4ByCkRORqP9WdkXfx65A2b6fhc9_GzL8DOM,6258
 samples/trade/trade_client_v2.py,sha256=IO-zmRiUnCmIetTdiYunPh8jVK2VaPrOR77Dwvz1auY,10771
-samples/trade/trade_client_v3.py,sha256=AwG4Ev2t836g1vACUo2rF-fGfOfFc_kSgtTiw-PN9mE,34240
+samples/trade/trade_client_v3.py,sha256=GdLsEnWZyBcOEEqGjfMVYtNkw2qN7J6ePj_gwjlPpmo,36105
 samples/trade/trade_client_v3_event.py,sha256=91HlT04KlK8Q5gUnsB8F5ErCFdJRnpDABKkBfYRc-YE,3932
 samples/trade/trade_event_client.py,sha256=ni7OEc4nnz2Hpbh0Kzl6DXB-FuDPc2UGBaLFnCrdFZ4,2824
 samples/watchlist/__init__.py,sha256=rtV5s4_CJgDAT4DGEJa_pNLJU71Wdr5OLz_IQ1EajFQ,567
 samples/watchlist/watchlist_client.py,sha256=lpzJs7SXuSka2KKkJ0u9s83A9iHta5qrjvIdkbfNcwg,3246
-webull/__init__.py,sha256=Ys8n4as2Wcnr8Aq6OV-e59RKmKVeyh9Oh2nzJ2FZPFk,22
-webull/core/__init__.py,sha256=xq1DShtNGxNOWulRwZya99hPjyivsNppPIQlglL62Cs,225
+webull/__init__.py,sha256=f3vNGrLTgOxbJH5qxemKyIWl-KEbqvz66qZKwIM1iw8,22
+webull/core/__init__.py,sha256=zLMH14kKlr1OhIsfLMPzGot6OWScjEUSGNR83zf8U7k,225
 webull/core/client.py,sha256=zxSBiII9KDxc5tHpTerJfV_PKPt8E9e3oTOpiakAtJw,16758
 webull/core/compat.py,sha256=_r6Y_f3vTo_DoxOaCvLjnvOo1KRkD2Z9kXSh8OijEIA,3088
 webull/core/headers.py,sha256=Wj2zev1XYyYsy2b9YKnoK3GqjVsXZO_o2WziMmuVBTw,2061
@@ -88,9 +89,9 @@ webull/core/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
 webull/core/utils/common.py,sha256=bb64grSP7PjaAIe8YYKDNzQ4qwgN7-qW0r24idTEqEY,2177
 webull/core/utils/data.py,sha256=YUyoWY68_2RkKanh3jsDscgGx__FIPh5VNEGXr1Qotc,852
 webull/core/utils/desensitize.py,sha256=186BKVDomhhKnIi_4-1bWJ7P5s01rStjeIwJkTEGoIA,952
-webull/core/utils/validation.py,sha256=gJcIrHYtgo48yVJ0q6O-f5buTYWOcr6ShhDIBhTp-Yg,1957
-webull/data/__init__.py,sha256=e6LgVJw9kaNVjruinsj2bum0Q3WEdZ3bhYQan5_1YiQ,38
-webull/data/data_client.py,sha256=FzatKHXgu5xv-FKFaX-mFYdhLTdz7zpRUox9AGWrReQ,2429
+webull/core/utils/validation.py,sha256=WXNBtJSvKfZ4qX40ke1rOMcu8TyYRemKsLog_t_T6tQ,2192
+webull/data/__init__.py,sha256=pUnsU4T4w-Gyx9oaz5dfbdFa0NeQO95vnIY_DzF6izQ,38
+webull/data/data_client.py,sha256=XfgXb2StfMN-ci3xQ48Hlv8QvMzBZC7sxg2feNZIdbQ,2527
 webull/data/data_streaming_client.py,sha256=kLKjFH4INREkPIjw6efPwnHGHWIDJn42IEsQam0njb8,4623
 webull/data/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/data/common/category.py,sha256=8mtq9J9aiNan1CkwgfqRnggdH0tENyhJBJ2HI3EkUHE,978
@@ -112,6 +113,7 @@ webull/data/internal/quotes_decoder.py,sha256=Y849H41h-cnKPjFe9xDsvG3bWD3l7FnMcC
 webull/data/internal/quotes_payload_decoder.py,sha256=xyG2bEeicF_mZLgdMZUTC7CYpZ441o6xswWP8MKqys0,977
 webull/data/internal/quotes_topic.py,sha256=kG4RZTjj01U0e54qoOrJHlLrPeBzXekySasm2uoyXVo,1138
 webull/data/quotes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webull/data/quotes/community.py,sha256=b6XPgmBc7vpvZ6VvmCz8ueuih6raTSyiTuhDb5CTDME,3816
 webull/data/quotes/crypto_market_data.py,sha256=UQlxUz0GntvwcRS-Vh_h7cXbhQ045MqPlG5AhWUoQI4,3063
 webull/data/quotes/event_market_data.py,sha256=lARSHqnVxRZZNOIi9uP-Rs5StMIUWtmwrw-p8droqtc,4650
 webull/data/quotes/fundamentals.py,sha256=WALbh8Q_91vDXJjdolVzMZpUNlqBQCRqL6SmVXUJVDU,15421
@@ -143,6 +145,8 @@ webull/data/quotes/subscribe/snapshot_result.py,sha256=U-YPGAVklcCsXZsp-9TPUUIfv
 webull/data/quotes/subscribe/tick_decoder.py,sha256=Qb__nJth2vsDMk2bWfNxY-mUGTUPzSZPO-ukHVxq80g,1008
 webull/data/quotes/subscribe/tick_result.py,sha256=i2-4ZD1GK5EI3NhxkhSmUXfKnkBMjrwVBzLoDUY95OU,1467
 webull/data/request/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+webull/data/request/create_comment_request.py,sha256=Z7C0b_3WDCrOysWbDHANd-NioCxm-ZswocETnB4CF-w,1160
+webull/data/request/create_post_request.py,sha256=NvOdFQ-QEuZ09_o6NEibLipTi51963ZmwiI5x1pq3SE,1351
 webull/data/request/get_analyst_rating_request.py,sha256=AxqT2mFmLOLH8QbvZzMgBmrw-SxcTqCHZehYi79uvsc,1256
 webull/data/request/get_analyst_target_price_request.py,sha256=BWMfyQwGJno3sBbPUTSiBBpB4QzDTQC3FsTW4PzoTRU,1267
 webull/data/request/get_batch_historical_bars_request.py,sha256=J4iQjpWIz0lbeOwH-Q223Wj7chnQkd_pWA7fGR9o7Bg,2201
@@ -203,10 +207,14 @@ webull/data/request/get_option_contracts_request.py,sha256=SOc_d-Y-9ELPEvF6pkCDi
 webull/data/request/get_option_contracts_request_v2.py,sha256=9V1evUzMOP5uVnkgG9cG1vOtFdCt7QeTzujfe5lMCjY,2721
 webull/data/request/get_option_snapshot_request.py,sha256=QH1YlrtpJq-VsrtSJEY3hC_knbVJLYqh_VoKH6qfKUk,1815
 webull/data/request/get_option_tick_request.py,sha256=uowqhVsXVBRz09RFNxYa_09_x8B9H5Nv9Q86PfmQUiU,1647
+webull/data/request/get_post_request.py,sha256=IsDWFRJ0ukR-DWQkKjZ3nnHHGvx5JlFr47kFGmoAyi8,1023
 webull/data/request/get_quotes_request.py,sha256=r_NkNUycrCgC1YVONN20xoW6ms6eYOTWGMH8SN5thR4,1242
 webull/data/request/get_sec_filings_request.py,sha256=AuDN4XwjuVfom7JDZdl_DGKEjf1OVrQ0nG79656zInk,1061
 webull/data/request/get_snapshot_request.py,sha256=PqDZ-Q_SXpLUU9D20jlEtBsajKHuNtbaqkcLmAqyGj8,1470
 webull/data/request/get_tick_request.py,sha256=Ts45r3dWqrWHtryKh-qQiO0PfSy9CRjh_6eq15A_t8I,1365
+webull/data/request/list_hot_stocks_request.py,sha256=dwJ7oyA6U_NI8xxK5lpxMtghpYAABCCxGl9v3-00ZmQ,916
+webull/data/request/list_my_posts_request.py,sha256=lB_r7uu2XSXhL5UpJbcX52-9jDQcugotvHtF3mD8SFY,1137
+webull/data/request/list_posts_by_symbol_request.py,sha256=m5Sc6Mci-xnSHGIxCjoCCTDAh8k2RnNalLMVUC-w39k,1571
 webull/data/request/subscribe_request.py,sha256=t2K5rkuDoB3e6Yw29_EA0c8B84W-Zykdj-QNXvKdC8o,1499
 webull/data/request/unsubscribe_request.py,sha256=3-47QAUf0TdbEr_AylnWF_QGAm7qsC7RaNyKg6L6UsY,1474
 webull/data/request/screener/__init__.py,sha256=68et0-FOloDo6Yo6vqmHPM45z-8zorzbhrZmUrLApEQ,583
@@ -231,7 +239,7 @@ webull/data/request/watchlist/get_watchlist_request.py,sha256=AC59m2-5I78ctAcTUh
 webull/data/request/watchlist/remove_watchlist_instruments_request.py,sha256=Fr9whov0qTCSINYSi_eDbvIhZmqdm5p7XW-X-eyICwk,1472
 webull/data/request/watchlist/update_watchlist_instruments_request.py,sha256=OYuF3dYQJAZLf0FkB3i9SxwG6Zy9ZUaiBvsu5flKhvA,1514
 webull/data/request/watchlist/update_watchlist_request.py,sha256=vGWnDZoK3bT9NKLJ7TO4rqlDqcOemj0HOuARTeAGnS0,1459
-webull/trade/__init__.py,sha256=Ys8n4as2Wcnr8Aq6OV-e59RKmKVeyh9Oh2nzJ2FZPFk,22
+webull/trade/__init__.py,sha256=f3vNGrLTgOxbJH5qxemKyIWl-KEbqvz66qZKwIM1iw8,22
 webull/trade/trade_client.py,sha256=c2SWGi0ATix5U2ZRWgsx4p4CJKmGy2qPkq1Pn2ndN0s,2279
 webull/trade/trade_events_client.py,sha256=sHoKPKQQ2Ye_c9tt9MYxFeza3T5lLR5VosNro7H1gN4,9748
 webull/trade/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -252,6 +260,7 @@ webull/trade/common/position_intent.py,sha256=nfO6vihp3z_rk4QUpOlUuFEiLL3KVWja2G
 webull/trade/common/trade_policy.py,sha256=Tm3RN2_fZSXl5APPWeg8riEHlrvFURPt-dGIK6zDbPU,800
 webull/trade/common/trading_date_type.py,sha256=xw8-oxBZNB-jdF25-PRv_5gwpXs8MksVZyZ7ZXRMLqY,747
 webull/trade/common/trailing_type.py,sha256=w-wi2Gy-v-8b2oUprQHobwql639Je4FIlPKxojlagz4,729
+webull/trade/common/transfer_activities_param.py,sha256=KESYl9aMTQn0fXWh7GrX1fbuvC7yeNNqkwKg4BRLkQ0,2065
 webull/trade/events/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/trade/events/default_retry_policy.py,sha256=zWoaJFJSUTtHw_qLj9_AIPBzFW6UHX295IfcuBHzYaI,2748
 webull/trade/events/events_pb2.py,sha256=NLolj5VOws1LJT5YIvnuZab9YYhR4lm2-iCkztaARPo,2440
@@ -307,12 +316,14 @@ webull/trade/request/v3/get_order_history_request.py,sha256=vGDQ1WGhgbSPifoXIMLh
 webull/trade/request/v3/get_order_history_request_v2.py,sha256=pOzlI9IV2gK-IgJmmn2zfZgRjiwJZVYldf8SlFnPpCA,1306
 webull/trade/request/v3/get_order_open_request.py,sha256=SwjcPEQ2V2di84Gsuq1dsrWc9jcXUzh-VsCUn5hG5zk,1202
 webull/trade/request/v3/get_order_open_request_v2.py,sha256=0GDvshJC2WfAV_v1xcuPpfn-ExTyh9W3tgp72DkkNI0,1033
+webull/trade/request/v3/get_transfer_activities_detail_request.py,sha256=cJeqN6NzDhz-6JmoV1LvEHKJOfffqew_U5lf-zwbB-k,1057
+webull/trade/request/v3/get_transfer_activities_request.py,sha256=IyAlcaxa3x0_ae0a0jscvjdUu3kBGAC8Q_n07TmhC9Y,2067
 webull/trade/request/v3/place_order_request.py,sha256=4WadcssswvLleaIw4DAuUo4Y9CrTVuP8b-oFnO31ABA,2261
 webull/trade/request/v3/preview_order_request.py,sha256=40IAlgfT11B1hVCQgtTKxkS6BsPxKvYkAw6y_v2YZ_0,1127
 webull/trade/request/v3/replace_order_request.py,sha256=vaC1Y6y10_MITkAweCwAi4Lo80cBOxWGFnGubPrGKAQ,1207
 webull/trade/trade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/trade/trade/account_info.py,sha256=M67jtCpbttp7tDCNNW99A1oLX-62c26yR1XXZ-xkK18,3609
-webull/trade/trade/activity.py,sha256=21UUGEyfaqxzB8R1A_aNrFMZ73a-vR2grWmfWk2LA0I,3762
+webull/trade/trade/activity.py,sha256=ppPuJ_8uFzGqSvipLxogJ5_u75qAqSUkOWu0D8TwSvs,7882
 webull/trade/trade/order_operation.py,sha256=QrL4Da87RTOSupiAbuXtZigo9602Byp14DQGyR99hkI,12849
 webull/trade/trade/trade_calendar.py,sha256=rGSiR5GZggQnZOmmpbC-06trgPQgFTvdpUzGMpw2ycw,1415
 webull/trade/trade/trade_instrument.py,sha256=AV-Y-x_hWBnF9T2g8SbYGKEGFmEQJi0QhtfTCoZicZo,3472
@@ -321,9 +332,9 @@ webull/trade/trade/v2/account_info_v2.py,sha256=TX-BskDxag52Om-RY803mOThZUtN1j2G
 webull/trade/trade/v2/order_operation_v2.py,sha256=ZWH-6dp5rvokb5YX5HO2Op-KPLjGR4gpJ06Kc_IUilQ,12816
 webull/trade/trade/v3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/trade/trade/v3/order_operation_v3.py,sha256=0tYdvcUIht4PNxZfAZLB4BlvgW5_kOFMzQhiL9YTJU4,15382
-webull_openapi_python_sdk-3.0.1.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
-webull_openapi_python_sdk-3.0.1.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
-webull_openapi_python_sdk-3.0.1.dist-info/METADATA,sha256=DK1po6EdF2IL0_OBtiaeimWt2rzO1VudnS3FKO6l-rk,1211
-webull_openapi_python_sdk-3.0.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-webull_openapi_python_sdk-3.0.1.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
-webull_openapi_python_sdk-3.0.1.dist-info/RECORD,,
+webull_openapi_python_sdk-3.0.3.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
+webull_openapi_python_sdk-3.0.3.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
+webull_openapi_python_sdk-3.0.3.dist-info/METADATA,sha256=gS_lnI1a7F21wP36uaCRqrSQJzLecUkEwTEGb8Gd5l0,1211
+webull_openapi_python_sdk-3.0.3.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+webull_openapi_python_sdk-3.0.3.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
+webull_openapi_python_sdk-3.0.3.dist-info/RECORD,,