unicex 0.13.18__py3-none-any.whl → 0.14.1__py3-none-any.whl

unicex/__init__.py

@@ -81,6 +81,13 @@ __all__ = [
     "GateioWebsocketManager",
     "GateioUserWebsocket",
     "GateioExchangeInfo",
+    # Kucoin
+    "KucoinClient",
+    "KucoinUniClient",
+    "KucoinUniWebsocketManager",
+    "KucoinWebsocketManager",
+    "KucoinUserWebsocket",
+    "KucoinExchangeInfo",
 ]
 
 # ruff: noqa
@@ -173,6 +180,15 @@ from .okx import (
     ExchangeInfo as OkxExchangeInfo,
 )
 
+from .kucoin import (
+    Client as KucoinClient,
+    UniClient as KucoinUniClient,
+    UniWebsocketManager as KucoinUniWebsocketManager,
+    UserWebsocket as KucoinUserWebsocket,
+    WebsocketManager as KucoinWebsocketManager,
+    ExchangeInfo as KucoinExchangeInfo,
+)
+
 
 async def load_exchanges_info() -> None:
     """Единожды загружает информацию о тикерах на всех биржах."""
@@ -184,6 +200,7 @@ async def load_exchanges_info() -> None:
         HyperliquidExchangeInfo.load_exchange_info(),
         MexcExchangeInfo.load_exchange_info(),
         OkxExchangeInfo.load_exchange_info(),
+        KucoinExchangeInfo.load_exchange_info(),
     )
 
 
@@ -197,4 +214,5 @@ async def start_exchanges_info(parse_interval_seconds: int = 60 * 60) -> None:
         HyperliquidExchangeInfo.start(parse_interval_seconds),
         MexcExchangeInfo.start(parse_interval_seconds),
         OkxExchangeInfo.start(parse_interval_seconds),
+        KucoinExchangeInfo.start(parse_interval_seconds),
     )

unicex/enums.py

@@ -26,14 +26,12 @@ class Exchange(StrEnum):
 
     BINANCE = "BINANCE"
     BITGET = "BITGET"
-    BITUNIX = "BITUNIX"
     BYBIT = "BYBIT"
     GATE = "GATE"
     HYPERLIQUID = "HYPERLIQUID"
-    KCEX = "KCEX"
     MEXC = "MEXC"
     OKX = "OKX"
-    XT = "XT"
+    KUCOIN = "KUCOIN"
 
     def __add__(self, market_type: "MarketType") -> tuple["Exchange", "MarketType"]:
         """Возвращает кортеж из биржи и типа рынка."""

unicex/extra.py

@@ -125,6 +125,10 @@ def normalize_ticker(raw_ticker: str) -> str:
             .removesuffix("SWAP")
         )
 
+    # Меняем постфикс USDTM на USDT
+    if ticker.endswith("USDTM"):
+        ticker = ticker.removesuffix("USDTM") + "USDT"
+
     # Удаляем разделители
     ticker = ticker.translate(str.maketrans("", "", "-_."))
 
@@ -149,6 +153,7 @@ def normalize_symbol(raw_ticker: str, quote: Literal["USDT", "USDC"] = "USDT") -
         normalize_symbol("BTC")  # "BTCUSDT"
         normalize_symbol("btc_usdt_swap")  # "BTCUSDT"
         normalize_symbol("ETH", "USDC")  # "ETHUSDC"
