Unified Crypto Exchange API
unicex — асинхронная библиотека для работы с криптовалютными биржами, реализующая унифицированный интерфейс поверх «сырых» REST и WebSocket API разных бирж. Поддерживает спотовый и USDT-фьючерсный рынки.
✅ Статус реализации
1) Инфраструктурный слой
| Exchange | Client | Auth | WS Manager | User WS | ExchangeInfo |
|---|---|---|---|---|---|
| Aster | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
| Binance | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
| Bitget | 🟢 | 🟢 | 🟢 | 🔴 | 🟢 |
| Bybit | 🟢 | 🟢 | 🟢 | 🔴 | 🟢 |
| Gateio | 🟢 | 🟢 | 🟢 | 🔴 | 🟢 |
| Hyperliquid | 🟢 | 🟢 | 🟢 | 🔴 | 🟢 |
| Mexc | 🟢 | 🟢 | 🟢 | 🔴 | 🟢 |
| Okx | 🟢 | 🟢 | 🟢 | 🔴 | 🟢 |
| Kucoin | 🟢 | 🔴 | 🟢 | 🔴 | 🟢 |
| BingX | 🟢 | 🔴 | 🟢 | 🔴 | 🟢 |
2) Унифицированный слой
| Exchange | UniClient (20) | UniWebsocketManager (8) |
|---|---|---|
| Aster | 20/20 🟢 | 8/8 🟢 |
| Binance | 20/20 🟢 | 8/8 🟢 |
| Bitget | 20/20 🟢 | 8/8 🟢 |
| Bybit | 20/20 🟢 | 8/8 🟢 |
| Gateio | 20/20 🟢 | 8/8 🟢 |
| Hyperliquid | 11/20 🟡 | 8/8 🟢 |
| Mexc | 12/20 🟡 | 6/8 🟡 |
| Okx | 16/20 🟡 | 8/8 🟢 |
| Kucoin | 11/20 🟡 | 0/8 🔴 |
| BingX | 11/20 🟡 | 4/8 🟡 |
Расшифровка колонок (1 таблица):
- Client - Реализация сырого REST-клиента биржи (market/order/position/account).
- Auth - Поддержка авторизации и приватных REST-эндпоинтов.
- WS Manager - Реализация сырого WebSocket-менеджера биржи.
- User WS - Поддержка пользовательских (приватных) WebSocket-потоков.
- ExchangeInfo - Фоновая загрузка рыночных параметров (шаг цены, шаг объема, множитель контракта).
Расшифровка колонок (2 таблица):
- UniClient (19) - Количество реализованных методов из интерфейса
IUniClient. - UniWebsocketManager (8) - Количество реализованных методов из интерфейса
IUniWebsocketManager.
🚀 Быстрый старт
- Установка:
pip install unicexили из исходников:pip install -e . - Библиотека полностью асинхронная. Примеры импорта:
- Сырые клиенты:
from unicex.binance import Client - Унифицированные клиенты:
from unicex.binance import UniClient - Вебсокет менеджеры:
from unicex.binance import WebsocketManager, UniWebsocketManager
- Сырые клиенты:
Пример: Получение рыночных данных через API
import asyncio
from unicex import Exchange, Timeframe, get_uni_client
# Выбираем биржу, с которой хотим работать.
# Поддерживаются: Binance, Bybit, Bitget, Mexc, Gateio, Hyperliquid и другие.
exchange = Exchange.BYBIT
async def main() -> None:
"""Пример простого использования унифицированного клиента unicex."""
# 1️⃣ Создаём клиент для выбранной биржи
client = await get_uni_client(exchange).create()
# 2️⃣ Получаем открытый интерес по всем контрактам
open_interest = await client.open_interest()
print(open_interest)
# Пример вывода:
# {
# "BTCUSDT": {"t": 1759669833728, "v": 61099320.0},
# "ETHUSDT": {"t": 1759669833728, "v": 16302340.0},
# "SOLUSDT": {"t": 1759669833728, "v": 3427780.0},
# ...
# }
# 3️⃣ Можно точно так же получать другие данные в едином формате:
await client.tickers() # список всех тикеров
await client.futures_tickers() # тикеры фьючерсов
await client.ticker_24hr() # статистика за 24 часа (spot)
await client.futures_ticker_24hr() # статистика за 24 часа (futures)
await client.klines("BTCUSDT", Timeframe.MIN_5) # свечи спота
await client.futures_klines("BTCUSDT", Timeframe.HOUR_1) # свечи фьючерсов
await client.funding_rate() # ставка финансирования
if __name__ == "__main__":
asyncio.run(main())
Пример: Авторизация и приватные методы
Для приватных эндпоинтов (баланс, позиции, ордера) клиент создаётся с ключами.
Большинство бирж используют api_key + api_secret (Bitget, OKX, Kucoin — дополнительно api_passphrase),
а Aster и Hyperliquid авторизуются приватным ключом кошелька private_key (Web3-подпись).
import asyncio
from unicex import Exchange, get_uni_client
from unicex.enums import OrderSide, OrderType
async def main() -> None:
"""Пример создания авторизованных клиентов и вызова приватных методов."""
# 🔑 Биржи с API-ключами (Binance, Bybit, Mexc, Gateio, ...)
binance = await get_uni_client(Exchange.BINANCE).create(
api_key="...",
api_secret="...",
)
# 🔑 Bitget / OKX / Kucoin дополнительно требуют api_passphrase
okx = await get_uni_client(Exchange.OKX).create(
api_key="...",
api_secret="...",
api_passphrase="...",
)
# 🔑 Aster и Hyperliquid — авторизация приватным ключом кошелька (EIP-712)
aster = await get_uni_client(Exchange.ASTER).create(
private_key="0x...",
)
# Приватные методы доступны в едином формате на всех биржах:
await aster.futures_position_info("BTCUSDT")
await aster.futures_set_leverage("BTCUSDT", leverage=10)
await aster.futures_order_create(
symbol="BTCUSDT",
side=OrderSide.BUY,
type=OrderType.LIMIT,
quantity="0.001",
price="50000",
)
if __name__ == "__main__":
asyncio.run(main())
Пример: Получение данных в реальном времени через Websocket API
import asyncio
from unicex import Exchange, TradeDict, get_uni_websocket_manager
from unicex.enums import Timeframe
# Выбираем биржу, с которой хотим работать.
# Поддерживаются: Binance, Bybit, Bitget, Mexc, Gateio, Hyperliquid и другие.
exchange = Exchange.BITGET
async def main() -> None:
"""Пример простого использования унифицированного менеджера Websocket от UniCEX."""
# 1️⃣ Создаём WebSocket-менеджер для выбранной биржи
ws_manager = get_uni_websocket_manager(exchange)()
# 2️⃣ Подключаемся к потоку сделок (aggTrades)
aggtrades_ws = ws_manager.aggtrades(
callback=callback,
symbols=["BTCUSDT", "ETHUSDT"],
)
# Запускаем получение данных
await aggtrades_ws.start()
# 3️⃣ Примеры других типов потоков:
futures_aggtrades_ws = ws_manager.futures_aggtrades(
callback=callback,
symbols=["BTCUSDT", "ETHUSDT"],
)
klines_ws = ws_manager.klines(
callback=callback,
symbols=["BTCUSDT", "ETHUSDT"],
timeframe=Timeframe.MIN_5,
)
futures_klines_ws = ws_manager.futures_klines(
callback=callback,
symbols=["BTCUSDT", "ETHUSDT"],
timeframe=Timeframe.MIN_1,
)
# 💡 Также у каждой биржи есть свой WebsocketManager:
# unicex.<exchange>.websocket_manager.WebsocketManager
# В нём реализованы остальные методы для работы с WS API.
async def callback(trade: TradeDict) -> None:
"""Обработка входящих данных из Websocket."""
print(trade)
# Пример вывода:
# {'t': 1759670527594, 's': 'BTCUSDT', 'S': 'BUY', 'p': 123238.87, 'v': 0.05}
# {'t': 1759670527594, 's': 'BTCUSDT', 'S': 'BUY', 'p': 123238.87, 'v': 0.04}
# {'t': 1759670346828, 's': 'ETHUSDT', 'S': 'SELL', 'p': 4535.0, 'v': 0.0044}
# {'t': 1759670347087, 's': 'ETHUSDT', 'S': 'BUY', 'p': 4534.91, 'v': 0.2712}
if __name__ == "__main__":
asyncio.run(main())
Пример: Округление цен используя фоновый класс ExchangeInfo
import asyncio
from unicex import start_exchanges_info, get_exchange_info, Exchange
async def main() -> None:
# ⏳ Запускаем фоновые процессы, которые собирают рыночные параметры всех бирж:
# - количество знаков после точки для цены и объема
# - множители контрактов для фьючерсов
await start_exchanges_info()
# Небольшая пауза, чтобы данные успели подгрузиться
await asyncio.sleep(1)
# 1️⃣ Пример 1: Округление цены для фьючерсов OKX
okx_exchange_info = get_exchange_info(Exchange.OKX)
okx_rounded_price = okx_exchange_info.round_futures_price("BTC-USDT-SWAP", 123456.1234567890)
print(okx_rounded_price) # >> 123456.1
# 2️⃣ Пример 2: Округление объема для спота Binance
binance_exchange_info = get_exchange_info(Exchange.BINANCE)
binance_rounded_quantity = binance_exchange_info.round_quantity("BTCUSDT", 1.123456789)
print(binance_rounded_quantity) # >> 1.12345
# 3️⃣ Пример 3: Получение множителя контракта (например, Mexc Futures)
mexc_exchange_info = get_exchange_info(Exchange.MEXC)
mexc_contract_multiplier = mexc_exchange_info.get_futures_ticker_info("BTC_USDT")["contract_size"]
print(mexc_contract_multiplier) # >> 0.0001
# 4️⃣ Пример 4: Реальное применение — вычисляем тейк-профит вручную
# Допустим, позиция открыта по 123123.1 USDT, хотим +3.5% тейк-профит:
take_profit_raw = 123123.1 * 1.035
print("До округления:", take_profit_raw) # >> 127432.40849999999
# Биржа требует цену в допустимом формате — округляем:
take_profit = okx_exchange_info.round_futures_price("BTC-USDT-SWAP", take_profit_raw)
print("После округления:", take_profit) # >> 127432.4
# Теперь это число можно безопасно передать в API без ошибок:
# await client.create_order(symbol="BTC-USDT-SWAP", price=take_profit, ...)
if __name__ == "__main__":
asyncio.run(main())
Пример: Полезные утилиты из unicex.extra
import time
from unicex import Exchange, MarketType
from unicex.extra import (
TimeoutTracker,
SignalCounter,
percent_greater,
percent_less,
normalize_ticker,
normalize_symbol,
generate_ex_link,
generate_tv_link,
generate_cg_link,
make_humanreadable,
)
entry, last = 1975.0, 2012.5
print("Рост (%):", round(percent_greater(last, entry), 2))
print("Просадка (%):", round(percent_less(last, entry), 2))
raw = "eth-usdt-swap"
symbol = normalize_symbol(raw) # ETHUSDT
ticker = normalize_ticker(raw) # ETH
print("ticker:", ticker, "| symbol:", symbol)
print("Биржа:", generate_ex_link(Exchange.OKX, MarketType.FUTURES, symbol))
print("TradingView:", generate_tv_link(Exchange.OKX, MarketType.FUTURES, symbol))
print("CoinGlass:", generate_cg_link(Exchange.OKX, MarketType.FUTURES, symbol))
notional = 12_345_678.9
print("Объем (RU):", make_humanreadable(notional, "ru"))
print("Volume (EN):", make_humanreadable(notional, "en"))
cooldown = TimeoutTracker[str]()
cooldown.block("BTCUSDT", duration=3)
print("BTCUSDT заблокирован:", cooldown.is_blocked("BTCUSDT"))
time.sleep(3)
print("BTCUSDT заблокирован:", cooldown.is_blocked("BTCUSDT"))
counter = SignalCounter[str](window_sec=5)
counter.add("breakout")
counter.add("breakout")
print("Лимит 3 не превышен:", counter.is_within_limit("breakout", limit=3))
1 maintainer
Metadata
1 maintainer
Release files for unicex 0.29.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| unicex-0.29.6.tar.gz | 194.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| unicex-0.29.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 437.2 kB
Release files / unicex-0.29.6.tar.gz
| Download URL | unicex-0.29.6.tar.gz |
|---|---|
| Size | 194.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
97d409396aa05fb673f3af7166842bbe69cce49a2c19dc7348ab1117f9263f68
|
|
BLAKE2b-256 checksum How to use checksums |
70504a0c4ba6dcf08614a3fc25a403425a740759ec06c218e43ec9ce4067f8f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / unicex-0.29.6-py3-none-any.whl
| Download URL | unicex-0.29.6-py3-none-any.whl |
|---|---|
| Size | 243.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb543f30a35997017ee8ee7796e55f1c9acd62bb8dacfc7e8d66cf6e360c46c1
|
|
BLAKE2b-256 checksum How to use checksums |
6174513581ce086b4e67eb8e644a6d77feef4f3bd3163011a7daf5b7057d4ca2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency log
