unicex 0.16.6__tar.gz → 0.17.1__tar.gz

{unicex-0.16.6/unicex.egg-info → unicex-0.17.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.16.6
+Version: 0.17.1
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License
@@ -55,6 +55,7 @@ Dynamic: license-file
 
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
+| **Aster**       | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
 | **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
 | **Bitget**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |

{unicex-0.16.6 → unicex-0.17.1}/README.md

@@ -6,6 +6,7 @@
 
 | Exchange        | Client | Auth | WS Manager | User WS | Uni Client | Uni WS Manager | ExchangeInfo |
 |-----------------|--------|------|------------|---------|------------|----------------|--------------|
+| **Aster**       | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
 | **Binance**     | ✓      | ✓    | ✓          | ✓       | ✓          | ✓              | ✓            |
 | **Bitget**      | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |
 | **Bybit**       | ✓      | ✓    | ✓          |         | ✓          | ✓              | ✓            |

{unicex-0.16.6 → unicex-0.17.1}/pyproject.toml

@@ -4,7 +4,7 @@ name = "unicex"
 # •	PATCH (x.y.Z) → увеличивается при багфиксе, который не ломает совместимость.
 # •	MINOR (x.Y.z) → увеличивается при добавлении новой функциональности, но без ломающих изменений (backward-compatible).
 # •	MAJOR (X.y.z) → увеличивается при изменениях, которые ломают обратную совместимость.
-version = "0.16.6"
+version = "0.17.1"
 
 description = "Unified Crypto Exchange API "
 readme = "README.md"

{unicex-0.16.6 → unicex-0.17.1}/unicex/__init__.py

@@ -100,6 +100,7 @@ __all__ = [
 
 # abstract & base
 import asyncio
+from typing import Awaitable
 from ._abc import IUniClient, IUniWebsocketManager
 from ._base import BaseClient, Websocket
 
@@ -204,9 +205,9 @@ from .bingx import (
 )
 
 
-async def load_exchanges_info() -> None:
+async def load_exchanges_info() -> list:
     """Единожды загружает информацию о тикерах на всех биржах."""
-    await asyncio.gather(
+    return await asyncio.gather(
         BinanceExchangeInfo.load_exchange_info(),
         BitgetExchangeInfo.load_exchange_info(),
         BybitExchangeInfo.load_exchange_info(),
@@ -219,9 +220,9 @@ async def load_exchanges_info() -> None:
     )
 
 
-async def start_exchanges_info(parse_interval_seconds: int = 60 * 60) -> None:
+async def start_exchanges_info(parse_interval_seconds: int = 60 * 60) -> Awaitable:
     """Запускает цикл обновления информации о тикерах на всех биржах."""
-    asyncio.gather(
+    return asyncio.gather(
         BinanceExchangeInfo.start(parse_interval_seconds),
         BitgetExchangeInfo.start(parse_interval_seconds),
         BybitExchangeInfo.start(parse_interval_seconds),

unicex-0.17.1/unicex/aster/__init__.py

@@ -0,0 +1,27 @@
+"""Пакет, содержащий реализации клиентов и менеджеров для работы с биржей Aster."""
+
+__all__ = [
+    "Client",
+    "UniClient",
+    "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:
+    """Загружает информацию о бирже Aster."""
+    await ExchangeInfo.load_exchange_info()
+
+
+async def start_exchange_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает процесс обновления информации о бирже Aster."""
+    await ExchangeInfo.start(parse_interval_seconds)

unicex-0.17.1/unicex/aster/adapter.py

@@ -0,0 +1,173 @@
+__all__ = ["Adapter"]
+
+from typing import Any
+
+from unicex.types import (
+    KlineDict,
+    OpenInterestDict,
+    OpenInterestItem,
+    TickerDailyDict,
+    TickerDailyItem,
+    TradeDict,
+)
+from unicex.utils import catch_adapter_errors, decorate_all_methods, get_timestamp
+
+
+@decorate_all_methods(catch_adapter_errors)
+class Adapter:
+    """Адаптер для унификации данных с Aster API."""
+
+    @staticmethod
+    def tickers(raw_data: list[dict], only_usdt: bool) -> list[str]:
+        """Преобразует сырой ответ, в котором содержатся данные о тикерах в список тикеров.
+
+        Параметры:
+            raw_data (list[dict]): Сырой ответ с биржи.
+            only_usdt (bool): Флаг, указывающий, нужно ли включать только тикеры в паре к USDT.
+
+        Возвращает:
+            list[str]: Список тикеров.
+        """
+        return [
+            item["symbol"] for item in raw_data if item["symbol"].endswith("USDT") or not only_usdt
+        ]
+
+    @staticmethod
+    def ticker_24hr(raw_data: list[dict]) -> TickerDailyDict:
+        """Преобразует сырой ответ, в котором содержатся данные о тикере за последние 24 часа в унифицированный формат.
+
+        Параметры:
+            raw_data (list[dict]): Сырой ответ с биржи.
+
+        Возвращает:
+            TickerDailyDict: Словарь, где ключ - тикер, а значение - статистика за последние 24 часа.
+        """
+        return {
+            item["symbol"]: TickerDailyItem(
+                p=float(item["priceChangePercent"]),
+                q=float(item["quoteVolume"]),
+                v=float(item["volume"]),
+            )
+            for item in raw_data
+        }
+
+    @staticmethod
+    def last_price(raw_data: list[dict]) -> dict[str, float]:
+        """Преобразует сырой ответ с ценами тикеров в унифицированный формат.
+
+        Параметры:
+            raw_data (list[dict]): Сырой ответ с биржи.
+
+        Возвращает:
+            dict[str, float]: Словарь, где ключ - тикер, а значение - последняя цена.
+        """
+        return {item["symbol"]: float(item["price"]) for item in raw_data}
+
+    @staticmethod
+    def klines(raw_data: list[list], symbol: str) -> list[KlineDict]:
+        """Преобразует сырой ответ, в котором содержатся данные о свечах, в унифицированный формат.
+
+        Параметры:
+            raw_data (list[list]): Сырой ответ с биржи.
+            symbol (str): Символ тикера.
+
+        Возвращает:
+            list[KlineDict]: Список свечей.
+        """
+        return [
+            KlineDict(
+                s=symbol,
+                t=kline[0],
+                o=float(kline[1]),
+                h=float(kline[2]),
+                l=float(kline[3]),
+                c=float(kline[4]),
+                v=float(kline[5]),
+                q=float(kline[7]),
+                T=kline[6],
+                x=None,
+            )
+            for kline in sorted(raw_data, key=lambda x: int(x[0]))
+        ]
+
+    @staticmethod
+    def funding_rate(raw_data: list[dict]) -> dict[str, float]:
+        """Преобразует сырой ответ, в котором содержатся данные о ставках финансирования, в унифицированный формат.
+
+        Параметры:
+            raw_data (list[dict]): Сырой ответ с биржи.
+
+        Возвращает:
+            dict[str, float]: Словарь, где ключ - тикер, а значение - ставка финансирования.
+        """
+        return {item["symbol"]: float(item["lastFundingRate"]) * 100 for item in raw_data}
+
+    @staticmethod
+    def open_interest(raw_data: dict) -> OpenInterestDict:
+        """Преобразует сырой ответ, в котором содержатся данные об открытом интересе, в унифицированный формат.
+
+        Параметры:
+            raw_data (dict): Сырой ответ с биржи.
+
+        Возвращает:
+            OpenInterestDict: Словарь, где ключ - тикер, а значение - открытый интерес в USDT.
+        """
+        # В ответе нет времени, поэтому используем текущее.
+        timestamp = get_timestamp()
+        return {
+            item["symbol"]: OpenInterestItem(
+                t=timestamp,
+                v=float(item["openInterest"]),
+                u="usd",
+            )
+            for item in raw_data.get("data", [])
+        }
+
+    @staticmethod
+    def Klines_message(raw_msg: Any) -> list[KlineDict]:
+        """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
+        свече/свечах в унифицированный вид.
+
+        Параметры:
+            raw_msg (Any): Сырое сообщение с вебсокета.
+
+        Возвращает:
+            list[KlineDict]: Список словарей, где каждый словарь содержит данные о свече.
+        """
+        kline = raw_msg.get("data", raw_msg)["k"]  # Чтобы корректно обрабатывать multiplex стримы
+        return [
+            KlineDict(
+                s=kline["s"],
+                t=kline["t"],
+                o=float(kline["o"]),
+                h=float(kline["h"]),
+                l=float(kline["l"]),
+                c=float(kline["c"]),
+                v=float(kline["v"]),
+                q=float(kline["q"]),
+                T=kline["T"],
+                x=kline["x"],
+            )
+        ]
+
+    @staticmethod
+    def trades_message(raw_msg: Any) -> list[TradeDict]:
+        """Преобразует сырое сообщение с вебсокета, в котором содержится информация о
+        сделке/сделках в унифицированный вид.
+
+        Параметры:
+            raw_msg (Any): Сырое сообщение с вебсокета.
+
+        Возвращает:
+            list[TradeDict]: Список словарей, где каждый словарь содержит данные о сделке.
+        """
+        data = raw_msg.get("data", raw_msg)  # Чтобы корректно обрабатывать multiplex стримы
+        return [
+            TradeDict(
+                t=data["T"],
+                s=data["s"],
+                S="SELL" if data["m"] else "BUY",
+                p=float(data["p"]),
+                v=float(data["q"]),
+            )
+        ]