unicex 0.15.2__tar.gz → 0.16.0__tar.gz

{unicex-0.15.2/unicex.egg-info → unicex-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.15.2
+Version: 0.16.0
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License
@@ -56,12 +56,12 @@ Dynamic: license-file
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
 | **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
-| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
-| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Hyperliquid** | ✓      | ✓    | ✓          | ✓       | ✓          |                |              |
-| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
-| **Okx**         | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
+| **Okx**         | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Kucoin**      |        |      |            |         | ✓          |                |              |
 | **BingX**       |        |      |            |         | ✓          |                |              |
 ---

{unicex-0.15.2 → unicex-0.16.0}/README.md

@@ -7,12 +7,12 @@
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
 | **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
-| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
-| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Hyperliquid** | ✓      | ✓    | ✓          | ✓       | ✓          |                |              |
-| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
-| **Okx**         | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
+| **Okx**         | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Kucoin**      |        |      |            |         | ✓          |                |              |
 | **BingX**       |        |      |            |         | ✓          |                |              |
 ---

{unicex-0.15.2 → unicex-0.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ name = "unicex"
 # •	PATCH (x.y.Z) → увеличивается при багфиксе, который не ломает совместимость.
 # •	MINOR (x.Y.z) → увеличивается при добавлении новой функциональности, но без ломающих изменений (backward-compatible).
 # •	MAJOR (X.y.z) → увеличивается при изменениях, которые ломают обратную совместимость.
-version = "0.15.2"
+version = "0.16.0"
 
 description = "Unified Crypto Exchange API "
 readme = "README.md"

{unicex-0.15.2 → unicex-0.16.0}/unicex/_abc/exchange_info.py

@@ -17,7 +17,7 @@ if TYPE_CHECKING:
 
 
 class IExchangeInfo(ABC):
-    """Интерфейс для наследников, которые предзагружают и обновляют информацию о бирже."""
+    """Интерфейс класса, который обновляет информацию о правилах торговли на бирже."""
 
     _loaded: bool
     """Флаг, указывающий, была ли информация о бирже загружена."""

{unicex-0.15.2 → unicex-0.16.0}/unicex/_abc/uni_client.py

@@ -15,7 +15,7 @@ TClient = TypeVar("TClient", bound="BaseClient")
 
 
 class IUniClient(ABC, Generic[TClient]):
-    """Интерфейс для реализации асинхронного унифицированного клиента."""
+    """Интерфейс для унифицированного клиента."""
 
     def __init__(
         self,

{unicex-0.15.2 → unicex-0.16.0}/unicex/_abc/uni_websocket_manager.py

@@ -16,7 +16,7 @@ type CallbackType = Callable[[Any], Awaitable[None]]
 
 
 class IUniWebsocketManager(ABC):
-    """Интерфейс менеджера асинхронных унифицированных вебсокетов."""
+    """Интерфейс менеджера унифицированных вебсокетов."""
 
     def __init__(
         self, client: BaseClient | IUniClient | None = None, logger: LoggerLike | None = None

{unicex-0.15.2 → unicex-0.16.0}/unicex/_base/client.py

@@ -203,6 +203,9 @@ class BaseClient:
                 response_json=response_json,
             ) from None
 
+        # Валидирование ответа в конерктной реализации клиента
+        self._validate_response(response_json)
+
         # Логирование ответа
         try:
             self._logger.debug(
@@ -212,3 +215,7 @@ class BaseClient:
             self._logger.error(f"Error while logging response: {e}")
 
         return response_json
+
+    def _validate_response(self, response_json: dict[str, Any]) -> None:
+        """Проверка ответа API на ошибки биржи. Переопределяется в клиентах конкретных бирж."""
+        return None

{unicex-0.15.2 → unicex-0.16.0}/unicex/binance/adapter.py

@@ -115,7 +115,11 @@ class Adapter:
         Возвращает:
             OpenInterestItem: Словарь со временем и объемом открытого интереса в монетах.
         """
-        return OpenInterestItem(t=raw_data["time"], v=float(raw_data["openInterest"]))
+        return OpenInterestItem(
+            t=raw_data["time"],
+            v=float(raw_data["openInterest"]),
+            u="coins",
+        )
 
     @staticmethod
     def klines_message(raw_msg: dict) -> list[KlineDict]:

{unicex-0.15.2 → unicex-0.16.0}/unicex/bingx/adapter.py

@@ -68,7 +68,7 @@ class Adapter:
             OpenInterestItem: Словарь со временем и объемом открытого интереса в монетах.
         """
         item = raw_data["data"]
-        return OpenInterestItem(t=int(item["time"]), v=float(item["openInterest"]))
+        return OpenInterestItem(t=int(item["time"]), v=float(item["openInterest"]), u="usd")
 
     @staticmethod
     def funding_rate(raw_data: dict) -> dict[str, float]:

{unicex-0.15.2 → unicex-0.16.0}/unicex/bingx/uni_websocket_manager.py

@@ -199,7 +199,7 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        return self.trades(callback, symbol=symbol, symbols=symbols)  # type: ignore
 
     @overload
     def futures_trades(
@@ -280,4 +280,4 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        return self.futures_trades(callback, symbol=symbol, symbols=symbols)  # type: ignore

{unicex-0.15.2 → unicex-0.16.0}/unicex/bingx/websocket_manager.py

@@ -9,6 +9,7 @@ from typing import Any, Literal
 import orjson
 
 from unicex._base import Websocket
+from unicex.utils import validate_single_symbol_args
 
 from .client import Client
 
@@ -101,10 +102,7 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         data_types = [f"{ticker.upper()}@trade" for ticker in tickers]  # type: ignore[arg-type]

{unicex-0.15.2 → unicex-0.16.0}/unicex/bitget/adapter.py

@@ -183,6 +183,7 @@ class Adapter:
             i["symbol"]: OpenInterestItem(
                 t=int(i["ts"]),
                 v=float(i["holdingAmount"]),
+                u="coins",
             )
             for i in raw_data["data"]
         }

{unicex-0.15.2 → unicex-0.16.0}/unicex/bitget/uni_websocket_manager.py

@@ -5,7 +5,7 @@ from typing import Any, overload
 
 from unicex._abc import IUniWebsocketManager
 from unicex._base import Websocket
-from unicex.enums import Timeframe
+from unicex.enums import Exchange, MarketType, Timeframe
 from unicex.types import LoggerLike
 
 from .adapter import Adapter
@@ -76,7 +76,17 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета для управления соединением.
         """
-        raise NotImplementedError()
+        wrapper = self._make_wrapper(self._adapter.klines_message, callback)
+        return self._websocket_manager.candlestick(
+            callback=wrapper,
+            market_type="SPOT",
+            symbol=symbol,
+            symbols=symbols,
+            interval=timeframe.to_exchange_format(
+                Exchange.BITGET,
+                MarketType.FUTURES,  # Тут пришлось поставить Futures, потому что:
+            ),  # кто бы мог подумать, что у Bitget на споте для вебсокетов и HTTP запросов совершенно разные перечисления. Тупые ублюдки.
+        )
 
     @overload
     def futures_klines(
@@ -118,7 +128,14 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        wrapper = self._make_wrapper(self._adapter.klines_message, callback)
+        return self._websocket_manager.candlestick(
+            callback=wrapper,
+            market_type="USDT-FUTURES",
+            symbol=symbol,
+            symbols=symbols,
+            interval=timeframe.to_exchange_format(Exchange.BITGET, MarketType.FUTURES),
+        )
 
     @overload
     def trades(
@@ -276,4 +293,4 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        return self.futures_trades(callback=callback, symbol=symbol, symbols=symbols)  # type: ignore[reportCallIssue]

{unicex-0.15.2 → unicex-0.16.0}/unicex/bitget/websocket_manager.py

@@ -6,6 +6,7 @@ from collections.abc import Awaitable, Callable, Sequence
 from typing import Any, Literal
 
 from unicex._base import Websocket
+from unicex.utils import validate_single_symbol_args
 
 from .client import Client
 
@@ -46,10 +47,7 @@ class WebsocketManager:
         Возвращает:
             `str`: JSON-строка с сообщением для подписки на вебсокет.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         streams: list[dict] = [

{unicex-0.15.2 → unicex-0.16.0}/unicex/bybit/adapter.py

@@ -68,6 +68,7 @@ class Adapter:
             item["symbol"]: OpenInterestItem(
                 t=raw_data["time"],
                 v=float(item["openInterest"]),
+                u="coins",
             )
             for item in raw_data["result"]["list"]
         }

{unicex-0.15.2 → unicex-0.16.0}/unicex/bybit/websocket_manager.py

@@ -6,6 +6,7 @@ from collections.abc import Awaitable, Callable, Sequence
 from typing import Any, Literal
 
 from unicex._base import Websocket
+from unicex.utils import validate_single_symbol_args
 
 from .client import Client
 
@@ -108,10 +109,7 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         topics = [f"orderbook.{depth}.{ticker.upper()}" for ticker in tickers]  # type: ignore
@@ -152,10 +150,7 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         topics = [f"kline.{interval}.{ticker.upper()}" for ticker in tickers]  # type: ignore
@@ -192,10 +187,7 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         topics = [f"publicTrade.{ticker.upper()}" for ticker in tickers]  # type: ignore
@@ -232,10 +224,7 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         topics = [f"tickers.{ticker.upper()}" for ticker in tickers]  # type: ignore
@@ -280,10 +269,7 @@ class WebsocketManager:
             stacklevel=2,
         )
 
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         topics = [f"liquidation.{ticker.upper()}" for ticker in tickers]  # type: ignore
@@ -320,10 +306,7 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        if symbol and symbols:
-            raise ValueError("Parameters symbol and symbols cannot be used together")
-        if not (symbol or symbols):
-            raise ValueError("Either symbol or symbols must be provided")
+        validate_single_symbol_args(symbol, symbols)
 
         tickers = [symbol] if symbol else symbols
         topics = [f"allLiquidation.{ticker.upper()}" for ticker in tickers]  # type: ignore

{unicex-0.15.2 → unicex-0.16.0}/unicex/extra.py

@@ -179,23 +179,22 @@ def generate_ex_link(exchange: Exchange, market_type: MarketType, symbol: str):
     Возвращает:
         `str`: Ссылка на биржу.
     """
-    symbol = normalize_symbol(symbol)
     ticker = normalize_ticker(symbol)
     if exchange == Exchange.BINANCE:
         if market_type == MarketType.FUTURES:
-            return f"https://www.binance.com/en/futures/{symbol}"
+            return f"https://www.binance.com/en/futures/{ticker}USDT"
         else:
             return f"https://www.binance.com/en/trade/{ticker}_USDT?type=spot"
     elif exchange == Exchange.BYBIT:
         if market_type == MarketType.FUTURES:
-            return f"https://www.bybit.com/trade/usdt/{symbol}"
+            return f"https://www.bybit.com/trade/usdt/{ticker}USDT"
         else:
             return f"https://www.bybit.com/en/trade/spot/{ticker}/USDT"
     elif exchange == Exchange.BITGET:
         if market_type == MarketType.FUTURES:
-            return f"https://www.bitget.com/ru/futures/usdt/{symbol}"
+            return f"https://www.bitget.com/ru/futures/usdt/{ticker}USDT"
         else:
-            return f"https://www.bitget.com/ru/spot/{symbol}"
+            return f"https://www.bitget.com/ru/spot/{ticker}USDT"
     elif exchange == Exchange.OKX:
         if market_type == MarketType.FUTURES:
             return f"https://www.okx.com/ru/trade-swap/{ticker.lower()}-usdt-swap"
@@ -218,14 +217,14 @@ def generate_ex_link(exchange: Exchange, market_type: MarketType, symbol: str):
             return f"https://app.hyperliquid.xyz/trade/{ticker}/USDC"
     elif exchange == Exchange.KUCOIN:
         if market_type == MarketType.FUTURES:
-            return f"https://www.kucoin.com/trade/futures/{symbol}M"
+            return f"https://www.kucoin.com/trade/futures/{ticker}USDTM"
         else:
             return f"https://www.kucoin.com/trade/{ticker}-USDT"
     elif exchange == Exchange.BINGX:
         if market_type == MarketType.FUTURES:
             return f"https://bingx.com/en/perpetual/{ticker}-USDT"
         else:
-            return f"https://bingx.com/en/spot/{symbol}"
+            return f"https://bingx.com/en/spot/{ticker}USDT"
     else:
         raise NotSupported(f"Exchange {exchange} is not supported")
 
@@ -260,34 +259,35 @@ def generate_cg_link(exchange: Exchange, market_type: MarketType, symbol: str) -
     Возвращает:
         `str`: Ссылка для CoinGlass.
     """
-    base_url = "https://www.coinglass.com/tv/ru"
-
-    symbol = normalize_symbol(symbol)
+    ticker = normalize_ticker(symbol)
 
+    base_url = "https://www.coinglass.com/tv/ru"
     if market_type == MarketType.FUTURES:
         match exchange:
             case Exchange.OKX:
-                return f"{base_url}/OKX_{symbol.replace('USDT', '-USDT')}-SWAP"
+                return f"{base_url}/OKX_{ticker}-USDT-SWAP"
             case Exchange.MEXC:
-                return f"{base_url}/MEXC_{symbol.replace('USDT', '_USDT')}"
+                return f"{base_url}/MEXC_{ticker}_USDT"
             case Exchange.BITGET:
-                return f"{base_url}/Bitget_{symbol}_UMCBL"
+                return f"{base_url}/Bitget_{ticker}USDT_UMCBL"
             case Exchange.GATE:
-                return f"{base_url}/Gate_{symbol.replace('USDT', '_USDT')}"
+                return f"{base_url}/Gate_{ticker}_USDT"
             case Exchange.HYPERLIQUID:
-                return f"{base_url}/Hyperliquid_{symbol.replace('USDT', '-USD')}"
+                return f"{base_url}/Hyperliquid_{ticker}-USD"
             case Exchange.KUCOIN:
-                return f"https://www.coinglass.com/tv/ru/KuCoin_{symbol}M"
+                return f"https://www.coinglass.com/tv/ru/KuCoin_{ticker}USDTM"
             case Exchange.BINGX:
-                return f"https://www.coinglass.com/tv/ru/BingX_{symbol.replace('USDT', '-USDT')}"
+                return f"https://www.coinglass.com/tv/ru/BingX_{ticker}-USDT"
             case _:
-                return f"{base_url}/{exchange.capitalize()}_{symbol}"
+                return f"{base_url}/{exchange.capitalize()}_{ticker}USDT"
     else:
-        # Для спота корректная ссылка есть только у OKX
-        if exchange == Exchange.OKX:
-            return f"{base_url}/SPOT_{exchange.upper()}_{symbol.replace('USDT', '-USDT')}"
-        # Для остальных бирж ссылки нет → возвращаем заглушку
-        return generate_cg_link(exchange, MarketType.FUTURES, symbol)
+        match exchange:
+            case Exchange.OKX:
+                return f"{base_url}/SPOT_{exchange.upper()}_{ticker}-USDT"
+            case Exchange.GATE:
+                return f"{base_url}/SPOT_{exchange.capitalize()}_{ticker}_USDT"
+            case _:
+                return f"{base_url}/SPOT_{exchange.capitalize()}_{ticker}USDT"
 
 
 def make_humanreadable(value: float, locale: Literal["ru", "en"] = "ru") -> str:

{unicex-0.15.2 → unicex-0.16.0}/unicex/gate/adapter.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import time
+from typing import Any
 
 __all__ = ["Adapter"]
 
@@ -10,6 +11,7 @@ from unicex.types import (
     OpenInterestItem,
     TickerDailyDict,
     TickerDailyItem,
+    TradeDict,
 )
 from unicex.utils import catch_adapter_errors, decorate_all_methods
 
@@ -173,6 +175,107 @@ class Adapter:
             item["contract"]: OpenInterestItem(
                 t=int(time.time() * 1000),
                 v=float(item["total_size"]) * float(item["quanto_multiplier"]),
+                u="coins",
             )
             for item in raw_data
         }
+
+    @staticmethod
+    def klines_message(raw_msg: Any) -> list[KlineDict]:
+        """Преобразует вебсокет-сообщение со свечами в унифицированный формат.
+
+        Параметры:
+            raw_msg (Any): Сырое сообщение с вебсокета.
+
+        Возвращает:
+            list[KlineDict]: Список свечей в унифицированном формате.
+        """
+        data = raw_msg["result"]
+        return [
+            KlineDict(
+                s=data["n"].split("_", 1)[1],  # XRP_USDT
+                t=int(data["t"]) * 1000,
+                o=float(data["o"]),
+                h=float(data["h"]),
+                l=float(data["l"]),
+                c=float(data["c"]),
+                v=float(data["a"]),
+                q=float(data["v"]),
+                T=None,
+                x=not data["w"],  # w=False → свеча закрыта
+            )
+        ]
+
+    @staticmethod
+    def futures_klines_message(raw_msg: Any) -> list[KlineDict]:
+        """Преобразует вебсокет-сообщение со свечами в унифицированный формат.
+
+        Параметры:
+            raw_msg (Any): Сырое сообщение с вебсокета.
+
+        Возвращает:
+            list[KlineDict]: Список свечей в унифицированном формате.
+        """
+        return [
+            KlineDict(
+                s=item["n"].split("_", 1)[1],  # XRP_USDT
+                t=int(item["t"]) * 1000,
+                o=float(item["o"]),
+                h=float(item["h"]),
+                l=float(item["l"]),
+                c=float(item["c"]),
+                v=float(item["a"]),
+                q=float(item["v"]),
+                T=None,
+                x=not item["w"],  # w=False → свеча закрыта
+            )
+            for item in sorted(
+                raw_msg["result"],
+                key=lambda x: int(x["t"]),
+            )
+        ]
+
+    @staticmethod
+    def trades_message(raw_msg: Any) -> list[TradeDict]:
+        """Преобразует вебсокет-сообщение со сделками в унифицированный формат.
+
+        Параметры:
+            raw_msg (Any): Сырое сообщение с вебсокета.
+
+        Возвращает:
+            list[TradeDict]: Список сделок в унифицированном формате.
+        """
+        trade = raw_msg["result"]
+        return [
+            TradeDict(
+                t=trade["create_time_ms"],
+                s=trade["currency_pair"],
+                S=trade["side"].upper(),
+                p=float(trade["price"]),
+                v=float(trade["amount"]),
+            )
+        ]
+
+    @staticmethod
+    def futures_trades_message(raw_msg: Any) -> list[TradeDict]:
+        """Преобразует вебсокет-сообщение со сделками в унифицированный формат.
+
+        Параметры:
+            raw_msg (Any): Сырое сообщение с вебсокета.
+
+        Возвращает:
+            list[TradeDict]: Список сделок в унифицированном формате.
+        """
+        return [
+            TradeDict(
+                t=item["create_time_ms"],
+                s=item["contract"],
+                S="BUY" if float(item["size"]) > 0 else "SELL",
+                p=float(item["price"]),
+                v=abs(float(item["size"])),
+            )
+            for item in sorted(
+                raw_msg["result"],
+                key=lambda x: x["create_time_ms"],
+            )
+        ]

{unicex-0.15.2 → unicex-0.16.0}/unicex/gate/uni_websocket_manager.py

@@ -5,7 +5,7 @@ from typing import Any, overload
 
 from unicex._abc import IUniWebsocketManager
 from unicex._base import Websocket
-from unicex.enums import Timeframe
+from unicex.enums import Exchange, MarketType, Timeframe
 from unicex.types import LoggerLike
 
 from .adapter import Adapter
@@ -36,6 +36,20 @@ class UniWebsocketManager(IUniWebsocketManager):
         self._websocket_manager = WebsocketManager(self._client, **ws_kwargs)  # type: ignore
         self._adapter = Adapter()
 
+    def _normalize_symbols(
+        self,
+        symbol: str | None,
+        symbols: Sequence[str] | None,
+    ) -> list[str]:
+        """Преобразует параметры symbol/symbols в список тикеров."""
+        if symbol and symbols:
+            raise ValueError("Parameters symbol and symbols cannot be used together")
+        if symbol:
+            return [symbol]
+        if symbols:
+            return list(symbols)
+        raise ValueError("Either symbol or symbols must be provided")
+
     @overload
     def klines(
         self,
@@ -76,7 +90,14 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета для управления соединением.
         """
-        raise NotImplementedError()
+        tickers = self._normalize_symbols(symbol, symbols)
+
+        wrapper = self._make_wrapper(self._adapter.klines_message, callback)
+        return self._websocket_manager.candlesticks(
+            callback=wrapper,
+            interval=timeframe.to_exchange_format(Exchange.GATE, MarketType.SPOT),
+            symbols=tickers,
+        )
 
     @overload
     def futures_klines(
@@ -118,7 +139,14 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        tickers = self._normalize_symbols(symbol, symbols)
+
+        wrapper = self._make_wrapper(self._adapter.futures_klines_message, callback)
+        return self._websocket_manager.futures_candlesticks(
+            callback=wrapper,
+            interval=timeframe.to_exchange_format(Exchange.GATE, MarketType.FUTURES),
+            symbols=tickers,
+        )
 
     @overload
     def trades(
@@ -156,7 +184,10 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        tickers = self._normalize_symbols(symbol, symbols)
+
+        wrapper = self._make_wrapper(self._adapter.trades_message, callback)
+        return self._websocket_manager.trades(callback=wrapper, symbols=tickers)
 
     @overload
     def aggtrades(
@@ -194,7 +225,7 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        return self.trades(callback=callback, symbol=symbol, symbols=symbols)  # type: ignore[reportCallIssue]
 
     @overload
     def futures_trades(
@@ -232,7 +263,10 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        tickers = self._normalize_symbols(symbol, symbols)
+
+        wrapper = self._make_wrapper(self._adapter.futures_trades_message, callback)
+        return self._websocket_manager.futures_trades(callback=wrapper, symbols=tickers)
 
     @overload
     def futures_aggtrades(
@@ -270,4 +304,4 @@ class UniWebsocketManager(IUniWebsocketManager):
         Возвращает:
             `Websocket`: Экземпляр вебсокета.
         """
-        raise NotImplementedError()
+        return self.futures_trades(callback=callback, symbol=symbol, symbols=symbols)  # type: ignore[reportCallIssue]