webull-openapi-python-sdk 1.0.8__py3-none-any.whl → 1.0.9__py3-none-any.whl

samples/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.8'
+__version__ = '1.0.9'

samples/data/data_client.py

@@ -74,6 +74,10 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get_tick:', res.json())
 
+    res = data_client.market_data.get_footprint("AAPL", Category.US_STOCK.name, Timespan.S5.name)
+    if res.status_code == 200:
+        print('get_footprint:', res.json())
+
     res = data_client.market_data.get_quotes("AAPL", Category.US_STOCK.name, depth=1, overnight_required=True)
     if res.status_code == 200:
         print('get_quotes:', res.json())
@@ -94,6 +98,10 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get_futures_snapshot:', res.json())
 
+    res = data_client.futures_market_data.get_futures_footprint("SILZ5,6BM6", Category.US_FUTURES.name, Timespan.S5.name)
+    if res.status_code == 200:
+        print('get_futures_footprint:', res.json())
+
     res = data_client.instrument.get_futures_products(Category.US_FUTURES.name)
     if res.status_code == 200:
         print('get_futures_products:', res.json())

webull/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.8'
+__version__ = '1.0.9'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.0.8'
+__version__ = '1.0.9'
 
 import logging
 

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '1.0.8'
+__version__ = '1.0.9'

webull/data/common/timespan.py

@@ -16,6 +16,8 @@
 
 from webull.core.common.easy_enum import EasyEnum
 class Timespan(EasyEnum):
+    S5 = (12, "5 Second")
+    S15= (13, "15 Second")
     M1 = (1, "1 minute")
     M5 = (2, "5 minute")
     M15 = (3, "15 minute")

webull/data/quotes/futures_market_data.py

@@ -11,8 +11,8 @@
 # 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.data.common.category import Category
+from webull.data.request.get_futures_footprint_request import GetFuturesFootprintRequest
 from webull.data.request.get_futures_historical_bars_request import GetFuturesHistoricalBarsRequest
 from webull.data.request.get_futures_snapshot_request import GetFuturesSnapshotRequest
 from webull.data.request.get_futures_depth_request import GetFuturesDepthRequest
@@ -86,4 +86,26 @@ class FuturesMarketData:
         tick_request.set_category(category)
         tick_request.set_count(count)
         response = self.client.get_response(tick_request)
+        return response
+
+    def get_futures_footprint(self, symbols, category, timespan, count=None,
+                      real_time_required=None, trading_sessions=None):
+        """
+         Search the futures footprint based on the list of futures codes and futures types.
+
+        :param symbols: Futures Securities symbol, such as: BITH6,BITF26.
+        :param category: Security type, enumeration.
+        :param timespan: Time granularity.
+        :param count: Number of entries: 200 by default, maximum 1200.
+        :param real_time_required: Whether to include the latest data or candlestick charts that are not yet finalized. The default is false, meaning they are not included. This option is only used for minute candlestick charts.
+        :param trading_sessions: RTH: During trading hours, PRE: Before trading hours, ATH: After trading hours. Default: RTH.
+        """
+        footprint_request = GetFuturesFootprintRequest()
+        footprint_request.set_symbols(symbols)
+        footprint_request.set_category(category)
+        footprint_request.set_timespan(timespan)
+        footprint_request.set_count(count)
+        footprint_request.set_real_time_required(real_time_required)
+        footprint_request.set_trading_sessions(trading_sessions)
+        response = self.client.get_response(footprint_request)
         return response

webull/data/quotes/market_data.py

@@ -11,9 +11,11 @@
 # 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.data.common.category import Category
 from webull.data.request.get_batch_historical_bars_request import BatchHistoricalBarsRequest
 from webull.data.request.get_corp_action_request import GetCorpActionRequest
 from webull.data.request.get_eod_bars_request import GetEodBarsRequest
+from webull.data.request.get_footprint_request import GetFootprintRequest
 from webull.data.request.get_historical_bars_request import GetHistoricalBarsRequest
 from webull.data.request.get_quotes_request import GetQuotesRequest
 from webull.data.request.get_snapshot_request import GetSnapshotRequest
@@ -183,3 +185,25 @@ class MarketData:
             eod_corp_action_request.set_last_update_time(last_update_time)
         response = self.client.get_response(eod_corp_action_request)
         return response
