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

unicex/binance/adapter.py

@@ -17,7 +17,7 @@ class Adapter:
     """Адаптер для унификации данных с Binance API."""
 
     @staticmethod
-    def tickers(raw_data: list[dict], only_usdt: bool = True) -> list[str]:
+    def tickers(raw_data: list[dict], only_usdt: bool) -> list[str]:
         """Преобразует сырой ответ, в котором содержатся данные о тикерах в список тикеров.
 
         Параметры:

unicex/bybit/adapter.py

@@ -16,7 +16,7 @@ class Adapter:
     """Адаптер для унификации данных с Bybit API."""
 
     @staticmethod
-    def tickers(raw_data: dict, only_usdt: bool = True) -> list[str]:
+    def tickers(raw_data: dict, only_usdt: bool) -> list[str]:
         """Преобразует сырой ответ, в котором содержатся данные о тикерах в список тикеров.
 
         Параметры:

unicex/bybit/uni_client.py

@@ -33,7 +33,7 @@ class UniClient(IUniClient[Client]):
             list[str]: Список тикеров.
         """
         raw_data = await self._client.tickers("spot")
-        return Adapter.tickers(raw_data)
+        return Adapter.tickers(raw_data, only_usdt)
 
     async def futures_tickers(self, only_usdt: bool = True) -> list[str]:
         """Возвращает список тикеров.
@@ -45,7 +45,7 @@ class UniClient(IUniClient[Client]):
             list[str]: Список тикеров.
         """
         raw_data = await self._client.tickers("linear")
-        return Adapter.tickers(raw_data)
+        return Adapter.tickers(raw_data, only_usdt)
 
     async def last_price(self) -> dict[str, float]:
         """Возвращает последнюю цену для каждого тикера.

unicex/extra.py

@@ -8,6 +8,8 @@ __all__ = [
     "generate_tv_link",
     "generate_cg_link",
     "make_humanreadable",
+    "normalize_ticker",
+    "normalize_symbol",
 ]
 
 import time
@@ -32,7 +34,7 @@ def percent_greater(higher: float, lower: float) -> float:
         `float`: На сколько процентов `higher` больше `lower`.
     """
     if lower == 0:
-        return float("inf")
+        return 0.0  # Не будем возвращать float('inf'), чтобы не ломать логику приложения
     return (higher / lower - 1) * 100
 
 
@@ -51,7 +53,7 @@ def percent_less(higher: float, lower: float) -> float:
         `float`: На сколько процентов `lower` меньше `higher`.
     """
     if lower == 0:
-        return float("inf")
+        return 0.0  # Не будем возвращать float('inf'), чтобы не ломать логику приложения
     return (1 - lower / higher) * 100
 
 
@@ -91,6 +93,76 @@ class TimeoutTracker[T]:
         self._blocked_items[item] = time.time() + duration
 
 
