Listen To Public Data

Use client.streams for public subscription-style updates.

Listen To Order Book Updates

Use l2_book() for order book updates.

from typed_hyperliquid import Hyperliquid

async with Hyperliquid.new(public=True) as client:
  async with client.streams.l2_book('BTC') as book:
    async for update in book:
      best_bid = update['levels'][0][0]
      best_ask = update['levels'][1][0]
      print(best_bid['px'], best_ask['px'])

If you need more compact aggregation, use the optional n_sig_figs and mantissa arguments.

Listen To Candle Updates

from typed_hyperliquid import Hyperliquid

async with Hyperliquid.new(public=True) as client:
  async with client.streams.candle('BTC', interval='1m') as candles:
    async for candle in candles:
      print(candle['s'], candle['i'], candle['c'])

Listen To Market-Wide Mid Prices

from typed_hyperliquid import Hyperliquid

async with Hyperliquid.new(public=True) as client:
  async with client.streams.all_mids() as mids:
    async for update in mids:
      print(update['mids']['BTC'])

Other Public Streams

client.streams also exposes:

l2_book() for aggregated order book updates
candle() for live candle updates
trades() for public trade prints
all_mids() for market-wide mid prices
bbo() for best-bid/best-offer updates
active_asset_ctx() and active_asset_data() for asset-level live state