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

webull/data/quotes/market_streaming_data.py

@@ -0,0 +1,66 @@
+# 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.data.request.subscribe_request import SubscribeRequest
+from webull.data.request.unsubscribe_request import UnsubcribeRequest
+
+
+class MarketDataStreaming:
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def subscribe(self, session_id, symbols, category, sub_types, depth=None, overnight_required=None):
+        """
+       Real-time quotes unsubscribe interface is subscribed to real-time quotes pushes according to symbol and data type.
+
+       :param session_id: Create the sessionId used for the connection
+       :param symbols: Such as: [AAPL,TSLA]
+       :param category: Security type, enumeration
+       :param sub_types: Unsubscribe data type, such as: [SNAPSHOT]、SubType Required when unsubscribe_all is empty
+        or not true
+       :param depth: Level 2 subscription levels.
+        10 levels by default, up to 50 levels for U.S. stocks.
+       :param overnight_required: Whether to include the night session, the default is not included
+       """
+        request = SubscribeRequest()
+        request.set_session_id(session_id)
+        request.set_symbols(symbols)
+        request.set_category(category)
+        request.set_sub_types(sub_types)
+        request.set_depth(depth)
+        request.set_overnight_required(overnight_required)
+        response = self.client.get_response(request)
+        return response
+
+    def unsubscribe(self, session_id, symbols=None, category=None, sub_types=None, unsubscribe_all=False):
+        """
+        Real-time quotes unsubscribe interface is subscribed to real-time quotes pushes according to symbol and data type.
+        When unsubscribing from the interface, you get no result returned if it succeeds, and Error is returned if it fails.
+
+        :param session_id: Create the sessionId used for the connection
+        :param symbols: Such as: [AAPL,TSLA]
+        :param category: Security type, enumeration
+        :param sub_types: Unsubscribe data type, such as: [SNAPSHOT]、SubType Required when unsubscribe_all is empty
+         or not true
+        :param unsubscribe_all: boolean false (true means canceling all real-time market subscriptions.
+         When unsubscribe_all is true, symbols, category, sub_types can be empty)
+        """
+        request = UnsubcribeRequest()
+        request.set_session_id(session_id)
+        request.set_symbols(symbols)
+        request.set_category(category)
+        request.set_sub_types(sub_types)
+        request.set_unsubscribe_all(unsubscribe_all)
+        response = self.client.get_response(request)
+        return response

webull/data/quotes/subscribe/ask_bid_result.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.
+
+from decimal import Decimal
+from webull.data.quotes.subscribe.order_result import Order
+from webull.data.quotes.subscribe.broker_result import Broker
+
+
+class AskBidResult:
+    def __init__(self, ask_bid):
+        self.price = Decimal(ask_bid.price) if ask_bid.price else None
+        self.size = ask_bid.size
+        self.order = []
+        if ask_bid.order:
+            for order in ask_bid.order:
+                self.order.append(Order(order))
+        self.broker = []
+        if ask_bid.broker:
+            for broker in ask_bid.broker:
+                self.broker.append(Broker(broker))
+
+    def get_price(self):
+        return self.price
+
+    def get_size(self):
+        return self.size
+
+    def get_order(self):
+        return self.order
+
+    def get_broker(self):
+        return self.broker
+
+    def __repr__(self):
+        return "price:%s,size:%s,order:%s,broker:%s" % (self.price, self.size, self.order, self.broker)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/quotes/subscribe/basic_result.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 datetime import datetime
+
+
+class BasicResult:
+    def __init__(self, pb_basic):
+        self.symbol = pb_basic.symbol
+        self.instrument_id = pb_basic.instrument_id
+        self.timestamp = int(pb_basic.timestamp)
+        self.trading_session = pb_basic.trading_session
+
+    def get_symbol(self):
+        return self.symbol
+
+    def get_instrument_id(self):
+        return self.instrument_id
+
+    def get_timestmap(self):
+        return self.timestamp
+
+    def get_timestamp_as_utc(self):
+        return datetime.utcfromtimestamp(self.timestamp / 1000.0)
+
+    def get_trading_session(self):
+        return self.trading_session
+
+    def __repr__(self):
+        return "symbol:%s,instrument_id:%s,timestamp:%d,trading_session:%s" % (self.symbol, self.instrument_id, self.timestamp, self.trading_session)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/quotes/subscribe/broker_result.py

