Guides
User-facing documentation for Botely. Onboarding, wallet basics, strategies, security, troubleshooting โ everything you need to operate the bot with confidence.
Botely setup
Account creation, the trading-key wizard, bot controls.
- Getting started with BotelySign up, log in, what each page in the dashboard shows you, and a 30-second tour of /app.
- Approve a Botely agent wallet on HyperliquidThe Botely autotrade feature works by approving a dedicated **agent wallet** (a separate keypair Botely generates) on your Hyperliquid account. Your main wallet stays in your custody.
- Agent-wallet security modelHow the Botely agent wallet is bounded, where its private key lives, what an attacker who compromised it could and could not do, and how revocation works.
- Revoke a Botely agent walletThree independent ways to disable the agent: in-app per-strategy toggle, in-app master switch, or wallet-side revocation on Hyperliquid (the hardest stop).
- Master + per-strategy bot togglesThe bot toggle in /app/settings has one aggregate master switch and two per-strategy switches (v6.4 + v7). The master is derived from the children โ turning it off turns both children off.
- Where the bot actually trades fromThe bot trades on YOUR main Hyperliquid account, signed by a agent wallet registered against YOUR wallet. Botely never holds your funds โ they stay in your account the whole time.
Wallet onboarding
MetaMask, Hyperliquid setup, funding, hardware wallets.
- Install MetaMaskMetaMask is the EVM wallet Botely's onboarding wizard expects. Install the extension once, then use it to sign actions on Hyperliquid โ including approving your Botely agent wallet.
- Import or create a wallet in MetaMaskEither import an existing 12/24-word recovery phrase, or generate a fresh wallet inside MetaMask. Both produce a 0x... EVM address Botely can target on Hyperliquid.
- Deposit USDC to your Hyperliquid accountHyperliquid trades perpetuals against USDC. To fund your account you bridge USDC from Arbitrum (or another supported chain) into Hyperliquid's clearinghouse.
- Withdraw legacy funds from dYdX v4Botely migrated from dYdX v4 to Hyperliquid in May 2026. If you have USDC still parked on dYdX (a leftover trading balance from the legacy bot era), here's how to move it.
- Use a hardware wallet (Ledger / Trezor) with BotelyConnect a Ledger or Trezor through MetaMask to keep your main account key in a signing device. Signatures Botely's wizard requests are mediated by MetaMask โ the device confirms the action physically.
- Alternative EVM wallets that work with BotelyMetaMask is the default in Botely's onboarding wizard, but any wallet that signs Hyperliquid's EIP-712 `approveAgent` action works. Common alternatives below.
Strategies
What the bot trades and why. Reading the charts.
- What is the v6.4 strategy?v6.4 is the conservative baseline: long-only momentum on ETH/SOL/BNB with regime-aware entries, rolling 30-minute features, and per-coin TP/SL/max-hold.
- What is the v7 strategy?v7 is the aggressive variant: adds short signals on SOL+BNB, Optuna-optimized parameters, and tighter exits. Higher trade count and higher backtest score, but more drawdown risk.
- How TP / SL / max-hold workThree exit gates fire whichever comes first: take-profit, stop-loss, or a hard time limit. Conceptual primer โ no formulas.
- Reading the cumulative P&L chartThe /app chart plots the running sum of every closed trade's net P&L in USD. Real numbers from your account โ not a simulated $1000 backtest.
- Reading the /backtest chartsThe backtest page shows per-coin per-year P&L grids, drawdown timelines, and the out-of-sample split. Quick reference for what each panel means.
- Why backtests aren't guaranteesWalk-forward backtests are the best evidence we have, but live markets shift in ways no historical sample fully captures. Read this before drawing conclusions from any chart on the /backtest page.
Plans & pricing
Free, Standard, Advanced, Custom โ what you get.
- Standard plan (โฌ39/month, up to $5,000 cap)Real-time signals with HMAC-signed webhook delivery, plus optional non-custodial autotrade on your Hyperliquid agent wallet up to a $5,000 capital cap.
- Advanced plan (โฌ69/month, up to $20,000 cap)Same delivery and optional non-custodial autotrade as Standard, with a higher $20,000 capital cap for larger portfolios. Includes CSV history download and priority support.
- Signals vs non-custodial autotradeBotely's core product is verified algorithmic signals (advisory). On paid tiers you can additionally enable optional non-custodial autotrade โ the bot signs orders on your Hyperliquid agent wallet for the three whitelisted markets (ETH/SOL/BNB). It's not trading-as-a-service; you stay in custody and you keep the kill-switch.
Delivery
Telegram, email, webhook, CSV export.
- Telegram delivery setupConnect your Telegram account to receive signals as chat messages. Setup is a /start command on a bot, link via a one-time token in /app/settings.
- Email delivery setupReceive signals as plain-text emails. Setup is automatic โ your account email is used unless you override.
- Webhook delivery (Pro plan)Botely POSTs each signal to your endpoint with an HMAC-SHA256 signature header. Audit-grade integration for programmatic consumers.
- Webhook payload schema (v1)Versioned JSON schema, header layout, and verification snippets in Node, Python, and PHP.
- Webhook troubleshootingCommon failure modes and how Botely retries.
- CSV history export (Pro plan)Download your full closed-trade history as a CSV from /app/trades โ Export, or programmatically via the API.
Security & trust
What we see and don't. Permissioned keys deep dive.
- Botely security overviewPlain-language summary of what Botely sees, never sees, and how the on-chain permissioned-key model bounds the blast radius if anything is compromised.
- Agent wallet deep dive (for engineers)What's actually signed, what's stored, what the failure modes are. For users who want to verify Botely's claims before approving the agent.
- Wallet compromise runbookIf you suspect your owner mnemonic / recovery phrase has leaked, time is critical. Follow these steps to limit damage and rotate.
- Mnemonic & wallet best practicesHow to store your recovery phrase so it survives device failure but doesn't end up on someone else's computer. Practical do's and don't's.
Troubleshooting
Common friction points and how to resolve them.
- Bot isn't trading โ checklistTop-down list of what to verify when the bot has been silent for an unusual stretch.
- I lost the .env block โ what now?Rotation, not recovery. The trading-key private key was shown to you ONCE during the wizard. If you didn't save it, you can't recover it โ but you can cheaply replace it.
- Wallet connection issuesCommon problems with the EVM-wallet โ Botely-wizard handoff: MetaMask popup blocked, wrong network, multiple wallet extensions fighting over the connection.
- Multiple wallets โ what's possible todayBotely Phase 0 is founder-only and runs one bot on one wallet. Phase 1 adds multi-tenant (one user, one wallet each). Multi-wallet per user is Phase 2.
- What happens if Botely is downBotely's SaaS and the trading bot are separate processes. SaaS down โ bot down. Open positions stay safe โ TP/SL are on-chain.
Compliance & taxes
Plain-language regulatory overview.
- EU regulatory overview (plain language)Practical user-facing summary of how Botely sits relative to MiCA + MAR. NOT legal advice โ see /compliance for the rigorous version.
- Tax considerations (general pointers)Botely doesn't file your taxes โ you do. General pointers on how perpetual futures profits are typically treated, and where to be careful.
- KYC โ when and whyPhase 0 does NOT require KYC. Phase 2 will when Botely opens to public users with payment processing. What we'd ask for, and why.