Python SDK
Connect to Aleatoric Hyperliquid feeds from Python. Async-native, typed events, automatic reconnection.
Install python
pip install aleatoricQuickstart
1. Install
pip install aleatoric2. Connect
from aleatoric import Client
client = Client(api_key="ak_your_key")3. Stream Data
async for event in client.stream("BTC"):
print(f"Mid: {event.mid} | Spread: {event.spread}")
print(f"Best bid: {event.best_bid} x {event.bid_qty}")Workflows
Connect to Endpoint
from aleatoric import Client
# US region (default)
client = Client(api_key="ak_your_key")
# Japan region
client_jp = Client(api_key="ak_your_key", region="jp")Subscribe to Fills
async for fill in client.fills("ETH"):
print(f"Fill: {fill.side} {fill.size} @ {fill.price}")
print(f"Fee: {fill.fee_usd}")Handle Liquidation Events
async for liq in client.liquidations("BTC", min_size_usd=50000):
print(f"LIQUIDATION: {liq.side} ${liq.size_usd:,.0f}")
print(f"Severity: {liq.severity}")
if liq.cascade_risk:
print("WARNING: Cascade risk detected")