unicex 0.13.18__tar.gz → 0.14.2__tar.gz

{unicex-0.13.18/unicex.egg-info → unicex-0.14.2}/PKG-INFO

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

{unicex-0.13.18 → unicex-0.14.2}/pyproject.toml

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

{unicex-0.13.18 → unicex-0.14.2}/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-0.13.18 → unicex-0.14.2}/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-0.13.18 → unicex-0.14.2}/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-0.14.2/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-0.14.2/unicex/kucoin/adapter.py

@@ -0,0 +1,91 @@
+__all__ = ["Adapter"]
+
+from typing import Any
+
+from unicex.types import OpenInterestDict, OpenInterestItem, TickerDailyDict, TickerDailyItem
+from unicex.utils import catch_adapter_errors, decorate_all_methods
+
+from .exchange_info import ExchangeInfo
+
+
+@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"]) * Adapter._get_contract_size(item["symbol"]),
+            )
+            for item in raw_data["data"]
+        }
+
+    @staticmethod
+    def _get_contract_size(symbol: str) -> float:
+        """Возвращает размер контракта для указанного символа тикера."""
+        try:
+            return ExchangeInfo.get_futures_ticker_info(symbol)["contract_size"] or 1
+        except:  # noqa
+            return 1

unicex-0.14.2/unicex/kucoin/client.py

@@ -0,0 +1,54 @@
+__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 symbol(
+        self,
+        trade_type: Literal["SPOT", "FUTURES", "ISOLATED", "CROSS"],
+        symbol: str | None = None,
+    ) -> dict[str, Any]:
+        """Получение символов и информации о них.
+
+        https://www.kucoin.com/docs-new/rest/ua/get-symbol
+        """
+        url = self._BASE_URL + "/api/ua/v1/market/instrument"
+        params = {"tradeType": trade_type}
+        if symbol:
+            params["symbol"] = symbol
+
+        return await self._make_request("GET", url, params=params)
+
+    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)
+
+    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)

unicex-0.14.2/unicex/kucoin/exchange_info.py

@@ -0,0 +1,47 @@
+__all__ = ["ExchangeInfo"]
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
+
+from .client import Client
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Kucoin."""
+
+    exchange_name = "Kucoin"
+    """Название биржи, на которой работает класс."""
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        tickers_info = {}
+        exchange_info = await Client(session).symbol("SPOT")
+        for el in exchange_info["data"]["list"]:
+            tickers_info[el["symbol"]] = TickerInfoItem(
+                tick_precision=None,
+                tick_step=None,
+                size_precision=None,
+                size_step=None,
+                contract_size=1,
+            )
+
+        cls._tickers_info = tickers_info
+
+    @classmethod
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        tickers_info = {}
+        exchange_info = await Client(session).symbol("FUTURES")
+        for el in exchange_info["data"]["list"]:
+            tickers_info[el["symbol"]] = TickerInfoItem(
+                tick_precision=None,
+                tick_step=None,
+                size_precision=None,
+                size_step=None,
+                contract_size=float(el["unitSize"]),
+            )
+
+        cls._futures_tickers_info = tickers_info

unicex-0.14.2/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-0.14.2/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-0.14.2/unicex/kucoin/user_websocket.py

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

unicex-0.14.2/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-0.13.18 → unicex-0.14.2}/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 → unicex-0.14.2}/unicex/okx/adapter.py

@@ -10,8 +10,6 @@ from unicex.types import (
 )
 from unicex.utils import catch_adapter_errors, decorate_all_methods
 
-from .exchange_info import ExchangeInfo
-
 
 @decorate_all_methods(catch_adapter_errors)
 class Adapter:
@@ -140,11 +138,3 @@ class Adapter:
             )
             for item in raw_data["data"]
         }
-
-    @staticmethod
-    def _get_contract_size(symbol: str) -> float:
-        """Возвращает размер контракта для указанного символа тикера."""
-        try:
-            return ExchangeInfo.get_futures_ticker_info(symbol)["contract_size"] or 1
-        except:  # noqa
-            return 1

{unicex-0.13.18 → unicex-0.14.2/unicex.egg-info}/PKG-INFO

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

{unicex-0.13.18 → unicex-0.14.2}/unicex.egg-info/SOURCES.txt

@@ -60,6 +60,14 @@ unicex/hyperliquid/uni_client.py
 unicex/hyperliquid/uni_websocket_manager.py
 unicex/hyperliquid/user_websocket.py
 unicex/hyperliquid/websocket_manager.py
+unicex/kucoin/__init__.py
+unicex/kucoin/adapter.py
+unicex/kucoin/client.py
+unicex/kucoin/exchange_info.py
+unicex/kucoin/uni_client.py
+unicex/kucoin/uni_websocket_manager.py
+unicex/kucoin/user_websocket.py
+unicex/kucoin/websocket_manager.py
 unicex/mexc/__init__.py
 unicex/mexc/adapter.py
 unicex/mexc/client.py