Merge branch 'main_merge_260916' into 'main'

[API-1623]: route get_history_bar to batch stocks/bars/list endpoint and...

See merge request webull/webull-openapi-python-sdk!45

Author: 方佳

samples/__init__.py

@@ -1 +1 @@
-__version__ = '2.0.17'
+__version__ = '3.0.1'

samples/data/data_client.py

@@ -63,6 +63,9 @@
     if res.status_code == 200:
         print('get_snapshot:', res.json())
 
+    # get_history_bar is deprecated: the /market-data/stocks/bars/get endpoint
+    # is no longer available. It now delegates to the batch endpoint
+    # /market-data/stocks/bars/list. Prefer get_batch_history_bar directly.
     res = data_client.market_data.get_history_bar('AAPL', Category.US_STOCK.name, Timespan.M1.name)
     if res.status_code == 200:
         print('get_history_bar:', res.json())

webull/__init__.py

@@ -1 +1 @@
-__version__ = '3.0.0'
+__version__ = '3.0.1'

webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '3.0.0'
+__version__ = '3.0.1'
 
 import logging
 

webull/data/__init__.py

@@ -1,3 +1,3 @@
 # coding=utf-8
 
-__version__ = '3.0.0'
+__version__ = '3.0.1'

webull/data/quotes/market_data.py

@@ -15,7 +15,6 @@
 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_noii_bars_request import GetNoiiBarsRequest
 from webull.data.request.get_noii_snapshot_request import GetNoiiSnapshotRequest
 from webull.data.request.get_quotes_request import GetQuotesRequest
@@ -29,6 +28,11 @@ def __init__(self, api_client):
 
     def get_history_bar(self, symbol, category, timespan, count='200', real_time_required=None, trading_sessions=None, start_time=None, end_time=None):
         """
+        .. deprecated::
+            The endpoint /market-data/stocks/bars/get is no longer available.
+            Use :meth:`get_batch_history_bar` instead, which calls the batch
+            endpoint /market-data/stocks/bars/list.
+
         Returns to Instrument in the window aggregated data.
         According to the last N K-lines of the stock code, it supports various granularity K-lines such as m1 and m5.
         Currently, only the K-line with the previous weight is provided for the daily K-line and above,
@@ -44,17 +48,16 @@ def get_history_bar(self, symbol, category, timespan, count='200', real_time_req
         :param start_time: Start timestamp in milliseconds (Long). Optional.
         :param end_time: End timestamp in milliseconds (Long). Delayed permission will auto-offset time. Optional.
         """
-        history_bar_request = GetHistoricalBarsRequest()
-        history_bar_request.set_symbol(symbol)
-        history_bar_request.set_category(category)
-        history_bar_request.set_timespan(timespan)
-        history_bar_request.set_count(count)
-        history_bar_request.set_real_time_required(real_time_required)
-        history_bar_request.set_trading_sessions(trading_sessions)
-        history_bar_request.set_start_time(start_time)
-        history_bar_request.set_end_time(end_time)
-        response = self.client.get_response(history_bar_request)
-        return response
+        return self.get_batch_history_bar(
+            [symbol],
+            category,
+            timespan,
+            count=count,
+            real_time_required=real_time_required,
+            trading_sessions=trading_sessions,
+            start_time=start_time,
+            end_time=end_time,
+        )
 
     def get_batch_history_bar(self, symbols, category, timespan, count='200', real_time_required=None, trading_sessions=None, start_time=None, end_time=None):
         """

webull/data/request/get_historical_bars_request.py

@@ -16,6 +16,13 @@
 from webull.core.request import ApiRequest
 
 class GetHistoricalBarsRequest(ApiRequest):
+    """
+    .. deprecated::
+        The endpoint /market-data/stocks/bars/get is no longer available.
+        Use :class:`webull.data.request.get_batch_historical_bars_request.BatchHistoricalBarsRequest`
+        instead, which calls the batch endpoint /market-data/stocks/bars/list.
+    """
+
     def __init__(self):
         ApiRequest.__init__(self, "/market-data/stocks/bars/get", version='v3', method="GET", query_params={})
 

webull/trade/__init__.py

@@ -1 +1 @@
-__version__ = '3.0.0'
+__version__ = '3.0.1'