HypeBook

Usage guide

Self-hosted Bookmap-class order flow for Hyperliquid-first crypto. Live demo: hypebook.1kpier.com.

Start

• Copy .env.example → .env. Market data needs no keys.
• docker compose up --build → UI http://localhost:3100 · API /health on :8000.
• Public site: https://hypebook.1kpier.com (Vercel UI + tunneled local API).

Demo & invite

• Homepage → Enter demo → private invite → /demo terminal.
• Set INVITE_ACCOUNTS or INVITE_PASSWORD on the frontend. Unset = local bypass.
• Keys stay on the host. Never commit secrets.

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.
• 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 = 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 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 uses public HL leaderboard stats.
• Liq/stop overlay is separate from the liquidity heatmap — estimates / tagged fills.

Shortcuts

• Space — pause / resume
• L — follow live
• , / . — scrub back / forward
• S — settings
• ? — 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.