unicex 0.1.18__tar.gz → 0.2.0__tar.gz

unicex-0.2.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: unicex
+Version: 0.2.0
+Summary: Unified Crypto Exchange API 
+Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, LoveBloodAndDiamonds
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+Project-URL: Github, https://github.com/LoveBloodAndDiamonds/uni-cex-api
+Project-URL: Author, https://t.me/LoveBloodAndDiamonds
+Project-URL: Readthedocs, https://unicex.readthedocs.io/ru/latest/
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.12.15
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: orjson>=3.11.3
+Requires-Dist: websockets>=15.0.1
+Dynamic: license-file
+
+# Unified Crypto Exchange API
+
+`unicex` — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж.
+
+## ✅ Статус реализации
+
+| Exchange | Client | UniClient | Adapter | WebsocketManager | UniWebsocketManager | UserWebsocket |
+|----------|--------|-----------|---------|------------------|---------------------|---------------|
+| Binance  | [x]    | [x]       | [x]     | [x]              | [x]                 | [x]           |
+| Bybit    | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Bitget   | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Okx      | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Mexc     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Gate     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+
+---
+
+## 🚀 Быстрый старт
+
+- Установка: `pip install unicex` или из исходников: `pip install -e .`
+- Библиотека полностью асинхронная. Примеры импорта:
+  - Сырые клиенты: `from unicex.binance import Client`
+  - Унифицированные клиенты: `from unicex.binance import UniClient`
+  - Менеджеры WS: `from unicex.binance import WebsocketManager, UniWebsocketManager`
+
+Пример: получить последние цены через унифицированный клиент Binance
+
+```
+import asyncio
+from unicex.binance import UniClient
+
+
+async def main():
+    client = await UniClient.create()
+    prices = await client.last_price()
+    print(prices["BTCUSDT"])
+    await client.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+Пример: подписаться на трейды через унифицированный WS‑менеджер Bitget
+
+```
+import asyncio
+from unicex.bitget import UniWebsocketManager
+from unicex import TradeDict
+
+
+async def on_trade(msg: TradeDict):
+    print(msg)
+
+
+async def main():
+    uwm = UniWebsocketManager()
+    socket = uwm.trades(callback=on_trade, symbol="BTCUSDT")
+    await socket.start()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## 🧑‍💻 Блок для разработчика
+
+### 📋 Todo
+- Добавить веса и рейт‑лимиты в документацию клиентов
+- Пересмотреть вопрос: должен ли быть адаптер интерфейсом?
+- Доделать BitgetClient и проверить типы
+- Добавить overload к методам с `None, None`
+- Определить порядок полей, возвращаемых адаптером
+- Написать 1–2 примера

unicex-0.2.0/README.md

@@ -0,0 +1,76 @@
+# Unified Crypto Exchange API
+
+`unicex` — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж.
+
+## ✅ Статус реализации
+
+| Exchange | Client | UniClient | Adapter | WebsocketManager | UniWebsocketManager | UserWebsocket |
+|----------|--------|-----------|---------|------------------|---------------------|---------------|
+| Binance  | [x]    | [x]       | [x]     | [x]              | [x]                 | [x]           |
+| Bybit    | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Bitget   | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Okx      | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Mexc     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+| Gate     | [ ]    | [ ]       | [ ]     | [ ]              | [ ]                 | [ ]           |
+
+---
+
+## 🚀 Быстрый старт
+
+- Установка: `pip install unicex` или из исходников: `pip install -e .`
+- Библиотека полностью асинхронная. Примеры импорта:
+  - Сырые клиенты: `from unicex.binance import Client`
+  - Унифицированные клиенты: `from unicex.binance import UniClient`
+  - Менеджеры WS: `from unicex.binance import WebsocketManager, UniWebsocketManager`
+
+Пример: получить последние цены через унифицированный клиент Binance
+
+```
+import asyncio
+from unicex.binance import UniClient
+
+
+async def main():
+    client = await UniClient.create()
+    prices = await client.last_price()
+    print(prices["BTCUSDT"])
+    await client.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+Пример: подписаться на трейды через унифицированный WS‑менеджер Bitget
+
+```
+import asyncio
+from unicex.bitget import UniWebsocketManager
+from unicex import TradeDict
+
+
+async def on_trade(msg: TradeDict):
+    print(msg)
+
+
+async def main():
+    uwm = UniWebsocketManager()
+    socket = uwm.trades(callback=on_trade, symbol="BTCUSDT")
+    await socket.start()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## 🧑‍💻 Блок для разработчика
+
+### 📋 Todo
+- Добавить веса и рейт‑лимиты в документацию клиентов
+- Пересмотреть вопрос: должен ли быть адаптер интерфейсом?
+- Доделать BitgetClient и проверить типы
+- Добавить overload к методам с `None, None`
+- Определить порядок полей, возвращаемых адаптером
+- Написать 1–2 примера