+def normalize_ticker(raw_ticker: str) -> str:
+    """Нормализует тикер и возвращает базовую валюту (например, `BTC`).
+
+    Эта функция принимает тикер в различных форматах (с разделителями, постфиксом SWAP,
+    в верхнем или нижнем регистре) и приводит его к стандартному виду — только базовый актив.
+
+    Примеры:
+        ```python
+        normalize_ticker("BTC-USDT")  # "BTC"
+        normalize_ticker("BTC-USDT-SWAP")  # "BTC"
+        normalize_ticker("btc_usdt")  # "BTC"
+        normalize_ticker("BTCUSDT")  # "BTC"
+        normalize_ticker("BTC")  # "BTC"
+        ```
+
+    Параметры:
+        raw_ticker (`str`): Исходный тикер в любом из распространённых форматов.
+
+    Возвращает:
+        `str`: Базовый актив в верхнем регистре (например, `"BTC"`).
+    """
+    ticker = raw_ticker.upper()
+
+    # Удаляем постфиксы SWAP
+    if ticker.endswith(("SWAP", "-SWAP", "_SWAP", ".SWAP")):
+        ticker = (
+            ticker.removesuffix("-SWAP")
+            .removesuffix("_SWAP")
+            .removesuffix(".SWAP")
+            .removesuffix("SWAP")
+        )
+
+    # Удаляем разделители
+    ticker = ticker.translate(str.maketrans("", "", "-_."))
+
+    # Убираем суффикс валюты котировки
+    for quote in ("USDT", "USDC"):
+        if ticker.endswith(quote):
+            ticker = ticker.removesuffix(quote)
+            break
+
+    return ticker
+
+
+def normalize_symbol(raw_ticker: str, quote: Literal["USDT", "USDC"] = "USDT") -> str:
+    """Нормализует тикер до унифицированного символа (например, `BTCUSDT`).
+
+    Функция принимает тикер в любом из популярных форматов и возвращает полный символ,
+    состоящий из базовой валюты и указанной валюты котировки (`USDT` или `USDC`).
+
+    Примеры:
+        ```python
+        normalize_symbol("BTC-USDT")  # "BTCUSDT"
+        normalize_symbol("BTC")  # "BTCUSDT"
+        normalize_symbol("btc_usdt_swap")  # "BTCUSDT"
+        normalize_symbol("ETH", "USDC")  # "ETHUSDC"
+        ```
+
+    Параметры:
+        raw_ticker (`str`): Исходный тикер в любом из распространённых форматов.
+        quote (`Literal["USDT", "USDC"]`, optional): Валюта котировки.
+            По умолчанию `"USDT"`.
+
+    Возвращает:
+        `str`: Символ в унифицированном формате, например `"BTCUSDT"`.
+    """
+    base = normalize_ticker(raw_ticker)
+    return f"{base}{quote}"
+
+
 def generate_ex_link(exchange: Exchange, market_type: MarketType, symbol: str):
     """Генерирует ссылку на биржу.
 
@@ -102,7 +174,8 @@ def generate_ex_link(exchange: Exchange, market_type: MarketType, symbol: str):
     Возвращает:
         `str`: Ссылка на биржу.
     """
-    ticker = symbol.removesuffix("USDT").removesuffix("_USDT").removesuffix("-USDT")
+    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}"
@@ -152,7 +225,7 @@ def generate_ex_link(exchange: Exchange, market_type: MarketType, symbol: str):
         if market_type == MarketType.FUTURES:
             return f"https://app.hyperliquid.xyz/trade/{ticker}"
         else:
-            return f"https://www.kcex.com/ru-RU/exchange/{ticker}/USDC"
+            return f"https://app.hyperliquid.xyz/trade/{ticker}/USDC"
     else:
         raise NotSupported(f"Exchange {exchange} is not supported")
 
@@ -168,6 +241,7 @@ def generate_tv_link(exchange: Exchange, market_type: MarketType, symbol: str) -
     Возвращает:
         `str`: Ссылка для TradingView.
     """
+    symbol = normalize_symbol(symbol)
     if market_type == MarketType.FUTURES:
         return f"https://www.tradingview.com/chart/?symbol={exchange}:{symbol}.P"
     else:
@@ -187,6 +261,8 @@ def generate_cg_link(exchange: Exchange, market_type: MarketType, symbol: str) -
     """
     base_url = "https://www.coinglass.com/tv/ru"
 
+    symbol = normalize_symbol(symbol)
+
     if market_type == MarketType.FUTURES:
         match exchange:
             case Exchange.OKX:
@@ -196,9 +272,11 @@ def generate_cg_link(exchange: Exchange, market_type: MarketType, symbol: str) -
             case Exchange.BITGET:
                 return f"{base_url}/{exchange.capitalize()}_{symbol}_UMCBL"
             case Exchange.GATEIO:
-                return f"{base_url}/{exchange.capitalize()}_{symbol.replace('USDT', '_USDT')}"
+                return f"{base_url}/Gate_{symbol.replace('USDT', '_USDT')}"
             case Exchange.BITUNIX:
                 return f"{base_url}/{exchange.capitalize()}_{symbol}"
+            case Exchange.HYPERLIQUID:
+                return f"{base_url}/{exchange.capitalize()}_{symbol.replace('USDT', '-USD')}"
             case _:
                 return f"{base_url}/{exchange.capitalize()}_{symbol}"
     else:
@@ -206,7 +284,7 @@ def generate_cg_link(exchange: Exchange, market_type: MarketType, symbol: str) -
         if exchange == Exchange.OKX:
             return f"{base_url}/SPOT_{exchange.upper()}_{symbol.replace('USDT', '-USDT')}"
         # Для остальных бирж ссылки нет → возвращаем заглушку
-        return base_url
+        return generate_cg_link(exchange, MarketType.FUTURES, symbol)
 
 
 def make_humanreadable(value: float, locale: Literal["ru", "en"] = "ru") -> str:

unicex/gateio/adapter.py

@@ -19,7 +19,7 @@ class Adapter:
     """Адаптер для унификации данных с Gateio API."""
 
     @staticmethod
-    def tickers(raw_data: list[dict], only_usdt: bool = True) -> list[str]:
+    def tickers(raw_data: list[dict], only_usdt: bool) -> list[str]:
         """Преобразует сырой ответ о тикерах в список символов.
 
         Параметры:
@@ -36,7 +36,7 @@ class Adapter:
         ]
 
     @staticmethod
-    def futures_tickers(raw_data: list[dict], only_usdt: bool = True) -> list[str]:
+    def futures_tickers(raw_data: list[dict], only_usdt: bool) -> list[str]:
         """Преобразует сырой ответ о фьючерсных тикерах в список символов.
 
         Параметры:

unicex/hyperliquid/adapter.py

@@ -110,7 +110,18 @@ class Adapter:
                 v = (day_ntl_vlm / mid_px) if mid_px else 0.0
                 q = day_ntl_vlm
 
-                result[coin] = TickerDailyItem(p=p, v=v, q=q)
+                if coin in result:
+                    # В случае с конфликтом оставляем ту монету, в которой больше дневного объема, т.к
+                    # для 6 монет (на 07.10.2025) встречаются пары к USDH, которые повторяют идентификатор.
+                    # Проблема не критичная - т.к. флаг resolve_symbols по идее использовать должен редко.
+                    prev_ticker_daily = result[coin]
+                    curr_ticker_daily = TickerDailyItem(p=p, v=v, q=q)
+                    if prev_ticker_daily["q"] > curr_ticker_daily["q"]:
+                        result[coin] = prev_ticker_daily
+                    else:
+                        result[coin] = curr_ticker_daily
+                else:
+                    result[coin] = TickerDailyItem(p=p, v=v, q=q)
 
             except (KeyError, TypeError, ValueError):
                 continue

unicex/mexc/adapter.py

@@ -17,7 +17,7 @@ class Adapter:
     """Адаптер для унификации данных с Mexc API."""
 
     @staticmethod
-    def tickers(raw_data: list[dict], only_usdt: bool = True) -> list[str]:
+    def tickers(raw_data: list[dict], only_usdt: bool) -> list[str]:
         """Преобразует сырой ответ, в котором содержатся данные о тикерах, в список тикеров.
 
         Параметры:
@@ -32,7 +32,7 @@ class Adapter:
         ]
 
     @staticmethod
-    def futures_tickers(raw_data: dict, only_usdt: bool = True) -> list[str]:
+    def futures_tickers(raw_data: dict, only_usdt: bool) -> list[str]:
         """Преобразует сырой ответ, в котором содержатся данные о фьючерсных тикерах, в список тикеров.
 
         Параметры:

unicex/okx/adapter.py

@@ -18,7 +18,7 @@ class Adapter:
     """Адаптер для унификации данных с Okx API."""
 
     @staticmethod
-    def tickers(raw_data: dict, only_usdt: bool = True) -> list[str]:
+    def tickers(raw_data: dict, only_usdt: bool) -> list[str]:
         """Преобразует сырые данные о тикерах в список унифицированных символов.
 
         Параметры:
@@ -35,7 +35,7 @@ class Adapter:
         ]
 
     @staticmethod
-    def futures_tickers(raw_data: dict, only_usdt: bool = True) -> list[str]:
+    def futures_tickers(raw_data: dict, only_usdt: bool) -> list[str]:
         """Преобразует сырые данные о тикерах в список унифицированных символов.
 
         Параметры: