Guides

Sign up, log in, what each page in the dashboard shows you, and a 30-second tour of /app.

The wizard in /app/settings creates a fresh on-chain authenticator for the bot to sign trades — without ever touching your mnemonic.

The permissioned trading key is heavily restricted by an on-chain whitelist. Even if it leaks, an attacker can only make you trade, not steal your funds.

If you suspect the key leaked, lost the .env block, or just want to rotate it, revocation is a two-step process: mark the DB row inactive and (optionally) broadcast on-chain MsgRemoveAuthenticator.

The 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.

The bot trades on YOUR dYdX subaccount 0, signed by a permissioned key registered against YOUR wallet. Botely never holds your funds — they stay in your subaccount the whole time.

Keplr is the most popular Cosmos wallet. You install it once, then use it to sign anything on dYdX — including registering your Botely trading key.

Either import an existing 12/24-word recovery phrase, or generate a new wallet inside Keplr. Both produce a dydx1… address that Botely can target.

Keplr supports hundreds of Cosmos chains but lets you pick which ones to enable. dYdX (chain id dydx-mainnet-1) must be checked before the wizard can talk to your wallet.

Your dydx1… address has TWO separate balances under it — the bank (for fees and transfers) and the subaccount (for trading). Keplr only shows the bank. This is the #1 source of confusion for new users.

Every Cosmos transaction needs a gas fee paid in the chain's native token. On dYdX, that's adydx (native DYDX). You need ~$0.50 worth in the bank before you can register a trading key.

Funds in the bank can't be traded. To put the bot to work, your USDC has to move from bank to subaccount 0 via MsgDepositToSubaccount. dydx.trade does this for you with one click.

Three ways out: subaccount → bank, bank → another Cosmos chain via IBC, or all the way back to an Ethereum/Solana CEX via Squid/Skip.

For larger balances, you can keep the recovery phrase off your computer entirely by signing transactions on a Ledger hardware wallet. Keplr becomes the UI; the Ledger is the actual signer.

Keplr is the default. If you already use Leap, Cosmostation, or dYdX Connect, here's how each fits and where the Botely wizard sits today.

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.

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.

Three exit gates fire whichever comes first: take-profit, stop-loss, or a hard time limit. Conceptual primer — no formulas.

The /app chart plots the running sum of every closed trade's net P&L in USD. Real numbers from your subaccount — not a simulated $1000 backtest.

The 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.

Walk-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.

The Paper tier shows you only closed-trade history — useful for evaluating the signal quality without paying. No real-time signals.

Real-time signals with a 30-minute delivery delay. Useful for non-arbitrage style users who want exposure to the strategy without paying full price.

Full real-time signal stream with HMAC-signed webhook delivery for programmatic consumption. Includes CSV history download and priority support.

Botely sells SIGNALS (advisory). It does not sell trading-as-a-service. You decide what to do with each signal; in Phase 1, you can also have Botely auto-execute on your own dYdX wallet.

Connect 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.

Receive signals as plain-text emails. Setup is automatic — your account email is used unless you override.

Botely POSTs each signal to your endpoint with an HMAC-SHA256 signature header. Audit-grade integration for programmatic consumers.

Download your full closed-trade history as a CSV from /app/trades → Export, or programmatically via the API.

Plain-language summary of what Botely sees, never sees, and how the on-chain permissioned-key model bounds the blast radius if anything is compromised.

Technical detail of the AllOf/AnyOf/MessageFilter/ClobPairIdFilter/SubaccountFilter composer used to register Botely trading keys on-chain.

If you suspect your owner mnemonic / recovery phrase has leaked, time is critical. Follow these steps to limit damage and rotate.

How 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.

Top-down list of what to verify when the bot has been silent for an unusual stretch.

Troubleshooting view of the same content as funding-dydx-gas. Use whichever path is fastest given what you already have on hand.

Troubleshooting view of accounts-bank-vs-subaccount. Quick reference for the most common 'where are my funds?' moment.

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.

Most Keplr connection problems boil down to extension permissions, an outdated version, or the dYdX chain not enabled. Quick triage list.

Botely 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.

Botely's SaaS and the trading bot are separate processes. SaaS down ≠ bot down. Open positions stay safe — TP/SL are on-chain.

Practical user-facing summary of how Botely sits relative to MiCA + MAR. NOT legal advice — see /compliance for the rigorous version.

Botely doesn't file your taxes — you do. General pointers on how perpetual futures profits are typically treated, and where to be careful.

Phase 0 does NOT require KYC. Phase 2 will when Botely opens to public users with payment processing. What we'd ask for, and why.