webull-openapi-python-sdk 2.0.12__py3-none-any.whl → 2.0.13__py3-none-any.whl

samples/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.12'
+__version__ = '2.0.13'

samples/trade/activities_client.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.
+
+# coding=utf-8
+
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>"
+account_id = "<your_account_id>"
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    # Query cash activities with default parameters
+    res = trade_client.activity.get_activities(account_id)
+    if res.status_code == 200:
+        print('get activities:', res.json())
+
+    # Query cash activities with activity type filter
+    res = trade_client.activity.get_activities(account_id, activity_types="TRADE,DEPOSIT")
+    if res.status_code == 200:
+        print('get activities by type:', res.json())
+
+    # Query cash activities with time range filter
+    res = trade_client.activity.get_activities(
+        account_id,
+        start_time="2026-06-30T12:00:00.000Z",
+        end_time="2026-07-03T12:00:00.000Z",
+        page_size=20
+    )
+    if res.status_code == 200:
+        print('get activities by time range:', res.json())
+
+    # Query cash activities with cursor-based pagination
+    res = trade_client.activity.get_activities(
+        account_id,
+        last_activity_id="<last_activity_id_from_previous_page>",
+        page_size=10
+    )
+    if res.status_code == 200:
+        print('get activities next page:', res.json())

webull/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.12'
+__version__ = '2.0.13'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '2.0.12'
+__version__ = '2.0.13'
 
 import logging
 

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '2.0.12'
+__version__ = '2.0.13'

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.12'
+__version__ = '2.0.13'

webull/trade/request/get_activities_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 GetActivitiesRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/trade/activities/cash", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_activity_types(self, activity_types):
+        self.add_query_param("activity_types", activity_types)
+
+    def set_start_time(self, start_time):
+        self.add_query_param("start_time", start_time)
+
+    def set_end_time(self, end_time):
+        self.add_query_param("end_time", end_time)
+
+    def set_last_activity_id(self, last_activity_id):
+        self.add_query_param("last_activity_id", last_activity_id)
+
+    def set_page_size(self, page_size):
+        self.add_query_param("page_size", page_size)

webull/trade/trade/activity.py

@@ -0,0 +1,49 @@
+# 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.get_activities_request import GetActivitiesRequest
+
+
+class Activity:
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def get_activities(self, account_id, activity_types=None, start_time=None, end_time=None,
+                       last_activity_id=None, page_size=10):
+        """
+        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 last_activity_id: The last activity ID of the previous page for cursor-based pagination (optional)
+        :param page_size: Number of entries per page, default value is 10
+        """
+        get_activities_request = GetActivitiesRequest()
+        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 last_activity_id is not None:
+            get_activities_request.set_last_activity_id(last_activity_id)
+        get_activities_request.set_page_size(page_size)
+        response = self.client.get_response(get_activities_request)
+        return response

webull/trade/trade_client.py

@@ -16,6 +16,7 @@ import sys
 
 from webull.core.http.initializer.client_initializer import ClientInitializer
 from webull.trade.trade.account_info import Account
+from webull.trade.trade.activity import Activity
 from webull.trade.trade.order_operation import OrderOperation
 from webull.trade.trade.trade_calendar import TradeCalendar
 from webull.trade.trade.trade_instrument import TradeInstrument
@@ -33,6 +34,7 @@ class TradeClient:
         self.order = OrderOperation(api_client)
         self.order_v2 = OrderOperationV2(api_client)
         self.order_v3 = OrderOperationV3(api_client)
+        self.activity = Activity(api_client)
         self.trade_instrument = TradeInstrument(api_client)
         self.trade_calendar = TradeCalendar(api_client)
 

{webull_openapi_python_sdk-2.0.12.dist-info → webull_openapi_python_sdk-2.0.13.dist-info}/METADATA

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

{webull_openapi_python_sdk-2.0.12.dist-info → webull_openapi_python_sdk-2.0.13.dist-info}/RECORD

@@ -1,4 +1,4 @@
-samples/__init__.py,sha256=RRwLT6p4EVy1Jtdz4OMtNbu7xEdpC4gTRQ0zWltm1MQ,23
+samples/__init__.py,sha256=F9oasgdSO040QuU150cChv-xopNDOmPbPvzmyDiEYjM,23
 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
