unicex 0.4.0__py3-none-any.whl → 0.7.0__py3-none-any.whl

unicex/__init__.py

@@ -4,18 +4,28 @@ __all__ = [
     # Mappers
     "get_uni_client",
     "get_uni_websocket_manager",
+    "get_exchange_info",
+    # Exchanges info
+    "load_exchanges_info",
+    "start_exchanges_info",
     # Enums
     "MarketType",
     "Exchange",
     "Timeframe",
     "Side",
     # Types
+    "TickerDailyDict",
+    "TickerDailyItem",
     "KlineDict",
-    "AggTradeDict",
     "TradeDict",
-    "TickerDailyDict",
+    "AggTradeDict",
     "RequestMethod",
     "LoggerLike",
+    "AccountType",
+    "OpenInterestDict",
+    "OpenInterestItem",
+    "TickerInfoItem",
+    "TickersInfoDict",
     # Interfaces
     "IUniClient",
     "IUniWebsocketManager",
@@ -28,109 +38,62 @@ __all__ = [
     "BinanceWebsocketManager",
     "BinanceUniWebsocketManager",
     "BinanceUserWebsocket",
+    "BinanceExchangeInfo",
     # Bitget
     "BitgetClient",
     "BitgetUniClient",
     "BitgetUniWebsocketManager",
     "BitgetWebsocketManager",
     "BitgetUserWebsocket",
-    # Bitrue
-    "BitrueClient",
-    "BitrueUniClient",
-    "BitrueUniWebsocketManager",
-    "BitrueWebsocketManager",
-    "BitrueUserWebsocket",
+    "BitgetExchangeInfo",
     # Mexc
     "MexcClient",
     "MexcUniClient",
     "MexcUniWebsocketManager",
     "MexcWebsocketManager",
     "MexcUserWebsocket",
+    "MexcExchangeInfo",
     # Bybit
     "BybitClient",
     "BybitUniClient",
     "BybitUniWebsocketManager",
     "BybitWebsocketManager",
     "BybitUserWebsocket",
+    "BybitExchangeInfo",
     # Okx
     "OkxClient",
     "OkxUniClient",
     "OkxUniWebsocketManager",
     "OkxWebsocketManager",
     "OkxUserWebsocket",
+    "OkxExchangeInfo",
     # Hyperliquid
     "HyperliquidClient",
     "HyperliquidUniClient",
     "HyperliquidUniWebsocketManager",
     "HyperliquidWebsocketManager",
     "HyperliquidUserWebsocket",
+    "HyperliquidExchangeInfo",
     # Gateio
     "GateioClient",
     "GateioUniClient",
     "GateioUniWebsocketManager",
     "GateioWebsocketManager",
     "GateioUserWebsocket",
-    # Bitunix
-    "BitunixClient",
-    "BitunixUniClient",
-    "BitunixUniWebsocketManager",
-    "BitunixWebsocketManager",
-    "BitunixUserWebsocket",
-    # Btse
-    "BtseClient",
-    "BtseUniClient",
-    "BtseUniWebsocketManager",
-    "BtseWebsocketManager",
-    "BtseUserWebsocket",
-    # Kcex
-    "KcexClient",
-    "KcexUniClient",
-    "KcexUniWebsocketManager",
-    "KcexWebsocketManager",
-    "KcexUserWebsocket",
-    # Kraken
-    "KrakenClient",
-    "KrakenUniClient",
-    "KrakenUniWebsocketManager",
-    "KrakenWebsocketManager",
-    "KrakenUserWebsocket",
-    # Kucoin
-    "KucoinClient",
-    "KucoinUniClient",
-    "KucoinUniWebsocketManager",
-    "KucoinWebsocketManager",
-    "KucoinUserWebsocket",
-    # Weex
-    "WeexClient",
-    "WeexUniClient",
-    "WeexUniWebsocketManager",
-    "WeexWebsocketManager",
-    "WeexUserWebsocket",
-    # Xt
-    "XtClient",
-    "XtUniClient",
-    "XtUniWebsocketManager",
-    "XtWebsocketManager",
-    "XtUserWebsocket",
+    "GateioExchangeInfo",
 ]
 
 # ruff: noqa
 
 # abstract & base
+import asyncio
 from ._abc import IUniClient, IUniWebsocketManager
 from ._base import BaseClient, Websocket
 
 # enums, mappers, types
 from .enums import Exchange, MarketType, Side, Timeframe
-from .mapper import get_uni_client, get_uni_websocket_manager
-from .types import (
-    AggTradeDict,
-    KlineDict,
-    LoggerLike,
-    RequestMethod,
-    TickerDailyDict,
-    TradeDict,
-)
+from .mapper import get_uni_client, get_uni_websocket_manager, get_exchange_info
+from .types import *
 
 # exchanges
 
@@ -140,6 +103,7 @@ from .binance import (
     UniWebsocketManager as BinanceUniWebsocketManager,
     UserWebsocket as BinanceUserWebsocket,
     WebsocketManager as BinanceWebsocketManager,
+    ExchangeInfo as BinanceExchangeInfo,
 )
 
 from .bitget import (
@@ -148,30 +112,7 @@ from .bitget import (
     UniWebsocketManager as BitgetUniWebsocketManager,
     UserWebsocket as BitgetUserWebsocket,
     WebsocketManager as BitgetWebsocketManager,
-)
-
-from .bitrue import (
-    Client as BitrueClient,
-    UniClient as BitrueUniClient,
-    UniWebsocketManager as BitrueUniWebsocketManager,
-    UserWebsocket as BitrueUserWebsocket,
-    WebsocketManager as BitrueWebsocketManager,
-)
-
-from .bitunix import (
-    Client as BitunixClient,
-    UniClient as BitunixUniClient,
-    UniWebsocketManager as BitunixUniWebsocketManager,
-    UserWebsocket as BitunixUserWebsocket,
-    WebsocketManager as BitunixWebsocketManager,
-)
-
-from .btse import (
-    Client as BtseClient,
-    UniClient as BtseUniClient,
-    UniWebsocketManager as BtseUniWebsocketManager,
-    UserWebsocket as BtseUserWebsocket,
-    WebsocketManager as BtseWebsocketManager,
+    ExchangeInfo as BitgetExchangeInfo,
 )
 
 from .bybit import (
@@ -180,6 +121,7 @@ from .bybit import (
     UniWebsocketManager as BybitUniWebsocketManager,
     UserWebsocket as BybitUserWebsocket,
     WebsocketManager as BybitWebsocketManager,
+    ExchangeInfo as BybitExchangeInfo,
 )
 
 from .gateio import (
@@ -188,6 +130,7 @@ from .gateio import (
     UniWebsocketManager as GateioUniWebsocketManager,
     UserWebsocket as GateioUserWebsocket,
     WebsocketManager as GateioWebsocketManager,
+    ExchangeInfo as GateioExchangeInfo,
 )
 
 from .hyperliquid import (
@@ -196,30 +139,7 @@ from .hyperliquid import (
     UniWebsocketManager as HyperliquidUniWebsocketManager,
     UserWebsocket as HyperliquidUserWebsocket,
     WebsocketManager as HyperliquidWebsocketManager,
-)
-
-from .kcex import (
-    Client as KcexClient,
-    UniClient as KcexUniClient,
-    UniWebsocketManager as KcexUniWebsocketManager,
-    UserWebsocket as KcexUserWebsocket,
-    WebsocketManager as KcexWebsocketManager,
-)
-
-from .kraken import (
-    Client as KrakenClient,
-    UniClient as KrakenUniClient,
-    UniWebsocketManager as KrakenUniWebsocketManager,
-    UserWebsocket as KrakenUserWebsocket,
-    WebsocketManager as KrakenWebsocketManager,
-)
-
-from .kucoin import (
-    Client as KucoinClient,
-    UniClient as KucoinUniClient,
-    UniWebsocketManager as KucoinUniWebsocketManager,
-    UserWebsocket as KucoinUserWebsocket,
-    WebsocketManager as KucoinWebsocketManager,
+    ExchangeInfo as HyperliquidExchangeInfo,
 )
 
 from .mexc import (
@@ -228,6 +148,7 @@ from .mexc import (
     UniWebsocketManager as MexcUniWebsocketManager,
     UserWebsocket as MexcUserWebsocket,
     WebsocketManager as MexcWebsocketManager,
+    ExchangeInfo as MexcExchangeInfo,
 )
 
 from .okx import (
@@ -236,20 +157,31 @@ from .okx import (
     UniWebsocketManager as OkxUniWebsocketManager,
     UserWebsocket as OkxUserWebsocket,
     WebsocketManager as OkxWebsocketManager,
-)
-
-from .weex import (
-    Client as WeexClient,
-    UniClient as WeexUniClient,
-    UniWebsocketManager as WeexUniWebsocketManager,
-    UserWebsocket as WeexUserWebsocket,
-    WebsocketManager as WeexWebsocketManager,
-)
-
-from .xt import (
-    Client as XtClient,
-    UniClient as XtUniClient,
-    UniWebsocketManager as XtUniWebsocketManager,
-    UserWebsocket as XtUserWebsocket,
-    WebsocketManager as XtWebsocketManager,
-)
+    ExchangeInfo as OkxExchangeInfo,
+)
+
+
+async def load_exchanges_info() -> None:
+    """Единожды загружает информацию о тикерах на всех биржах."""
+    await asyncio.gather(
+        BinanceExchangeInfo.load_exchange_info(),
+        BitgetExchangeInfo.load_exchange_info(),
+        BybitExchangeInfo.load_exchange_info(),
+        GateioExchangeInfo.load_exchange_info(),
+        HyperliquidExchangeInfo.load_exchange_info(),
+        MexcExchangeInfo.load_exchange_info(),
+        OkxExchangeInfo.load_exchange_info(),
+    )
+
+
+async def start_exchanges_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает цикл обновления информации о тикерах на всех биржах."""
+    asyncio.gather(
+        BinanceExchangeInfo.start(parse_interval_seconds),
+        BitgetExchangeInfo.start(parse_interval_seconds),
+        BybitExchangeInfo.start(parse_interval_seconds),
+        GateioExchangeInfo.start(parse_interval_seconds),
+        HyperliquidExchangeInfo.start(parse_interval_seconds),
+        MexcExchangeInfo.start(parse_interval_seconds),
+        OkxExchangeInfo.start(parse_interval_seconds),
+    )

unicex/_abc/__init__.py

@@ -1,7 +1,9 @@
 __all__ = [
     "IUniClient",
     "IUniWebsocketManager",
+    "IExchangeInfo",
 ]
 
+from .exchange_info import IExchangeInfo
 from .uni_client import IUniClient
 from .uni_websocket_manager import IUniWebsocketManager

unicex/_abc/exchange_info.py

@@ -0,0 +1,176 @@
+__all__ = ["IExchangeInfo"]
+
+import asyncio
+from abc import ABC, abstractmethod
+from decimal import Decimal
+from typing import TYPE_CHECKING
+
+from loguru import logger
+
+from unicex.enums import MarketType
+from unicex.types import TickerInfoItem, TickersInfoDict
+
+if TYPE_CHECKING:
+    import loguru
+
+
+class IExchangeInfo(ABC):
+    """Интерфейс для наследников, которые предзагружают и обновляют информацию о бирже."""
+
+    _loaded: bool
+    """Флаг, указывающий, была ли информация о бирже загружена."""
+
+    _running: bool
+    """Флаг, указывающий, запущена ли фоновая задача для обновления информации о бирже."""
+
+    _tickers_info: TickersInfoDict
+    """Словарь с информацией о округлении для каждого тикера."""
+
+    _futures_tickers_info: TickersInfoDict
+    """Словарь с информацией о округлении и размере контракта (если есть) для каждого тикера."""
+
+    _logger: "loguru.Logger"
+    """Логгер для записи сообщений о работе с биржей."""
+
+    def __init_subclass__(cls, **kwargs):
+        """Инициализация подкласса. Функция нужна, чтобы у каждого наследника была своя копия атрибутов."""
+        super().__init_subclass__(**kwargs)
+        cls._tickers_info = {}
+        cls._loaded = False
+        cls._running = False
+        cls._logger = logger
+
+    @classmethod
+    async def start(cls, update_interval_seconds: int = 60 * 60) -> None:
+        """Запускает фоновую задачу с бесконечным циклом для загрузки данных."""
+        cls._running = True
+        asyncio.create_task(cls._load_exchange_info_loop(update_interval_seconds))
+
+    @classmethod
+    async def stop(cls) -> None:
+        """Останавливает фоновую задачу для обновления информации о бирже."""
+        cls._running = False
+
+    @classmethod
+    async def set_logger(cls, logger: "loguru.Logger") -> None:
+        """Устанавливает логгер для записи сообщений о работе с биржей."""
+        cls._logger = logger
+
+    @classmethod
+    async def _load_exchange_info_loop(cls, update_interval_seconds: int) -> None:
+        """Запускает бесконечный цикл для загрузки данных о бирже."""
+        while cls._running:
+            try:
+                await cls.load_exchange_info()
+            except Exception as e:
+                cls._logger.error(f"Error loading exchange data: {e}")
+            for _ in range(update_interval_seconds):
+                if not cls._running:
+                    break
+                await asyncio.sleep(1)
+
+    @classmethod
+    async def load_exchange_info(cls) -> None:
+        """Принудительно вызывает загрузку информации о бирже."""
+        await cls._load_exchange_info()
+        cls._loaded = True
+
+    @classmethod
+    def get_ticker_info(
+        cls, symbol: str, market_type: MarketType = MarketType.SPOT
+    ) -> TickerInfoItem:  # type: ignore[reportReturnType]
+        """Возвращает информацию о тикере по его символу."""
+        try:
+            if market_type == MarketType.SPOT:
+                return cls._tickers_info[symbol]
+            return cls._futures_tickers_info[symbol]
+        except KeyError as e:
+            cls._handle_key_error(e, symbol)
+
+    @classmethod
+    def get_futures_ticker_info(cls, symbol: str) -> TickerInfoItem:
+        """Возвращает информацию о тикере фьючерсов по его символу."""
+        return cls.get_ticker_info(symbol, MarketType.FUTURES)
+
+    @classmethod
+    @abstractmethod
+    async def _load_exchange_info(cls) -> None:
+        """Загружает информацию о бирже."""
+        ...
+
+    @classmethod
+    def round_price(
+        cls, symbol: str, price: float, market_type: MarketType = MarketType.SPOT
+    ) -> float:
+        """Округляет цену до ближайшего возможного значения."""
+        try:
+            if market_type == MarketType.SPOT:
+                precision = cls._tickers_info[symbol]["tick_precision"]
+            else:
+                precision = cls._futures_tickers_info[symbol]["tick_precision"]
+        except KeyError as e:
+            cls._handle_key_error(e, symbol)
+        return round(price, precision)
+
+    @classmethod
+    def round_quantity(
+        cls, symbol: str, quantity: float, market_type: MarketType = MarketType.SPOT
+    ) -> float:
+        """Округляет объем до ближайшего возможного значения."""
+        try:
+            if market_type == MarketType.SPOT:
+                precision = cls._tickers_info[symbol]["size_precision"]
+            else:
+                precision = cls._futures_tickers_info[symbol]["size_precision"]
+        except KeyError as e:
+            cls._handle_key_error(e, symbol)
+        return round(quantity, precision)
+
+    @classmethod
+    def round_futures_price(cls, symbol: str, price: float) -> float:
+        """Округляет цену до ближайшего возможного значения на фьючерсах."""
+        return cls.round_price(symbol, price, MarketType.FUTURES)
+
+    @classmethod
+    def round_futures_quantity(cls, symbol: str, quantity: float) -> float:
+        """Округляет объем до ближайшего возможного значения на фьючерсах."""
+        return cls.round_quantity(symbol, quantity, MarketType.FUTURES)
+
+    @staticmethod
+    def _step_size_to_precision(tick_size: str | int | float) -> int:
+        """Возвращает precision для round(x, precision) по шагу цены/объёма.
+
+        Работает только для шагов — степеней 10.
+        Примеры:
+            "0.0001" ->  4
+            "0.01"   ->  2
+            "0.1"    ->  1
+            "1"      ->  0
+            "10"     -> -1
+            "100"    -> -2
+        """
+        d = Decimal(str(tick_size)).normalize()
+        if d <= 0:
+            raise ValueError("tick_size must be > 0")
+
+        t = d.as_tuple()
+        # Степень десяти даёт один значащий разряд = 1 (1eN)
+        if t.digits == (1,):
+            return -t.exponent  # type: ignore
+
+        # Иначе это не степень 10 (например, 0.5, 5 и т.п.)
+        raise ValueError(
+            f"tick_size={tick_size} is not a power of 10; cannot map to round() precision."
+        )
+
+    @classmethod
+    def _handle_key_error(cls, exception: KeyError, symbol: str) -> None:
+        """Обрабатывает KeyError при получении информации о тикере."""
+        cls._check_loaded()
+        raise KeyError(f"Symbol {symbol} not found") from exception
+
+    @classmethod
+    def _check_loaded(cls) -> None:
+        """Проверяет, загружены ли данные об обмене."""
+        if not cls._loaded:
+            raise ValueError("Exchange data not loaded") from None

unicex/_abc/uni_client.py

@@ -172,7 +172,7 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `list[list[str]]`: Список тикеров в чанках.
         """
-        tickers = await self.tickers(only_usdt=only_usdt)
+        tickers = await self.tickers(only_usdt)
         return batched_list(tickers, batch_size)
 
     @abstractmethod
@@ -199,7 +199,7 @@ class IUniClient(ABC, Generic[TClient]):
         Возвращает:
             `list[list[str]]`: Список тикеров в чанках.
         """
-        tickers = await self.futures_tickers(only_usdt=only_usdt)
+        tickers = await self.futures_tickers(only_usdt)
         return batched_list(tickers, batch_size)
 
     @abstractmethod

unicex/_base/client.py

@@ -33,7 +33,7 @@ class BaseClient:
             session (`aiohttp.ClientSession`): Сессия для выполнения HTTP‑запросов.
             api_key (`str | None`): Ключ API для аутентификации.
             api_secret (`str | None`): Секретный ключ API для аутентификации.
-            api_passphrase (`str | None`): Пароль API для аутентификации (Bitget).
+            api_passphrase (`str | None`): Пароль API для аутентификации (Bitget, OKX).
             logger (`LoggerLike | None`): Логгер для вывода информации.
             max_retries (`int`): Максимальное количество повторных попыток запроса.
             retry_delay (`int | float`): Задержка между повторными попытками, сек.
@@ -68,7 +68,7 @@ class BaseClient:
         Параметры:
             api_key (`str | None`): Ключ API для аутентификации.
             api_secret (`str | None`): Секретный ключ API для аутентификации.
-            api_passphrase (`str | None`): Пароль API для аутентификации (Bitget).
+            api_passphrase (`str | None`): Пароль API для аутентификации (Bitget, OKX).
             session (`aiohttp.ClientSession | None`): Сессия для HTTP‑запросов (если не передана, будет создана).
             logger (`LoggerLike | None`): Логгер для вывода информации.
             max_retries (`int`): Максимум повторов при ошибках запроса.

unicex/binance/__init__.py

@@ -6,10 +6,22 @@ __all__ = [
     "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:
+    """Загружает информацию о бирже Binance."""
+    await ExchangeInfo.load_exchange_info()
+
+
+async def start_exchange_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает процесс обновления информации о бирже Binance."""
+    await ExchangeInfo.start(parse_interval_seconds)

unicex/binance/adapter.py

@@ -28,7 +28,7 @@ class Adapter:
             list[str]: Список тикеров.
         """
         return [
-            item["symbol"] for item in raw_data if not only_usdt or item["symbol"].endswith("USDT")
+            item["symbol"] for item in raw_data if item["symbol"].endswith("USDT") or not only_usdt
         ]
 
     @staticmethod

unicex/binance/exchange_info.py

@@ -0,0 +1,12 @@
+__all__ = ["ExchangeInfo"]
+
+from unicex._abc import IExchangeInfo
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Binance."""
+
+    @classmethod
+    async def _load_exchange_info(cls) -> None:
+        """Загружает информацию о бирже."""
+        ...

unicex/bitget/__init__.py

@@ -2,16 +2,26 @@
 
 __all__ = [
     "Client",
-    "WebsocketManager",
-    "UniWebsocketManager",
     "UniClient",
-    "Adapter",
     "UserWebsocket",
+    "WebsocketManager",
+    "UniWebsocketManager",
+    "ExchangeInfo",
 ]
 
-from .adapter import Adapter
 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:
+    """Загружает информацию о бирже Bitget."""
+    await ExchangeInfo.load_exchange_info()
+
+
+async def start_exchange_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает процесс обновления информации о бирже Bitget."""
+    await ExchangeInfo.start(parse_interval_seconds)

unicex/bitget/adapter.py

@@ -30,7 +30,7 @@ class Adapter:
         return [
             item["symbol"]
             for item in raw_data["data"]
-            if not only_usdt or item["symbol"].endswith("USDT")
+            if item["symbol"].endswith("USDT") or not only_usdt
         ]
 
     @staticmethod

unicex/bitget/exchange_info.py

@@ -0,0 +1,12 @@
+__all__ = ["ExchangeInfo"]
+
+from unicex._abc import IExchangeInfo
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Bitget."""
+
+    @classmethod
+    async def _load_exchange_info(cls) -> None:
+        """Загружает информацию о бирже."""
+        ...

unicex/bitget/uni_websocket_manager.py

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

unicex/bybit/__init__.py

@@ -6,10 +6,22 @@ __all__ = [
     "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:
+    """Загружает информацию о бирже Bybit."""
+    await ExchangeInfo.load_exchange_info()
+
+
+async def start_exchange_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает процесс обновления информации о бирже Bybit."""
+    await ExchangeInfo.start(parse_interval_seconds)

unicex/bybit/adapter.py

@@ -29,7 +29,7 @@ class Adapter:
         return [
             item["symbol"]
             for item in raw_data["result"]["list"]
-            if only_usdt or item["symbol"].endswith("USDT")
+            if item["symbol"].endswith("USDT") or not only_usdt
         ]
 
     @staticmethod

unicex/bybit/exchange_info.py

@@ -0,0 +1,12 @@
+__all__ = ["ExchangeInfo"]
+
+from unicex._abc import IExchangeInfo
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Bybit."""
+
+    @classmethod
+    async def _load_exchange_info(cls) -> None:
+        """Загружает информацию о бирже."""
+        ...