webull-openapi-python-sdk 2.0.13__tar.gz → 2.0.14__tar.gz

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: webull-openapi-python-sdk
-Version: 2.0.13
+Version: 2.0.14
 Summary: Webull Python SDK.
 Home-page: 
 Author: Webull
 Author-email: 
 License: Apache License 2.0
 Platform: any
-Requires-Python: >=3.8,<3.14
+Requires-Python: >=3.8,<3.15
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
@@ -18,11 +18,13 @@ Requires-Dist: urllib3>=2.0
 Requires-Dist: requests>=2.31.0
 Requires-Dist: six>=1.16.0
 Requires-Dist: cryptography<42,>=3.4; python_version < "3.12"
-Requires-Dist: cryptography<43,>=41.0; python_version >= "3.12"
+Requires-Dist: cryptography<43,>=41.0; python_version >= "3.12" and python_version < "3.14"
+Requires-Dist: cryptography<55,>=43.0; python_version >= "3.14"
 Requires-Dist: protobuf<5,>=4.21.12; python_version < "3.12"
 Requires-Dist: protobuf<6,>=4.25.0; python_version >= "3.12"
 Requires-Dist: grpcio<1.60,>=1.51.1; python_version < "3.12"
-Requires-Dist: grpcio<1.70,>=1.60.0; python_version >= "3.12"
+Requires-Dist: grpcio<1.70,>=1.60.0; python_version >= "3.12" and python_version < "3.14"
+Requires-Dist: grpcio<2,>=1.75.1; python_version >= "3.14"
 Dynamic: author
 Dynamic: description-content-type
 Dynamic: license

webull_openapi_python_sdk-2.0.14/samples/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.14'

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/samples/data/data_client.py

@@ -265,6 +265,11 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get_forecast_eps:', res.json())
 
+    # Option Instrument - Query option contracts by underlying symbol and filters
+    res = data_client.instrument.get_option_contracts(Category.US_OPTION.name,"AAPL")
+    if res.status_code == 200:
+        print('get_option_contracts:', res.json())
+
     # Screener - Market Sectors
     res = data_client.screener.get_market_sectors(Category.US_STOCK.name)
     if res.status_code == 200:

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/setup.py

@@ -24,7 +24,8 @@ requires = [
 
     # cryptography
     "cryptography>=3.4,<42; python_version<'3.12'",
-    "cryptography>=41.0,<43; python_version>='3.12'",
+    "cryptography>=41.0,<43; python_version>='3.12' and python_version<'3.14'",
+    "cryptography>=43.0,<55; python_version>='3.14'",
 
     # protobuf
     "protobuf>=4.21.12,<5; python_version<'3.12'",
@@ -32,17 +33,19 @@ requires = [
 
     # grpc
     "grpcio>=1.51.1,<1.60; python_version<'3.12'",
-    "grpcio>=1.60.0,<1.70; python_version>='3.12'"
+    "grpcio>=1.60.0,<1.70; python_version>='3.12' and python_version<'3.14'",
+    "grpcio>=1.75.1,<2; python_version>='3.14'"
 ]
 
 extras_require = {
     "dev": [
-        "grpcio-tools>=1.60,<1.70",
+        "grpcio-tools>=1.60,<1.70; python_version<'3.14'",
+        "grpcio-tools>=1.75.1,<2; python_version>='3.14'",
     ]
 }
 
 setup_args = {
-    'python_requires':'>=3.8,<3.14',
+    'python_requires':'>=3.8,<3.15',
     'version': VERSION,
     'author': AUTHOR,
     'author_email': AUTHOR_EMAIL,

webull_openapi_python_sdk-2.0.14/webull/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.14'

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull/core/__init__.py

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

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull/core/auth/composer/default_signature_composer.py

@@ -59,10 +59,7 @@ def _refresh_sign_headers(host, headers, app_key_id, signer_spec):
     sign_headers[hd.APP_KEY] = app_key_id
     sign_headers[hd.TIMESTAMP] = common.get_iso_8601_date()
 
-    if common.is_not_upgrade_api_host(host):
-        signer_spec = sha_hmac256_new
-    else:
-        signer_spec = sha_hmac1
+    signer_spec = sha_hmac256_new
 
     sign_headers[hd.SIGN_VERSION] = signer_spec.get_signer_version()
     sign_headers[hd.SIGN_ALGORITHM] = signer_spec.get_signer_name()

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull/core/utils/common.py

@@ -16,7 +16,7 @@
 import base64
 import hashlib
 import socket
-from datetime import datetime
+from datetime import datetime, timezone
 import uuid
 import json
 from webull.core.compat import ensure_bytes, ensure_string
@@ -33,21 +33,21 @@ def get_uuid():
 def get_iso_8601_date(dt_as_utc=None):
     if dt_as_utc:
         return dt_as_utc.strftime(FORMAT_ISO_8601)
-    d = datetime.utcnow()
+    d = datetime.now(timezone.utc)
     return d.strftime(FORMAT_ISO_8601)
 
 def get_iso_8601_date_with_millis(dt_as_utc=None):
     if dt_as_utc:
         d = dt_as_utc
     else:
-        d = datetime.utcnow()
+        d = datetime.now(timezone.utc)
     ret = d.strftime(FORMAT_ISO_8601_MILLIS)
     if len(ret) != 27:
         raise RuntimeError("failed to convent timestamp, result: %s" % ret)
     return ret[:-4] + ret[-1:]
 
 def parse_timestamp_to_dt(timestamp_of_millis):
-    return datetime.utcfromtimestamp(timestamp_of_millis / 1000.0)
+    return datetime.fromtimestamp(timestamp_of_millis / 1000.0, tz=timezone.utc).replace(tzinfo=None)
 
 def md5_sum(content):
     content_bytes = ensure_bytes(content)
@@ -63,17 +63,4 @@ def sha256_hex(content):
     return hashlib.sha256(content_bytes).hexdigest()
 
 def json_dumps_compact(content):
-    return json.dumps(content, ensure_ascii=False, separators=(',', ':'))
-
-def is_not_upgrade_api_host(host):
-    upgrade_hosts = {
-        "api.webull.com","events-api.webull.com",
-        "api.webull.hk","events-api.webull.hk",
-        "pre-openapi-us-alb.webullbroker.com","pre-openapi-us-events.webullbroker.com",
-        "pre-openapi-alb.webullbroker.com","pre-openapi-events.webullbroker.com",
-        "us-openapi-alb.uat.webullbroker.com","us-openapi-events.uat.webullbroker.com",
-        "hk-openapi.uat.webullbroker.com", "hk-openapi-events-api.uat.webullbroker.com",
-        "api.sandbox.webull.hk", "events-api.sandbox.webull.hk"
-
-    }
-    return host not in upgrade_hosts
+    return json.dumps(content, ensure_ascii=False, separators=(',', ':'))

webull_openapi_python_sdk-2.0.14/webull/data/__init__.py

@@ -0,0 +1,3 @@
+# coding=utf-8
+
+__version__ = '2.0.14'

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull/data/quotes/instrument.py

@@ -25,6 +25,7 @@ from webull.data.request.get_futures_instruments_request import GetFuturesInstru
 from webull.data.request.get_futures_products_request import GetFuturesProductsRequest
 from webull.data.request.get_futures_instruments_by_code_request import GetFuturesInstrumentsByCodeRequest
 from webull.data.request.get_futures_product_class import GetFuturesProductClassRequest
+from webull.data.request.get_option_contracts_request import GetOptionContractsRequest
 
 
 class Instrument:
@@ -218,6 +219,48 @@ class Instrument:
         response = self.client.get_response(event_instrument_request)
         return response
 
+    def get_option_contracts(self, category=Category.US_OPTION.name, underlying_symbols=None, status=None,
+                               start_date=None, end_date=None, root_symbol=None, option_symbol=None,
+                               option_type=None, style=None, strike_price_gte=None, strike_price_lte=None,
+                               ppind=None, show_deliverables=None, page_size=10, last_instrument_id=None):
+        """
+        Query option contracts list by conditions such as underlying_symbols, status, expiration date, etc.
+
+        :param category: Market category. Value: US_OPTION.
+        :param underlying_symbols: Underlying symbol(s), comma-separated for multiple, e.g. AAPL,MSFT.
+        :param status: Contract status: LISTING (default), DELISTING.
+        :param start_date: Exact expiration date, format YYYY-MM-DD.
+        :param end_date: Expiration date lower bound (inclusive), format YYYY-MM-DD.
+        :param root_symbol: Root symbol filter (series symbol, e.g. SPXW), mainly for index options and non-standard contracts after CA.
+        :param option_symbol: Option symbol, e.g. AAPL250620C00150000.
+        :param option_type: Contract type: CALL / PUT.
+        :param style: Exercise style: AMERICAN / EUROPEAN.
+        :param strike_price_gte: Strike price lower bound (inclusive).
+        :param strike_price_lte: Strike price upper bound (inclusive).
+        :param ppind: Penny Program Indicator: true = Penny Pilot, false = non-Penny Pilot.
+        :param show_deliverables: Whether to return deliverables array in response: true / false, default false.
+        :param page_size: Page size, default 10, max 1000.
+        :param last_instrument_id: Last instrument_id from previous page for pagination.
+        """
+        request = GetOptionContractsRequest()
+        request.set_category(category)
+        request.set_underlying_symbols(underlying_symbols)
+        request.set_status(status)
+        request.set_start_date(start_date)
+        request.set_end_date(end_date)
+        request.set_root_symbol(root_symbol)
+        request.set_option_symbol(option_symbol)
+        request.set_option_type(option_type)
+        request.set_style(style)
+        request.set_strike_price_gte(strike_price_gte)
+        request.set_strike_price_lte(strike_price_lte)
+        request.set_ppind(ppind)
+        request.set_show_deliverables(show_deliverables)
+        request.set_page_size(page_size)
+        request.set_last_instrument_id(last_instrument_id)
+        response = self.client.get_response(request)
+        return response
+
     def get_company_profile(self, symbol, category=Category.US_STOCK.name):
         """
         Get company profile for one instrument.

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull/data/quotes/subscribe/basic_result.py

@@ -13,7 +13,7 @@
 # limitations under the License.
 
 # coding=utf-8
-from datetime import datetime
+from datetime import datetime, timezone
 
 
 class BasicResult:
@@ -33,7 +33,7 @@ class BasicResult:
         return self.timestamp
 
     def get_timestamp_as_utc(self):
-        return datetime.utcfromtimestamp(self.timestamp / 1000.0)
+        return datetime.fromtimestamp(self.timestamp / 1000.0, tz=timezone.utc).replace(tzinfo=None)
 
     def get_trading_session(self):
         return self.trading_session

webull_openapi_python_sdk-2.0.14/webull/data/request/get_option_contracts_request.py

@@ -0,0 +1,82 @@
+# 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 GetOptionContractsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/option/contracts", version="v2", method="GET",
+                           query_params={})
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_underlying_symbols(self, underlying_symbols):
+        if underlying_symbols:
+            self.add_query_param("underlying_symbols", underlying_symbols)
+
+    def set_status(self, status):
+        if status:
+            self.add_query_param("status", status)
+
+    def set_start_date(self, start_date):
+        if start_date:
+            self.add_query_param("start_date", start_date)
+
+    def set_end_date(self, end_date):
+        if end_date:
+            self.add_query_param("end_date", end_date)
+
+    def set_root_symbol(self, root_symbol):
+        if root_symbol:
+            self.add_query_param("root_symbol", root_symbol)
+
+    def set_option_symbol(self, option_symbol):
+        if option_symbol:
+            self.add_query_param("option_symbol", option_symbol)
+
+    def set_option_type(self, option_type):
+        if option_type:
+            self.add_query_param("option_type", option_type)
+
+    def set_style(self, style):
+        if style:
+            self.add_query_param("style", style)
+
+    def set_strike_price_gte(self, strike_price_gte):
+        if strike_price_gte is not None:
+            self.add_query_param("strike_price_gte", strike_price_gte)
+
+    def set_strike_price_lte(self, strike_price_lte):
+        if strike_price_lte is not None:
+            self.add_query_param("strike_price_lte", strike_price_lte)
+
+    def set_ppind(self, ppind):
+        if ppind is not None:
+            self.add_query_param("ppind", ppind)
+
+    def set_show_deliverables(self, show_deliverables):
+        if show_deliverables is not None:
+            self.add_query_param("show_deliverables", show_deliverables)
+
+    def set_page_size(self, page_size):
+        if page_size:
+            self.add_query_param("page_size", page_size)
+
+    def set_last_instrument_id(self, last_instrument_id):
+        if last_instrument_id:
+            self.add_query_param("last_instrument_id", last_instrument_id)

webull_openapi_python_sdk-2.0.14/webull/trade/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.0.14'

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull/trade/trade_events_client.py

@@ -80,10 +80,7 @@ class TradeEventsClient():
             timestamp=int(time.time() * 1000),  # millis
             accounts=accounts,
         )
-        if common.is_not_upgrade_api_host(self._host):
-            signer_spec = sha_hmac256_new
-        else:
-            signer_spec = sha_hmac1
+        signer_spec = sha_hmac256_new
 
         signature, metadata = calc_signature(app_key, app_secret, request, signer_spec)
         

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull_openapi_python_sdk.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: webull-openapi-python-sdk
-Version: 2.0.13
+Version: 2.0.14
 Summary: Webull Python SDK.
 Home-page: 
 Author: Webull
 Author-email: 
 License: Apache License 2.0
 Platform: any
-Requires-Python: >=3.8,<3.14
+Requires-Python: >=3.8,<3.15
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
@@ -18,11 +18,13 @@ Requires-Dist: urllib3>=2.0
 Requires-Dist: requests>=2.31.0
 Requires-Dist: six>=1.16.0
 Requires-Dist: cryptography<42,>=3.4; python_version < "3.12"
-Requires-Dist: cryptography<43,>=41.0; python_version >= "3.12"
+Requires-Dist: cryptography<43,>=41.0; python_version >= "3.12" and python_version < "3.14"
+Requires-Dist: cryptography<55,>=43.0; python_version >= "3.14"
 Requires-Dist: protobuf<5,>=4.21.12; python_version < "3.12"
 Requires-Dist: protobuf<6,>=4.25.0; python_version >= "3.12"
 Requires-Dist: grpcio<1.60,>=1.51.1; python_version < "3.12"
-Requires-Dist: grpcio<1.70,>=1.60.0; python_version >= "3.12"
+Requires-Dist: grpcio<1.70,>=1.60.0; python_version >= "3.12" and python_version < "3.14"
+Requires-Dist: grpcio<2,>=1.75.1; python_version >= "3.14"
 Dynamic: author
 Dynamic: description-content-type
 Dynamic: license

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull_openapi_python_sdk.egg-info/SOURCES.txt

@@ -201,6 +201,7 @@ webull/data/request/get_instruments_request.py
 webull/data/request/get_noii_bars_request.py
 webull/data/request/get_noii_snapshot_request.py
 webull/data/request/get_option_bars_request.py
+webull/data/request/get_option_contracts_request.py
 webull/data/request/get_option_snapshot_request.py
 webull/data/request/get_option_tick_request.py
 webull/data/request/get_quotes_request.py

{webull_openapi_python_sdk-2.0.13 → webull_openapi_python_sdk-2.0.14}/webull_openapi_python_sdk.egg-info/requires.txt

@@ -11,6 +11,12 @@ protobuf<5,>=4.21.12
 grpcio<1.60,>=1.51.1
 
 [:python_version >= "3.12"]
-cryptography<43,>=41.0
 protobuf<6,>=4.25.0
+
+[:python_version >= "3.12" and python_version < "3.14"]
+cryptography<43,>=41.0
 grpcio<1.70,>=1.60.0
+
+[:python_version >= "3.14"]
+cryptography<55,>=43.0
+grpcio<2,>=1.75.1

webull_openapi_python_sdk-2.0.13/samples/__init__.py

@@ -1 +0,0 @@
-__version__ = '2.0.13'

webull_openapi_python_sdk-2.0.13/webull/__init__.py

@@ -1 +0,0 @@
-__version__ = '2.0.13'

webull_openapi_python_sdk-2.0.13/webull/data/__init__.py

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

webull_openapi_python_sdk-2.0.13/webull/trade/__init__.py

@@ -1 +0,0 @@
-__version__ = '2.0.13'