@@ -0,0 +1,33 @@
+# 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 decimal import Decimal
+
+
+class Broker:
+    def __init__(self, pb_broker):
+        self.bid = Decimal(pb_broker.bid) if pb_broker.bid else None
+        self.name = pb_broker.name if pb_broker.name else None
+
+    def get_bid(self):
+        return self.bid
+
+    def get_name(self):
+        return self.name
+
+    def __repr__(self):
+        return "name:%s,bid:%s" % (self.name, self.bid)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/quotes/subscribe/message_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: message.proto
+"""Generated protocol buffer code."""
+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\rmessage.proto\"Z\n\x05\x42\x61sic\x12\x0e\n\x06symbol\x18\x01 \x01(\t\x12\x15\n\rinstrument_id\x18\x02 \x01(\t\x12\x11\n\ttimestamp\x18\x03 \x01(\t\x12\x17\n\x0ftrading_session\x18\x04 \x01(\t\"\xb6\x01\n\x08Snapshot\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x12\n\ntrade_time\x18\x02 \x01(\t\x12\r\n\x05price\x18\x03 \x01(\t\x12\x0c\n\x04open\x18\x04 \x01(\t\x12\x0c\n\x04high\x18\x05 \x01(\t\x12\x0b\n\x03low\x18\x06 \x01(\t\x12\x11\n\tpre_close\x18\x07 \x01(\t\x12\x0e\n\x06volume\x18\x08 \x01(\t\x12\x0e\n\x06\x63hange\x18\t \x01(\t\x12\x14\n\x0c\x63hange_ratio\x18\n \x01(\t\"L\n\x05Quote\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x15\n\x04\x61sks\x18\x02 \x03(\x0b\x32\x07.AskBid\x12\x15\n\x04\x62ids\x18\x03 \x03(\x0b\x32\x07.AskBid\"X\n\x04Tick\x12\x15\n\x05\x62\x61sic\x18\x01 \x01(\x0b\x32\x06.Basic\x12\x0c\n\x04time\x18\x02 \x01(\t\x12\r\n\x05price\x18\x03 \x01(\t\x12\x0e\n\x06volume\x18\x04 \x01(\t\x12\x0c\n\x04side\x18\x05 \x01(\t\"U\n\x06\x41skBid\x12\r\n\x05price\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\x12\x15\n\x05order\x18\x03 \x03(\x0b\x32\x06.Order\x12\x17\n\x06\x62roker\x18\x04 \x03(\x0b\x32\x07.Broker\"#\n\x05Order\x12\x0c\n\x04mpid\x18\x01 \x01(\t\x12\x0c\n\x04size\x18\x02 \x01(\t\"#\n\x06\x42roker\x12\x0b\n\x03\x62id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\tb\x06proto3')
+
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'message_pb2', globals())
+if _descriptor._USE_C_DESCRIPTORS == False:
+
+  DESCRIPTOR._options = None
+  _BASIC._serialized_start=17
+  _BASIC._serialized_end=107
+  _SNAPSHOT._serialized_start=110
+  _SNAPSHOT._serialized_end=292
+  _QUOTE._serialized_start=294
+  _QUOTE._serialized_end=370
+  _TICK._serialized_start=372
+  _TICK._serialized_end=460
+  _ASKBID._serialized_start=462
+  _ASKBID._serialized_end=547
+  _ORDER._serialized_start=549
+  _ORDER._serialized_end=584
+  _BROKER._serialized_start=586
+  _BROKER._serialized_end=621
+# @@protoc_insertion_point(module_scope)

webull/data/quotes/subscribe/order_result.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.
+
+class Order:
+    def __init__(self, order):
+        self.mpid = order.mpid
+        self.size = order.size
+
+    def get_mpid(self):
+        return self.mpid
+
+    def get_size(self):
+        return self.size
+
+    def __repr__(self):
+        return "mpid:%s,size:%s" % (self.mpid, self.size)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/quotes/subscribe/payload_type.py

