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.
- Genera una trading key permissionedIl wizard in /app/settings crea un authenticator on-chain fresco che il bot userà per firmare i trade — senza mai toccare la tua mnemonic.
- Cosa la trading key può e non può fareLa trading key permissioned è fortemente ristretta da una whitelist on-chain. Anche se trapelasse, un attaccante potrebbe solo farti tradeare, non rubarti i fondi.
- Revocare una trading key esistenteSe sospetti un leak, hai perso il blocco .env, o vuoi solo ruotarla, la revoca è un processo in due step: marcare la riga DB come inattiva e (opzionalmente) broadcastare MsgRemoveAuthenticator on-chain.
- 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 subaccount 0 dYdX, firmando con una permissioned key registrata sul TUO wallet. Botely non detiene mai i tuoi fondi — restano nel tuo subaccount tutto il tempo.
Onboarding wallet
Keplr, account dYdX, gas, hardware wallet.
- Installa l'estensione KeplrKeplr è il wallet Cosmos più diffuso. Lo installi una volta e lo usi poi per firmare qualsiasi cosa su dYdX — inclusa la registrazione della trading-key Botely.
- Importa o crea un wallet in KeplrImporta una recovery phrase 12/24 parole esistente oppure genera un wallet nuovo dentro Keplr. Entrambi producono un indirizzo dydx1… che Botely può usare.
- Abilita la chain dYdX in KeplrKeplr supporta centinaia di chain Cosmos ma ti fa scegliere quali abilitare. dYdX (chain id dydx-mainnet-1) deve essere spuntato prima che il wizard possa parlare con il wallet.
- Bank vs Subaccount: dove stanno davvero i tuoi soldiIl tuo indirizzo dydx1… ha DUE bilanci separati sotto — il bank (per fees e trasferimenti) e il subaccount (per trading). Keplr mostra solo il bank. È la confusione #1 per i nuovi utenti.
- Gas: DYDX o USDC, scegli tuOgni transazione Cosmos paga gas. dYdX v4 accetta gas IN ENTRAMBI i denoms: DYDX nativo (adydx) o USDC (IBC). Se hai già un piccolo balance USDC nel bank, puoi saltare del tutto l'acquisto di DYDX nativo.
- Deposita USDC nel Subaccount 0 per fare tradingI fondi nel bank non possono essere tradeati. Per far lavorare il bot, gli USDC devono spostarsi da bank a subaccount 0 via MsgDepositToSubaccount. dydx.trade lo fa con un click.
- Ritirare fondi da dYdXTre strade di uscita: subaccount → bank, bank → altra chain Cosmos via IBC, oppure direttamente a CEX Ethereum/Solana via Squid/Skip.
- Usare un hardware wallet Ledger via KeplrPer balance grandi, puoi tenere la recovery phrase completamente fuori dal computer firmando le transazioni su un Ledger. Keplr diventa solo l'interfaccia; il Ledger è il firmatario reale.
- Wallet alternativi (Leap, Cosmostation, dYdX Connect)Keplr è il default. Se usi già Leap, Cosmostation o dYdX Connect, ecco come ciascuno si colloca e dove il wizard Botely si trova oggi.
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 subaccount — 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
Paper, Signal Lite, Signal Pro — cosa ricevi.
- Piano Paper (gratis, solo trade chiusi)Il tier Paper mostra solo la cronologia dei trade chiusi — utile per valutare la qualità del signal senza pagare. Niente signal real-time.
- Signal Lite (€19/mese, +30 min delay)Signal real-time con 30 minuti di delay di consegna. Utile per chi non fa arbitraggio e vuole esposizione alla strategia senza pagare full price.
- Signal Pro (€49/mese, real-time + webhook)Stream signal full real-time con consegna webhook HMAC-signed per consumo programmatico. Include export CSV storico e supporto prioritario.
- Segnali vs gestire il bot in proprioBotely vende SEGNALI (consulenziali). Non vende trading-as-a-service. Tu decidi cosa fare con ogni signal; in Phase 1 potrai anche far auto-eseguire Botely sul tuo wallet dYdX.
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.
- 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.
- Composer permissioned-key in dettaglioDettaglio tecnico del composer AllOf/AnyOf/MessageFilter/ClobPairIdFilter/SubaccountFilter usato per registrare le trading key Botely on-chain.
- 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.
- Senza gas — strade di top-up DYDXView troubleshooting dello stesso contenuto di funding-dydx-gas. Usa la strada più veloce in base a cosa hai già.
- Keplr mostra quasi nulla ma Botely mostra il mio balance realeView troubleshooting di accounts-bank-vs-subaccount. Reference veloce per il momento 'dove sono i miei fondi?' più comune.
- 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.
- Keplr non si connette al wizardLa maggior parte dei problemi di connessione Keplr si riducono a permessi estensione, versione vecchia, o chain dYdX non abilitata. Triage veloce.
- 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é.