English | 中文
A local desktop app for grid trading on Hyperliquid perpetual futures.
Set a price range and size. The app places buys below the market and sells above it — aiming to profit when price oscillates inside that range.
The UI is multilingual: 中文, English, 日本語, 한국어, Español, Français, Deutsch, Português, and Русский (switch in the top-right; defaults to your system language).
- Referral link: https://app.hyperliquid.xyz/join/MMREFCSI — fee discount for you; rewards for the author
- Author Telegram: https://t.me/smith123_lee — if you like the app, feel free to ask about the Pro edition
Live account example:
Grid trading splits a price band into multiple levels. Roughly:
- Define the range — set lower/upper price, grid count, and total size; or fill ±5% around mid.
- Place the grid — relative to the live mid: buys below, sells above.
- Refill on fill — a buy fill places a sell higher; a sell fill places a buy lower, harvesting swings inside the band.
- Risk & stop — optional breakout actions, max drawdown, daily loss limits; Stop cancels all orders and flattens positions at market.
The app does not deposit or withdraw for you. Manage funds on the Hyperliquid website.
If you do not want to compile, download a prebuilt app from Releases:
- Pick the file for your OS (no installer):
- Windows →
hyper-grid-windows-x64.exe(double-click) - macOS Apple Silicon →
hyper-grid-macos-arm64.app.tar.gz(extract, open the.app) - macOS Intel →
hyper-grid-macos-x64.app.tar.gz(extract, open the.app) - Linux →
hyper-grid-linux-x86_64.AppImage, then:chmod +x hyper-grid-linux-x86_64.AppImage ./hyper-grid-linux-x86_64.AppImage
- Windows →
- Open the app and try Simulation first.
- Switch the UI language from the top-right language menu (defaults to your system language).
Linux note: The AppImage is built on Ubuntu 22.04 (needs a recent glibc). Ubuntu 20.04 cannot run the desktop build.
Install Rust and Node.js (20+ recommended).
cd apps/desktop
npm install
npm exec tauri dev # launch the desktop appOn Linux you also need WebKit and related system packages (e.g. libwebkit2gtk-4.1-dev), or the desktop build will fail.
| Item | Notes |
|---|---|
| Hyperliquid perps balance | Deposit yourself on the site. Mainnet · Testnet faucet |
| Wallet private key | Stored only in a local .env next to the binary; Simulation can skip it |
Testnet / Mainnet require a private key before start. Never share it.
- Account — pick Simulation / Testnet / Mainnet; for live modes paste the key and Refresh balances.
- Configure grid — symbol, range, levels, size, leverage → Preview → Start.
- Run panel — watch status, PnL, and fills; Pause / Resume / Stop as needed (Stop cancels and flattens).
You can also set spacing (arithmetic / geometric), margin mode (cross / isolated), fixed / dynamic grid, breakout behavior, max drawdown, and daily loss; import / export strategy configs is supported. The PnL analytics tab shows all-session totals and equity curves.
| Setting | Notes |
|---|---|
| Run mode | Simulation (no real funds) / Testnet / Mainnet |
| Symbol | Hyperliquid perps (e.g. BTC); not spot grids |
| Lower / upper price | Grid band; in dynamic mode filled from ATR (refreshable) |
| Fit range from mid % | Quick ±N% band around live mid (RANGE_PCT) |
| Grid levels | Number of layers in the band (start with defaults) |
| Total notional | Planned notional in USDC; too little per level blocks start |
| Spacing | Arithmetic / geometric |
| Margin mode | Cross / isolated |
| Leverage | Amplifies both gain and loss |
| Grid mode | Dynamic (default): ATR band, optional soft recenter with position kept; Fixed: manual bounds (GRID_MODE) |
| ATR candle interval | Candle interval for ATR, default 1h (ATR_INTERVAL) |
| ATR period | ATR lookback bars, default 14 (ATR_PERIOD) |
| ATR multiplier | Half-width ≈ ATR% × mult, default 5, clamped ~2%–12% (ATR_MULT) |
| Breakout confirm bars | Closed candles outside the band before recenter / breakout action, default 2 (CONFIRM_BARS) |
| Recenter cooldown / max per day | Limits how often dynamic grids may migrate (default 3600s / 4 per day) |
| On breakout | Fixed: pause / cancel-stop, etc.; dynamic defaults to recenter (keep position) |
| Max drawdown / daily loss | Circuit breaker; cancel and flatten |
| Max consecutive order failures | Halt after this many failures (MAX_ORDER_FAILURES) |
| Auto-start on launch | Start from saved config if no resumable session (AUTO_START) |
| Resume on restart | Restore open session state when possible (RESUME_ON_RESTART) |
| Close-window policy | Default preserve exchange orders/position (EXIT_POLICY=preserve); Stop cancels and flattens the strategy symbol |
- Crypto and perps are risky; you can lose money — higher leverage means higher risk.
- Keep the private key on this machine only; never send it to anyone or upload it.
- Practice on Simulation / Testnet first; start small on mainnet.
- Stop cancels and flattens the strategy symbol; closing the window by default preserves exchange orders/position (resumable) — watch fees and positions.
This software is for learning and research only and is not investment advice. Assess risks yourself and follow Hyperliquid’s terms and local laws. The author is not liable for any losses from using this software.
MIT