feat:added security information interfaces

Author: kim2pawn

webull-python-sdk-core/webullsdkcore/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.1.6"
+__version__ = "0.1.7"
 
 import logging
 

webull-python-sdk-demos/setup.py

@@ -15,8 +15,8 @@
     LONG_DESCRIPTION = fp.read()
 
 requires = [
-    "webull-python-sdk-mdata==0.1.6",
-    "webull-python-sdk-trade==0.1.6"
+    "webull-python-sdk-mdata==0.1.7",
+    "webull-python-sdk-trade==0.1.7"
 ]
 
 setup_args = {

webull-python-sdk-demos/tests/trade/test_api.py

@@ -18,6 +18,9 @@
 from webullsdkcore.client import ApiClient
 from webullsdkmdata.common.category import Category
 from webullsdktrade.api import API
+from webullsdktrade.common.markets import Markets
+from webullsdktrade.common.instrument_type import InstrumentType
+
 
 optional_api_endpoint = "<api_endpoint>"
 your_app_key = "<your_app_key>"
@@ -48,6 +51,9 @@ def test_api(self):
         if res.status_code == 200:
             print(res.json())
         res = api.trade_instrument.get_trade_instrument_detail("913244615")
+        if res.status_code == 200:
+            print(res.json())
+        res = api.trade_instrument.get_trade_security_detail("SPX", Markets.US.name, "OPTION", InstrumentType.CALL_OPTION.name, "3400", "2024-12-20")
         if res.status_code == 200:
             print(res.json())
         res = api.market_data.get_snapshot('AAPL', 'US_STOCK')

webull-python-sdk-mdata/setup.py

@@ -15,8 +15,8 @@
     LONG_DESCRIPTION = fp.read()
 
 requires = [
-    "webull-python-sdk-core==0.1.6",
-    "webull-python-sdk-quotes-core==0.1.6"
+    "webull-python-sdk-core==0.1.7",
+    "webull-python-sdk-quotes-core==0.1.7"
 ]
 
 setup_args = {

webull-python-sdk-mdata/webullsdkmdata/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '0.1.6'
+__version__ = '0.1.7'

webull-python-sdk-quotes-core/setup.py

@@ -24,7 +24,7 @@
     "grpcio==1.51.1",
     "grpcio-tools==1.51.1",
     "protobuf==4.21.12",
-    "webull-python-sdk-core==0.1.6"
+    "webull-python-sdk-core==0.1.7"
 ]
 
 setup_args = {

webull-python-sdk-quotes-core/webullsdkquotescore/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.6"
+__version__ = "0.1.7"

webull-python-sdk-trade-events-core/setup.py

@@ -23,7 +23,7 @@
     "grpcio==1.51.1",
     "grpcio-tools==1.51.1",
     "protobuf==4.21.12",
-    "webull-python-sdk-core==0.1.6"
+    "webull-python-sdk-core==0.1.7"
 ]
 
 setup_args = {

webull-python-sdk-trade-events-core/webullsdktradeeventscore/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.6"
+__version__ = "0.1.7"

webull-python-sdk-trade/setup.py

@@ -15,8 +15,8 @@
     LONG_DESCRIPTION = fp.read()
 
 requires = [
-    "webull-python-sdk-trade-events-core==0.1.6",
-    "webull-python-sdk-core==0.1.6"
+    "webull-python-sdk-trade-events-core==0.1.7",
+    "webull-python-sdk-core==0.1.7"
 ]
 
 setup_args = {

webull-python-sdk-trade/webullsdktrade/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "0.1.6"
+__version__ = "0.1.7"
 

webull-python-sdk-trade/webullsdktrade/common/instrument_type.py

@@ -23,3 +23,5 @@ class InstrumentType(EasyEnum):
     UNIT = (3, "UNIT")
     WARRANT = (4, "WARRANT")
     RIGHT = (5, "RIGHT")
+    CALL_OPTION = (6, "CALL_OPTION")
+    PUT_OPTION = (7, "PUT_OPTION")

webull-python-sdk-trade/webullsdktrade/request/get_trade_security_detail_request.py

@@ -0,0 +1,42 @@
+# 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 webullsdkcore.request import ApiRequest
+
+
+class TradeSecurityDetailRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/security", version='v1', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_symbol(self, symbol):
+        self.add_query_param("symbol", symbol)
+
+    def set_market(self, market):
+        self.add_query_param("market", market)
+
+    def set_instrument_super_type(self, instrument_super_type):
+        self.add_query_param("instrument_super_type", instrument_super_type)
+
+    def set_instrument_type(self, instrument_type):
+        self.add_query_param("instrument_type", instrument_type)
+
+    def set_strike_price(self, strike_price):
+        self.add_query_param("strike_price", strike_price)
+
+    def set_init_exp_date(self, init_exp_date):
+        self.add_query_param("init_exp_date", init_exp_date)

webull-python-sdk-trade/webullsdktrade/trade/trade_instrument.py

@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 from webullsdktrade.request.get_trade_instrument_detail_request import TradeInstrumentDetailRequest
+from webullsdktrade.request.get_trade_security_detail_request import TradeSecurityDetailRequest
 
 
 class TradeInstrument:
@@ -29,3 +30,24 @@ def get_trade_instrument_detail(self, instrument_id):
         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