sonicmountain / Trade-Bot-Hyperliquid

# Trade-Bot-Hyperliquid
Independently analyze ROI, win rate, and PnL using the public Hyperliquid API, detect martingale/grid recovery strategies, and assess maximum drawdown and risk-adjusted returns. Read-only terminal checker — no trading, no API keys. Unofficial community project, not affiliated with Hyperliquid.
# 🔐 Hyperliquid Trade Bot
### Independent ROI, PnL and martingale analysis in your terminal.
**A read-only verification & monitoring terminal for Hyperliquid trading.**
Don't blindly mirror a leaderboard address — *audit it first.*
---
## 📖 Overview
**Hyperliquid Trade Bot** is a keyboard-driven **terminal user interface (TUI)** for
**perpetual futures trading due diligence**: it performs an **independent verification of
ROI, win rate, and PnL** for any trader on the Hyperliquid leaderboard, recomputed from the
public Hyperliquid API — *before* you decide to mirror their positions.
Raw leaderboard ROI hides a lot: martingale sizing, lucky single-trade pumps, wash-trading,
fee-ignorance, and drawdowns masked by spot/perp swaps. The verifier analyzes a trader's
**full fill history** and reconstructs the **equity curve from on-chain fills**, surfacing the
metrics that actually predict trading safety: **max drawdown and risk-adjusted returns
(Sharpe/Sortino)**, **martingale and grid recovery pattern detection**, outlier dependence,
**position sizing consistency and leverage analysis**, and a significance test that helps you
**spot inflated track records and survivorship bias**.
> ⚠️ **Read-only by design.** This verifier never places orders. It is an *audit and monitoring*
> layer — a **read-only terminal checker: no trading, no keys** 
---
## ✨ Features
| Area | What you get |
|------|--------------|
| 🕵️ **Trader Verification** | Independent re-derivation of ROI / PnL / win-rate / drawdown from public Hyperliquid fills. |
| 🧠 **Manipulation Heuristics** | Martingale detection, outlier-dependence score, wash-trade flags, survivorship warnings. |
| 📈 **Live Monitor** | Watch a verified trader's open positions, equity curve, and fills update in real time. |
| 🧮 **Risk Simulator** | Project trade outcomes under configurable size-scaling, leverage caps and stop-loss. |
| 📋 **Trade Log** | A local, append-only audit log of every fill you *would have* mirrored (paper-trail). |
| 🎛️ **Dashboard** | Single-pane-of-glass TUI: stats panel, trader table, positions, sparkline equity. |
| ⌨️ **Keyboard-first** | 100% navigable from the home row. Vim-style bindings. No mouse required. |
| 🌑 **Theming** | Light / dark / hyperliquid-themed palettes. |
---
## 🖥️ Screenshots
> The verifier runs as a live TUI. Below is a static ASCII preview of the dashboard.
 [code] 
---
## 🚀 Quick start
 [code] 
One-click launchers (no system Python required — they unpack a bundled standalone
interpreter on first run):
 [code] 
 [code] 
> No API keys required for verification — the tool reads public Hyperliquid data.
> An optional read-only wallet is used only for the l