unicex 0.11.0__tar.gz → 0.13.0__tar.gz

{unicex-0.11.0/unicex.egg-info → unicex-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.11.0
+Version: 0.13.0
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License
@@ -49,18 +49,18 @@ Dynamic: license-file
 
 # Unified Crypto Exchange API
 
-`unicex` — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж.
+`unicex` — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж. Поддерживает спотовый и USDT-фьючерсный рынки.
 
 ## ✅ Статус реализации
 
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
-| **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              |              |
-| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                |              |
-| **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              |              |
-| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                |              |
+| **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
+| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
+| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
 | **Hyperliquid** | ✓      | ✓    | ✓          | ✓       | ✓          |                |              |
-| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                |              |
+| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
 | **Okx**         | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
 ---
 
@@ -191,3 +191,53 @@ async def callback(trade: TradeDict) -> None:
 if __name__ == "__main__":
     asyncio.run(main())
 ```
+
+
+### Пример: Округление цен используя фоновый класс ExchangeInfo
+
+
+```python
+import asyncio
+from unicex import start_exchanges_info, get_exchange_info, Exchange
+
+
+async def main() -> None:
+    # ⏳ Запускаем фоновые процессы, которые собирают рыночные параметры всех бирж:
+    #  - количество знаков после точки для цены и объема
+    #  - множители контрактов для фьючерсов
+    await start_exchanges_info()
+
+    # Небольшая пауза, чтобы данные успели подгрузиться
+    await asyncio.sleep(1)
+
+    # 1️⃣ Пример 1: Округление цены для фьючерсов OKX
+    okx_exchange_info = get_exchange_info(Exchange.OKX)
+    okx_rounded_price = okx_exchange_info.round_futures_price("BTC-USDT-SWAP", 123456.1234567890)
+    print(okx_rounded_price)  # >> 123456.1
+
+    # 2️⃣ Пример 2: Округление объема для спота Binance
+    binance_exchange_info = get_exchange_info(Exchange.BINANCE)
+    binance_rounded_quantity = binance_exchange_info.round_quantity("BTCUSDT", 1.123456789)
+    print(binance_rounded_quantity)  # >> 1.12345
+
+    # 3️⃣ Пример 3: Получение множителя контракта (например, Mexc Futures)
+    mexc_exchange_info = get_exchange_info(Exchange.MEXC)
+    mexc_contract_multiplier = mexc_exchange_info.get_futures_ticker_info("BTC_USDT")["contract_size"]
+    print(mexc_contract_multiplier)  # >> 0.0001
+
+    # 4️⃣ Пример 4: Реальное применение — вычисляем тейк-профит вручную
+    # Допустим, позиция открыта по 123123.1 USDT, хотим +3.5% тейк-профит:
+    take_profit_raw = 123123.1 * 1.035
+    print("До округления:", take_profit_raw)  # >> 127432.40849999999
+
+    # Биржа требует цену в допустимом формате — округляем:
+    take_profit = okx_exchange_info.round_futures_price("BTC-USDT-SWAP", take_profit_raw)
+    print("После округления:", take_profit)  # >> 127432.4
+
+    # Теперь это число можно безопасно передать в API без ошибок:
+    # await client.create_order(symbol="BTC-USDT-SWAP", price=take_profit, ...)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```

{unicex-0.11.0 → unicex-0.13.0}/README.md

@@ -1,17 +1,17 @@
 # Unified Crypto Exchange API
 
-`unicex` — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж.
+`unicex` — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж. Поддерживает спотовый и USDT-фьючерсный рынки.
 
 ## ✅ Статус реализации
 
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
-| **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              |              |
-| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                |              |
-| **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              |              |
-| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                |              |
+| **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
+| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
+| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
 | **Hyperliquid** | ✓      | ✓    | ✓          | ✓       | ✓          |                |              |
-| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                |              |
+| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
 | **Okx**         | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
 ---
 
@@ -142,3 +142,53 @@ async def callback(trade: TradeDict) -> None:
 if __name__ == "__main__":
     asyncio.run(main())
 ```
+
+
+### Пример: Округление цен используя фоновый класс ExchangeInfo
+
+
+```python
+import asyncio
+from unicex import start_exchanges_info, get_exchange_info, Exchange
+
+
+async def main() -> None:
+    # ⏳ Запускаем фоновые процессы, которые собирают рыночные параметры всех бирж:
+    #  - количество знаков после точки для цены и объема
+    #  - множители контрактов для фьючерсов
+    await start_exchanges_info()
+
+    # Небольшая пауза, чтобы данные успели подгрузиться
+    await asyncio.sleep(1)
+
+    # 1️⃣ Пример 1: Округление цены для фьючерсов OKX
+    okx_exchange_info = get_exchange_info(Exchange.OKX)
+    okx_rounded_price = okx_exchange_info.round_futures_price("BTC-USDT-SWAP", 123456.1234567890)
+    print(okx_rounded_price)  # >> 123456.1
+
+    # 2️⃣ Пример 2: Округление объема для спота Binance
+    binance_exchange_info = get_exchange_info(Exchange.BINANCE)
+    binance_rounded_quantity = binance_exchange_info.round_quantity("BTCUSDT", 1.123456789)
+    print(binance_rounded_quantity)  # >> 1.12345
+
+    # 3️⃣ Пример 3: Получение множителя контракта (например, Mexc Futures)
+    mexc_exchange_info = get_exchange_info(Exchange.MEXC)
+    mexc_contract_multiplier = mexc_exchange_info.get_futures_ticker_info("BTC_USDT")["contract_size"]
+    print(mexc_contract_multiplier)  # >> 0.0001
+
+    # 4️⃣ Пример 4: Реальное применение — вычисляем тейк-профит вручную
+    # Допустим, позиция открыта по 123123.1 USDT, хотим +3.5% тейк-профит:
+    take_profit_raw = 123123.1 * 1.035
+    print("До округления:", take_profit_raw)  # >> 127432.40849999999
+
+    # Биржа требует цену в допустимом формате — округляем:
+    take_profit = okx_exchange_info.round_futures_price("BTC-USDT-SWAP", take_profit_raw)
+    print("После округления:", take_profit)  # >> 127432.4
+
+    # Теперь это число можно безопасно передать в API без ошибок:
+    # await client.create_order(symbol="BTC-USDT-SWAP", price=take_profit, ...)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```

{unicex-0.11.0 → unicex-0.13.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.11.0"
+version = "0.13.0"
 
 description = "Unified Crypto Exchange API "
 readme = "README.md"

{unicex-0.11.0 → unicex-0.13.0}/unicex/_abc/exchange_info.py

@@ -1,10 +1,12 @@
 __all__ = ["IExchangeInfo"]
 
 import asyncio
+import math
 from abc import ABC, abstractmethod
 from decimal import Decimal
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, ClassVar
 
+import aiohttp
 from loguru import logger
 
 from unicex.enums import MarketType
@@ -32,6 +34,9 @@ class IExchangeInfo(ABC):
     _logger: "loguru.Logger"
     """Логгер для записи сообщений о работе с биржей."""
 
+    exchange_name: ClassVar[str] = "not_defined_exchange"
+    """Название биржи, на которой работает класс."""
+
     def __init_subclass__(cls, **kwargs):
         """Инициализация подкласса. Функция нужна, чтобы у каждого наследника была своя копия атрибутов."""
         super().__init_subclass__(**kwargs)
@@ -63,7 +68,7 @@ class IExchangeInfo(ABC):
             try:
                 await cls.load_exchange_info()
             except Exception as e:
-                cls._logger.error(f"Error loading exchange data: {e}")
+                cls._logger.error(f"Error loading exchange data for {cls.exchange_name}: {e}")
             for _ in range(update_interval_seconds):
                 if not cls._running:
                     break
@@ -72,9 +77,33 @@ class IExchangeInfo(ABC):
     @classmethod
     async def load_exchange_info(cls) -> None:
         """Принудительно вызывает загрузку информации о бирже."""
-        await cls._load_exchange_info()
+        async with aiohttp.ClientSession() as session:
+            try:
+                await cls._load_spot_exchange_info(session)
+                cls._logger.debug(f"Loaded spot exchange data for {cls.exchange_name} ")
+            except Exception as e:
+                cls._logger.error(f"Error loading spot exchange data for {cls.exchange_name}: {e}")
+            try:
+                await cls._load_futures_exchange_info(session)
+                cls._logger.debug(f"Loaded futures exchange data for {cls.exchange_name} ")
+            except Exception as e:
+                cls._logger.error(
+                    f"Error loading futures exchange data for {cls.exchange_name}: {e}"
+                )
         cls._loaded = True
 
+    @classmethod
+    @abstractmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        ...
+
+    @classmethod
+    @abstractmethod
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        ...
+
     @classmethod
     def get_ticker_info(
         cls, symbol: str, market_type: MarketType = MarketType.SPOT
@@ -92,39 +121,41 @@ class IExchangeInfo(ABC):
         """Возвращает информацию о тикере фьючерсов по его символу."""
         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:
+    ) -> float:  # type: ignore
         """Округляет цену до ближайшего возможного значения."""
         try:
             if market_type == MarketType.SPOT:
                 precision = cls._tickers_info[symbol]["tick_precision"]
+                step = cls._tickers_info[symbol]["tick_step"]
             else:
                 precision = cls._futures_tickers_info[symbol]["tick_precision"]
+                step = cls._futures_tickers_info[symbol]["tick_step"]
+            if precision:
+                return cls._floor_round(price, precision)
+            return cls._floor_to_step(price, step)  # type: ignore
         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:
+    ) -> float:  # type: ignore
         """Округляет объем до ближайшего возможного значения."""
         try:
             if market_type == MarketType.SPOT:
                 precision = cls._tickers_info[symbol]["size_precision"]
+                step = cls._tickers_info[symbol]["size_step"]
             else:
                 precision = cls._futures_tickers_info[symbol]["size_precision"]
+                step = cls._futures_tickers_info[symbol]["size_step"]
+            if precision:
+                return cls._floor_round(quantity, precision)
+            return cls._floor_to_step(quantity, step)  # type: ignore
         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:
@@ -137,31 +168,40 @@ class IExchangeInfo(ABC):
         return cls.round_quantity(symbol, quantity, MarketType.FUTURES)
 
     @staticmethod
-    def _step_size_to_precision(tick_size: str | int | float) -> int:
-        """Возвращает precision для round(x, precision) по шагу цены/объёма.
+    def _floor_to_step(value: float, step: float) -> float:
+        """Округляет число вниз до ближайшего кратного шага.
+
+        Принимает:
+            value (float): Исходное число.
+            step: (float): Шаг округления (> 0).
+
+        Возвращает:
+            Число, округлённое вниз до кратного step.
 
-        Работает только для шагов — степеней 10.
         Примеры:
-            "0.0001" ->  4
-            "0.01"   ->  2
-            "0.1"    ->  1
-            "1"      ->  0
-            "10"     -> -1
-            "100"    -> -2
+            >>> floor_to_step(0.16, 0.05)
+            0.15
+            >>> floor_to_step(16, 5)
+            15
+            >>> floor_to_step(1.2345, 0.01)
+            1.23
+            >>> floor_to_step(-1.23, 0.1)
+            -1.3
+            >>> floor_to_step(100, 25)
+            100
+
         """
-        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."
-        )
+        if step <= 0:
+            raise ValueError("step must be > 0")
+        result = math.floor(value / step) * step
+        digits = abs(Decimal(str(step)).as_tuple().exponent)  # type: ignore
+        return round(result, digits)
+
+    @staticmethod
+    def _floor_round(value: float, digits: int) -> float:
+        """Округляет число вниз до указанного количества знаков после запятой."""
+        factor = 10**digits
+        return math.floor(value * factor) / factor
 
     @classmethod
     def _handle_key_error(cls, exception: KeyError, symbol: str) -> None:

unicex-0.13.0/unicex/binance/exchange_info.py

@@ -0,0 +1,62 @@
+__all__ = ["ExchangeInfo"]
+
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
+
+from .client import Client
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Binance."""
+
+    exchange_name = "Binance"
+    """Название биржи, на которой работает класс."""
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        exchange_info = await Client(session).exchange_info()
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in exchange_info["symbols"]:
+            filters = {
+                flt["filterType"]: flt
+                for flt in symbol_info.get("filters", [])
+                if "filterType" in flt
+            }
+            price_filter = filters["PRICE_FILTER"]
+            lot_size_filter = filters["LOT_SIZE"]
+            tickers_info[symbol_info["symbol"]] = TickerInfoItem(
+                tick_step=float(price_filter["tickSize"]),
+                tick_precision=None,
+                size_step=float(lot_size_filter["stepSize"]),
+                size_precision=None,
+                contract_size=1,
+            )
+
+        cls._tickers_info = tickers_info
+
+    @classmethod
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        exchange_info = await Client(session).futures_exchange_info()
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in exchange_info["symbols"]:
+            filters = {
+                flt["filterType"]: flt
+                for flt in symbol_info.get("filters", [])
+                if "filterType" in flt
+            }
+            price_filter = filters["PRICE_FILTER"]
+            lot_size_filter = filters["LOT_SIZE"]
+            tickers_info[symbol_info["symbol"]] = TickerInfoItem(
+                tick_step=float(price_filter["tickSize"]),
+                tick_precision=None,
+                size_step=float(lot_size_filter["stepSize"]),
+                size_precision=None,
+                contract_size=1,
+            )
+
+        cls._futures_tickers_info = tickers_info

unicex-0.13.0/unicex/bitget/exchange_info.py

@@ -0,0 +1,48 @@
+__all__ = ["ExchangeInfo"]
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
+
+from .client import Client
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Bitget."""
+
+    exchange_name = "Bitget"
+    """Название биржи, на которой работает класс."""
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        exchange_info = await Client(session).get_symbol_info()
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in exchange_info["data"]:
+            tickers_info[symbol_info["symbol"]] = TickerInfoItem(
+                tick_precision=int(symbol_info["pricePrecision"]),
+                tick_step=None,
+                size_precision=int(symbol_info["quantityPrecision"]),
+                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: dict[str, TickerInfoItem] = {}
+        exchange_info = await Client(session).futures_get_contracts("USDT-FUTURES")
+        for symbol_info in exchange_info["data"]:
+            symbol = symbol_info["symbol"]
+            tickers_info[symbol] = TickerInfoItem(
+                tick_precision=int(symbol_info["pricePlace"]),
+                tick_step=None,
+                size_precision=int(symbol_info["volumePlace"]),
+                size_step=None,
+                contract_size=float(symbol_info["sizeMultiplier"]),
+            )
+
+        cls._futures_tickers_info = tickers_info

unicex-0.13.0/unicex/bybit/exchange_info.py

@@ -0,0 +1,51 @@
+__all__ = ["ExchangeInfo"]
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
+
+from .client import Client
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Bybit."""
+
+    exchange_name = "Bybit"
+    """Название биржи, на которой работает класс."""
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        exchange_info = await Client(session).instruments_info("spot")
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in exchange_info["result"]["list"]:
+            tickers_info[symbol_info["symbol"]] = TickerInfoItem(
+                tick_step=float(symbol_info["priceFilter"]["tickSize"]),
+                tick_precision=None,
+                size_step=float(symbol_info["lotSizeFilter"]["basePrecision"]),
+                size_precision=None,
+                contract_size=1,
+            )
+
+        cls._tickers_info = tickers_info
+
+    @classmethod
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        exchange_info = await Client(session).instruments_info("linear", limit=1000)
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in exchange_info["result"]["list"]:
+            try:
+                tickers_info[symbol_info["symbol"]] = TickerInfoItem(
+                    tick_step=float(symbol_info["priceFilter"]["tickSize"]),
+                    tick_precision=None,
+                    size_step=float(symbol_info["lotSizeFilter"]["qtyStep"]),
+                    size_precision=None,
+                    contract_size=1,
+                )
+            except ValueError as e:
+                cls._logger.trace(
+                    f"ValueError on {cls.exchange_name} by {symbol_info['symbol']}: {e}"
+                )
+        cls._futures_tickers_info = tickers_info

{unicex-0.11.0 → unicex-0.13.0}/unicex/gateio/client.py

@@ -4,7 +4,7 @@ import hashlib
 import hmac
 import json
 import time
-from typing import Any
+from typing import Any, Literal
 
 from unicex._base import BaseClient
 from unicex.exceptions import NotAuthorized
@@ -691,7 +691,7 @@ class Client(BaseClient):
 
     async def futures_contracts(
         self,
-        settle: str,
+        settle: Literal["usdt", "btc"],
         limit: int | None = None,
         offset: int | None = None,
     ) -> dict:

unicex-0.13.0/unicex/gateio/exchange_info.py

@@ -0,0 +1,55 @@
+__all__ = ["ExchangeInfo"]
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
+
+from .client import Client
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Gateio."""
+
+    exchange_name = "Gateio"
+    """Название биржи, на которой работает класс."""
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        currency_pairs = await Client(session).currency_pairs()
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in currency_pairs:
+            try:
+                tickers_info[symbol_info.get("id")] = TickerInfoItem(
+                    tick_precision=int(symbol_info["precision"]),
+                    tick_step=None,
+                    size_precision=int(symbol_info["amount_precision"]),
+                    size_step=None,
+                    contract_size=1,
+                )
+            except ValueError as e:
+                cls._logger.trace(
+                    f"ValueError on {cls.exchange_name} by {symbol_info['symbol']}: {e}"
+                )
+
+        cls._tickers_info = tickers_info
+
+    @classmethod
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        contracts = await Client(session).futures_contracts("usdt")
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for contract in contracts:
+            try:
+                tickers_info[contract.get("name")] = TickerInfoItem(
+                    tick_precision=None,
+                    tick_step=float(contract["order_price_round"]),
+                    size_precision=None,
+                    size_step=float(contract["quanto_multiplier"]),
+                    contract_size=float(contract["quanto_multiplier"]),
+                )
+            except ValueError as e:
+                cls._logger.trace(f"ValueError on {cls.exchange_name} by {contract['name']}: {e}")
+
+        cls._futures_tickers_info = tickers_info

{unicex-0.11.0 → unicex-0.13.0}/unicex/hyperliquid/exchange_info.py

@@ -1,6 +1,9 @@
 __all__ = ["ExchangeInfo"]
 
+import aiohttp
+
 from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
 
 from .client import Client
 
@@ -8,6 +11,9 @@ from .client import Client
 class ExchangeInfo(IExchangeInfo):
     """Предзагружает информацию о тикерах для биржи Hyperliquid."""
 
+    exchange_name = "Hyperliquid"
+    """Название биржи, на которой работает класс."""
+
     _spot_meta: dict = {}
     """Словарь с метаинформацией о спотовом рынке."""
 
@@ -20,17 +26,30 @@ class ExchangeInfo(IExchangeInfo):
     _futures_meta: dict = {}
     """Словарь с метаинформацией о фьючерсном рынке."""
 
+    # DOCS: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size
+
+    @classmethod
+    async def _load_spot_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для спотового рынка."""
+        cls._spot_meta = await Client(session).spot_metadata()
+        cls._build_spot_mappings(cls._spot_meta)
+
+        tickers_info: dict[str, TickerInfoItem] = {}
+        for symbol_info in cls._spot_meta["tokens"]:
+            tickers_info[symbol_info["name"]] = TickerInfoItem(
+                tick_step=None,
+                tick_precision=int(symbol_info["weiDecimals"]),
+                size_step=None,
+                size_precision=int(symbol_info["szDecimals"]),
+                contract_size=1,
+            )
+
+        cls._tickers_info = tickers_info
+
     @classmethod
-    async def _load_exchange_info(cls) -> None:
-        """Загружает информацию о бирже."""
-        client = await Client.create()
-        async with client as conn:
-            cls._spot_meta = await conn.spot_metadata()
-            cls._build_spot_mappings(cls._spot_meta)
-            cls._logger.debug("Hyperliquid spot exchange info loaded")
-
-            cls._futures_meta = await conn.perp_metadata()
-            cls._logger.debug("Hyperliquid futures exchange info loaded")
+    async def _load_futures_exchange_info(cls, session: aiohttp.ClientSession) -> None:
+        """Загружает информацию о бирже для фьючерсного рынка."""
+        cls._futures_meta = await Client(session).perp_metadata()
 
     @classmethod
     def _build_spot_mappings(cls, spot_meta: dict) -> None: