HypeBook

HypeBook

Usage guide

Self-hosted Bookmap-class order flow for Hyperliquid-first crypto. Read this once, then live in the terminal.

Start

  • Copy .env.example → .env. Market data needs no keys.
  • docker compose up --build → UI http://localhost:3100 · API http://localhost:8000/health
  • Public demo: https://hypebook.1kpier.com (invite login → /demo).
  • Host port 3100 is intentional when 3000 is busy.

Demo & invite

  • Homepage is the product portal. Enter demo → private invite → live terminal at /demo.
  • Set INVITE_ACCOUNTS or INVITE_PASSWORD on the frontend (Vercel / Compose). Unset = local bypass.
  • Backend stays on your box (or a tunnel). Keys never leave the host.

Memory buffers

  • Pick a symbol, then Hold in memory — server keeps loading L2/trades into RAM even if you switch away.
  • Save take writes the current ring to a scrubbable session (Settings → Sessions).
  • Held assets appear as chips under Memory — click to switch.

Chart (Bookmap-class)

  • Heatmap = resting L2 size over time (not candles, not liquidations).
  • Style presets on the chart toolbar: Clean / Flow / Depth / Momentum / Full.
  • Momentum preset: ATR bands + CVD + flow HUD for impulse context.
  • Bubbles = aggressive trade volume; color = aggressor side.
  • Volume strip + CVD = aggressor flow; CVD is cumulative buy − sell.
  • Absorption rings = L2 estimate when a large trade barely depletes resting size (not MBO iceberg).
  • Wheel = time zoom · Shift+wheel = price pad · right scale = zoom/pan · dbl-click = follow mid.

DOM & trading

  • Trading DOM shares the same book as the heatmap.
  • Modes: Ladder / Bookmap / Split — Settings → Layout.
  • PAPER = click-to-place local marks. LIVE needs keys + dry-run=0.
  • Prefer testnet first. Agent wallet signs; main address is for info queries.

Pause / replay

  • Pause or scrub freezes the view; live feed is locked out so it cannot overwrite history.
  • Settings → Sessions loads a recorded JSONL take from the server.
  • Follow live unlocks and resubscribes.

Wallets & intel

  • Watchlists track public fills (main addresses only).
  • Top traders panel uses public HL leaderboard stats.
  • Liq/stop overlay is separate from the liquidity heatmap — estimates / tagged fills, not an official HL liq heatmap.

Shortcuts

  • Space — pause / resume
  • L — follow live
  • , / . — scrub back / forward
  • S — settings
  • ? — this guide

Honest limits

  • Hyperliquid public book is aggregated L2 — no MBO / PIQ / classic iceberg.
  • Aggregate venue sums size at exact price strings across HL+Binance+Bybit.
  • Never commit API keys. Self-host only — no multi-tenant key custody.