{unicex-0.1.18 → unicex-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ name = "unicex"
 # •	PATCH (x.y.Z) → увеличивается при багфиксе, который не ломает совместимость.
 # •	MINOR (x.Y.z) → увеличивается при добавлении новой функциональности, но без ломающих изменений (backward-compatible).
 # •	MAJOR (X.y.z) → увеличивается при изменениях, которые ломают обратную совместимость.
-version = "0.1.18"
+version = "0.2.0"
 
 description = "Unified Crypto Exchange API "
 readme = "README.md"
@@ -17,8 +17,6 @@ dependencies = [
     "aiohttp>=3.12.15",
     "loguru>=0.7.3",
     "orjson>=3.11.3",
-    "requests>=2.32.5",
-    "websocket-client>=1.8.0",
     "websockets>=15.0.1",
 ]
 

{unicex-0.1.18 → unicex-0.2.0}/unicex/__init__.py

@@ -20,21 +20,31 @@ __all__ = [
     "IUniClient",
     "IUniWebsocketManager",
     "IAdapter",
-    "IUniAsyncClient",
-    "IUniAsyncWebsocketManager",
     # Base clients and websockets
     "Websocket",
     "BaseClient",
-    "AsyncWebsocket",
-    "BaseAsyncClient",
+    # Binance
+    "BinanceClient",
+    "BinanceUniClient",
+    "BinanceWebsocketManager",
+    "BinanceUniWebsocketManager",
+    # Bitget
+    "BitgetClient",
+    "BitgetUniClient",
+    "BitgetUniWebsocketManager",
+    "BitgetWebsocketManager",
 ]
 
 from ._abc import IAdapter, IUniClient, IUniWebsocketManager
-from ._abc.asyncio import IUniClient as IUniAsyncClient
-from ._abc.asyncio import IUniWebsocketManager as IUniAsyncWebsocketManager
 from ._base import BaseClient, Websocket
-from ._base.asyncio import BaseClient as BaseAsyncClient
-from ._base.asyncio import Websocket as AsyncWebsocket
+from .binance import Client as BinanceClient
+from .binance import UniClient as BinanceUniClient
+from .binance import UniWebsocketManager as BinanceUniWebsocketManager
+from .binance import WebsocketManager as BinanceWebsocketManager
+from .bitget import Client as BitgetClient
+from .bitget import UniClient as BitgetUniClient
+from .bitget import UniWebsocketManager as BitgetUniWebsocketManager
+from .bitget import WebsocketManager as BitgetWebsocketManager
 from .enums import Exchange, MarketType, Side, Timeframe
 from .mapper import get_uni_client, get_uni_websocket_manager
 from .types import AggTradeDict, KlineDict, LoggerLike, RequestMethod, TickerDailyDict, TradeDict

{unicex-0.1.18 → unicex-0.2.0}/unicex/_abc/__init__.py

@@ -5,4 +5,5 @@ __all__ = [
 ]
 
 from .adapter import IAdapter
-from .sync import IUniClient, IUniWebsocketManager
+from .uni_client import IUniClient
+from .uni_websocket_manager import IUniWebsocketManager

{unicex-0.1.18/unicex/_abc/asyncio → unicex-0.2.0/unicex/_abc}/uni_client.py

@@ -6,12 +6,12 @@ from typing import Generic, Self, TypeVar, overload
 
 import aiohttp
 
-from unicex._base.asyncio import BaseClient
+from unicex._base import BaseClient
 from unicex.enums import Timeframe
 from unicex.types import KlineDict, LoggerLike, TickerDailyDict
 from unicex.utils import batched_list
 
-from ..adapter import IAdapter
+from .adapter import IAdapter
 
 TClient = TypeVar("TClient", bound="BaseClient")
 

{unicex-0.1.18/unicex/_abc/asyncio → unicex-0.2.0/unicex/_abc}/uni_websocket_manager.py

@@ -6,7 +6,7 @@ from typing import Any, overload
 
 from loguru import logger as _logger
 
-from unicex._base.asyncio import BaseClient, Websocket
+from unicex._base import BaseClient, Websocket
 from unicex.enums import Timeframe
 from unicex.types import LoggerLike
 

{unicex-0.1.18/unicex/binance/asyncio → unicex-0.2.0/unicex/binance}/__init__.py

@@ -1,4 +1,4 @@
-"""Пакет содержит асинхронные клиенты и менеджеры для работы с биржей Binance."""
+"""Пакет, содержащий реализации клиентов и менеджеров для работы с биржей Binance."""
 
 __all__ = ["Client", "UniClient", "UserWebsocket", "WebsocketManager", "UniWebsocketManager"]
 

{unicex-0.1.18/unicex/binance/asyncio → unicex-0.2.0/unicex/binance}/client.py

@@ -1,18 +1,86 @@
 __all__ = ["Client"]
 
 import json
+import time
 import warnings
 from typing import Any
 
-from unicex._base.asyncio import BaseClient
+from unicex._base import BaseClient
+from unicex.exceptions import NotAuthorized
 from unicex.types import RequestMethod
+from unicex.utils import dict_to_query_string, filter_params, generate_hmac_sha256_signature
 
-from .._mixins import ClientMixin
 
-
-class Client(ClientMixin, BaseClient):
+class Client(BaseClient):
     """Клиент для работы с Binance API."""
 
+    _BASE_SPOT_URL: str = "https://api.binance.com"
+    """Базовый URL для REST API Binance Spot."""
+
+    _BASE_FUTURES_URL: str = "https://fapi.binance.com"
+    """Базовый URL для REST API Binance Futures."""
+
+    _RECV_WINDOW: int = 5000
+    """Стандартный интервал времени для получения ответа от сервера."""
+
+    def _get_headers(self) -> dict:
+        """Возвращает заголовки для запросов к Binance API."""
+        headers = {"Accept": "application/json"}
+        if self._api_key:  # type: ignore[attr-defined]
+            headers["X-MBX-APIKEY"] = self._api_key  # type: ignore[attr-defined]
+        return headers
+
+    def _prepare_payload(
+        self,
+        *,
+        signed: bool,
+        params: dict[str, Any] | None,
+        data: dict[str, Any] | None,
+    ) -> tuple[dict[str, Any], dict[str, Any] | None]:
+        """Подготавливает payload и заголовки для запроса.
+
+        Если signed=True:
+            - добавляет подпись и все обязательные параметры в заголовки
+
+        Если signed=False:
+            - возвращает только отфильтрованные params/data.
+
+        Параметры:
+            signed (`bool`): Нужно ли подписывать запрос.
+            params (`dict | None`): Параметры для query string.
+            data (`dict | None`): Параметры для тела запроса.
+
+        Возвращает:
+            tuple:
+                - payload (`dict`): Параметры/тело запроса с подписью (если нужно).
+                - headers (`dict | None`): Заголовки для запроса или None.
+        """
+        # Фильтруем параметры от None значений
+        params = filter_params(params) if params else {}
+        data = filter_params(data) if data else {}
+
+        if not signed:
+            return {"params": params, "data": data}, None
+
+        if not self._api_key or not self._api_secret:  # type: ignore[attr-defined]
+            raise NotAuthorized("Api key is required to private endpoints")
+
+        # Объединяем все параметры в payload
+        payload = {**params, **data}
+        payload["timestamp"] = int(time.time() * 1000)
+        payload["recvWindow"] = self._RECV_WINDOW
+
+        # Генерируем подпись
+        query_string = dict_to_query_string(payload)
+        payload["signature"] = generate_hmac_sha256_signature(
+            self._api_secret,  # type: ignore[attr-defined]
+            query_string,
+            "hex",
+        )
+
+        headers = self._get_headers()
+        return payload, headers
+
     async def _make_request(
         self,
         method: RequestMethod,

{unicex-0.1.18/unicex/binance/asyncio → unicex-0.2.0/unicex/binance}/uni_client.py

@@ -2,11 +2,11 @@ __all__ = ["UniClient"]
 
 from functools import cached_property
 
-from unicex._abc.asyncio import IUniClient
+from unicex._abc import IUniClient
 from unicex.enums import Exchange, Timeframe
 from unicex.types import KlineDict, TickerDailyDict
 
-from ..adapter import Adapter
+from .adapter import Adapter
 from .client import Client
 
 

{unicex-0.1.18/unicex/binance/asyncio → unicex-0.2.0/unicex/binance}/uni_websocket_manager.py

@@ -3,12 +3,12 @@ __all__ = ["UniWebsocketManager"]
 from collections.abc import Awaitable, Callable
 from typing import Any
 
-from unicex._abc.asyncio import IUniWebsocketManager
-from unicex._base.asyncio import Websocket
+from unicex._abc import IUniWebsocketManager
+from unicex._base import Websocket
 from unicex.enums import Exchange, Timeframe
 from unicex.types import LoggerLike
 
-from ..adapter import Adapter
+from .adapter import Adapter
 from .client import Client
 from .uni_client import UniClient
 from .websocket_manager import WebsocketManager

{unicex-0.1.18/unicex/binance/asyncio → unicex-0.2.0/unicex/binance}/user_websocket.py

@@ -6,20 +6,28 @@ from typing import Any
 
 from loguru import logger as _logger
 
-from unicex._base.asyncio import Websocket
+from unicex._base import Websocket
 from unicex.exceptions import NotSupported
 from unicex.types import AccountType, LoggerLike
 
-from .._mixins import UserWebsocketMixin
 from .client import Client
 
 
-class UserWebsocket(UserWebsocketMixin):
+class UserWebsocket:
     """Пользовательский вебсокет Binance с авто‑продлением listenKey.
 
     Поддержка типов аккаунта: "SPOT" и "FUTURES" (USDT‑M фьючерсы).
     """
 
+    _BASE_SPOT_URL: str = "wss://stream.binance.com:9443"
+    """Базовый URL для вебсокета на спот."""
+
+    _BASE_FUTURES_URL: str = "wss://fstream.binance.com"
+    """Базовый URL для вебсокета на фьючерсы."""
+
+    _RENEW_INTERVAL: int = 30 * 60
+    """Интервал продления listenKey (сек.)"""
+
     def __init__(
         self,
         callback: Callable[[Any], Awaitable[None]],
@@ -28,7 +36,7 @@ class UserWebsocket(UserWebsocketMixin):
         logger: LoggerLike | None = None,
         **kwargs: Any,  # Не дадим сломаться, если юзер передал ненужные аргументы
     ) -> None:
-        """Инициализирует асинхронный пользовательский вебсокет для работы с биржей Binance.
+        """Инициализирует пользовательский вебсокет для работы с биржей Binance.
 
         Параметры:
             callback (`Callable`): Асинхронная функция обратного вызова, которая принимает сообщение с вебсокета.
@@ -48,6 +56,15 @@ class UserWebsocket(UserWebsocketMixin):
 
         self._running = False
 
+    @classmethod
+    def _create_ws_url(cls, type: AccountType, listen_key: str) -> str:
+        """Создает URL для подключения к WebSocket."""
+        if type == "FUTURES":
+            return f"{cls._BASE_FUTURES_URL}/ws/{listen_key}"
+        if type == "SPOT":
+            return f"{cls._BASE_SPOT_URL}/ws/{listen_key}"
+        raise NotSupported(f"Account type '{type}' not supported")
+
     async def start(self) -> None:
         """Запускает пользовательский стрим с автопродлением listenKey."""
         self._running = True

{unicex-0.1.18/unicex/binance/asyncio → unicex-0.2.0/unicex/binance}/websocket_manager.py

@@ -1,22 +1,26 @@
 __all__ = ["WebsocketManager"]
 
-
 from collections.abc import Awaitable, Callable, Sequence
 from typing import Any
 
-from unicex._base.asyncio import Websocket
+from unicex._base import Websocket
 from unicex.exceptions import NotAuthorized
 
-from .._mixins import WebsocketManagerMixin
 from .client import Client
 from .user_websocket import UserWebsocket
 
 type CallbackType = Callable[[Any], Awaitable[None]]
 
 
-class WebsocketManager(WebsocketManagerMixin):
+class WebsocketManager:
     """Менеджер асинхронных вебсокетов для Binance."""
 
+    _BASE_SPOT_URL: str = "wss://stream.binance.com:9443"
+    """Базовый URL для вебсокета на спот."""
+
+    _BASE_FUTURES_URL: str = "wss://fstream.binance.com"
+    """Базовый URL для вебсокета на фьючерсы."""
+
     def __init__(self, client: Client | None = None, **ws_kwargs: Any) -> None:
         """Инициализирует менеджер вебсокетов для Binance.
 
@@ -27,6 +31,37 @@ class WebsocketManager(WebsocketManagerMixin):
         self.client = client
         self._ws_kwargs = ws_kwargs
 
+    def _generate_stream_url(
+        self,
+        type: str,
+        url: str,
+        symbol: str | None = None,
+        symbols: Sequence[str] | None = None,
+        require_symbol: bool = False,
+    ) -> str:
+        """Генерирует URL для вебсокета Binance. Параметры symbol и symbols не могут быть использованы вместе.
+
+        Параметры:
+            type (`str`): Тип вебсокета.
+            url (`str`): Базовый URL для вебсокета.
+            symbol (`str | None`): Символ для подписки.
+            symbols (`Sequence[str] | None`): Список символов для подписки.
+            require_symbol (`bool`): Требуется ли символ для подписки.
+
+        Возвращает:
+            str: URL для вебсокета.
+        """
+        if symbol and symbols:
+            raise ValueError("Parameters symbol and symbols cannot be used together")
+        if require_symbol and not (symbol or symbols):
+            raise ValueError("Either symbol or symbols must be provided")
+        if symbol:
+            return f"{url}/ws/{symbol.lower()}@{type}"
+        if symbols:
+            streams = "/".join(f"{s.lower()}@{type}" for s in symbols)
+            return f"{url}/stream?streams={streams}"
+        return f"{url}/ws/{type}"
+
     def trade(
         self,
         callback: CallbackType,

{unicex-0.1.18/unicex/bitget/asyncio → unicex-0.2.0/unicex/bitget}/__init__.py

@@ -1,5 +1,8 @@
-__all__ = ["Client", "WebsocketManager", "UniWebsocketManager", "UniClient"]
+"""Пакет, содержащий реализации клиентов и менеджеров для работы с биржей Bitget."""
 
+__all__ = ["Client", "WebsocketManager", "UniWebsocketManager", "UniClient", "Adapter"]
+
+from .adapter import Adapter
 from .client import Client
 from .uni_client import UniClient
 from .uni_websocket_manager import UniWebsocketManager