@@ -15,6 +15,7 @@ samples/order/order_stock_client.py,sha256=hYwVwVFVERk-YS7gRcW-LuGfAvcF8VJHZs1qw
 samples/screener/__init__.py,sha256=68et0-FOloDo6Yo6vqmHPM45z-8zorzbhrZmUrLApEQ,583
 samples/screener/screener_client.py,sha256=NGwjY7YaG_3l9c-QePpmpPG4Gtk_BZaM7-jQbMb2kzw,3636
 samples/trade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+samples/trade/activities_client.py,sha256=HOF0-T_-v9Am3Raob-iq2IM4PetfhQWbRw2rkMaufzk,2093
 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=yAkVwWhZBGD929oMmlUj4GvJVWWZiV8PLlv_BeXbDZ8,32069
@@ -22,8 +23,8 @@ samples/trade/trade_client_v3_event.py,sha256=91HlT04KlK8Q5gUnsB8F5ErCFdJRnpDABK
 samples/trade/trade_event_client.py,sha256=BWdD1L41LXmDlaig6ku9T3t3fSCCZEdj5nxH1xI1AZA,2653
 samples/watchlist/__init__.py,sha256=rtV5s4_CJgDAT4DGEJa_pNLJU71Wdr5OLz_IQ1EajFQ,567
 samples/watchlist/watchlist_client.py,sha256=lpzJs7SXuSka2KKkJ0u9s83A9iHta5qrjvIdkbfNcwg,3246
-webull/__init__.py,sha256=RRwLT6p4EVy1Jtdz4OMtNbu7xEdpC4gTRQ0zWltm1MQ,23
-webull/core/__init__.py,sha256=7GjyCroCZNfqvAsrpXggx5gEix62mf-KiQnxescdKPE,226
+webull/__init__.py,sha256=F9oasgdSO040QuU150cChv-xopNDOmPbPvzmyDiEYjM,23
+webull/core/__init__.py,sha256=Qhu2u_ECRyTmwLpFqEvg3uf4DNpsW3CQr6STtRrF6eo,226
 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
@@ -89,7 +90,7 @@ webull/core/utils/common.py,sha256=T5VVcYQVhA9fhiUHZN9gBuoh0uzVgbCM01o1qK08NAE,2
 webull/core/utils/data.py,sha256=YUyoWY68_2RkKanh3jsDscgGx__FIPh5VNEGXr1Qotc,852
 webull/core/utils/desensitize.py,sha256=f8_ps9BrG3WfXD8ZAw873-_YoGeke1Q55CeDwRmYkqA,1104
 webull/core/utils/validation.py,sha256=gJcIrHYtgo48yVJ0q6O-f5buTYWOcr6ShhDIBhTp-Yg,1957
-webull/data/__init__.py,sha256=tdVEX3AOmd6xefuH0MbcmWzpkGJBiPH9YyyjUbQm2Dw,39
+webull/data/__init__.py,sha256=A1ewcdVQ2-bAKc0T1HpPB3BsNC-a_6o-DRL8CcYULZE,39
 webull/data/data_client.py,sha256=FzatKHXgu5xv-FKFaX-mFYdhLTdz7zpRUox9AGWrReQ,2429
 webull/data/data_streaming_client.py,sha256=TQBAilvOLCbcMqacByrniXGr9VjSwjym-4-LUOiqKx8,4456
 webull/data/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -217,8 +218,8 @@ webull/data/request/watchlist/get_watchlist_request.py,sha256=XxzS4gxFbdQSajpFSm
 webull/data/request/watchlist/remove_watchlist_instruments_request.py,sha256=qOtQYDBp-PSawAgljnLmtfUce8dAblWI_zB0nnIv3G0,1451
 webull/data/request/watchlist/update_watchlist_instruments_request.py,sha256=KoihfB8MszsAooQGUUMjFmnid_a7xk4YSdEMDO1gh-k,1493
 webull/data/request/watchlist/update_watchlist_request.py,sha256=0s3ftkxiz9hjtXhLORrIUphyDIldRA8pJ4mP5zfbsyU,1466
