feat: upload codebase

Author: 0xTan1319

.gitignore

@@ -0,0 +1,5 @@
+.env
+/target
+Cargo.lock
+testnet
+src/frontend/interface/.vite

Cargo.toml

@@ -0,0 +1,40 @@
+[package]
+name = "hyperliquid_rust_bot"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+hyperliquid_rust_sdk = { git = "https://github.com/0xNoSystem/hyperliquid-rust-sdk.git", branch = "master" }
+kwant = { git = "https://github.com/0xNoSystem/Indicators_rs.git", branch = "main" }
+chrono = "0.4.26"
+env_logger = "0.10.0"
+ethers = {version = "2.0.14", features = ["eip712", "abigen"]}
+futures-util = "0.3.28"
+hex = "0.4.3"
+http = "0.2.9"
+lazy_static = "1.3"
+log = "0.4.19"
+rand = "0.8.5"
+reqwest = "0.11.18"
+serde = { version = "1.0.175", features = ["derive"] }
+serde_json = "1.0.103"
+rmp-serde = "1.0.0"
+thiserror = "1.0.44"
+tokio = { version = "1.29.1", features = ["full"] }
+tokio-tungstenite = {version = "0.20.0", features = ["native-tls"]}
+uuid = {version = "1.6.1", features = ["v4"]}
+dotenv = "0.15.0"
+flume = "0.11.1"
+toml = "0.8.20"
+arraydeque = "0.5.1"
+rustc-hash = "2.1.1"
+futures = "0.3.31"
+hyperliquid = "0.2.4"
+anyhow = "1.0.98"
+actix = "0.13"
+actix-web = "4.11.0"
+actix-web-actors = "4"
+actix-cors = "0.6"
+
+
+

README.md

