webull-openapi-python-sdk 1.0.0__py3-none-any.whl

webull/trade/common/trading_date_type.py

@@ -0,0 +1,24 @@
+# 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.
+
+from webull.core.common.easy_enum import EasyEnum
+
+
+class TradingDateType(EasyEnum):
+
+    # Full day
+    FULL_DAY = (1, "FULL_DAY")
+
+    # Half day
+    HALF_DAY = (2, "HALF_DAY")

webull/trade/common/trailing_type.py

@@ -0,0 +1,23 @@
+# 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.common.easy_enum import EasyEnum
+
+
+class TrailingType(EasyEnum):
+    PERCENTAGE = (1, "PERCENTAGE")
+    AMOUNT = (2, "AMOUNT")
+
+

webull/trade/events/default_retry_policy.py

@@ -0,0 +1,64 @@
+# 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
+import grpc
+from webull.core.retry.retry_policy import RetryPolicy
+from webull.core.retry.backoff_strategy import FixedDelayStrategy
+from webull.core.retry.retry_condition import RetryCondition, MaxRetryTimesCondition, MergeRetryCondition
+from webull.core.retry.retry_policy_context import RetryPolicyContext
+
+class SubscribeRetryPolicyContext(RetryPolicyContext):
+    def __init__(self, exception, retries_attempted, grpc_status_code):
+        super().__init__(None, exception, retries_attempted, None)
+        self.grpc_status_code = grpc_status_code
+
+    def __str__(self):
+        return "exception:%s, retries:%s, grpc_status_code:%s" % (self.exception, self.retries_attempted, self.grpc_status_code)
+
+class RetryOnGrpcStatusCondition(RetryCondition):
+    DEFAULT_RETRYABLE_GRPC_STATUS_LIST = [
+        grpc.StatusCode.UNAVAILABLE,
+        grpc.StatusCode.INTERNAL,
+        grpc.StatusCode.UNKNOWN
+    ]
+
+    def __init__(self, retryable_grpc_status_list=None):
+        if retryable_grpc_status_list:
+            self.retryable_grpc_status_list = retryable_grpc_status_list
+        else:
+            self.retryable_grpc_status_list = self.DEFAULT_RETRYABLE_GRPC_STATUS_LIST
+
+    def should_retry(self, retry_policy_context):
+        if retry_policy_context.grpc_status_code in self.retryable_grpc_status_list:
+            return RetryCondition.RETRY
+        else:
+            return RetryCondition.NO_RETRY
+
+class DefaultSubscribeRetryCondition(RetryCondition):
+    def __init__(self, max_retry_times=-1):
+        RetryCondition.__init__(self) 
+        if max_retry_times < 0:
+            _conditions = []
+        else:
+            _conditions = [MaxRetryTimesCondition(max_retry_times)]
+        _conditions.append(RetryOnGrpcStatusCondition())
+        self._condition = MergeRetryCondition(_conditions)
+
+    def should_retry(self, retry_policy_context):
+        return self._condition.should_retry(retry_policy_context)
+            
+class DefaultSubscribeRetryPolicy(RetryPolicy):
+    def __init__(self, max_retry_times=-1, fixed_delay=5000):
+        RetryPolicy.__init__(self, DefaultSubscribeRetryCondition(max_retry_times), FixedDelayStrategy(fixed_delay))

