Merge pull request #466 from binance/release_clients_2025_11_24

Author: alplabin

clients/derivatives_trading_options/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 3.0.0 - 2025-11-24
+
+### Changed (2)
+
+#### REST API
+
+- Renamed `symbol_price_ticker()` to `index_price_ticker()`.
+
+#### WebSocket Streams
+
+- Modified response for `trade_streams()` (`<symbol>@trade` method):
+  - `t`: number -> string
+
+
 ## 2.0.0 - 2025-10-10
 
 ### Changed (9)
@@ -96,4 +110,4 @@
 
 ## 1.0.0 - 2025-07-17
 
-- Initial release
+- Initial release

…st_api/MarketData/symbol_price_ticker.py …est_api/MarketData/index_price_ticker.pyclients/derivatives_trading_options/examples/rest_api/MarketData/symbol_price_ticker.py renamed to clients/derivatives_trading_options/examples/rest_api/MarketData/index_price_ticker.py clients/derivatives_trading_options/examples/rest_api/MarketData/symbol_price_ticker.py renamed to clients/derivatives_trading_options/examples/rest_api/MarketData/index_price_ticker.py

@@ -22,18 +22,18 @@
 client = DerivativesTradingOptions(config_rest_api=configuration_rest_api)
 
 
-def symbol_price_ticker():
+def index_price_ticker():
     try:
-        response = client.rest_api.symbol_price_ticker(underlying="underlying_example")
+        response = client.rest_api.index_price_ticker(underlying="underlying_example")
 
         rate_limits = response.rate_limits
-        logging.info(f"symbol_price_ticker() rate limits: {rate_limits}")
+        logging.info(f"index_price_ticker() rate limits: {rate_limits}")
 
         data = response.data()
-        logging.info(f"symbol_price_ticker() response: {data}")
+        logging.info(f"index_price_ticker() response: {data}")
     except Exception as e:
-        logging.error(f"symbol_price_ticker() error: {e}")
+        logging.error(f"index_price_ticker() error: {e}")
 
 
 if __name__ == "__main__":
-    symbol_price_ticker()
+    index_price_ticker()

clients/derivatives_trading_options/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "binance-sdk-derivatives-trading-options"
-version = "2.0.0"
+version = "3.0.0"
 description = "Official Binance Derivatives Trading Options SDK - A lightweight library that provides a convenient interface to Binance's DerivativesTradingOptions REST API and WebSocket Streams."
 authors = ["Binance"]
 license = "MIT"

clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/api/market_data_api.py

@@ -19,14 +19,14 @@
 from ..models import CheckServerTimeResponse
 from ..models import ExchangeInformationResponse
 from ..models import HistoricalExerciseRecordsResponse
+from ..models import IndexPriceTickerResponse
 from ..models import KlineCandlestickDataResponse
 from ..models import OldTradesLookupResponse
 from ..models import OpenInterestResponse
 from ..models import OptionMarkPriceResponse
 from ..models import OrderBookResponse
 from ..models import RecentBlockTradesListResponse
 from ..models import RecentTradesListResponse
-from ..models import SymbolPriceTickerResponse
 
 from ..models import Ticker24hrPriceChangeStatisticsResponse
 
@@ -161,6 +161,48 @@ def historical_exercise_records(
             response_model=HistoricalExerciseRecordsResponse,
         )
 
