Loading bots…
Account settings
Credentials, network, portfolio limits, alerts and backup, shared by every bot. Each bot's own strategy settings live inside it.
Alerts & notifications
Backup & recovery
One archive covering every bot on this account, each bot’s database plus the shared registry and configuration. Keep it somewhere safe before you rebuild or destroy this server.
The standard backup holds every trade, setting and registry row, and no credentials. Restoring it means re-entering your HyperLiquid key; that is deliberate, because this file gets copied around.
Whole-server recovery (includes your wallet key)
This version also archives .env, which holds your
HyperLiquid wallet key. Anyone with the file can trade your
account. Do not email it and do not attach it to a support ticket.
Questions & answers
How this works, what to do when something looks wrong, and where your funds and keys actually live. Applies to every bot on the account.
Getting started
How do I install the trading bot?
Two ways, depending on where you want it to run.
On a server (recommended). On a fresh Ubuntu 22 or 24 box, run install.sh from the release you downloaded. It creates the Python environment, installs the dashboard, sets up HTTPS through Caddy, registers the bot and dashboard as services so they restart on reboot, and opens the firewall. When it finishes, open the address it prints and the setup wizard walks you through your wallet and first bot.
On your own computer. Install the Python dependencies, then start the dashboard with npm start from the dashboard folder and open http://127.0.0.1:3847. The setup wizard runs the same way. Note the bot only trades while your computer is awake and online, which is why a server is the better home for it.
Either way, start on testnet, and use an agent wallet rather than your master key. A video walkthrough is coming.
What wallets can I use with this bot?
You trade with your own HyperLiquid account and a key you generate there. For safety the bot requires a HyperLiquid agent / API wallet on mainnet (a trade-only key that cannot withdraw funds) and refuses to start with your master account key unless you explicitly override it. See the agent-wallet question below.
Can I use this bot on any other brokers or exchanges?
No. Currently HyperLiquid is the only exchange, due to its low commissions and high liquidity.
Can I run this bot on my computer, or do I need a server?
You can run it on your own computer, but a server (VPS) is strongly recommended. The bot only trades while its process is running, so a machine that sleeps, loses its network, or shuts down means missed signals and any open position left unmanaged. A VPS gives continuous uptime and a stable, low-latency connection to HyperLiquid.
Should I start on testnet or mainnet?
Always start on testnet. Testnet places real orders against fake USDC so you can confirm setup, bars, Renko bricks, and logs look healthy before risking real money. Switch to mainnet in Settings only after you are comfortable, and use an agent wallet.
What it trades, and how
What does this bot trade?
SOL perpetual futures on HyperLiquid only. It does not trade spot SOL, other coins, or other exchanges.
Does the bot trade 24/7?
Yes. Crypto markets trade around the clock, so the bot processes every closed 1-minute bar with no stock-market session filter. Keep the process running continuously (a VPS is best) if you want full coverage.
How does the bot size positions?
It risks a configurable percentage of your live HyperLiquid equity per trade (see risk settings). Position size is derived from that risk amount and the distance to the stop. Equity is read from your exchange account at runtime, not a fixed number you type in.
Can the bot hold more than one position at a time?
No. It holds a single SOL position (long or short, never both) and waits for the next signal after it is flat.
When do Settings changes take effect?
After you save, restart the bot (Stop → Start, or Restart on the Bot state tab). Strategy and risk changes are applied on the next bot start, not while it is mid-run. Switching testnet/mainnet is the exception: that is an account-level change in Workspace and it restarts the bots itself.
Your money and your keys
Do you hold my funds or keys?
No. The bot is fully non-custodial. It runs on your own computer or server, against your own HyperLiquid account, using a key you provide. Funds never leave your exchange account to us, and we cannot deposit, withdraw, or transfer for you.
What is an agent / API wallet, and should I use one?
Yes, strongly recommended, and required for mainnet. In the HyperLiquid UI go to More → API and create an agent wallet. An agent can place and cancel orders on your account but cannot withdraw or transfer funds. That way, even if your server were compromised, an attacker could trade the account but could not drain it.
What is the daily drawdown circuit breaker?
If equity falls a configurable percent below the day's open (in your chosen timezone), the bot flattens any open position and stops trading until the next calendar day. Set the percent to 0 in Settings to disable it. You can also get an alert when it fires.
Is this bot guaranteed to make money?
No. Trading perpetual futures is high risk and you can lose money, including your entire margin. Past or backtested results do not predict future performance. The software is a tool you run yourself, not financial advice and not a managed account.
How do I back up my bot?
On this page, use Download backup (all bots) under Backup & recovery. One archive covers every bot on the account (each bot's database plus the shared registry) along with your configuration, including your wallet key from .env. Store it securely and never share it. Download a fresh backup before rebuilding or destroying a server.
When something goes wrong
What happens when I turn the bot off while in the middle of a trade?
Your position stays open on HyperLiquid, but the bot stops managing it: no stop-loss, trailing stop, or take-profit runs until you start the bot again. If you want to be flat, close the position yourself on HyperLiquid before or after stopping. On restart, the bot restores the position and resumes managing it.
What happens if my computer or server goes down while in a trade?
The bot stops managing the position until it is running again. The position remains open on HyperLiquid. When the bot restarts, it restores state from its database and reconciles with your on-chain position. Use a reliable VPS and set up alerts so you know quickly if the process crashes.
Do I need to keep the dashboard open for the bot to trade?
No. The dashboard is only for setup, monitoring, and changing settings. Once the bot process is running, it trades on its own. Closing the browser does not stop trading.
How do I set up alerts?
Open the Settings tab and configure Telegram, Discord, and/or email under Alerts & notifications. Use Send test alert to verify. Alerts cover bot start and stop, crashes, positions opened and closed (with realized PnL), the daily-drawdown circuit breaker, and sustained exchange API errors.
Can I run two copies of the bot on the same account or database?
No. Run only one bot process per database and account. Two processes can double-order and corrupt the shared SQLite database. Control the bot from the dashboard (or systemd on a VPS). Do not also start main.py by hand alongside it.