Neleus
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.
No-project market tools
Search, list, analyze, scan, and monitor Hyperliquid markets directly from the CLI.
Rust-backed market core
REST and WebSocket paths are driven by the Rust Hyperliquid adapter, then exposed to Python and the CLI.
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, and concise command-driven workflows.
What You Can Do Today
| Workflow | Command | Result |
|---|---|---|
| Search markets | neleus market search BTC |
Find matching spot, default perp, or HIP-3 markets |
| List market catalogs | neleus market list --scope hip3 --dex xyz |
View market groups with counts and metadata |
| Analyze a market | neleus market analyze GAS --scope hip3 --dex flx |
Get RSI, trend, levels, volatility, and a directional read without typing the exact routed market id |
| Scan setups | neleus market scan --scope perps |
Rank a bounded market set by conviction-style TA score |
| Stream live depth | neleus market book flx:GAS-PERP |
Watch a live Hyperliquid L2 order book in the terminal, even when Hyperliquid needs an internal routed symbol |
| Scaffold a project | neleus new my_strategy_project |
Generate a Python strategy project wired to the Rust core |
Product Scope
Implemented now:
- market search, list, analysis, scanning, and live order book monitoring
- 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
- Start with Installation
- Run the no-project commands in Quickstart
- Learn the full market command surface in Market Workflows
- Scaffold a project in Strategy Projects
- Learn the actual strategy API in Writing Strategies
- Copy and adapt code from Strategy Examples