Skip to content

Neleus

Neleus logo

Neleus

Trade Hyperliquid from the terminal.

Neleus is a Hyperliquid-first CLI and Python toolkit powered by a Rust core. Use it to search markets, run technical scans, stream live order books, backtest strategies, and scaffold Python trading projects.

Get Started Market Workflows Website GitHub

No-project market tools

Search, list, analyze, scan, and monitor Hyperliquid markets directly from the CLI — perps, spot, HIP-3, and HIP-4 outcome markets.

Rust-backed market core

All market data, execution, and backtesting logic lives in Rust. Python is the CLI and interactive surface only.

Python strategy workflow

Scaffold a project, write strategies in Python, backtest them, and run them once or as a daemon.

Terminal-first UX

Rich dashboards, ranked scans, live order book views, interactive REPL, and concise command-driven workflows.

What You Can Do Today

Workflow Command Result
Search markets neleus market search BTC Find matching spot, default perp, HIP-3, or HIP-4 markets
List market catalogs neleus market list --scope hip3 --dex xyz View market groups with counts and metadata
List outcome markets neleus market list --scope hip4 --testnet Browse HIP-4 binary outcome markets (testnet)
Analyze a market neleus market analyze GAS --scope hip3 --dex flx Get RSI, trend, levels, volatility, and a directional read
Scan setups neleus market scan --scope perps Rank a bounded market set by conviction-style TA score
Stream live depth neleus market book BTC-PERP Watch a live Hyperliquid L2 order book in the terminal
Scaffold a project neleus new my_strategy_project Generate a Python strategy project wired to the Rust core
Interactive REPL neleus (in a terminal) Launch an interactive session with history and tab completion

Product Scope

Implemented now:

  • market search, list, analysis, scanning, and live order book monitoring
  • HIP-4 outcome market browsing (testnet)
  • interactive REPL when no subcommand is given in a terminal
  • project scaffolding for Python strategies
  • backtesting
  • one-shot and daemon strategy runtimes
  • database-backed runtime order/fill monitoring through TradeMonitor
  • database schema inspection and initialization through neleus db status and neleus db init

Not implemented yet:

  • a dedicated neleus trade command separate from the current runtime/core APIs
  • broader live operations tooling beyond the current trade-monitoring path

Suggested Reading Order

  1. Start with Installation
  2. Run the no-project commands in Quickstart
  3. Learn the full market command surface in Market Workflows
  4. Scaffold a project in Strategy Projects
  5. Learn the actual strategy API in Writing Strategies
  6. Copy and adapt code from Strategy Examples