Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hyper-grid

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.

  • Referral link: MMREFCSI — fee discount for you; rewards for the author
  • Author Telegram: smith123_lee — if you like the app, feel free to ask about the Pro edition

Live account example:

Portfolio

Demo

Demo

This app can connect to real markets with real funds. Understand the risks first. Prefer Simulation or Testnet before going live.

How it works

Grid trading splits a price band into multiple levels. Roughly:

  1. Define the range — set lower/upper price, grid count, and total size; or fill ±5% around mid.
  2. Place the grid — relative to the live mid: buys below, sells above.
  3. Refill on fill — a buy fill places a sell higher; a sell fill places a buy lower, harvesting swings inside the band.
  4. 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.

Quick start

Download portable build (recommended)

If you do not want to compile, download a prebuilt app from Releases:

  1. Pick the file for your OS (no installer):
    • Windowshyper-grid-windows-x64.exe (double-click)
    • macOS Apple Siliconhyper-grid-macos-arm64.app.tar.gz (extract, open the .app)
    • macOS Intelhyper-grid-macos-x64.app.tar.gz (extract, open the .app)
    • Linuxhyper-grid-linux-x86_64.AppImage, then:
      chmod +x hyper-grid-linux-x86_64.AppImage
      ./hyper-grid-linux-x86_64.AppImage
  2. Open the app and try Simulation first.
  3. Switch 中文 / EN in the top bar.

Linux note: The AppImage is built on Ubuntu 22.04 (needs a recent glibc). Ubuntu 20.04 cannot run the desktop build.

Run from source

Install Rust and Node.js (20+ recommended).

cd apps/desktop
npm install
npm exec tauri dev    # launch the desktop app

On Linux you also need WebKit and related system packages (e.g. libwebkit2gtk-4.1-dev), or the desktop build will fail.

Before live trading

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.

Three steps

  1. Account — pick Simulation / Testnet / Mainnet; for live modes paste the key and Refresh balances.
  2. Configure grid — symbol, range, levels, size, leverage → PreviewStart.
  3. 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), breakout behavior, max drawdown, and daily loss; import / export strategy configs is supported.

Common settings

Setting Notes
Run mode Simulation (no real funds) / Testnet / Mainnet
Symbol Hyperliquid perps (e.g. BTC); not spot grids
Lower / upper price Price band covered by the grid
Grid levels Number of layers in the band (start with defaults)
Total notional Planned notional in USDC; too little per level blocks start
Leverage Amplifies both gain and loss
On breakout Alert only / Pause / Cancel & pause
Max drawdown / daily loss Circuit breaker; stops new orders

Safety

  • 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.
  • On Stop, quit, or restart, the app tries to cancel orders and flatten — watch fees and positions.

Disclaimer

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.

License

MIT

Releases

Packages

Contributors

Languages