@@ -0,0 +1,98 @@
+# Hyperliquid Trading Bot - Rust
+
+Hyperliquid trading Bot with Rust is an experimental trading system built with
+[`hyperliquid_rust_sdk`](https://github.com/0xTan1319/hyperliquid-rust-sdk). It manages multiple
+markets on the Hyperliquid exchange and places trades based on signals from
+user-selected indicators.
+
+The repository currently ships a React/TS UI and actix server, follow the getting started steps.
+
+## Contact
+
+If you have any question or need more update for this, contact here: [Telegram](https://t.me/shiny0103) | [Twitter](https://x.com/0xTan1319)
+
+## 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
+
+After cloning the repo
+
+1. Install a recent Rust toolchain.
+2. Create a `.env` file in the root directory`:
+
+   ```env
+   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 app:
+
+   ```bash
+   ./run.sh
+   ```
+
+## 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:
+
+```rust
+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/strategy.ra' - Implements strategies followed by the signal engine.
+- `src/trade_setup.rs` – trading parameters and trade metadata.
+- `config.toml` – example strategy configuration.
+
+Supported trading pairs can be found in `src/assets.rs` (`MARKETS`).
+
+## Disclaimer
+
+This code is experimental and not audited. Use at your own risk when trading on
+live markets.

config.toml

@@ -0,0 +1,13 @@
+#Three trading styles: Scalp - Swing - build_position
+
+style = "Scalp"
+
+#Risk: Low - Normal - High
+risk = "High"
+
+#Stance: Bull - Neutral - Bear
+stance = "Neutral"
+
+#Follow trend: true - false
+followTrend= false
+

run.sh

@@ -0,0 +1,12 @@
+cargo run --release --bin load #update tradable assets list
+
+
+cargo run --release --bin kwant & #PREFIX WITH "RUST_LOG=info" for logging
+
+cd ./src/frontend/interface
+
+npm install
+npm run dev
+
+
+

src/assets.rs

@@ -0,0 +1 @@
+pub static MARKETS: &[&str] = &["BTC", "ETH", "ATOM", "MATIC", "DYDX", "SOL", "AVAX", "BNB", "APE", "OP", "LTC", "ARB", "DOGE", "INJ", "SUI", "kPEPE", "CRV", "LDO", "LINK", "STX", "RNDR", "CFX", "FTM", "GMX", "SNX", "XRP", "BCH", "APT", "AAVE", "COMP", "MKR", "WLD", "FXS", "HPOS", "RLB", "UNIBOT", "YGG", "TRX", "kSHIB", "UNI", "SEI", "RUNE", "OX", "FRIEND", "SHIA", "CYBER", "ZRO", "BLZ", "DOT", "BANANA", "TRB", "FTT", "LOOM", "OGN", "RDNT", "ARK", "BNT", "CANTO", "REQ", "BIGTIME", "KAS", "ORBS", "BLUR", "TIA", "BSV", "ADA", "TON", "MINA", "POLYX", "GAS", "PENDLE", "STG", "FET", "STRAX", "NEAR", "MEME", "ORDI", "BADGER", "NEO", "ZEN", "FIL", "PYTH", "SUSHI", "ILV", "IMX", "kBONK", "GMT", "SUPER", "USTC", "NFTI", "JUP", "kLUNC", "RSR", "GALA", "JTO", "NTRN", "ACE", "MAV", "WIF", "CAKE", "PEOPLE", "ENS", "ETC", "XAI", "MANTA", "UMA", "ONDO", "ALT", "ZETA", "DYM", "MAVIA", "W", "PANDORA", "STRK", "PIXEL", "AI", "TAO", "AR", "MYRO", "kFLOKI", "BOME", "ETHFI", "ENA", "MNT", "TNSR", "SAGA", "MERL", "HBAR", "POPCAT", "OMNI", "EIGEN", "REZ", "NOT", "TURBO", "BRETT", "IO", "ZK", "BLAST", "LISTA", "MEW", "RENDER", "kDOGS", "POL", "CATI", "CELO", "HMSTR", "SCR", "NEIROETH", "kNEIRO", "GOAT", "MOODENG", "GRASS", "PURR", "PNUT", "XLM", "CHILLGUY", "SAND", "IOTA", "ALGO", "HYPE", "ME", "MOVE", "VIRTUAL", "PENGU", "USUAL", "FARTCOIN", "AI16Z", "AIXBT", "ZEREBRO", "BIO", "GRIFFAIN", "SPX", "S", "MORPHO", "TRUMP", "MELANIA", "ANIME", "VINE", "VVV", "JELLY", "BERA", "TST", "LAYER", "IP", "OM", "KAITO", "NIL", "PAXG", "PROMPT", "BABY", "WCT", "HYPER", "ZORA", "INIT", "DOOD", "LAUNCHCOIN", "NXPC", "SOPH", "RESOLV", "SYRUP", "PUMP", "PROVE", "YZY", "XPL", "WLFI", "LINEA"];

src/backtest.rs

@@ -0,0 +1,35 @@
+use crate::{SignalEngine, MARKETS, IndexId};  
+use crate::helper::{load_candles};
+use kwant::indicators::{Price};
+use crate::trade_setup::{TradeParams, TimeFrame};
+use crate::strategy::{Strategy, CustomStrategy, Style, Stance};
+use tokio::time::{sleep, Duration};
+use hyperliquid_rust_sdk::{InfoClient, BaseUrl};
+
+pub struct BackTester{
+    pub asset: String,
+    pub signal_engine: SignalEngine,
+    pub params: TradeParams,
+    pub candle_data: Vec<Price>,
+}
+
+
+
+
+impl BackTester{
+
+    pub fn new(asset: &str,params: TradeParams, config: Option<Vec<IndexId>>, margin: f64) -> Self{
+        if !MARKETS.contains(&asset){
+            panic!("ASSET ISN'T TRADABLE, MARKET CAN'T BE INITILIAZED");
+        }
+
+        BackTester{
+            asset: asset.to_string(),
+            signal_engine: SignalEngine::new_backtest(params.clone(), config, margin),
+            params,
+            candle_data: Vec::new(),
+        }
+    }
+
+}
+