tigerogijzooav/Hyperliquid-Trade-Bot

What it does

Hyperliquid Trade Bot is a read-only terminal UI for due diligence on traders listed on the Hyperliquid perpetual futures leaderboard. Instead of trusting headline ROI, it recomputes PnL, win rate and drawdown from public fill and funding data, then flags patterns that make a track record look better than it is: martingale or revenge sizing, dependence on a few outlier trades, wash-trade suspicion, and whether the reported edge is statistically distinguishable from luck README overview.

Each address receives a TRUSTED / REVIEW / REJECT grade from an editable rule set, and the dashboard adds open positions, an equity sparkline and a paper-trade log of fills you would have mirrored. It never places orders and needs no private keys; verification works from public L1 data alone configuration.

Quick start

Requires Python 3.11 or newer. Clone the repository, install dependencies, then start the TUI:

git clone https://github.com/tigerogijzooav/Hyperliquid-Trade-Bot.git
cd Hyperliquid-Trade-Bot
pip install -r requirements.txt
python main.py          # launch the verifier TUI
python main.py --demo   # bundled offline demo dataset

Windows users can run run.bat, and Linux/macOS users can run chmod +x run.sh && ./run.sh; these launchers unpack a bundled standalone interpreter on first use quick start. No API key is needed to verify a trader — enter the public address in the Verify tab and inspect the report, or press v for the detailed report and r to re-verify keybindings.

Verification checks

For a given trader address the verifier rebuilds mark-to-market PnL per fill, adjusts for fees and funding, computes peak-to-trough drawdown and time under water, scores sizing consistency and leverage, measures how much PnL comes from the top-N trades, and runs a significance test on expectancy. Thresholds live in ~/.hl-verify/rules.toml, with network, verification window and risk-simulation settings in ~/.hl-verify/config.toml what verification checks.

Constraints

Analysis quality depends on the public fill history and the configured lookback window (90 days by default, 100 trades minimum). The tool is an audit layer, not an execution bot: the trade log and simulator only track hypothetical positions, and live monitoring uses an optional read-only wallet. The project is unofficial and not affiliated with Hyperliquid; it is research tooling, not financial advice. The README lists a cross-platform Python package but notes pre-compiled binaries only as planned project layout. License is MIT license.

HotRepo's take

In the new-project list for Python on 2026-11-12, the repository recorded 106 stars and 28 forks over a window of roughly 14 hours starting 2026-11-11 19:11 UTC, with no all-language daily rank recorded. That single-snapshot burst is the only HotRepo signal available, so it says little about sustained adoption. Technically, the read-only boundary is the interesting part: recomputing fill-based PnL and drawdown before copying a leaderboard address answers a real due-diligence need, and the trust rubric being editable in TOML makes the verdict inspectable rather than a black box.