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.