unicex 0.2.0

Unified Crypto Exchange API

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 примера