@@ -0,0 +1,19 @@
+# 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
+
+PAYLOAD_TYPE_QUOTE = 'quote'
+PAYLOAD_TYPE_SHAPSHOT = 'snapshot'
+PAYLOAD_TYPE_TICK = 'tick'

webull/data/quotes/subscribe/quote_decoder.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.data.quotes.subscribe.message_pb2 import Quote
+from webull.data.quotes.subscribe.quote_result import QuoteResult
+from webull.data.internal.quotes_payload_decoder import BaseQuotesPayloadDecoder
+
+class QuoteDecoder(BaseQuotesPayloadDecoder):
+    def __init__(self):
+        super().__init__()
+
+    def parse(self, payload):
+        quote = Quote()
+        quote.ParseFromString(payload)
+        return QuoteResult(quote)

webull/data/quotes/subscribe/quote_result.py

@@ -0,0 +1,47 @@
+# 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 decimal import Decimal
+from webull.data.quotes.subscribe.basic_result import BasicResult
+from webull.data.quotes.subscribe.ask_bid_result import AskBidResult
+
+
+class QuoteResult:
+    def __init__(self, pb_quote):
+        self.basic = BasicResult(pb_quote.basic)
+        self.asks = []
+        if pb_quote.asks:
+            for ask in pb_quote.asks:
+                self.asks.append(AskBidResult(ask))
+        self.bids = []
+        if pb_quote.bids:
+            for bid in pb_quote.bids:
+                self.bids.append(AskBidResult(bid))
+
+    def get_basic(self):
+        return self.basic
+
+    def get_asks(self):
+        return self.asks
+
+    def get_bids(self):
+        return self.bids
+
+    def __repr__(self):
+        return "basic: %s,asks: %s,bids:%s" % (self.basic, self.asks, self.bids)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/quotes/subscribe/snapshot_decoder.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.data.quotes.subscribe.message_pb2 import Snapshot
+from webull.data.quotes.subscribe.snapshot_result import SnapshotResult
+from webull.data.internal.quotes_payload_decoder import BaseQuotesPayloadDecoder
+
+
+
+class SnapshotDecoder(BaseQuotesPayloadDecoder):
+    def __init__(self):
+        super().__init__()
+
+    def parse(self, payload):
+        snapshot = Snapshot()
+        snapshot.ParseFromString(payload)
+        return SnapshotResult(snapshot)

webull/data/quotes/subscribe/snapshot_result.py

@@ -0,0 +1,69 @@
+# 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 decimal import Decimal
+from webull.data.quotes.subscribe.basic_result import BasicResult
+
+
+class SnapshotResult:
+    def __init__(self, pb_snapshot):
+        self.basic = BasicResult(pb_snapshot.basic)
+        self.open = Decimal(pb_snapshot.open) if pb_snapshot.open else None
+        self.high = Decimal(pb_snapshot.high) if pb_snapshot.high else None
+        self.low = Decimal(pb_snapshot.low) if pb_snapshot.low else None
+        self.price = Decimal(pb_snapshot.price) if pb_snapshot.price else None
+        self.pre_close = Decimal(
+            pb_snapshot.pre_close) if pb_snapshot.pre_close else None
+        self.volume = Decimal(
+            pb_snapshot.volume) if pb_snapshot.volume else None
+        self.change = Decimal(
+            pb_snapshot.change) if pb_snapshot.change else None
+        self.change_ratio = Decimal(
+            pb_snapshot.change_ratio) if pb_snapshot.change_ratio else None
+
+    def get_basic(self):
+        return self.basic
+
+    def get_open(self):
+        return self.open
+
+    def get_high(self):
+        return self.high
+
+    def get_low(self):
+        return self.low
+
+    def get_price(self):
+        return self.price
+
+    def get_pre_close(self):
+        return self.pre_close
+
+    def get_volume(self):
+        return self.volume
+
+    def get_change(self):
+        return self.change
+
+    def get_change_ratio(self):
+        return self.change_ratio
+
+    def __repr__(self):
+        return "%s, open:%s, high:%s, low:%s, price:%s, pre_close:%s, volume:%s, change:%s, change_ratio:%s" \
+            % (self.basic, self.open, self.high, self.low, self.price, self.pre_close, self.volume, self.change, self.change_ratio)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/quotes/subscribe/tick_decoder.py

