webull-openapi-python-sdk 1.0.3__py3-none-any.whl → 1.0.5__py3-none-any.whl

webull/data/quotes/futures_market_data.py

@@ -0,0 +1,89 @@
+# 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.get_futures_historical_bars_request import GetFuturesHistoricalBarsRequest
+from webull.data.request.get_futures_snapshot_request import GetFuturesSnapshotRequest
+from webull.data.request.get_futures_depth_request import GetFuturesDepthRequest
+from webull.data.request.get_futures_tick_request import GetFuturesTickRequest
+
+class FuturesMarketData:
+    def __init__(self, api_client):
+        self.client = api_client
+
+    def get_futures_history_bars(self, symbols, category, timespan, count='200', real_time_required=None):
+        """
+        Batch query K-line data for multiple futures symbols, returning aggregated data within the window.
+        According to the last N K-lines of the futures code, it supports various granularity K-lines such as m1 and m5.
+
+        :param symbols: List of futures security codes
+        :param category: Security type, enumeration
+        :param timespan: K-line interval
+        :param count: Number of K-lines to return, default is 200, maximum is 1200
+        :param real_time_required: Returns the latest trade quote data. By default, the most recent market data is returned.
+        """
+        history_bar_request = GetFuturesHistoricalBarsRequest()
+        history_bar_request.set_symbols(symbols)
+        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)
+        response = self.client.get_response(history_bar_request)
+        return response
+
+    def get_futures_snapshot(self, symbols, category):
+        """
+        Query the latest futures market snapshots in batches according to the futures code list.
+
+        :param symbols: List of futures security codes; for example: single: ESZ3 multiple: ESZ3,NQZ3;
+        For each request,up to 100 symbols can be subscribed
+        :param category: Security type, enumeration.
+        """
+        snapshot_request = GetFuturesSnapshotRequest()
+        snapshot_request.set_symbols(symbols)
+        snapshot_request.set_category(category)
+        response = self.client.get_response(snapshot_request)
+        return response
+
+    def get_futures_depth(self, symbol, category, depth=None):
+        """
+        Query the depth quote of futures according to the futures code list.
+
+        :param symbol: Futures securities code
+        :param category: Security type, enumeration.
+        :param depth: Retrieve bid/ask depth
+        Level 1 contains only the top 1 bid/ask level.
+        Level 2 becomes effective, with 10 levels by default. For U.S. futures, Level 2 supports up to 50 levels.
+        """
+        quote_request = GetFuturesDepthRequest()
+        quote_request.set_symbol(symbol)
+        quote_request.set_category(category)
+        quote_request.set_depth(depth)
+        response = self.client.get_response(quote_request)
+        return response
+
+    def get_futures_tick(self, symbol, category, count='200'):
+        """
+        Query tick-by-tick transaction of futures according to the futures code list.
+
+        :param symbol: Futures securities code
+        :param category: Security type, enumeration.
+        :param count: The number of lines: the default is 30, and the maximum limit is 1200
+        """
+        tick_request = GetFuturesTickRequest()
+        tick_request.set_symbol(symbol)
+        tick_request.set_category(category)
+        tick_request.set_count(count)
+        response = self.client.get_response(tick_request)
+        return response

webull/data/quotes/instrument.py

@@ -11,23 +11,100 @@
 # 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.common.category import Category
 from webull.data.request.get_instruments_request import GetInstrumentsRequest
+from webull.data.request.get_crypto_instruments_request import GetCryptoInstrumentsRequest
+from webull.data.request.get_futures_instruments_request import GetFuturesInstrumentsRequest
+from webull.data.request.get_futures_products_request import GetFuturesProductsRequest
+from webull.data.request.get_futures_instruments_by_code_request import GetFuturesInstrumentsByCodeRequest
 
 
 class Instrument:
     def __init__(self, api_client):
         self.client = api_client
 