+
+    def get_footprint(self, symbols, category, timespan, count=None,
+                      real_time_required=None, trading_sessions=None):
+        """
+         Search the footprint based on the list of security codes and security types.
+
+        :param symbols: Securities symbol, such as: 00700,00981.
+        :param category: Security type, enumeration.
+        :param timespan: Time granularity.
+        :param count: Number of entries: 200 by default, maximum 1200.
+        :param real_time_required: Whether to include the latest data or candlestick charts that are not yet finalized. The default is false, meaning they are not included. This option is only used for minute candlestick charts.
+        :param trading_sessions: RTH: During trading hours, PRE: Before trading hours, ATH: After trading hours. Default: RTH.
+        """
+        footprint_request = GetFootprintRequest()
+        footprint_request.set_symbols(symbols)
+        footprint_request.set_category(category)
+        footprint_request.set_timespan(timespan)
+        footprint_request.set_count(count)
+        footprint_request.set_real_time_required(real_time_required)
+        footprint_request.set_trading_sessions(trading_sessions)
+        response = self.client.get_response(footprint_request)
+        return response

webull/data/request/get_footprint_request.py

@@ -0,0 +1,45 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# coding=utf-8
+from webull.core.request import ApiRequest
+
+class GetFootprintRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/stock/footprint", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_timespan(self, timespan):
+        if timespan:
+            self.add_query_param("timespan", timespan)
+
+    def set_count(self, count):
+        if count:
+            self.add_query_param("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_query_param("real_time_required", real_time_required)
+
+    def set_trading_sessions(self, trading_sessions):
+        if trading_sessions:
+            self.add_query_param("trading_sessions", trading_sessions)

webull/data/request/get_futures_footprint_request.py

@@ -0,0 +1,45 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# coding=utf-8
+from webull.core.request import ApiRequest
+
+class GetFuturesFootprintRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/futures/footprint", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_timespan(self, timespan):
+        if timespan:
+            self.add_query_param("timespan", timespan)
+
+    def set_count(self, count):
+        if count:
+            self.add_query_param("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_query_param("real_time_required", real_time_required)
+
+    def set_trading_sessions(self, trading_sessions):
+        if trading_sessions:
+            self.add_query_param("trading_sessions", trading_sessions)

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '1.0.8'
+__version__ = '1.0.9'

{webull_openapi_python_sdk-1.0.8.dist-info → webull_openapi_python_sdk-1.0.9.dist-info}/METADATA

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

{webull_openapi_python_sdk-1.0.8.dist-info → webull_openapi_python_sdk-1.0.9.dist-info}/RECORD

@@ -1,10 +1,10 @@
-samples/__init__.py,sha256=mFFUUCx5TqyW1TTFRrWDhXXVMJDMRxXWrkHanVtp9oY,22
+samples/__init__.py,sha256=mg2kb865UYMe9zOkU2VcRPfv-5zzU182OL3t45SXXWk,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/data_client.py,sha256=rH91Yj7oIF6dBOOzF99cUn_12cgDLkw02SNIQM2nB1o,4868
+samples/data/data_client.py,sha256=8FR5ZOY8jWCGfN3XohzyvLdFxYv-TdqfWRKw3E827WY,5248
 samples/data/data_streaming_client.py,sha256=IdCUNdfo2_dR9OLgWZuIc9U9s-0-uNjwqkf9aLoG-44,4088
 samples/data/data_streaming_client_async.py,sha256=o_u1ch8JdbcYnLCvDCCUzO-Z1IG7BUKncu_GB_kCbOs,4443
 samples/order/__init__.py,sha256=eoZ6GfifbqhMLNzjlqRDVil-yyBkOmVN9ujSgJWNBlY,15
@@ -15,8 +15,8 @@ samples/trade/trade_client.py,sha256=LyWSvZJH4ByCkRORqP9WdkXfx65A2b6fhc9_GzL8DOM
 samples/trade/trade_client_v2.py,sha256=IO-zmRiUnCmIetTdiYunPh8jVK2VaPrOR77Dwvz1auY,10771
 samples/trade/trade_client_v3.py,sha256=70f4VJYWcSJP3ppA8mRAoftJqjRTn5GTeGZck8eLCTg,16526
 samples/trade/trade_event_client.py,sha256=uOx9EwFaves2yaTNm13BHpYC0IHXSoBL8BWPbDLeFw4,2469
-webull/__init__.py,sha256=mFFUUCx5TqyW1TTFRrWDhXXVMJDMRxXWrkHanVtp9oY,22
-webull/core/__init__.py,sha256=l5SgEaJNDBxUASBJsNGBJYu3AocnG4Mr89RIOokPiTA,225
+webull/__init__.py,sha256=mg2kb865UYMe9zOkU2VcRPfv-5zzU182OL3t45SXXWk,22
+webull/core/__init__.py,sha256=MSNIk2XHGC6pQer-Z5tjWyHUXb0Wi1O1Vnn93JEPa5A,225
 webull/core/client.py,sha256=OE_ghPA558eE85MmaU_I3Tg0j-osCQFChTk-6dy4OW0,16398
 webull/core/compat.py,sha256=HDis0D271oQ6OCpA7ViX10NJdhfXdoBfzx6nuV3vrnI,3114
 webull/core/headers.py,sha256=7aMt3_YtaL9Yhqj2T1g7ESQgkI78SAXIk7hMX5U5FgE,2019
@@ -186,7 +186,7 @@ webull/core/vendored/requests/packages/urllib3/util/ssl_.py,sha256=aRUKc1WIyS-sU
 webull/core/vendored/requests/packages/urllib3/util/timeout.py,sha256=sAyiBBds7eOk1oM3ulvVMWZiqx1B743puHqK92XwBcY,10325
 webull/core/vendored/requests/packages/urllib3/util/url.py,sha256=_CgqbyNrQWubrv_y5aWhuutz3mnbj1cvTUe4VYbGYWA,7367
 webull/core/vendored/requests/packages/urllib3/util/wait.py,sha256=0FHS8R3OrMU-97XWt8AxuUStkSGXTct9CfOwY_fWn7U,5971
-webull/data/__init__.py,sha256=s8jHH-qZ5jY8Rsk-YS41NY0gFUU5YjdRBlDw0egN2-4,38
+webull/data/__init__.py,sha256=16Et8WoO5VLLeKZR62v51Ah41JMXVyb5jk5AlVyFpvU,38
 webull/data/data_client.py,sha256=JGouoFd37-sxpP6GyOJ0rRw7UuBmXqoIcis0jiRGJPQ,1871
 webull/data/data_streaming_client.py,sha256=hYqrdKTeIB3Xmp7LMjMwN1XE6Y7bKXX0y-lGX1ty6W4,3870
 webull/data/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -200,7 +200,7 @@ webull/data/common/expiration_cycle.py,sha256=f1yyOVBnw8jQX16t_QIhyWgfAsaQn8asjd
 webull/data/common/instrument_status.py,sha256=T8lMZxvhwV-19XprrvbajEfGQ9gaWVjf0p0UASrCxSQ,789
 webull/data/common/option_type.py,sha256=E4lzZJS-6iX167l6b3mMhWUbNVD0joPxwqGL_mnOGRI,705
 webull/data/common/subscribe_type.py,sha256=2EpBsPXCDjx5q25GonbUur2upQFfGvT6dcSYQ3BolyY,745
-webull/data/common/timespan.py,sha256=Mg-dnvIWclVZRhIkjDiGzRlnOK457PWZ8sY5I8NXRBA,938
+webull/data/common/timespan.py,sha256=Yjr35Zjhj6qyW1k_pnXkDjm6fWWZ-vs44F_gMWCYCKU,991
 webull/data/internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/data/internal/default_retry_policy.py,sha256=g94o5LKtbB5XoDiZWHp7yKGOWTTTOT89bz1ZSlT79mI,3307
 webull/data/internal/exceptions.py,sha256=qtInXjns6ce6KQTtJOxz8M4bywuOJe2sNSAwGJqTWDs,1800
@@ -210,9 +210,9 @@ webull/data/internal/quotes_payload_decoder.py,sha256=x2XGYDu4wSdc1LLrcIo3BXeb5j
 webull/data/internal/quotes_topic.py,sha256=kG4RZTjj01U0e54qoOrJHlLrPeBzXekySasm2uoyXVo,1138
 webull/data/quotes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/data/quotes/crypto_market_data.py,sha256=UQlxUz0GntvwcRS-Vh_h7cXbhQ045MqPlG5AhWUoQI4,3063
-webull/data/quotes/futures_market_data.py,sha256=cS_VMbVsqz8JGF1zM3Hc5fQBR-30yoRM30jIw8HBD3A,4131
+webull/data/quotes/futures_market_data.py,sha256=fc9giYNy1LcdLHOJV31zMbPBKtWDH8kBW5xRFgHzQUA,5596
 webull/data/quotes/instrument.py,sha256=4mrL8VEftiPmbEl_7qdpnrgFDuty54tb6C9j_Hh8iME,5089
-webull/data/quotes/market_data.py,sha256=6Md4a30byQiJuglKP0EJW28LCYPCHgJmD1NEAkNocUA,9907
+webull/data/quotes/market_data.py,sha256=5HjzLQje1F7OxasRrjNPZ2d-tkuYJ-aDMZj3fVEO6cI,11329
 webull/data/quotes/market_streaming_data.py,sha256=cI9xxGpKV_KDS8cgh9azHifBji0yeSuKmH7Jxaqij38,3139
 webull/data/quotes/subscribe/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webull/data/quotes/subscribe/ask_bid_result.py,sha256=EWu5dFMb_BwFGYPLe-f9uCD8_Ftl1wguhpU1qXi2zaY,1552
@@ -234,7 +234,9 @@ webull/data/request/get_crypto_historical_bars_request.py,sha256=FKIp2hB2fPbkMLx
 webull/data/request/get_crypto_instruments_request.py,sha256=GwOA9oPBH4qNg7yR-lVjrRSGZDF5zfRUBS4PegKLcjk,1549
 webull/data/request/get_crypto_snapshot_request.py,sha256=W-z9nuBu2RaXqy07zFVHMQs9GP5Hc55vOWWYKoibWVA,1136
 webull/data/request/get_eod_bars_request.py,sha256=CwbyXeAE-iPKu43zNxcekSw5qOlfEwZsztFxCQvAXuQ,1234
+webull/data/request/get_footprint_request.py,sha256=MnbKhhe7QMkKqyTxmXl-ztDl5l_3kkFhT1vtql82K3Y,1664
 webull/data/request/get_futures_depth_request.py,sha256=d6Tl-75pcJlvX6-beAdko15o8hDhdB-486uxH8AeGIk,1083
+webull/data/request/get_futures_footprint_request.py,sha256=I0l-SlXBKqY61Oxq1zn1EWwLY79euuEoUcrvCzPJlA8,1673
 webull/data/request/get_futures_historical_bars_request.py,sha256=QwvJq33wkJ-_KLZutkh3Z55gQyCDTRkCPwc9UyYcvKU,1330
 webull/data/request/get_futures_instruments_by_code_request.py,sha256=9WjmisgOtzSim-3umKu_2NaATPZBFQxU-3HQ-jBHU1U,1319
 webull/data/request/get_futures_instruments_request.py,sha256=3i1B0v0jhQxx3ETN2Jiu-3aoitUWFN6QfwGNnBfK8eo,1136
@@ -248,7 +250,7 @@ webull/data/request/get_snapshot_request.py,sha256=OD2PiaxmBCboFDaU8DFTwvfNd2zOb
 webull/data/request/get_tick_request.py,sha256=rUHhQgC8Z_6ensLyCkg3DDK55SlEi0Bc_dhpCIIspDs,1366
 webull/data/request/subscribe_request.py,sha256=dm93Q5Q4gigAMqAobolaYYSs3wM6QddPUZOjEtJsX-8,1471
 webull/data/request/unsubscribe_request.py,sha256=hQA4mYM64PgmQEA2otl47-3nCXqjsSY_weFA3_wNbMM,1446
-webull/trade/__init__.py,sha256=iCEPnhz-knfGRAO4Ep2uQaYf4xwhPIjjcgAcNjga8kc,21
+webull/trade/__init__.py,sha256=mu4LFHUATfA8gJh1jUgMKeIXEjlhbQqTC5UyMGu-2Gs,21
 webull/trade/trade_client.py,sha256=_6lH4KO-jKgKWU28fWNsc9-KEHto-WvaP0gT96BJ_dw,2184
 webull/trade/trade_events_client.py,sha256=4a7qupeT3dKJRKBQqXNhCai6ENzX6PA4yjTDHHxPR0w,8892
 webull/trade/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -328,9 +330,9 @@ webull/trade/trade/v2/account_info_v2.py,sha256=IGY_BGTrZ0h7yQ_nDodNtmKen9gXW6he
 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=_L10--m_XhoMe8YeYjQXVvRoTAWoRRzLU59UeneyMrU,7428
-webull_openapi_python_sdk-1.0.8.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
-webull_openapi_python_sdk-1.0.8.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
-webull_openapi_python_sdk-1.0.8.dist-info/METADATA,sha256=jcAKegwV60urTKWSWSD1BhcsnEPVUU49Cz22cpSAKU8,702
-webull_openapi_python_sdk-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-webull_openapi_python_sdk-1.0.8.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
-webull_openapi_python_sdk-1.0.8.dist-info/RECORD,,
+webull_openapi_python_sdk-1.0.9.dist-info/licenses/LICENSE,sha256=ALOnsLtb1aHxmDJg3-oMi0BO-i-cjfyZaOBfnnavKMc,11359
+webull_openapi_python_sdk-1.0.9.dist-info/licenses/NOTICE,sha256=X5TApte6CPV10b96Cb70IRLusXmiRmK_R-dB-1tQM_I,2018
+webull_openapi_python_sdk-1.0.9.dist-info/METADATA,sha256=I4Ohkx7rljnJeBfQ0goKx42vBTbF48Kp4aSWQF3xEcM,702
+webull_openapi_python_sdk-1.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+webull_openapi_python_sdk-1.0.9.dist-info/top_level.txt,sha256=h8pEjNDGWS2ZUZ2vYFpUShoMQT0ZRIQaD57QJWD8_aI,15
+webull_openapi_python_sdk-1.0.9.dist-info/RECORD,,