unicex 0.15.1__py3-none-any.whl → 0.15.4__py3-none-any.whl

unicex/_abc/exchange_info.py

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

unicex/_abc/uni_client.py

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

unicex/_abc/uni_websocket_manager.py

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

unicex/_base/client.py

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

unicex/binance/adapter.py

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

unicex/bingx/adapter.py

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

unicex/bingx/websocket_manager.py

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

unicex/bitget/adapter.py

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

unicex/bitget/websocket_manager.py

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

unicex/bybit/adapter.py

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

unicex/bybit/websocket_manager.py

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

unicex/extra.py

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

unicex/gate/adapter.py

@@ -173,6 +173,7 @@ class Adapter:
             item["contract"]: OpenInterestItem(
                 t=int(time.time() * 1000),
                 v=float(item["total_size"]) * float(item["quanto_multiplier"]),
+                u="coins",
             )
             for item in raw_data
         }

unicex/hyperliquid/adapter.py

@@ -256,6 +256,7 @@ class Adapter:
             universe[i]["name"]: OpenInterestItem(
                 t=int(time.time() * 1000),
                 v=float(item["openInterest"]),
+                u="coins",
             )
             for i, item in enumerate(metrics)
         }

unicex/kucoin/adapter.py

@@ -126,27 +126,22 @@ class Adapter:
             item["symbol"]: OpenInterestItem(
                 t=item["ts"],
                 v=float(item["openInterest"]) * Adapter._get_contract_size(item["symbol"]),
+                u="coins",
             )
             for item in raw_data["data"]
         }
 
     @staticmethod
-    def funding_rate(raw_data: dict) -> dict[str, float]:
+    def funding_rate(raw_data: dict) -> float:
         """Преобразует историю ставок финансирования в унифицированный формат.
 
         Параметры:
             raw_data (dict): Сырой ответ с биржи.
 
         Возвращает:
-            dict[str, float]: Словарь, где ключ - тикер, а значение - актуальная ставка финансирования.
+            float: Актуальная ставка финансирования.
         """
-        symbol = raw_data["data"]["symbol"]
-        history = raw_data["data"]["list"]
-        if not history:
-            return {}
-
-        last_point = max(history, key=lambda item: int(item["ts"]))
-        return {symbol: float(last_point["fundingRate"]) * 100}
+        return round(raw_data["data"]["nextFundingRate"] * 100, 6)
 
     @staticmethod
     def _get_contract_size(symbol: str) -> float:

unicex/kucoin/client.py

@@ -120,3 +120,16 @@ class Client(BaseClient):
             "/api/ua/v1/market/funding-rate-history",
             params=params,
         )
+
+    async def funding_rate(self, symbol: str) -> dict[str, Any]:
+        """Получение текущей ставки финансирования.
+
+        https://www.kucoin.com/docs-new/rest/ua/get-current-funding-rate
+        """
+        params = {"symbol": symbol}
+
+        return await self._make_request(
+            "GET",
+            "/api/ua/v1/market/funding-rate",
+            params=params,
+        )

unicex/kucoin/uni_client.py

@@ -1,7 +1,6 @@
 __all__ = ["UniClient"]
 
 
-import time
 from typing import overload
 
 from unicex._abc import IUniClient
@@ -181,19 +180,8 @@ class UniClient(IUniClient[Client]):
         """
         if not symbol:
             raise ValueError("Symbol is required to fetch Kucoin funding rate")
-
-        end_time = int(time.time() * 1000)
-        # Kucoin публикует ставку каждые 8 часов, берем окно в 24 часа для гарантии наличия записи.
-        start_time = end_time - 24 * 60 * 60 * 1000
-        raw_data = await self._client.funding_rate_history(
-            symbol=symbol,
-            start_at=start_time,
-            end_at=end_time,
-        )
-        adapted_data = Adapter.funding_rate(raw_data)
-        if symbol not in adapted_data:
-            raise ValueError(f"Kucoin funding rate history is empty for {symbol}")
-        return adapted_data[symbol]
+        raw_data = await self._client.funding_rate(symbol=symbol)
+        return Adapter.funding_rate(raw_data)
 
     @overload
     async def open_interest(self, symbol: str) -> OpenInterestItem: ...