+    def index_price_ticker(
+        self,
+        underlying: Union[str, None],
+    ) -> ApiResponse[IndexPriceTickerResponse]:
+        """
+                Index Price Ticker
+                GET /eapi/v1/index
+                https://developers.binance.com/docs/derivatives/option/market-data/Index-Price-Ticker
+
+                Get spot index price for option underlying.
+
+        Weight: 1
+
+                Args:
+                    underlying (Union[str, None]): Option underlying, e.g BTCUSDT
+
+                Returns:
+                    ApiResponse[IndexPriceTickerResponse]
+
+                Raises:
+                    RequiredError: If a required parameter is missing.
+
+        """
+
+        if underlying is None:
+            raise RequiredError(
+                field="underlying",
+                error_message="Missing required parameter 'underlying'",
+            )
+
+        payload = {"underlying": underlying}
+
+        return send_request(
+            self._session,
+            self._configuration,
+            method="GET",
+            path="/eapi/v1/index",
+            payload=payload,
+            time_unit=self._configuration.time_unit,
+            response_model=IndexPriceTickerResponse,
+        )
+
     def kline_candlestick_data(
         self,
         symbol: Union[str, None],
@@ -482,48 +524,6 @@ def recent_trades_list(
             response_model=RecentTradesListResponse,
         )
 
-    def symbol_price_ticker(
-        self,
-        underlying: Union[str, None],
-    ) -> ApiResponse[SymbolPriceTickerResponse]:
-        """
-                Symbol Price Ticker
-                GET /eapi/v1/index
-                https://developers.binance.com/docs/derivatives/option/market-data/Symbol-Price-Ticker
-
-                Get spot index price for option underlying.
-
-        Weight: 1
-
-                Args:
-                    underlying (Union[str, None]): Option underlying, e.g BTCUSDT
-
-                Returns:
-                    ApiResponse[SymbolPriceTickerResponse]
-
-                Raises:
-                    RequiredError: If a required parameter is missing.
-
-        """
-
-        if underlying is None:
-            raise RequiredError(
-                field="underlying",
-                error_message="Missing required parameter 'underlying'",
-            )
-
-        payload = {"underlying": underlying}
-
-        return send_request(
-            self._session,
-            self._configuration,
-            method="GET",
-            path="/eapi/v1/index",
-            payload=payload,
-            time_unit=self._configuration.time_unit,
-            response_model=SymbolPriceTickerResponse,
-        )
-
     def test_connectivity(
         self,
     ) -> ApiResponse[None]:

clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/api/trade_api.py

@@ -213,6 +213,7 @@ def cancel_multiple_option_orders(
                 Cancel multiple orders.
 
         * At least one instance of `orderId` and `clientOrderId` must be sent.
+        * Max 10 orders can be deleted in one request
 
         Weight: 1
 

clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/models/__init__.py

@@ -98,6 +98,9 @@
 from .historical_exercise_records_response_inner import (
     HistoricalExerciseRecordsResponseInner as HistoricalExerciseRecordsResponseInner,
 )
+from .index_price_ticker_response import (
+    IndexPriceTickerResponse as IndexPriceTickerResponse,
+)
 from .kline_candlestick_data_response import (
     KlineCandlestickDataResponse as KlineCandlestickDataResponse,
 )
@@ -212,9 +215,6 @@
 from .start_user_data_stream_response import (
     StartUserDataStreamResponse as StartUserDataStreamResponse,
 )
-from .symbol_price_ticker_response import (
-    SymbolPriceTickerResponse as SymbolPriceTickerResponse,
-)
 from .ticker24hr_price_change_statistics_response import (
     Ticker24hrPriceChangeStatisticsResponse as Ticker24hrPriceChangeStatisticsResponse,
 )

…i/models/symbol_price_ticker_response.py …pi/models/index_price_ticker_response.pyclients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/models/symbol_price_ticker_response.py renamed to clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/models/index_price_ticker_response.py clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/models/symbol_price_ticker_response.py renamed to clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/models/index_price_ticker_response.py

@@ -22,9 +22,9 @@
 from typing_extensions import Self
 
 
-class SymbolPriceTickerResponse(BaseModel):
+class IndexPriceTickerResponse(BaseModel):
     """
-    SymbolPriceTickerResponse
+    IndexPriceTickerResponse
     """  # noqa: E501
 
     time: Optional[StrictInt] = None
@@ -53,7 +53,7 @@ def is_array(cls) -> bool:
 
     @classmethod
     def from_json(cls, json_str: str) -> Optional[Self]:
-        """Create an instance of SymbolPriceTickerResponse from a JSON string"""
+        """Create an instance of IndexPriceTickerResponse from a JSON string"""
         return cls.from_dict(json.loads(json_str))
 
     def to_dict(self) -> Dict[str, Any]:
@@ -87,7 +87,7 @@ def to_dict(self) -> Dict[str, Any]:
 
     @classmethod
     def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
-        """Create an instance of SymbolPriceTickerResponse from a dict"""
+        """Create an instance of IndexPriceTickerResponse from a dict"""
         if obj is None:
             return None
 

clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/rest_api/rest_api.py

@@ -29,14 +29,14 @@
 from .models import CheckServerTimeResponse
 from .models import ExchangeInformationResponse
 from .models import HistoricalExerciseRecordsResponse
+from .models import IndexPriceTickerResponse
 from .models import KlineCandlestickDataResponse
 from .models import OldTradesLookupResponse
 from .models import OpenInterestResponse
 from .models import OptionMarkPriceResponse
 from .models import OrderBookResponse
 from .models import RecentBlockTradesListResponse
 from .models import RecentTradesListResponse
-from .models import SymbolPriceTickerResponse
 
 from .models import Ticker24hrPriceChangeStatisticsResponse
 from .models import AcceptBlockTradeOrderResponse
@@ -377,6 +377,30 @@ def historical_exercise_records(
             underlying, start_time, end_time, limit
         )
 
+    def index_price_ticker(
+        self,
+        underlying: Union[str, None],
+    ) -> ApiResponse[IndexPriceTickerResponse]:
+        """
+                Index Price Ticker
+
+                Get spot index price for option underlying.
+
+        Weight: 1
+
+                Args:
+                    underlying (Union[str, None]): Option underlying, e.g BTCUSDT
+
+                Returns:
+                    ApiResponse[IndexPriceTickerResponse]
+
+                Raises:
+                    RequiredError: If a required parameter is missing.
+
+        """
+
+        return self._marketDataApi.index_price_ticker(underlying)
+
     def kline_candlestick_data(
         self,
         symbol: Union[str, None],
@@ -575,30 +599,6 @@ def recent_trades_list(
 
         return self._marketDataApi.recent_trades_list(symbol, limit)
 
-    def symbol_price_ticker(
-        self,
-        underlying: Union[str, None],
-    ) -> ApiResponse[SymbolPriceTickerResponse]:
-        """
-                Symbol Price Ticker
-
-                Get spot index price for option underlying.
-
-        Weight: 1
-
-                Args:
-                    underlying (Union[str, None]): Option underlying, e.g BTCUSDT
-
-                Returns:
-                    ApiResponse[SymbolPriceTickerResponse]
-
-                Raises:
-                    RequiredError: If a required parameter is missing.
-
-        """
-
-        return self._marketDataApi.symbol_price_ticker(underlying)
-
     def test_connectivity(
         self,
     ) -> ApiResponse[None]:
@@ -1152,6 +1152,7 @@ def cancel_multiple_option_orders(
                 Cancel multiple orders.
 
         * At least one instance of `orderId` and `clientOrderId` must be sent.
+        * Max 10 orders can be deleted in one request
 
         Weight: 1
 

clients/derivatives_trading_options/src/binance_sdk_derivatives_trading_options/websocket_streams/models/trade_streams_response.py

@@ -30,7 +30,7 @@ class TradeStreamsResponse(BaseModel):
     e: Optional[StrictStr] = None
     E: Optional[StrictInt] = Field(default=None, alias="E")
     s: Optional[StrictStr] = None
-    t: Optional[StrictInt] = None
+    t: Optional[StrictStr] = None
     p: Optional[StrictStr] = None
     q: Optional[StrictStr] = None
     b: Optional[StrictInt] = None