unicex 0.13.17__py3-none-any.whl → 0.16.5__py3-none-any.whl

unicex/okx/websocket_manager.py

@@ -15,13 +15,13 @@ type CallbackType = Callable[[Any], Awaitable[None]]
 class WebsocketManager:
     """Менеджер асинхронных вебсокетов для Okx."""
 
-    _BASE_URL = "wss://ws.okx.com:8443/ws"
+    _BASE_URL: str = "wss://ws.okx.com:8443/ws"
     """Базовый URL вебсокетов на Okx."""
 
-    _PUBLIC_URL = _BASE_URL + "/v5/public"
+    _PUBLIC_URL: str = _BASE_URL + "/v5/public"
     """Публичный URL вебсокетов на Okx."""
 
-    _BUSINESS_URL = _BASE_URL + "/v5/business"
+    _BUSINESS_URL: str = _BASE_URL + "/v5/business"
     """Бизнес-URL вебсокетов на Okx. (для топиков trades-all и candle)"""
 
     def __init__(self, client: Client | None = None, **ws_kwargs: Any) -> None:
@@ -34,6 +34,15 @@ class WebsocketManager:
         self.client = client
         self._ws_kwargs = {"ping_message": "ping", **ws_kwargs}
 
+    def _build_subscription_message(self, args: list[dict[str, Any]]) -> str:
+        """Формирует JSON-сообщение подписки."""
+        return json.dumps(
+            {
+                "op": "subscribe",
+                "args": args,
+            }
+        )
+
     def instruments(
         self,
         callback: CallbackType,
@@ -50,16 +59,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "instruments",
-                        "instType": inst_type,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "instruments",
+                    "instType": inst_type,
+                }
+            ]
         )
 
         return Websocket(
@@ -85,16 +91,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "open-interest",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "open-interest",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -120,16 +123,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "funding-rate",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "funding-rate",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -155,16 +155,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "price-limit",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "price-limit",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -190,16 +187,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "opt-summary",
-                        "instFamily": inst_family,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "opt-summary",
+                    "instFamily": inst_family,
+                }
+            ]
         )
 
         return Websocket(
@@ -244,12 +238,7 @@ class WebsocketManager:
         if inst_id:
             args["instId"] = inst_id
 
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [args],
-            }
-        )
+        subscription_message = self._build_subscription_message([args])
 
         return Websocket(
             callback=callback,
@@ -274,16 +263,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "mark-price",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "mark-price",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -309,16 +295,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "index-tickers",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "index-tickers",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -375,16 +358,13 @@ class WebsocketManager:
             `Websocket`: Объект для управления вебсокет соединением.
         """
         channel = f"mark-price-candle{interval}"
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": channel,
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": channel,
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -440,16 +420,13 @@ class WebsocketManager:
             `Websocket`: Объект для управления вебсокет соединением.
         """
         channel = f"index-candle{interval}"
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": channel,
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": channel,
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -475,16 +452,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "liquidation-orders",
-                        "instType": inst_type,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "liquidation-orders",
+                    "instType": inst_type,
+                }
+            ]
         )
 
         return Websocket(
@@ -520,12 +494,7 @@ class WebsocketManager:
         if inst_family:
             args["instFamily"] = inst_family
 
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [args],
-            }
-        )
+        subscription_message = self._build_subscription_message([args])
 
         return Websocket(
             callback=callback,
@@ -550,16 +519,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "tickers",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "tickers",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -615,17 +581,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        channel = f"candle{interval}"
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": channel,
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": f"candle{interval}",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -651,16 +613,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "trades",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "trades",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -686,16 +645,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": "trades-all",
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": "trades-all",
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(
@@ -723,16 +679,13 @@ class WebsocketManager:
         Возвращает:
             `Websocket`: Объект для управления вебсокет соединением.
         """
-        subscription_message = json.dumps(
-            {
-                "op": "subscribe",
-                "args": [
-                    {
-                        "channel": channel,
-                        "instId": inst_id,
-                    }
-                ],
-            }
+        subscription_message = self._build_subscription_message(
+            [
+                {
+                    "channel": channel,
+                    "instId": inst_id,
+                }
+            ]
         )
 
         return Websocket(

unicex/types.py

@@ -5,9 +5,9 @@ __all__ = [
     "TickerDailyItem",
     "KlineDict",
     "TradeDict",
-    "AggTradeDict",
     "RequestMethod",
     "LoggerLike",
+    "NumberLike",
     "OpenInterestDict",
     "OpenInterestItem",
     "TickerInfoItem",
@@ -26,6 +26,13 @@ type LoggerLike = LoggingLogger | loguru.Logger
 type RequestMethod = Literal["GET", "POST", "PUT", "DELETE", "PATCH"]
 """Типы методов HTTP запросов."""
 
+type NumberLike = str | int | float
+"""
+Числовое значение для аргументов API-клиентов.
+API бирж принимают числа как str, int или float — значение
+передаётся без преобразований и сериализуется HTTP-клиентом.
+"""
+
 
 class TickerDailyItem(TypedDict):
     """Статистика одного тикера за последние 24 часа."""
@@ -71,10 +78,10 @@ class KlineDict(TypedDict):
     q: float
     """Объем свечи. В долларах."""
 
-    T: int | None
+    T: int | None  # `None` means untrackable
     """Время закрытия. В миллисекундах."""
 
-    x: bool | None
+    x: bool | None  # `None` means untrackable
     """Флаг закрыта ли свеча."""
 
 
@@ -97,12 +104,6 @@ class TradeDict(TypedDict):
     """Объем сделки. В монетах."""
 
 
-class AggTradeDict(TradeDict):
-    """Модель агрегированной сделки."""
-
-    pass
-
-
 class OpenInterestItem(TypedDict):
     """Модель одного элемента открытого интереса."""
 
@@ -110,7 +111,10 @@ class OpenInterestItem(TypedDict):
     """Время. В миллисекундах."""
 
     v: float
-    """Открытый интерес. В монетах."""
+    """Открытый интерес."""
+
+    u: Literal["coins", "usd"]
+    """Единица измерения открытого интереса."""
 
 
 type OpenInterestDict = dict[str, OpenInterestItem]

unicex/utils.py

@@ -1,6 +1,7 @@
 """Модуль, который предоставляет дополнительные функции, которые нужны для внутренного использования в библиотеке."""
 
 __all__ = [
+    "get_timestamp",
     "dict_to_query_string",
     "generate_hmac_sha256_signature",
     "sort_params_by_alphabetical_order",
@@ -9,13 +10,15 @@ __all__ = [
     "catch_adapter_errors",
     "decorate_all_methods",
     "symbol_to_exchange_format",
+    "validate_single_symbol_args",
 ]
 
 import base64
 import hashlib
 import hmac
 import json
-from collections.abc import Callable, Iterable
+import time
+from collections.abc import Callable, Iterable, Sequence
 from functools import wraps
 from typing import Any, Literal
 from urllib.parse import urlencode
@@ -24,6 +27,19 @@ from unicex.enums import Exchange, MarketType
 from unicex.exceptions import AdapterError
 
 
+def get_timestamp(milliseconds: bool = True) -> int:
+    """Возвращает текущее время в миллисекундах или секундах.
+
+    Параметры:
+        milliseconds (`bool`, опционально): Если True, возвращает время в миллисекундах.
+                                          Если False, возвращает время в секундах.
+
+    Возвращает:
+        `int`: Текущее время в миллисекундах или секундах.
+    """
+    return int(time.time() * 1000) if milliseconds else int(time.time())
+
+
 def filter_params(params: dict) -> dict:
     """Фильтрует параметры запроса, удаляя None-значения.
 
@@ -215,4 +231,31 @@ def symbol_to_exchange_format(
             return symbol.removesuffix("USDT")  # Вот тут мб и не так, там вроде что-то к USDC
         else:
             return symbol.removesuffix("USDT")  # Вот тут мб и не так, там вроде что-то к USDC
+    elif exchange == Exchange.KUCOIN:
+        if market_type == MarketType.FUTURES:
+            if symbol_upper == "BTCUSDT":
+                return "XBTUSDTM"
+            return symbol_upper + "M"
+        else:
+            return symbol_upper.replace("USDT", "-USDT")
+    elif exchange == Exchange.BINGX:
+        return symbol_upper.replace("USDT", "-USDT")
     return symbol_upper
+
+
+def validate_single_symbol_args(
+    symbol: str | None = None, symbols: Sequence[str] | None = None
+) -> None:
+    """Проверяет, что передан ровно один из аргументов symbol/symbols.
+
+    Параметры:
+      symbol (`str | None`, опционально): Одиночный торговый символ.
+      symbols (`Sequence[str] | None`, опционально): Список торговых символов.
+
+    Возвращает:
+      `None`: Ничего не возвращает, выбрасывает ValueError при нарушении условий.
+    """
+    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")

{unicex-0.13.17.dist-info → unicex-0.16.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.13.17
+Version: 0.16.5
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License
@@ -56,12 +56,14 @@ Dynamic: license-file
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
 | **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
-| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Bitget**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
-| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Gateio**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Hyperliquid** | ✓      | ✓    | ✓          | ✓       | ✓          |                |              |
-| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
-| **Okx**         | ✓      | ✓    | ✓          |         | ✓          |                | ✓            |
+| **Mexc**        | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
+| **Okx**         | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
+| **Kucoin**      |        |      |            |         | ✓          |                |              |
+| **BingX**       |        |      |            |         | ✓          |                |              |
 ---