webull/trade/events/events_pb2.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 google.protobuf.internal import builder as _builder
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x0c\x65vents.proto\x12\x10grpc.trade.event\"t\n\x10SubscribeRequest\x12\x15\n\rsubscribeType\x18\x01 \x01(\r\x12\x11\n\ttimestamp\x18\x02 \x01(\x03\x12\x13\n\x0b\x63ontentType\x18\x03 \x01(\t\x12\x0f\n\x07payload\x18\x04 \x01(\t\x12\x10\n\x08\x61\x63\x63ounts\x18\x05 \x03(\t\"\xa6\x01\n\x11SubscribeResponse\x12.\n\teventType\x18\x01 \x01(\x0e\x32\x1b.grpc.trade.event.EventType\x12\x15\n\rsubscribeType\x18\x02 \x01(\r\x12\x13\n\x0b\x63ontentType\x18\x03 \x01(\t\x12\x0f\n\x07payload\x18\x04 \x01(\t\x12\x11\n\trequestId\x18\x05 \x01(\t\x12\x11\n\ttimestamp\x18\x06 \x01(\x03*e\n\tEventType\x12\x14\n\x10SubscribeSuccess\x10\x00\x12\x08\n\x04Ping\x10\x01\x12\r\n\tAuthError\x10\x02\x12\x13\n\x0fNumOfConnExceed\x10\x03\x12\x14\n\x10SubscribeExpired\x10\x04\x32h\n\x0c\x45ventService\x12X\n\tSubscribe\x12\".grpc.trade.event.SubscribeRequest\x1a#.grpc.trade.event.SubscribeResponse\"\x00\x30\x01\x62\x06proto3')
+
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'events_pb2', globals())
+if _descriptor._USE_C_DESCRIPTORS == False:
+
+  DESCRIPTOR._options = None
+  _EVENTTYPE._serialized_start=321
+  _EVENTTYPE._serialized_end=422
+  _SUBSCRIBEREQUEST._serialized_start=34
+  _SUBSCRIBEREQUEST._serialized_end=150
+  _SUBSCRIBERESPONSE._serialized_start=153
+  _SUBSCRIBERESPONSE._serialized_end=319
+  _EVENTSERVICE._serialized_start=424
+  _EVENTSERVICE._serialized_end=528
+# @@protoc_insertion_point(module_scope)

webull/trade/events/events_pb2_grpc.py

@@ -0,0 +1,66 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+import webull.trade.events.events_pb2 as events__pb2
+
+
+class EventServiceStub(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.Subscribe = channel.unary_stream(
+                '/grpc.trade.event.EventService/Subscribe',
+                request_serializer=events__pb2.SubscribeRequest.SerializeToString,
+                response_deserializer=events__pb2.SubscribeResponse.FromString,
+                )
+
+
+class EventServiceServicer(object):
+    """Missing associated documentation comment in .proto file."""
+
+    def Subscribe(self, request, context):
+        """Missing associated documentation comment in .proto file."""
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_EventServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'Subscribe': grpc.unary_stream_rpc_method_handler(
+                    servicer.Subscribe,
+                    request_deserializer=events__pb2.SubscribeRequest.FromString,
+                    response_serializer=events__pb2.SubscribeResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'grpc.trade.event.EventService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+
+
+ # This class is part of an EXPERIMENTAL API.
+class EventService(object):
+    """Missing associated documentation comment in .proto file."""
+
+    @staticmethod
+    def Subscribe(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_stream(request, target, '/grpc.trade.event.EventService/Subscribe',
+            events__pb2.SubscribeRequest.SerializeToString,
+            events__pb2.SubscribeResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)

webull/trade/events/signature_composer.py

@@ -0,0 +1,61 @@
+# 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 asyncio.log import logger
+from webull.core.auth.algorithm import sha_hmac1
+from webull.core.auth.composer import default_signature_composer
+import webull.core.headers as hd
+import webull.core.utils.common as core_common
+import logging
+logger = logging.getLogger(__name__)
+
+def _build_sign_metadata(app_key_id, signer_spec=sha_hmac1):
+    sign_params = {}
+    sign_algorithm = signer_spec.get_signer_name()
+    sign_version = signer_spec.get_signer_version()
+    nonce = core_common.get_uuid()
+    ts = core_common.get_iso_8601_date() 
+    metadata = [
+        (hd.APP_KEY, app_key_id),
+        (hd.SIGN_ALGORITHM, sign_algorithm),
+        (hd.SIGN_VERSION, sign_version),
+        (hd.NONCE, nonce),
+        (hd.TIMESTAMP, ts)
+    ]
+    sign_params[hd.APP_KEY] = app_key_id
+    sign_params[hd.SIGN_ALGORITHM] = sign_algorithm
+    sign_params[hd.SIGN_VERSION] = sign_version
+    sign_params[hd.NONCE] = nonce
+    sign_params[hd.TIMESTAMP] = ts
+    return metadata, sign_params
+
+def _get_body_string(pb_object):
+    if pb_object:
+        pb_object_bytes = pb_object.SerializeToString()
+        return core_common.md5_hex(pb_object_bytes)
+    return None
+    
+def calc_signature(app_key_id, app_key_secret, pb_object, signer_spec=sha_hmac1):
+    metadata, sign_params = _build_sign_metadata(app_key_id, signer_spec)
+    sign_params = default_signature_composer._lower_key_dict(sign_params)
+    logger.debug("sign_params:%s", sign_params)
+    body_string = _get_body_string(pb_object)
+    logger.debug("body_string:%s" % body_string) 
+    string_to_sign = default_signature_composer._build_sign_string(sign_params, None, body_string)
+    logger.debug("string_to_sign:%s" % string_to_sign)
+    signature = default_signature_composer._gen_signature(string_to_sign, app_key_secret, signer_spec)
+    metadata.append((hd.SIGNATURE, signature))
+    logger.debug("signature:%s", signature)
+    return signature, metadata

webull/trade/events/types.py

@@ -0,0 +1,21 @@
+# 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
+
+EVENT_TYPE_ORDER = 1024
+EVENT_TYPE_POSITION = 1025
+
+ORDER_STATUS_CHANGED = 1
+POSITION_STATUS_CHANGED = 2

webull/trade/request/cancel_order_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 CancelOrderRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/order/cancel", version='v2', method="POST", body_params={})
+
+    def set_account_id(self, account_id):
+        self.add_body_params("account_id", account_id)
+
+    def set_client_order_id(self, client_order_id):
+        self.add_body_params("client_order_id", client_order_id)
+        

webull/trade/request/get_account_balance_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 AccountBalanceRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/account/balance", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_total_asset_currency(self, total_asset_currency="HKD"):
+        self.add_query_param("total_asset_currency", total_asset_currency)
+        

webull/trade/request/get_account_positions_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 AccountPositionsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/account/positions", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_page_size(self, page_size):
+        self.add_query_param("page_size", page_size)
+
+    def set_last_instrument_id(self, last_instrument_id):
+        self.add_query_param("last_instrument_id", last_instrument_id)

webull/trade/request/get_account_profile_request.py

@@ -0,0 +1,26 @@
+# 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 AccountProfileRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/account/profile", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+        

webull/trade/request/get_app_subscriptions.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 GetAppSubscriptions(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/app/subscriptions/list", version='v2', method="GET", query_params={})
+
+    def set_subscription_id(self, subscription_id=None):
+        if subscription_id:
+            self.add_query_param("subscription_id", subscription_id)
+
+
+        

webull/trade/request/get_open_orders_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 OpenOrdersListRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/orders/list-open", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_page_size(self, page_size):
+        self.add_query_param("page_size", page_size)
+
+    def set_last_client_order_id(self, last_client_order_id):
+        self.add_query_param("last_client_order_id", last_client_order_id)

webull/trade/request/get_order_detail_request.py

@@ -0,0 +1,27 @@
+# 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 OrderDetailRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/order/detail", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param('account_id', account_id)
+
+    def set_client_order_id(self, client_order_id):
+        self.add_query_param("client_order_id", client_order_id)

webull/trade/request/get_today_orders_request.py

@@ -0,0 +1,31 @@
+# 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 TodayOrdersListRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/orders/list-today", version='v2', method="GET", query_params={})
+
+    def set_account_id(self, account_id):
+        self.add_query_param("account_id", account_id)
+
+    def set_page_size(self, page_size):
+        self.add_query_param("page_size", page_size)
+
+    def set_last_client_order_id(self, last_client_order_id):
+        self.add_query_param("last_client_order_id", last_client_order_id)
+        

webull/trade/request/get_trade_calendar_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 TradeCalendarRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/calendar", version='v2', method="GET", query_params={})
+
+    def set_market(self, market):
+        self.add_query_param("market", market)
+
+    def set_start(self, start):
+        self.add_query_param("start", start)
+
+    def set_end(self, end):
+        self.add_query_param("end", end)

webull/trade/request/get_trade_instrument_detail_request.py

@@ -0,0 +1,24 @@
+# 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 TradeInstrumentDetailRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/instrument", version='v2', method="GET", query_params={})
+
+    def set_instrument_id(self, instrument_id):
+        self.add_query_param("instrument_id", instrument_id)

webull/trade/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 webull.core.request import ApiRequest
+
+
+class TradeSecurityDetailRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/trade/security", version='v2', 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)