-webull/trade/__init__.py,sha256=Ast7uVPztIC3X6Smxn3jnx9xmlIl0IpX3UNDj0m_wTQ,22
-webull/trade/trade_client.py,sha256=_6lH4KO-jKgKWU28fWNsc9-KEHto-WvaP0gT96BJ_dw,2184
+webull/trade/__init__.py,sha256=ETOzoBNhLSJycFTTlQ9F3NIdUYtPhNYYTm7erVExyfg,22
+webull/trade/trade_client.py,sha256=ck8yRjm-aibv8LGOP0Gk5zg6bv4-bTVjULFpZlCAK2c,2278
 webull/trade/trade_events_client.py,sha256=G9ovuxrnQh8iA1so2Ar-41jWRzDCYQYSHTkQLGlwhhA,9983
 webull/trade/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/trade/common/account_type.py,sha256=haVAB33MERN6XyPsbrfVQhK9_CpU90VltI6_KDkxzlE,715
@@ -249,6 +250,7 @@ webull/trade/request/cancel_order_request.py,sha256=JbyeVNOVu9xvwzba7Ntw2Sh4BrNV
 webull/trade/request/get_account_balance_request.py,sha256=S9M1rz6HFlIwRpWfkQKVfRo996_DWF8Qe6bGirSnkV0,1042
 webull/trade/request/get_account_positions_request.py,sha256=Nr7fyzsZfcCqQlyapu7KagZEagM60IG7PFU9Qempv9w,1117
 webull/trade/request/get_account_profile_request.py,sha256=SgF-eDkL6XM3IC-I-Mqmi8lFrTPa0iM4CkTjkZwZx_U,899
+webull/trade/request/get_activities_request.py,sha256=yp8ZiUM0mKyiIeBgBJHiokUSoF6zwAuqKdy0QnAtqa8,1421
 webull/trade/request/get_app_subscriptions.py,sha256=ViITk9Tt164LceijAq0harcO_5eoTRyCDnFsvr-ZJ4Y,962
 webull/trade/request/get_open_orders_request.py,sha256=USAN2LKVtJ0CK-lJlLQ8ihhM5M78du5rYoD2lMAV85g,1129
 webull/trade/request/get_order_detail_request.py,sha256=X42LnDBBh1shJ5DFB31ukgS8u1l-JM-Z2kumJnbutfw,1008
@@ -291,6 +293,7 @@ webull/trade/request/v3/preview_order_request.py,sha256=ZgzwrlAed8IJ8ORDRjJ7rIuF
 webull/trade/request/v3/replace_order_request.py,sha256=Xsa-vKGTMAwv-dJuSm8cx8rHVoFhk-cFjnHOpsUaZwM,1212
 webull/trade/trade/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/trade/trade/account_info.py,sha256=C3YcBDZfYOe5QSJEbysblye-W90RbQ7xNing5gLsIng,3622
+webull/trade/trade/activity.py,sha256=pyvsJcMhyKoKdxurJPgXexsoUy6EefwKneqqSJpdA0U,2154
 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=293IaiLnhw0mAc1IuF3LSgwgve_XZ1Dyf1VeFtmClc8,3474
@@ -299,9 +302,9 @@ webull/trade/trade/v2/account_info_v2.py,sha256=fs2-XaxklItuhaspzPkthXA5SgbnIffL
 webull/trade/trade/v2/order_operation_v2.py,sha256=m54RH2j45CBBWEnqe4KxrsltAF44XKtPMT4kv8t7djQ,12745
 webull/trade/trade/v3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/trade/trade/v3/order_opration_v3.py,sha256=NsInXC5sPCW8y55jU71BnR0sQYhtWclqCmyK7V09MLc,8275
-webull_openapi_python_sdk-2.0.12.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
-webull_openapi_python_sdk-2.0.12.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
-webull_openapi_python_sdk-2.0.12.dist-info/METADATA,sha256=suQHI55MCoTax2Gh12BxlA2z1aQ0NvxDiHzvWEs-UCc,1033
-webull_openapi_python_sdk-2.0.12.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-webull_openapi_python_sdk-2.0.12.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
-webull_openapi_python_sdk-2.0.12.dist-info/RECORD,,
+webull_openapi_python_sdk-2.0.13.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
+webull_openapi_python_sdk-2.0.13.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
+webull_openapi_python_sdk-2.0.13.dist-info/METADATA,sha256=ax-GvRxzowuykj36heNhXVhnd8J9ttaF6Hg6lZmqj6M,1033
+webull_openapi_python_sdk-2.0.13.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+webull_openapi_python_sdk-2.0.13.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
+webull_openapi_python_sdk-2.0.13.dist-info/RECORD,,

{webull_openapi_python_sdk-2.0.12.dist-info → webull_openapi_python_sdk-2.0.13.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any