@@ -0,0 +1,29 @@
+# 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.data.quotes.subscribe.message_pb2 import Tick
+from webull.data.quotes.subscribe.tick_result import TickResult
+from webull.data.internal.quotes_payload_decoder import BaseQuotesPayloadDecoder
+
+
+class TickDecoder(BaseQuotesPayloadDecoder):
+    def __init__(self):
+        super().__init__()
+
+    def parse(self, payload):
+        tick = Tick()
+        tick.ParseFromString(payload)
+        return TickResult(tick)

webull/data/quotes/subscribe/tick_result.py

@@ -0,0 +1,47 @@
+# 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 decimal import Decimal
+from webull.data.quotes.subscribe.basic_result import BasicResult
+
+
+class TickResult:
+    def __init__(self, pb_tick):
+        self.basic = BasicResult(pb_tick.basic)
+        self.time = pb_tick.time
+        self.price = Decimal(pb_tick.price) if pb_tick.price else None
+        self.volume = pb_tick.volume if pb_tick.volume else None
+        self.side = pb_tick.side if pb_tick.side else None
+
+    def get_basic(self):
+        return self.basic
+
+    def get_price(self):
+        return self.price
+
+    def get_volume(self):
+        return self.volume
+
+    def get_time(self):
+        return self.time
+
+    def get_side(self):
+        return self.side
+
+    def __repr__(self):
+        return "%s, price:%s, volume:%s, time:%s, side:%s" \
+               % (self.basic, self.price, self.volume, self.time, self.side)
+
+    def __str__(self):
+        return self.__repr__()

webull/data/request/get_batch_historical_bars_request.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 webull.core.request import ApiRequest
+
+class BatchHistoricalBarsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/batch-bars", version='v2', method="POST", body_params={})
+
+    def set_symbols(self, symbol):
+        self.add_body_params("symbols", symbol)
+
+    def set_category(self, category):
+        self.add_body_params("category", category)
+
+    def set_timespan(self, timespan):
+        self.add_body_params("timespan", timespan)
+
+    def set_count(self, count='200'):
+        self.add_body_params("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_body_params("real_time_required", real_time_required)
+
+    def set_trading_sessions(self, trading_sessions):
+        if trading_sessions:
+            if isinstance(trading_sessions, list):
+                self.add_body_params("trading_sessions", ','.join(trading_sessions))
+            else:
+                self.add_body_params("trading_sessions", trading_sessions)

webull/data/request/get_corp_action_request.py

@@ -0,0 +1,47 @@
+# 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 GetCorpActionRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/instrument/corp-action", version='v2', method="GET", query_params={})
+
+    def set_instrument_ids(self, instrument_ids):
+        if isinstance(instrument_ids, str):
+            self.add_query_param("instrument_ids", instrument_ids)
+        elif isinstance(instrument_ids, list):
+            self.add_query_param("instrument_ids", ",".join(instrument_ids))
+
+    def set_event_types(self, event_types):
+        if isinstance(event_types, str):
+            self.add_query_param("event_types", event_types)
+        elif isinstance(event_types, list):
+            self.add_query_param("event_types", ",".join(event_types))
+
+    def set_start_date(self, start_date):
+        self.add_query_param("start_date", start_date)
+
+    def set_end_date(self, end_date):
+        self.add_query_param("end_date", end_date)
+
+    def set_page_number(self, page_number):
+        self.add_query_param("page_number", page_number)
+
+    def set_page_size(self, page_size):
+        self.add_query_param("page_size", page_size)
+
+    def set_last_update_time(self, last_update_time):
+        self.add_query_param("last_update_time", last_update_time)

webull/data/request/get_eod_bars_request.py

@@ -0,0 +1,32 @@
+# 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 GetEodBarsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/market-data/eod-bars", version='v2', method="GET", query_params={})
+
+    def set_instrument_ids(self, instrument_ids):
+        if isinstance(instrument_ids, str):
+            self.add_query_param("instrument_ids", instrument_ids)
+        elif isinstance(instrument_ids, list):
+            self.add_query_param("instrument_ids", ",".join(instrument_ids))
+
+    def set_date(self, date):
+        self.add_query_param("date", date)
+
+    def set_count(self, count='1'):
+        self.add_query_param("count", count)