Guide
Documentazione utente di Botely. Onboarding, basi del wallet, strategie, sicurezza, troubleshooting — tutto ciò che ti serve per operare il bot con sicurezza.
Setup Botely
Creazione account, wizard trading-key, controlli bot.
- Inizia con BotelySign-up, login, cosa mostra ogni pagina della dashboard, e tour di 30 secondi su /app.
- Approva un agent wallet Botely su HyperliquidLa funzione autotrade Botely funziona approvando un **agent wallet** dedicato (un keypair separato che Botely genera) sul tuo account Hyperliquid. Il tuo wallet principale resta in tua custody.
- Modello di sicurezza dell'agent walletCome è bounded l'agent wallet Botely, dove vive la sua chiave privata, cosa potrebbe e non potrebbe fare un attaccante che la compromettesse, e come funziona la revoca.
- Revoca un agent wallet BotelyTre modi indipendenti per disabilitare l'agent: toggle per-strategia in-app, master switch in-app, o revoca lato wallet su Hyperliquid (lo stop più hard).
- Toggle master + per-strategyIl toggle bot in /app/settings ha uno switch master aggregato e due switch per-strategy (v6.4 + v7). Il master è derivato dai figli — spegnerlo spegne entrambi.
- Da dove tradeа il botIl bot tradeа sul TUO account principale Hyperliquid, firmando con una agent wallet registrata sul TUO wallet. Botely non detiene mai i tuoi fondi — restano nel tuo account tutto il tempo.
Onboarding wallet
MetaMask, setup Hyperliquid, funding, hardware wallet.
- Installa MetaMaskMetaMask è il wallet EVM che il wizard di onboarding Botely si aspetta. Installalo una volta, poi lo usi per firmare azioni su Hyperliquid — inclusa l'approvazione del tuo agent wallet Botely.
- Importa o crea un wallet in MetaMaskImporta una recovery phrase 12/24 parole esistente, oppure genera un wallet nuovo dentro MetaMask. Entrambi producono un address EVM 0x... che Botely può usare su Hyperliquid.
- Deposita USDC sul tuo account HyperliquidHyperliquid traduce i perpetual contro USDC. Per finanziare il tuo account bridgi USDC da Arbitrum (o un'altra chain supportata) verso la clearinghouse Hyperliquid.
- Preleva fondi legacy da dYdX v4Botely è migrato da dYdX v4 a Hyperliquid a maggio 2026. Se hai ancora USDC parcheggiato su dYdX (un saldo residuo dall'epoca del bot legacy), ecco come spostarlo.
- Usa un hardware wallet (Ledger / Trezor) con BotelyConnetti un Ledger o Trezor tramite MetaMask per tenere la chiave del tuo account principale in un dispositivo di firma. Le firme richieste dal wizard Botely sono mediate da MetaMask — il device conferma l'azione fisicamente.
- Wallet EVM alternativi che funzionano con BotelyMetaMask è il default nel wizard di onboarding Botely, ma qualsiasi wallet che firma l'azione EIP-712 `approveAgent` di Hyperliquid va bene. Alternative comuni di seguito.
Strategie
Cosa scambia il bot e perché. Leggere i grafici.
- Cos'è la strategia v6.4?v6.4 è la baseline conservativa: long-only momentum su ETH/SOL/BNB con entries regime-aware, feature rolling 30 minuti, e TP/SL/max-hold per-coin.
- Cos'è la strategia v7?v7 è la variante aggressiva: aggiunge signal short su SOL+BNB, parametri Optuna-optimized, e exit più stretti. Più trade count e score backtest più alto, ma più rischio drawdown.
- Come funzionano TP / SL / max-holdTre gate di exit sparano nell'ordine in cui scattano: take-profit, stop-loss, o un time limit duro. Primer concettuale — niente formule.
- Leggere il chart cumulativo P&LIl chart in /app plotta la somma cumulativa del P&L netto di ogni trade chiuso in USD. Numeri reali del tuo account — non un backtest simulato a $1000.
- Leggere i chart di /backtestLa pagina backtest mostra griglie P&L per-coin per-year, timeline di drawdown, e lo split out-of-sample. Reference veloce su cosa significa ogni pannello.
- Perché i backtest non sono garanzieI backtest walk-forward sono la miglior evidenza che abbiamo, ma i mercati live shiftano in modi che nessun sample storico cattura del tutto. Leggi questo prima di trarre conclusioni dai chart in /backtest.
Piani e prezzi
Free, Standard, Advanced, Custom — cosa ricevi.
- Piano Standard (€39/mese, fino a $5.000 di cap)Signal real-time con consegna webhook HMAC, più autotrade non-custodial opzionale sulla tua Hyperliquid agent wallet fino a un cap di $5.000 di capitale.
- Piano Advanced (€69/mese, fino a $20.000 di cap)Stessa delivery e stesso autotrade non-custodial opzionale di Standard, con cap di capitale più alto ($20.000) per portafogli più grandi. Include export CSV storico e supporto prioritario.
- Signal vs autotrade non-custodialIl prodotto centrale di Botely sono i signal algoritmici verificati (consulenziali). Sui tier pagati puoi inoltre attivare l'autotrade non-custodial opzionale — il bot firma ordini sulla tua Hyperliquid agent wallet per i tre mercati whitelisted (ETH/SOL/BNB). Non è trading-as-a-service; resti tu in custody e tu mantieni il kill-switch.
Consegna segnali
Telegram, email, webhook, export CSV.
- Setup consegna TelegramConnetti il tuo account Telegram per ricevere segnali come messaggi chat. Setup è un comando /start su un bot, link via token monouso da /app/settings.
- Setup consegna EmailRicevi i segnali come email plain-text. Setup automatico — viene usata l'email dell'account, a meno che non ne specifichi un'altra.
- Consegna webhook (piano Pro)Botely fa POST di ogni signal al tuo endpoint con un header firma HMAC-SHA256. Integrazione audit-grade per consumer programmatici.
- Schema payload webhook (v1)Schema JSON versionato, header e snippet di verifica in Node, Python e PHP.
- Webhook — troubleshootingErrori comuni e come Botely fa il retry.
- Export CSV storico (piano Pro)Scarica l'intera cronologia trade chiusi come CSV da /app/trades → Export, o via API programmatica.
Sicurezza
Cosa vediamo e cosa no. Permissioned key in dettaglio.
- Sicurezza Botely in sintesiRiepilogo in linguaggio piano di cosa Botely vede, cosa non vede, e come il modello permissioned-key on-chain limita il blast radius in caso di compromissione.
- Agent wallet deep dive (per engineer)Cosa viene effettivamente firmato, cosa viene conservato, quali sono i failure mode. Per utenti che vogliono verificare le claim di Botely prima di approvare l'agent.
- Runbook compromissione walletSe sospetti che la tua owner mnemonic / recovery phrase sia trapelata, il tempo è critico. Segui questi step per limitare il danno e ruotare.
- Best practice per la mnemonicCome conservare la recovery phrase così che sopravviva al guasto del device ma non finisca sul computer di qualcun altro. Cose pratiche da fare e non fare.
Troubleshooting
Friction comuni e come risolvere.
- Il bot non tradeа — checklistLista top-down di cosa verificare quando il bot è silente per un tempo insolito.
- Ho perso il blocco .env — e ora?Rotazione, non recupero. La private key è stata mostrata UNA volta durante il wizard. Se non l'hai salvata, non puoi recuperarla — ma puoi sostituirla a basso costo.
- Problemi di connessione del walletProblemi comuni nell'handoff wallet EVM → wizard Botely: popup MetaMask bloccato, rete sbagliata, estensioni wallet multiple che si contendono la connessione.
- Più wallet — cosa è possibile oggiBotely Phase 0 è founder-only e gira un bot su un wallet. Phase 1 aggiunge multi-tenant (un utente, un wallet ciascuno). Multi-wallet per utente è Phase 2.
- Cosa succede se Botely è giùIl SaaS Botely e il bot di trading sono due processi separati. SaaS giù ≠ bot giù. Le posizioni aperte restano safe — TP/SL sono on-chain.
Compliance e tasse
Quadro regolamentare in linguaggio piano.
- Quadro regolamentare UE (linguaggio piano)Riepilogo pratico user-facing di come Botely si colloca rispetto a MiCA + MAR. NON è consulenza legale — vedi /compliance per la versione rigorosa.
- Considerazioni fiscali (linee generali)Botely non fa la tua dichiarazione dei redditi — la fai tu. Linee generali su come i profitti da perpetual futures sono tipicamente trattati, e dove stare attento.
- KYC — quando e perchéPhase 0 NON richiede KYC. Phase 2 la richiederà quando Botely apre al pubblico con processing pagamenti. Cosa chiederemmo, e perché.