-    def get_instrument(self, symbols, category):
+    def get_instrument(self, symbols=None, category=Category.US_STOCK.name, status=None, last_instrument_id=None,
+                       page_size=1000):
         """
          Query the underlying information according to the security symbol list and security type.
 
         :param symbols: Securities symbol, such as: 00700,00981.
         :param category: Security type, enumeration.
+        :param status: Tradable status.
+        :param last_instrument_id: Last instrument id for pagination.
+        :param page_size: Page size, default 1000.
         """
         instruments_request = GetInstrumentsRequest()
         instruments_request.set_symbols(symbols)
         instruments_request.set_category(category)
+        instruments_request.set_status(status)
+        instruments_request.set_last_instrument_id(last_instrument_id)
+        instruments_request.set_page_size(page_size)
         response = self.client.get_response(instruments_request)
         return response
+
+    def get_crypto_instrument(self, symbols=None, status=None, last_instrument_id=None,
+                              category=Category.US_CRYPTO.name, page_size=1000):
+        """
+         Query the crypto underlying information according to the security symbol.
+        :param symbols: Securities symbol, such as: BTCUSD,ETHUSD.
+        :param status: Tradable status.
+        :param last_instrument_id: Last instrument id for pagination.
+        :param category: (str, required) Instrument type.
+                     Possible values: ["US_CRYPTO"]
+                     Example: "US_CRYPTO"
+        :param page_size: Page size, default 1000.
+        """
+        crypto_instruments_request = GetCryptoInstrumentsRequest()
+        crypto_instruments_request.set_symbols(symbols)
+        crypto_instruments_request.set_category(category)
+        crypto_instruments_request.set_status(status)
+        crypto_instruments_request.set_last_instrument_id(last_instrument_id)
+        crypto_instruments_request.set_page_size(page_size)
+        response = self.client.get_response(crypto_instruments_request)
+        return response
+
+    def get_futures_instrument(self, symbols, category):
+        """
+         Query the futures instrument information based on the futures contract symbol.
+
+        :param symbols: Futures contract symbol, such as: ESmain,ESM5.
+        :param category: Security type, enumeration.
+        """
+
+        futures_instrument_request = GetFuturesInstrumentsRequest()
+        futures_instrument_request.set_symbols(symbols)
+        futures_instrument_request.set_category(category)
+        response = self.client.get_response(futures_instrument_request)
+        return response
+
+    def get_futures_products(self, category):
+        """
+        Query futures contract codes in batches based on security types.
+
+        :param category: Security type, enumeration.
+        """
+
+        batch_futures_products_request = GetFuturesProductsRequest()
+        batch_futures_products_request.set_category(category)
+        response = self.client.get_response(batch_futures_products_request)
+        return response
+
+    def get_futures_instrument_by_code(self, code, category, contract_type=None):
+        """
+        Query futures instrument information based on futures contract code.
+
+        :param code: Futures contract code, such as: ES.
+        :param category: Security type, enumeration.
+        :param contract_type: Contract type, values include
+            - MONTHLY: Regular monthly contract
+            - MAIN: Main continuous contract
+        """
+
+        futures_instrument_request = GetFuturesInstrumentsByCodeRequest()
+        futures_instrument_request.set_codes(code)
+        futures_instrument_request.set_category(category)
+        if contract_type:
+            futures_instrument_request.set_contract_type(contract_type)
+        response = self.client.get_response(futures_instrument_request)
+        return response

webull/data/quotes/market_data.py

@@ -18,8 +18,6 @@ from webull.data.request.get_historical_bars_request import GetHistoricalBarsReq
 from webull.data.request.get_quotes_request import GetQuotesRequest
 from webull.data.request.get_snapshot_request import GetSnapshotRequest
 from webull.data.request.get_tick_request import GetTickRequest
-from webull.data.request.subscribe_request import SubscribeRequest
-from webull.data.request.unsubscribe_request import UnsubcribeRequest
 
 
 class MarketData:

webull/data/request/get_crypto_historical_bars_request.py

@@ -0,0 +1,40 @@
+# 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 GetCryptoHistoricalBarsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/crypto/bars", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_timespan(self, timespan):
+        self.add_query_param("timespan", timespan)
+
+    def set_count(self, count='200'):
+        self.add_query_param("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_query_param("real_time_required", real_time_required)

webull/data/request/get_crypto_instruments_request.py

@@ -0,0 +1,44 @@
+# 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 GetCryptoInstrumentsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/crypto/list", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        if category:
+            self.add_query_param("category", category)
+
+    def set_status(self, status):
+        if status:
+            self.add_query_param("status", status)
+
+    def set_last_instrument_id(self, last_instrument_id):
+        if last_instrument_id:
+            self.add_query_param("last_instrument_id", last_instrument_id)
+
+    def set_page_size(self, page_size):
+        if page_size:
+            self.add_query_param("page_size", page_size)

webull/data/request/get_crypto_snapshot_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 GetCryptoSnapshotRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/crypto/snapshot", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)

webull/data/request/get_futures_depth_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 GetFuturesDepthRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/futures/depth", version='v2', method="GET", query_params={})
+
+    def set_symbol(self, symbol):
+        self.add_query_param("symbol", symbol)
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_depth(self, depth):
+        if depth:
+            self.add_query_param("depth", depth)

webull/data/request/get_futures_historical_bars_request.py

@@ -0,0 +1,36 @@
+# 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 GetFuturesHistoricalBarsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/futures/bars", version='v2', method="GET", body_params={})
+
+    def set_symbols(self, symbol):
+        self.add_query_param("symbols", symbol)
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_timespan(self, timespan):
+        self.add_query_param("timespan", timespan)
+
+    def set_count(self, count='200'):
+        self.add_query_param("count", count)
+
+    def set_real_time_required(self, real_time_required):
+        if real_time_required:
+            self.add_query_param("real_time_required", real_time_required)

webull/data/request/get_futures_instruments_by_code_request.py

@@ -0,0 +1,36 @@
+# 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 GetFuturesInstrumentsByCodeRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/futures/by-code", version='v2', method="GET", query_params={})
+
+    def set_codes(self, code):
+        self.add_query_param("code", code)
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_contract_type(self, contract_type):
+        """
+        Set the contract type for the futures instruments.
+        contract_type: Contract type, values include
+        - MONTHLY: Regular monthly contract
+        - MAIN: Main continuous contract
+        """
+        self.add_query_param("contract_type", contract_type)

webull/data/request/get_futures_instruments_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 GetFuturesInstrumentsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/futures/list", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)

webull/data/request/get_futures_products_request.py

@@ -0,0 +1,25 @@
+# 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 GetFuturesProductsRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/instrument/futures/products", version='v2', method="GET", query_params={})
+
+    def set_category(self, category):
+        self.add_query_param("category", category)

webull/data/request/get_futures_snapshot_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 GetFuturesSnapshotRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/futures/snapshot", version='v2', method="GET", query_params={})
+
+    def set_symbols(self, symbols):
+        if isinstance(symbols, str):
+            self.add_query_param("symbols", symbols)
+        elif isinstance(symbols, list):
+            self.add_query_param("symbols", ",".join(symbols))
+
+    def set_category(self, category):
+        self.add_query_param("category", category)

webull/data/request/get_futures_tick_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 GetFuturesTickRequest(ApiRequest):
+    def __init__(self):
+        ApiRequest.__init__(self, "/openapi/market-data/futures/tick", version='v2', method="GET", query_params={})
+
+    def set_symbol(self, symbol):
+        self.add_query_param("symbol", symbol)
+
+    def set_category(self, category):
+        self.add_query_param("category", category)
+
+    def set_count(self, count):
+        self.add_query_param("count", count)

webull/data/request/get_instruments_request.py

@@ -27,4 +27,16 @@ class GetInstrumentsRequest(ApiRequest):
             self.add_query_param("symbols", ",".join(symbols))
     
     def set_category(self, category):
-        self.add_query_param("category", category)
+        self.add_query_param("category", category)
+
+    def set_status(self, status):
+        if status:
+            self.add_query_param("status", status)
+
+    def set_last_instrument_id(self, last_instrument_id):
+        if last_instrument_id:
+            self.add_query_param("last_instrument_id", last_instrument_id)
+
+    def set_page_size(self, page_size):
+        if page_size:
+            self.add_query_param("page_size", page_size)

webull/trade/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "1.0.3"
+__version__ = "1.0.5"
 

webull/trade/common/category.py

@@ -21,9 +21,8 @@ class Category(EasyEnum):
     US_STOCK = (1, 'US STOCK')
     US_OPTION = (2, 'US OPTION')
     HK_STOCK = (3, 'HK STOCK')
-    CRYPTO = (4, 'CRYPTO')
     US_ETF = (5, 'US ETF')
     HK_ETF = (6, 'HK ETF')
     CN_STOCK = (7, "CN STOCK")
-    NFT = (8, "NFT")
-    US_CFDONSTOCK = (8, "US CFDON STOCK")
+    US_CRYPTO = (8, "US CRYPTO")
+    US_FUTURES = (12, "US FUTURES")

webull/trade/request/v2/palce_order_request.py

@@ -37,8 +37,10 @@ class PlaceOrderRequest(ApiRequest):
         if not new_orders:
             return
 
-        if not isinstance(new_orders, (list, tuple)):
-            market = new_orders.get("market")
-            category = market + "_" + "STOCK"
+        if isinstance(new_orders, list) and new_orders[0]:
+            first_order = new_orders[0]
+            instrument_type = first_order.get("instrument_type")
+            market = first_order.get("market")
+            category = market + "_" + instrument_type
             if category is not None:
                 self.add_header("category", category)

webull/trade/request/v2/place_option_request.py

@@ -37,13 +37,13 @@ class PlaceOptionRequest(ApiRequest):
 
         if isinstance(new_orders, list) and new_orders[0]:
             first_order = new_orders[0]
-            orders_list = first_order.get("orders", [])
-            if isinstance(orders_list, list):
-                for sub_order in orders_list:
-                    if (sub_order and isinstance(sub_order, dict)
-                            and sub_order.get("instrument_type") == "OPTION"):
-                        instrument_type = sub_order.get("instrument_type")
-                        market = sub_order.get("market")
+            leg_list = first_order.get("legs", [])
+            if isinstance(leg_list, list):
+                for sub_leg in leg_list:
+                    if (sub_leg and isinstance(sub_leg, dict)
+                            and sub_leg.get("instrument_type") == "OPTION"):
+                        instrument_type = sub_leg.get("instrument_type")
+                        market = sub_leg.get("market")
                         category = market + "_" + instrument_type
                         if category is not None:
                             self.add_header("category", category)

webull/trade/request/v2/place_order_request.py

@@ -19,9 +19,6 @@ from webull.core.request import ApiRequest
 class PlaceOrderRequest(ApiRequest):
     def __init__(self):
         super().__init__("/openapi/trade/stock/order/place", version='v2', method="POST", body_params={})
-        self._new_orders = []
-        self._current_order = {}
-        self.add_body_params("new_orders", self._new_orders)
 
     def set_new_orders(self, new_orders):
         self.add_body_params("new_orders", new_orders)
@@ -37,8 +34,9 @@ class PlaceOrderRequest(ApiRequest):
         if not new_orders:
             return
 
-        if not isinstance(new_orders, (list, tuple)):
-            market = new_orders.get("market")
+        if isinstance(new_orders, list) and new_orders[0]:
+            first_order = new_orders[0]
+            market = first_order.get("market")
             category = market + "_" + "STOCK"
             if category is not None:
-                self.add_header("category", category)
+                self.add_header("category", category)