+        normalize_symbol("BTCUSDTM")  # "BTCUSDT"
         ```
 
     Параметры:
@@ -206,26 +211,16 @@ def generate_ex_link(exchange: Exchange, market_type: MarketType, symbol: str):
             return f"https://www.gate.com/ru/futures/USDT/{ticker}_USDT"
         else:
             return f"https://www.gate.com/ru/trade/{ticker}_USDT"
-    elif exchange == Exchange.XT:
-        if market_type == MarketType.FUTURES:
-            return f"https://www.xt.com/ru/futures/trade/{ticker.lower()}_usdt"
-        else:
-            return f"https://www.xt.com/ru/trade/{ticker.lower()}_usdt"
-    elif exchange == Exchange.BITUNIX:
-        if market_type == MarketType.FUTURES:
-            return f"https://www.bitunix.com/ru-ru/contract-trade/{ticker.upper()}USDT"
-        else:
-            return f"https://www.bitunix.com/ru-ru/spot-trade/{ticker.upper()}USDT"
-    elif exchange == Exchange.KCEX:
-        if market_type == MarketType.FUTURES:
-            return f"https://www.kcex.com/ru-RU/futures/exchange/{ticker.upper()}_USDT"
-        else:
-            return f"https://www.kcex.com/ru-RU/exchange/{ticker.upper()}_USDT"
     elif exchange == Exchange.HYPERLIQUID:
         if market_type == MarketType.FUTURES:
             return f"https://app.hyperliquid.xyz/trade/{ticker}"
         else:
             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"
+        else:
+            return f"https://www.kucoin.com/trade/{ticker}-USDT"
     else:
         raise NotSupported(f"Exchange {exchange} is not supported")
 
@@ -274,10 +269,10 @@ def generate_cg_link(exchange: Exchange, market_type: MarketType, symbol: str) -
                 return f"{base_url}/Bitget_{symbol}_UMCBL"
             case Exchange.GATE:
                 return f"{base_url}/Gate_{symbol.replace('USDT', '_USDT')}"
-            case Exchange.BITUNIX:
-                return f"{base_url}/Bitunix_{symbol}"
             case Exchange.HYPERLIQUID:
                 return f"{base_url}/Hyperliquid_{symbol.replace('USDT', '-USD')}"
+            case Exchange.KUCOIN:
+                return f"https://www.coinglass.com/tv/ru/KuCoin_{symbol}M"
             case _:
                 return f"{base_url}/{exchange.capitalize()}_{symbol}"
     else:

unicex/kucoin/__init__.py

@@ -0,0 +1,27 @@
+"""Пакет, содержащий реализации клиентов и менеджеров для работы с биржей Kucoin."""
+
+__all__ = [
+    "Client",
+    "UniClient",
+    "UserWebsocket",
+    "WebsocketManager",
+    "UniWebsocketManager",
+    "ExchangeInfo",
+]
+
+from .client import Client
+from .exchange_info import ExchangeInfo
+from .uni_client import UniClient
+from .uni_websocket_manager import UniWebsocketManager
+from .user_websocket import UserWebsocket
+from .websocket_manager import WebsocketManager
+
+
+async def load_exchange_info() -> None:
+    """Загружает информацию о бирже Kucoin."""
+    await ExchangeInfo.load_exchange_info()
+
+
+async def start_exchange_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает процесс обновления информации о бирже Kucoin."""
+    await ExchangeInfo.start(parse_interval_seconds)

unicex/kucoin/adapter.py

@@ -0,0 +1,81 @@
+__all__ = ["Adapter"]
+
+from typing import Any
+
+from unicex.types import OpenInterestDict, OpenInterestItem, TickerDailyDict, TickerDailyItem
+from unicex.utils import catch_adapter_errors, decorate_all_methods
+
+
+@decorate_all_methods(catch_adapter_errors)
+class Adapter:
+    """Адаптер для унификации данных с Kucoin API."""
+
+    @staticmethod
+    def tickers(raw_data: dict, only_usdt: bool) -> list[str]:
+        """Преобразует сырой ответ, в котором содержатся данные о тикерах в список тикеров.
+
+        Параметры:
+            raw_data (dict): Сырой ответ с биржи.
+            only_usdt (bool): Флаг, указывающий, нужно ли включать только тикеры в паре к USDT.
+
+        Возвращает:
+            list[str]: Список тикеров.
+        """
+        return [
+            item["symbol"]
+            for item in raw_data["data"]["list"]
+            if item["symbol"].endswith("USDTM") or not only_usdt
+        ]
+
+    @staticmethod
+    def ticker_24hr(raw_data: dict) -> TickerDailyDict:
+        """Преобразует сырой ответ, в котором содержатся данные о тикере за последние 24 часа в унифицированный формат.
+
+        Параметры:
+            raw_data (dict): Сырой ответ с биржи.
+
+        Возвращает:
+            TickerDailyDict: Словарь, где ключ - тикер, а значение - статистика за последние 24 часа.
+        """
+        return {
+            item["symbol"]: TickerDailyItem(
+                p=(
+                    round((float(item["lastPrice"]) / float(item["open"]) - 1) * 100, 2)
+                    if float(item["open"]) != 0
+                    else 0.0
+                ),
+                v=float(item["baseVolume"]),
+                q=float(item["quoteVolume"]),
+            )
+            for item in raw_data["data"]["list"]
+        }
+
+    @staticmethod
+    def last_price(raw_data: dict) -> dict[str, float]:
+        """Преобразует сырой ответ, в котором содержатся данные о последней цене, в унифицированный формат.
+
+        Параметры:
+            raw_data (dict): Сырой ответ с биржи.
+
+        Возвращает:
+            dict[str, float]: Словарь, где ключ - тикер, а значение - последняя цена.
+        """
+        return {item["symbol"]: float(item["lastPrice"]) for item in raw_data["data"]["list"]}
+
+    @staticmethod
+    def open_interest(raw_data: dict[str, Any]) -> OpenInterestDict:
+        """Преобразует сырой ответ, в котором содержатся данные об открытом интересе, в унифицированный формат.
+
+        Параметры:
+            raw_data (dict): Сырой ответ с биржи.
+
+        Возвращает:
+            OpenInterestDict: Словарь, где ключ - тикер, а значение - агрегированные данные открытого интереса.
+        """
+        return {
+            item["symbol"]: OpenInterestItem(
+                t=item["ts"],
+                v=float(item["openInterest"]),
+            )
+            for item in raw_data["data"]
+        }

unicex/kucoin/client.py

@@ -0,0 +1,38 @@
+__all__ = ["Client"]
+
+
+from typing import Any, Literal
+
+from unicex._base import BaseClient
+
+
+class Client(BaseClient):
+    """Клиент для работы с Kucoin API."""
+
+    _BASE_URL: str = "https://api.kucoin.com"
+    """Базовый URL для запросов."""
+
+    async def open_interest(self) -> dict[str, Any]:
+        """Получение открытого интереса.
+
+        https://www.kucoin.com/docs-new/3476287e0
+        """
+        url = self._BASE_URL + "/api/ua/v1/market/open-interest"
+
+        return await self._make_request("GET", url)
+
+    async def ticker(
+        self,
+        trade_type: Literal["SPOT", "FUTURES"],
+        symbol: str | None = None,
+    ) -> dict[str, Any]:
+        """Получение тикеров и информации о них.
+
+        https://www.kucoin.com/docs-new/rest/ua/get-ticker
+        """
+        url = self._BASE_URL + "/api/ua/v1/market/ticker"
+        params = {"tradeType": trade_type}
+        if symbol:
+            params["symbol"] = symbol
+
+        return await self._make_request("GET", url, params=params)

unicex/kucoin/exchange_info.py

@@ -0,0 +1,22 @@
+__all__ = ["ExchangeInfo"]
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Kucoin."""
+
+    exchange_name = "Kucoin"
+    """Название биржи, на которой работает класс."""
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        ...
+
+    @classmethod
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        ...

unicex/kucoin/uni_client.py

@@ -0,0 +1,160 @@
+__all__ = ["UniClient"]
+
+
+from typing import overload
+
+from unicex._abc import IUniClient
+from unicex.enums import Timeframe
+from unicex.types import KlineDict, OpenInterestDict, OpenInterestItem, TickerDailyDict
+
+from .adapter import Adapter
+from .client import Client
+
+
+class UniClient(IUniClient[Client]):
+    """Унифицированный клиент для работы с Kucoin API."""
+
+    @property
+    def _client_cls(self) -> type[Client]:
+        """Возвращает класс клиента для Kucoin.
+
+        Возвращает:
+            type[Client]: Класс клиента для Kucoin.
+        """
+        return Client
+
+    async def tickers(self, only_usdt: bool = True) -> list[str]:
+        """Возвращает список тикеров.
+
+        Параметры:
+            only_usdt (bool): Если True, возвращает только тикеры в паре к USDT.
+
+        Возвращает:
+            list[str]: Список тикеров.
+        """
+        raw_data = await self._client.ticker("SPOT")
+        return Adapter.tickers(raw_data, only_usdt)
+
+    async def futures_tickers(self, only_usdt: bool = True) -> list[str]:
+        """Возвращает список тикеров.
+
+        Параметры:
+            only_usdt (bool): Если True, возвращает только тикеры в паре к USDT.
+
+        Возвращает:
+            list[str]: Список тикеров.
+        """
+        raw_data = await self._client.ticker("FUTURES")
+        return Adapter.tickers(raw_data, only_usdt)
+
+    async def last_price(self) -> dict[str, float]:
+        """Возвращает последнюю цену для каждого тикера.
+
+        Возвращает:
+            dict[str, float]: Словарь с последними ценами для каждого тикера.
+        """
+        raw_data = await self._client.ticker("SPOT")
+        return Adapter.last_price(raw_data)
+
+    async def futures_last_price(self) -> dict[str, float]:
+        """Возвращает последнюю цену для каждого тикера.
+
+        Возвращает:
+            dict[str, float]: Словарь с последними ценами для каждого тикера.
+        """
+        raw_data = await self._client.ticker("FUTURES")
+        return Adapter.last_price(raw_data)
+
+    async def ticker_24hr(self) -> TickerDailyDict:
+        """Возвращает статистику за последние 24 часа для каждого тикера.
+
+        Возвращает:
+            TickerDailyDict: Словарь с статистикой за последние 24 часа для каждого тикера.
+        """
+        raw_data = await self._client.ticker("SPOT")
+        return Adapter.ticker_24hr(raw_data)
+
+    async def futures_ticker_24hr(self) -> TickerDailyDict:
+        """Возвращает статистику за последние 24 часа для каждого тикера.
+
+        Возвращает:
+            TickerDailyDict: Словарь с статистикой за последние 24 часа для каждого тикера.
+        """
+        raw_data = await self._client.ticker("FUTURES")
+        return Adapter.ticker_24hr(raw_data)
+
+    async def klines(
+        self,
+        symbol: str,
+        interval: Timeframe | str,
+        limit: int | None = None,
+        start_time: int | None = None,
+        end_time: int | None = None,
+    ) -> list[KlineDict]:
+        """Возвращает список свечей для тикера.
+
+        Параметры:
+            symbol (str): Название тикера.
+            limit (int | None): Количество свечей.
+            interval (Timeframe | str): Таймфрейм свечей.
+            start_time (int | None): Время начала периода в миллисекундах.
+            end_time (int | None): Время окончания периода в миллисекундах.
+
+        Возвращает:
+            list[KlineDict]: Список свечей для тикера.
+        """
+        raise NotImplementedError()
+
+    async def futures_klines(
+        self,
+        symbol: str,
+        interval: Timeframe | str,
+        limit: int | None = None,
+        start_time: int | None = None,
+        end_time: int | None = None,
+    ) -> list[KlineDict]:
+        """Возвращает список свечей для тикера.
+
+        Параметры:
+            symbol (str): Название тикера.
+            limit (int | None): Количество свечей.
+            interval (Timeframe | str): Таймфрейм свечей.
+            start_time (int | None): Время начала периода в миллисекундах.
+            end_time (int | None): Время окончания периода в миллисекундах.
+
+        Возвращает:
+            list[KlineDict]: Список свечей для тикера.
+        """
+        raise NotImplementedError()
+
+    async def funding_rate(self) -> dict[str, float]:
+        """Возвращает ставку финансирования для всех тикеров.
+
+        Возвращает:
+            dict[str, float]: Ставка финансирования для каждого тикера.
+        """
+        raise NotImplementedError()
+
+    @overload
+    async def open_interest(self, symbol: str) -> OpenInterestItem: ...
+
+    @overload
+    async def open_interest(self, symbol: None) -> OpenInterestDict: ...
+
+    @overload
+    async def open_interest(self) -> OpenInterestDict: ...
+
+    async def open_interest(self, symbol: str | None = None) -> OpenInterestItem | OpenInterestDict:
+        """Возвращает объем открытого интереса для тикера или всех тикеров, если тикер не указан.
+
+        Параметры:
+            symbol (`str | None`): Название тикера. (Опционально, но обязателен для следующих бирж: BINANCE).
+
+        Возвращает:
+            `OpenInterestItem | OpenInterestDict`: Если тикер передан - словарь со временем и объемом
+                открытого интереса в монетах. Если нет передан - то словарь, в котором ключ - тикер,
+                а значение - словарь с временем и объемом открытого интереса в монетах.
+        """
+        raw_data = await self._client.open_interest()
+        adapted_data = Adapter.open_interest(raw_data)
+        return adapted_data[symbol] if symbol else adapted_data

unicex/kucoin/uni_websocket_manager.py

@@ -0,0 +1,269 @@
+__all__ = ["IUniWebsocketManager"]
+
+from collections.abc import Awaitable, Callable, Sequence
+from typing import Any, overload
+
+from unicex._abc import IUniWebsocketManager
+from unicex._base import Websocket
+from unicex.enums import Timeframe
+from unicex.types import LoggerLike
+
+from .adapter import Adapter
+from .client import Client
+from .uni_client import UniClient
+from .websocket_manager import WebsocketManager
+
+type CallbackType = Callable[[Any], Awaitable[None]]
+
+
+class UniWebsocketManager(IUniWebsocketManager):
+    """Реализация менеджера асинхронных унифицированных вебсокетов."""
+
+    def __init__(
+        self, client: Client | UniClient | None = None, logger: LoggerLike | None = None
+    ) -> None:
+        """Инициализирует унифицированный менеджер вебсокетов.
+
+        Параметры:
+            client (`Client | UniClient | None`): Клиент Kucoin или унифицированный клиент. Нужен для подключения к приватным топикам.
+            logger (`LoggerLike | None`): Логгер для записи логов.
+        """
+        super().__init__(client=client, logger=logger)
+        self._websocket_manager = WebsocketManager(self._client)  # type: ignore
+        self._adapter = Adapter()
+
+    @overload
+    def klines(
+        self,
+        callback: CallbackType,
+        timeframe: Timeframe,
+        *,
+        symbol: str,
+        symbols: None = None,
+    ) -> Websocket: ...
+
+    @overload
+    def klines(
+        self,
+        callback: CallbackType,
+        timeframe: Timeframe,
+        *,
+        symbol: None = None,
+        symbols: Sequence[str],
+    ) -> Websocket: ...
+
+    def klines(
+        self,
+        callback: CallbackType,
+        timeframe: Timeframe,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+    ) -> Websocket:
+        """Открывает стрим свечей (spot) с унификацией сообщений.
+
+        Параметры:
+            callback (`CallbackType`): Асинхронная функция обратного вызова для обработки сообщений.
+            timeframe (`Timeframe`): Временной интервал свечей.
+            symbol (`str | None`): Один символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для мультиплекс‑подключения.
+
+        Должен быть указан либо `symbol`, либо `symbols`.
+
+        Возвращает:
+            `Websocket`: Экземпляр вебсокета для управления соединением.
+        """
+        raise NotImplementedError()
+
+    @overload
+    def futures_klines(
+        self,
+        callback: CallbackType,
+        timeframe: Timeframe,
+        *,
+        symbol: str,
+        symbols: None = None,
+    ) -> Websocket: ...
+
+    @overload
+    def futures_klines(
+        self,
+        callback: CallbackType,
+        timeframe: Timeframe,
+        *,
+        symbol: None = None,
+        symbols: Sequence[str],
+    ) -> Websocket: ...
+
+    def futures_klines(
+        self,
+        callback: CallbackType,
+        timeframe: Timeframe,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+    ) -> Websocket:
+        """Открывает стрим свечей (futures) с унификацией сообщений.
+
+        Параметры:
+            callback (`CallbackType`): Асинхронная функция обратного вызова для обработки сообщений.
+            timeframe (`Timeframe`): Временной интервал свечей.
+            symbol (`str | None`): Один символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для мультиплекс‑подключения.
+
+        Должен быть указан либо `symbol`, либо `symbols`.
+
+        Возвращает:
+            `Websocket`: Экземпляр вебсокета.
+        """
+        raise NotImplementedError()
+
+    @overload
+    def trades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: str,
+        symbols: None = None,
+    ) -> Websocket: ...
+
+    @overload
+    def trades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: None = None,
+        symbols: Sequence[str],
+    ) -> Websocket: ...
+
+    def trades(
+        self,
+        callback: CallbackType,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+    ) -> Websocket:
+        """Открывает стрим сделок (spot) с унификацией сообщений.
+
+        Параметры:
+            callback (`CallbackType`): Асинхронная функция обратного вызова для обработки сообщений.
+            symbol (`str | None`): Один символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для мультиплекс‑подключения.
+
+        Должен быть указан либо `symbol`, либо `symbols`.
+
+        Возвращает:
+            `Websocket`: Экземпляр вебсокета.
+        """
+        raise NotImplementedError()
+
+    @overload
+    def aggtrades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: str,
+        symbols: None = None,
+    ) -> Websocket: ...
+
+    @overload
+    def aggtrades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: None = None,
+        symbols: Sequence[str],
+    ) -> Websocket: ...
+
+    def aggtrades(
+        self,
+        callback: CallbackType,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+    ) -> Websocket:
+        """Открывает стрим агрегированных сделок (spot) с унификацией сообщений.
+
+        Параметры:
+            callback (`CallbackType`): Асинхронная функция обратного вызова для обработки сообщений.
+            symbol (`str | None`): Один символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для мультиплекс‑подключения.
+
+        Должен быть указан либо `symbol`, либо `symbols`.
+
+        Возвращает:
+            `Websocket`: Экземпляр вебсокета.
+        """
+        raise NotImplementedError()
+
+    @overload
+    def futures_trades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: str,
+        symbols: None = None,
+    ) -> Websocket: ...
+
+    @overload
+    def futures_trades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: None = None,
+        symbols: Sequence[str],
+    ) -> Websocket: ...
+
+    def futures_trades(
+        self,
+        callback: CallbackType,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+    ) -> Websocket:
+        """Открывает стрим сделок (futures) с унификацией сообщений.
+
+        Параметры:
+            callback (`CallbackType`): Асинхронная функция обратного вызова для обработки сообщений.
+            symbol (`str | None`): Один символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для мультиплекс‑подключения.
+
+        Должен быть указан либо `symbol`, либо `symbols`.
+
+        Возвращает:
+            `Websocket`: Экземпляр вебсокета.
+        """
+        raise NotImplementedError()
+
+    @overload
+    def futures_aggtrades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: str,
+        symbols: None = None,
+    ) -> Websocket: ...
+
+    @overload
+    def futures_aggtrades(
+        self,
+        callback: CallbackType,
+        *,
+        symbol: None = None,
+        symbols: Sequence[str],
+    ) -> Websocket: ...
+
+    def futures_aggtrades(
+        self,
+        callback: CallbackType,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+    ) -> Websocket:
+        """Открывает стрим агрегированных сделок (futures) с унификацией сообщений.
+
+        Параметры:
+            callback (`CallbackType`): Асинхронная функция обратного вызова для обработки сообщений.
+            symbol (`str | None`): Один символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для мультиплекс‑подключения.
+
+        Должен быть указан либо `symbol`, либо `symbols`.
+
+        Возвращает:
+            `Websocket`: Экземпляр вебсокета.
+        """
+        raise NotImplementedError()

unicex/kucoin/user_websocket.py

@@ -0,0 +1,7 @@
+__all__ = ["UserWebsocket"]
+
+
+class UserWebsocket:
+    """Пользовательский вебсокет Kucoin."""
+
+    pass

unicex/kucoin/websocket_manager.py

@@ -0,0 +1,11 @@
+__all__ = ["WebsocketManager"]
+
+
+from collections.abc import Awaitable, Callable
+from typing import Any
+
+type CallbackType = Callable[[Any], Awaitable[None]]
+
+
+class WebsocketManager:
+    """Менеджер асинхронных вебсокетов для Kucoin."""

unicex/mapper.py

@@ -25,6 +25,9 @@ from .gate import UniWebsocketManager as GateioUniWebsocketManager
 from .hyperliquid import ExchangeInfo as HyperliquidExchangeInfo
 from .hyperliquid import UniClient as HyperliquidUniClient
 from .hyperliquid import UniWebsocketManager as HyperliquidUniWebsocketManager
+from .kucoin import ExchangeInfo as KucoinExchangeInfo
+from .kucoin import UniClient as KucoinUniClient
+from .kucoin import UniWebsocketManager as KucoinUniWebsocketManager
 from .mexc import ExchangeInfo as MexcExchangeInfo
 from .mexc import UniClient as MexcUniClient
 from .mexc import UniWebsocketManager as MexcUniWebsocketManager
@@ -40,6 +43,7 @@ _UNI_CLIENT_MAPPER: dict[Exchange, type[IUniClient]] = {
     Exchange.HYPERLIQUID: HyperliquidUniClient,
     Exchange.MEXC: MexcUniClient,
     Exchange.OKX: OkxUniClient,
+    Exchange.KUCOIN: KucoinUniClient,
 }
 """Маппер, который связывает биржу и реализацию унифицированного клиента."""
 
@@ -51,6 +55,7 @@ _UNI_WS_MANAGER_MAPPER: dict[Exchange, type[IUniWebsocketManager]] = {
     Exchange.HYPERLIQUID: HyperliquidUniWebsocketManager,
     Exchange.MEXC: MexcUniWebsocketManager,
     Exchange.OKX: OkxUniWebsocketManager,
+    Exchange.KUCOIN: KucoinUniWebsocketManager,
 }
 """Маппер, который связывает биржу и реализацию унифицированного вебсокет-менеджера."""
 
@@ -62,6 +67,7 @@ _EXCHANGE_INFO_MAPPER: dict[Exchange, type[IExchangeInfo]] = {
     Exchange.HYPERLIQUID: HyperliquidExchangeInfo,
     Exchange.MEXC: MexcExchangeInfo,
     Exchange.OKX: OkxExchangeInfo,
+    Exchange.KUCOIN: KucoinExchangeInfo,
 }
 """Маппер, который связывает биржу и реализацию сборщика информации о тикерах на бирже."""
 

{unicex-0.13.18.dist-info → unicex-0.14.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.13.18
+Version: 0.14.1
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License

{unicex-0.13.18.dist-info → unicex-0.14.1.dist-info}/RECORD

@@ -1,8 +1,8 @@
-unicex/__init__.py,sha256=Ny1l_NVM_FSaT0ZtiJ75dRmXMC67G9aoKnu8kKcWICE,5768
-unicex/enums.py,sha256=8S72iJvD1Hd8i9EmF8KshJEEfAYe9dITVcIxBLREjn0,9625
+unicex/__init__.py,sha256=todVh-ePhe2HSqndToGZtpIk5fUow4pbzTFmL3X98tQ,6318
+unicex/enums.py,sha256=agHr6nhfTm1emLzvOxkwRxBUQBZ_7N1xS684hvm8ym4,9591
 unicex/exceptions.py,sha256=r-xZzX78VuxVnI5pe99AM8FIiGcdIUDcF5CaTkQ4NE0,2213
-unicex/extra.py,sha256=bU88Oh4-9Cvc2vuuf2fDGksUR7gvdluDh99O0m-vDFo,13830
-unicex/mapper.py,sha256=PPMC5E8smjmhXwiOCQG3WIc_-8wZ3iZGey6HiLiN7TQ,4903
+unicex/extra.py,sha256=Ki0ZvF88BNpnt-k-c-AgdUig80f-Yi1gTt8qqO7M5ss,13492
+unicex/mapper.py,sha256=yncbMCecZ3nvGtUyvWaiQAQ3RWGAAmm3MEi6Y7YJUG4,5203
 unicex/types.py,sha256=QmhBTfSXX0Ie5E_wDJJmVDLZFMocg6mzh3yBjDAr96Y,4630
 unicex/utils.py,sha256=xzeP8E2bBoie8GvxW97FPEu_QPYMxiNgc9zX7yrdsfk,8048
 unicex/_abc/__init__.py,sha256=fxZjNFJFeFwWTXz8iSDe7eCWwE6xfFwFwAuG6l-TI8A,289
@@ -52,6 +52,14 @@ unicex/hyperliquid/uni_client.py,sha256=4jv2uC076PBeq-EzCKvwaEEMk_M3HpsWA6iwNepJ
 unicex/hyperliquid/uni_websocket_manager.py,sha256=AzR_8Aq98NkCA1oc2IiH02ysMOYLaisEmcuuaafeaJw,9334
 unicex/hyperliquid/user_websocket.py,sha256=BKD9ap2bx5DwpkkwwecfOTVedrZBR9eMAITgCBgg02w,134
 unicex/hyperliquid/websocket_manager.py,sha256=mlsQYykFHfQr-k6AZ3b6JfK7DnnhGtt4MRemZg4O9X4,17991
+unicex/kucoin/__init__.py,sha256=7RSMUDiqjmj8T1cvotlRu8LKH-Ok9UlajSrlXyq1mnc,929
+unicex/kucoin/adapter.py,sha256=dPUFJFIbNmxXfB9qsYlGIYjDttVjX7YSGGoYAJ6jY5w,3531
+unicex/kucoin/client.py,sha256=z37R2vOt4YsJFMI0sG-lRJgrPmN3hSkkYFccErqzH4o,1104
+unicex/kucoin/exchange_info.py,sha256=FjazsBe0_M5vhJer9hL-GrKxsuRqz73IOQ7clXFjuH0,788
+unicex/kucoin/uni_client.py,sha256=yCYgBv6nTYvn0Wt0guFVYZyh6OXbmQMDr4r81D-UqBY,6924
+unicex/kucoin/uni_websocket_manager.py,sha256=B9LZxp7KgitSq8k0Gk2lFcZr51mwStRWFfksz-5DL14,9329
+unicex/kucoin/user_websocket.py,sha256=Tx0yuGpf2HrPbcOHHZioYjVp6LBfagOKF-zzD3UM0Ok,129
+unicex/kucoin/websocket_manager.py,sha256=GNNpzxONgTuTByrsGk1MNMlj5-zx5vs_WBTgssYSYDQ,270
 unicex/mexc/__init__.py,sha256=lltANqM_2P-fmF5j8o5-pjmORPuK6C5sVjcQhuUU_R0,923
 unicex/mexc/adapter.py,sha256=6Ioy6IvXHDRKVBTXnofUYWubVvGx5lUCOxKA8R_ynxY,9862
 unicex/mexc/client.py,sha256=oJSpz-8hvA1WMCN2B7oqI2lXEx1_VJLAn8jbzhW8mF0,30950
@@ -86,8 +94,8 @@ unicex/okx/uni_client.py,sha256=E_Wod0JSGt1K6k1mAIWnOv350pELbv-nic7g1KgOuos,8694
 unicex/okx/uni_websocket_manager.py,sha256=b4f_QjA64DJmENQdIGb5IOVc7kvit7KMCdWeCmRbxGY,9326
 unicex/okx/user_websocket.py,sha256=8c9kpm-xVa729pW93OKUGLHaE9MY0uzEpjIgNIFRF80,126
 unicex/okx/websocket_manager.py,sha256=wROXTUDqKzOE-wDnCtXso_MC4SzfPuPols5aPg_Z3y4,26027
-unicex-0.13.18.dist-info/licenses/LICENSE,sha256=lNNK4Vqak9cXm6qVJLhbqS7iR_BMj6k7fd7XQ6l1k54,1507
-unicex-0.13.18.dist-info/METADATA,sha256=RbyUK_BO1KYvRqjhx2UTFohEnhz6hVwieAp2PI2Fmxg,11753
-unicex-0.13.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-unicex-0.13.18.dist-info/top_level.txt,sha256=_7rar-0OENIg4KRy6cgjWiebFYAJhjKEcMggAocGWG4,7
-unicex-0.13.18.dist-info/RECORD,,
+unicex-0.14.1.dist-info/licenses/LICENSE,sha256=lNNK4Vqak9cXm6qVJLhbqS7iR_BMj6k7fd7XQ6l1k54,1507
+unicex-0.14.1.dist-info/METADATA,sha256=BUTZCNtVx_QXjkLrvmyCAgvOjLEU_MsiPuj-14-XO84,11752
+unicex-0.14.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+unicex-0.14.1.dist-info/top_level.txt,sha256=_7rar-0OENIg4KRy6cgjWiebFYAJhjKEcMggAocGWG4,7
+unicex-0.14.1.dist-info/RECORD,,