binance-sdk-derivatives-trading-portfolio-margin 1.0.0__py3-none-any.whl

binance_sdk_derivatives_trading_portfolio_margin/websocket_streams/models/user_data_stream_events_response.py

@@ -0,0 +1,386 @@
+# coding: utf-8
+
+"""
+Binance Derivatives Trading Portfolio Margin WebSocket Market Streams
+
+OpenAPI Specification for the Binance Derivatives Trading Portfolio Margin WebSocket Market Streams
+The version of the OpenAPI document: 1.0.0
+Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+Do not edit the class manually.
+"""
+
+
+from __future__ import annotations
+import json
+import pprint
+from pydantic import (
+    BaseModel,
+    ConfigDict,
+    ValidationError,
+    field_validator,
+)
+from typing import Any, Optional
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.account_config_update import (
+    AccountConfigUpdate,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.account_update import (
+    AccountUpdate,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.balanceupdate import (
+    Balanceupdate,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.conditional_order_trade_update import (
+    ConditionalOrderTradeUpdate,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.executionreport import (
+    Executionreport,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.liabilitychange import (
+    Liabilitychange,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.listenkeyexpired import (
+    Listenkeyexpired,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.openorderloss import (
+    Openorderloss,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.order_trade_update import (
+    OrderTradeUpdate,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.outboundaccountposition import (
+    Outboundaccountposition,
+)
+from binance_sdk_derivatives_trading_portfolio_margin.websocket_streams.models.risklevelchange import (
+    Risklevelchange,
+)
+from typing import Union, Set, Dict
+from typing_extensions import Self
+
+USERDATASTREAMEVENTSRESPONSE_ONE_OF_SCHEMAS = [
+    "AccountConfigUpdate",
+    "AccountUpdate",
+    "Balanceupdate",
+    "ConditionalOrderTradeUpdate",
+    "Executionreport",
+    "Liabilitychange",
+    "Listenkeyexpired",
+    "Openorderloss",
+    "OrderTradeUpdate",
+    "Outboundaccountposition",
+    "Risklevelchange",
+]
+
+
+class UserDataStreamEventsResponse(BaseModel):
+    """
+    UserDataStreamEventsResponse
+    """
+
+    # data type: ConditionalOrderTradeUpdate
+    oneof_schema_1_validator: Optional[ConditionalOrderTradeUpdate] = None
+    # data type: AccountConfigUpdate
+    oneof_schema_2_validator: Optional[AccountConfigUpdate] = None
+    # data type: AccountUpdate
+    oneof_schema_3_validator: Optional[AccountUpdate] = None
+    # data type: OrderTradeUpdate
+    oneof_schema_4_validator: Optional[OrderTradeUpdate] = None
+    # data type: Liabilitychange
+    oneof_schema_5_validator: Optional[Liabilitychange] = None
+    # data type: Outboundaccountposition
+    oneof_schema_6_validator: Optional[Outboundaccountposition] = None
+    # data type: Balanceupdate
+    oneof_schema_7_validator: Optional[Balanceupdate] = None
+    # data type: Executionreport
+    oneof_schema_8_validator: Optional[Executionreport] = None
+    # data type: Openorderloss
+    oneof_schema_9_validator: Optional[Openorderloss] = None
+    # data type: Listenkeyexpired
+    oneof_schema_10_validator: Optional[Listenkeyexpired] = None
+    # data type: Risklevelchange
+    oneof_schema_11_validator: Optional[Risklevelchange] = None
+    actual_instance: Optional[
+        Union[
+            AccountConfigUpdate,
+            AccountUpdate,
+            Balanceupdate,
+            ConditionalOrderTradeUpdate,
+            Executionreport,
+            Liabilitychange,
+            Listenkeyexpired,
+            Openorderloss,
+            OrderTradeUpdate,
+            Outboundaccountposition,
+            Risklevelchange,
+        ]
+    ] = None
+    one_of_schemas: Set[str] = {
+        "AccountConfigUpdate",
+        "AccountUpdate",
+        "Balanceupdate",
+        "ConditionalOrderTradeUpdate",
+        "Executionreport",
+        "Liabilitychange",
+        "Listenkeyexpired",
+        "Openorderloss",
+        "OrderTradeUpdate",
+        "Outboundaccountposition",
+        "Risklevelchange",
+    }
+
+    model_config = ConfigDict(
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+    discriminator_value_class_map: Dict[str, str] = {}
+
+    def __init__(self, *args, **kwargs) -> None:
+        if args:
+            if len(args) > 1:
+                raise ValueError(
+                    "If a position argument is used, only 1 is allowed to set `actual_instance`"
+                )
+            if kwargs:
+                raise ValueError(
+                    "If a position argument is used, keyword arguments cannot be used."
+                )
+            super().__init__(actual_instance=args[0])
+        else:
+            super().__init__(**kwargs)
+
+    @field_validator("actual_instance")
+    def actual_instance_must_validate_oneof(cls, v):
+
+        error_messages = []
+        match = 0
+        # validate data type: ConditionalOrderTradeUpdate
+        if not isinstance(v, ConditionalOrderTradeUpdate):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `ConditionalOrderTradeUpdate`"
+            )
+        else:
+            match += 1
+        # validate data type: AccountConfigUpdate
+        if not isinstance(v, AccountConfigUpdate):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `AccountConfigUpdate`"
+            )
+        else:
+            match += 1
+        # validate data type: AccountUpdate
+        if not isinstance(v, AccountUpdate):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `AccountUpdate`"
+            )
+        else:
+            match += 1
+        # validate data type: OrderTradeUpdate
+        if not isinstance(v, OrderTradeUpdate):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `OrderTradeUpdate`"
+            )
+        else:
+            match += 1
+        # validate data type: Liabilitychange
+        if not isinstance(v, Liabilitychange):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Liabilitychange`"
+            )
+        else:
+            match += 1
+        # validate data type: Outboundaccountposition
+        if not isinstance(v, Outboundaccountposition):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Outboundaccountposition`"
+            )
+        else:
+            match += 1
+        # validate data type: Balanceupdate
+        if not isinstance(v, Balanceupdate):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Balanceupdate`"
+            )
+        else:
+            match += 1
+        # validate data type: Executionreport
+        if not isinstance(v, Executionreport):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Executionreport`"
+            )
+        else:
+            match += 1
+        # validate data type: Openorderloss
+        if not isinstance(v, Openorderloss):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Openorderloss`"
+            )
+        else:
+            match += 1
+        # validate data type: Listenkeyexpired
+        if not isinstance(v, Listenkeyexpired):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Listenkeyexpired`"
+            )
+        else:
+            match += 1
+        # validate data type: Risklevelchange
+        if not isinstance(v, Risklevelchange):
+            error_messages.append(
+                f"Error! Input type `{type(v)}` is not `Risklevelchange`"
+            )
+        else:
+            match += 1
+        if match > 1:
+            # more than 1 match
+            raise ValueError(
+                "Multiple matches found when setting `actual_instance` in UserDataStreamEventsResponse with oneOf schemas: AccountConfigUpdate, AccountUpdate, Balanceupdate, ConditionalOrderTradeUpdate, Executionreport, Liabilitychange, Listenkeyexpired, Openorderloss, OrderTradeUpdate, Outboundaccountposition, Risklevelchange. Details: "
+                + ", ".join(error_messages)
+            )
+        elif match == 0:
+            # no match
+            raise ValueError(
+                "No match found when setting `actual_instance` in UserDataStreamEventsResponse with oneOf schemas: AccountConfigUpdate, AccountUpdate, Balanceupdate, ConditionalOrderTradeUpdate, Executionreport, Liabilitychange, Listenkeyexpired, Openorderloss, OrderTradeUpdate, Outboundaccountposition, Risklevelchange. Details: "
+                + ", ".join(error_messages)
+            )
+        else:
+            return v
+
+    @classmethod
+    def from_dict(cls, obj: Union[str, Dict[str, Any]]) -> Self:
+        return cls.from_json(json.dumps(obj))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Returns the object represented by the json string"""
+        instance = cls.model_construct()
+        error_messages = []
+        match = 0
+
+        # deserialize data into ConditionalOrderTradeUpdate
+        try:
+            instance.actual_instance = ConditionalOrderTradeUpdate.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into AccountConfigUpdate
+        try:
+            instance.actual_instance = AccountConfigUpdate.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into AccountUpdate
+        try:
+            instance.actual_instance = AccountUpdate.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into OrderTradeUpdate
+        try:
+            instance.actual_instance = OrderTradeUpdate.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Liabilitychange
+        try:
+            instance.actual_instance = Liabilitychange.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Outboundaccountposition
+        try:
+            instance.actual_instance = Outboundaccountposition.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Balanceupdate
+        try:
+            instance.actual_instance = Balanceupdate.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Executionreport
+        try:
+            instance.actual_instance = Executionreport.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Openorderloss
+        try:
+            instance.actual_instance = Openorderloss.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Listenkeyexpired
+        try:
+            instance.actual_instance = Listenkeyexpired.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+        # deserialize data into Risklevelchange
+        try:
+            instance.actual_instance = Risklevelchange.from_json(json_str)
+            match += 1
+        except (ValidationError, ValueError) as e:
+            error_messages.append(str(e))
+
+        if match > 1:
+            # more than 1 match
+            raise ValueError(
+                "Multiple matches found when deserializing the JSON string into UserDataStreamEventsResponse with oneOf schemas: AccountConfigUpdate, AccountUpdate, Balanceupdate, ConditionalOrderTradeUpdate, Executionreport, Liabilitychange, Listenkeyexpired, Openorderloss, OrderTradeUpdate, Outboundaccountposition, Risklevelchange. Details: "
+                + ", ".join(error_messages)
+            )
+        elif match == 0:
+            # no match
+            raise ValueError(
+                "No match found when deserializing the JSON string into UserDataStreamEventsResponse with oneOf schemas: AccountConfigUpdate, AccountUpdate, Balanceupdate, ConditionalOrderTradeUpdate, Executionreport, Liabilitychange, Listenkeyexpired, Openorderloss, OrderTradeUpdate, Outboundaccountposition, Risklevelchange. Details: "
+                + ", ".join(error_messages)
+            )
+        else:
+            return instance
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the actual instance"""
+        if self.actual_instance is None:
+            return "null"
+
+        if hasattr(self.actual_instance, "to_json") and callable(
+            self.actual_instance.to_json
+        ):
+            return self.actual_instance.to_json()
+        else:
+            return json.dumps(self.actual_instance)
+
+    def to_dict(
+        self,
+    ) -> Optional[
+        Union[
+            Dict[str, Any],
+            AccountConfigUpdate,
+            AccountUpdate,
+            Balanceupdate,
+            ConditionalOrderTradeUpdate,
+            Executionreport,
+            Liabilitychange,
+            Listenkeyexpired,
+            Openorderloss,
+            OrderTradeUpdate,
+            Outboundaccountposition,
+            Risklevelchange,
+        ]
+    ]:
+        """Returns the dict representation of the actual instance"""
+        if self.actual_instance is None:
+            return None
+
+        if hasattr(self.actual_instance, "to_dict") and callable(
+            self.actual_instance.to_dict
+        ):
+            return self.actual_instance.to_dict()
+        else:
+            # primitive type
+            return self.actual_instance
+
+    def to_str(self) -> str:
+        """Returns the string representation of the actual instance"""
+        return pprint.pformat(self.model_dump())

binance_sdk_derivatives_trading_portfolio_margin/websocket_streams/streams/__init__.py

@@ -0,0 +1,9 @@
+"""
+Binance Derivatives Trading Portfolio Margin WebSocket Market Streams
+
+OpenAPI Specification for the Binance Derivatives Trading Portfolio Margin WebSocket Market Streams
+The version of the OpenAPI document: 1.0.0
+Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+Do not edit the class manually.
+"""

binance_sdk_derivatives_trading_portfolio_margin/websocket_streams/websocket_streams.py

@@ -0,0 +1,105 @@
+"""
+Binance Derivatives Trading Portfolio Margin WebSocket Market Streams
+
+OpenAPI Specification for the Binance Derivatives Trading Portfolio Margin WebSocket Market Streams
+The version of the OpenAPI document: 1.0.0
+Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+Do not edit the class manually.
+"""
+
+from pydantic import BaseModel
+from typing import Callable, Optional, TypeVar
+
+from binance_common.configuration import ConfigurationWebSocketStreams
+from binance_common.websocket import (
+    WebSocketStreamBase,
+    WebSocketConnection,
+    RequestStream,
+)
+
+from .models import UserDataStreamEventsResponse
+
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class DerivativesTradingPortfolioMarginWebSocketStreams(WebSocketStreamBase):
+    def __init__(
+        self,
+        configuration: ConfigurationWebSocketStreams,
+    ) -> None:
+        super().__init__(configuration)
+        self.configuration = configuration
+
+    async def ping_server(self, connection: WebSocketConnection):
+        """Sends a ping message to the WebSocket server to check the connection status.
+
+        Args:
+            connection (WebSocketConnection): The WebSocket connection to send the ping message to.
+        """
+
+        if self.session:
+            await super().ping_ws_stream(connection=connection)
+        else:
+            raise ValueError("WebSocket session is not initialized.")
+
+    async def subscribe(self, streams, response_model: Optional[T] = None):
+        """Subscribes to the specified WebSocket streams.
+
+        Args:
+            streams (list): A list of WebSocket streams to subscribe to.
+            response_model (Optional[T]): The Pydantic model to validate the response against.
+        """
+
+        await super().subscribe(streams, response_model=response_model)
+
+    async def unsubscribe(self, streams):
+        """Unsubscribes from the specified WebSocket streams.
+
+        Args:
+            streams (list): A list of WebSocket streams to unsubscribe from.
+        """
+
+        await super().unsubscribe(streams)
+
+    def on(self, event: str, callback: Callable[[T], None], stream: str):
+        """Registers a callback function for a specific WebSocket event.
+
+        Args:
+            event (str): The event type to listen for (e.g., 'message', 'error').
+            callback (Callable[[T], None]): The callback function to be called when the event occurs.
+            stream (str): The specific WebSocket stream to listen to.
+        """
+
+        super().on(event, callback, stream)
+
+    async def list_subscribe(self):
+        """Lists all currently subscribed WebSocket streams."""
+
+        await super().list_subscribe()
+
+    async def close_connection(
+        self, connection: WebSocketConnection = None, close_session: bool = True
+    ):
+        """Closes the WebSocket connection and optionally the session.
+
+        Args:
+            connection (WebSocketConnection, optional): The WebSocket connection to close. If None, the current session's connection is used.
+            close_session (bool, optional): Whether to close the session after closing the connection. Defaults to True.
+        """
+
+        await super().close_connection(connection, close_session)
+
+    async def user_data(self, listenKey: str) -> UserDataStreamEventsResponse:
+        """Subscribe to User Data Stream (USER_STREAM)
+
+        Args:
+            listenKey (str): The listen key for the user data stream.
+        Returns:
+            UserDataStreamEventsResponse: The response model containing user data stream events.
+        """
+
+        return await RequestStream(
+            self.websocket_base, listenKey, response_model=UserDataStreamEventsResponse
+        )

binance_sdk_derivatives_trading_portfolio_margin-1.0.0.dist-info/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Binance
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.