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

unicex/mexc/exchange_info.py

@@ -0,0 +1,32 @@
+__all__ = ["ExchangeInfo"]
+
+import aiohttp
+
+from unicex._abc import IExchangeInfo
+from unicex.types import TickerInfoItem
+
+
+class ExchangeInfo(IExchangeInfo):
+    """Предзагружает информацию о тикерах для биржи Mexc."""
+
+    @classmethod
+    async def _load_exchange_info(cls) -> None:
+        """Загружает информацию о бирже."""
+        futures_tickers_info = {}
+        async with aiohttp.ClientSession() as session:
+            url = "https://contract.mexc.com/api/v1/contract/detail"
+            async with session.get(url) as response:
+                data = await response.json()
+                for el in data["data"]:
+                    futures_tickers_info[el["symbol"]] = TickerInfoItem(
+                        tick_precision=cls._step_size_to_precision(el["priceUnit"]),
+                        size_precision=el["amountScale"],
+                        contract_size=el["contractSize"],
+                        min_market_size=el["minVol"],
+                        max_market_size=el["maxVol"],
+                        min_limit_size=el["minVol"],
+                        max_limit_size=el["maxVol"],
+                    )
+
+            cls._futures_tickers_info = futures_tickers_info
+            cls._logger.debug("Mexc futures exchange info loaded")

unicex/mexc/uni_client.py

@@ -138,9 +138,15 @@ class UniClient(IUniClient[Client]):
         Возвращает:
             list[KlineDict]: Список свечей для тикера.
         """
+        if not limit and not all([start_time, end_time]):
+            raise ValueError("limit and (start_time and end_time) must be provided")
+
         if limit:  # Перезаписываем start_time и end_time если указан limit, т.к. по умолчанию Mexc Futures не принимают этот параметр
+            if not isinstance(interval, Timeframe):
+                raise ValueError("interval must be a Timeframe if limit param provided")
             end_time = int(time.time())
             start_time = end_time - (limit * interval.to_seconds)  # type: ignore[reportOptionalOperand]
+
         interval = (
             interval.to_exchange_format(Exchange.MEXC, MarketType.FUTURES)
             if isinstance(interval, Timeframe)

unicex/okx/__init__.py

@@ -6,10 +6,22 @@ __all__ = [
     "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:
+    """Загружает информацию о бирже Okx."""
+    await ExchangeInfo.load_exchange_info()
+
+
+async def start_exchange_info(parse_interval_seconds: int = 60 * 60) -> None:
+    """Запускает процесс обновления информации о бирже Okx."""
+    await ExchangeInfo.start(parse_interval_seconds)

unicex/okx/adapter.py

@@ -10,13 +10,15 @@ from unicex.types import (
 )
 from unicex.utils import catch_adapter_errors, decorate_all_methods
 
+from .exchange_info import ExchangeInfo
+
 
 @decorate_all_methods(catch_adapter_errors)
 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]:
         """Преобразует сырые данные о тикерах в список унифицированных символов.
 
         Параметры:
@@ -29,11 +31,11 @@ class Adapter:
         return [
             item["instId"]
             for item in raw_data["data"]
-            if only_usdt or item["instId"].endswith("-USDT")
+            if item["instId"].endswith("-USDT") or not only_usdt
         ]
 
     @staticmethod
-    def futures_tickers(raw_data: dict, only_usdt: bool = True) -> list[str]:
+    def futures_tickers(raw_data: dict, only_usdt: bool) -> list[str]:
         """Преобразует сырые данные о тикерах в список унифицированных символов.
 
         Параметры:
@@ -46,16 +48,19 @@ class Adapter:
         return [
             item["instId"]
             for item in raw_data["data"]
-            if only_usdt or item["instId"].endswith("-USDT-SWAP")
+            if item["instId"].endswith("-USDT-SWAP") or not only_usdt
         ]
 
     @staticmethod
     def ticker_24hr(raw_data: dict) -> TickerDailyDict:
-        """Преобразует статистику 24ч в унифицированный формат."""
+        """Преобразует статистику 24ч в унифицированный формат.
+
+        # NOTE: Обратите внимание, изменение цены в случае с OKX возвращается относительно открытия 1 day свечи.
+        """
         return {
             item["instId"]: TickerDailyItem(
                 p=round(
-                    (float(item["last"]) - float(item["open24h"]) / float(item["open24h"])) * 100, 2
+                    (float(item["last"]) - float(item["open24h"])) / float(item["open24h"]) * 100, 2
                 ),
                 v=float(item["vol24h"]),
                 q=float(item["volCcy24h"]),
@@ -65,14 +70,17 @@ class Adapter:
 
     @staticmethod
     def futures_ticker_24hr(raw_data: dict) -> TickerDailyDict:
-        """Преобразует статистику 24ч в унифицированный формат."""
+        """Преобразует статистику 24ч в унифицированный формат.
+
+        # NOTE: Обратите внимание, изменение цены в случае с OKX возвращается относительно открытия 1 day свечи.
+        """
         return {
             item["instId"]: TickerDailyItem(
                 p=round(
-                    (float(item["last"]) - float(item["open24h"]) / float(item["open24h"])) * 100, 2
+                    (float(item["last"]) - float(item["open24h"])) / float(item["open24h"]) * 100, 2
                 ),
                 v=float(item["volCcy24h"]),
-                q=float(item["vol24h"]),
+                q=float(item["volCcy24h"]) * float(item["last"]),
             )
             for item in raw_data["data"]
         }
@@ -120,3 +128,11 @@ class Adapter:
             )
             for item in raw_data["data"]
         }
+
+    @staticmethod
+    def _get_contract_size(symbol: str) -> float:
+        """Возвращает размер контракта для указанного символа тикера."""
+        try:
+            return ExchangeInfo.get_futures_ticker_info(symbol)["contract_size"] or 1
+        except:  # noqa
+            return 1