Hyperliquid Rust Bot

Hyperliquid Rust Bot is an experimental trading system built with hyperliquid_rust_sdk and kwant. It manages multiple markets on the Hyperliquid exchange and places trades based on signals from user-selected indicators.

The repository currently ships a CLI example (enginetest.rs). A UI is in the works.

Features

• Connect to Hyperliquid mainnet, testnet or localhost.
• Manage several markets concurrently with configurable margin allocation.
• Customisable strategy (risk, style, stance).
• Indicator engine where each indicator is bound to a timeframe.
• Asynchronous design using tokio and flume channels.

Getting started

1. Install a recent Rust toolchain.

2. Create a .env file in the project root based on .env.test:

   PRIVATE_KEY=<your API private key> -> https://app.hyperliquid.xyz/API
   AGENT_KEY=<optional agent api public key>
   WALLET=<public wallet address>

3. Run the demonstration:

   cargo run --bin enginetest

   The example spawns a bot, allocates margin to a few markets and shows how indicators can be edited on the fly.

Strategy

The bot uses CustomStrategy (see src/strategy.rs). It combines indicators such as RSI, StochRSI, EMA crosses, ADX and ATR. Risk level (Low, Normal, High), trading style (Scalp or Swing) and market stance (Bull, Bear or Neutral) can be set. Signals are generated when multiple indicator conditions agree—for example an oversold RSI with a bullish StochRSI crossover may trigger a long trade.

Indicators

Indicators are activated with (IndicatorKind, TimeFrame) pairs. Available kinds include:

• Rsi(u32)
• SmaOnRsi { periods, smoothing_length }
• StochRsi { periods, k_smoothing, d_smoothing }
• Adx { periods, di_length }
• Atr(u32)
• Ema(u32)
• EmaCross { short, long }
• Sma(u32)

Each pair is wrapped in an Entry together with an EditType (Add, Remove or Toggle). The snippet below (from enginetest.rs) shows how a market can be created with a custom indicator configuration:

let config = vec![
    (IndicatorKind::Rsi(12), TimeFrame::Min1),
    (IndicatorKind::EmaCross { short: 21, long: 200 }, TimeFrame::Day1),
];

let market = AddMarketInfo {
    asset: "BTC".to_string(),
    margin_alloc: MarginAllocation::Alloc(0.1),
    trade_params,
    config: Some(config),
};

Project structure

• src/bot.rs – orchestrates markets and keeps margin in sync.
• src/market.rs – handles a single market: data feed, signal engine and order execution.
• src/signal/ – indicator trackers and strategy logic.
• src/executor.rs – sends orders via the Hyperliquid API.
• src/trade_setup.rs – trading parameters and trade metadata.
• config.toml – example strategy configuration.

Supported trading pairs can be found in src/consts.rs (MARKETS).

Disclaimer

This code is experimental and not audited. Use at your own risk when trading on live markets.