Configura il bot di trading unCoded sul tuo server
Esegui il bot sul tuo server e collegalo al tuo exchange, senza scrivere una sola riga di codice.
Il tuo server
In Germania
API dell'exchange protetta
Sub-account + whitelist IP
Trading automatico
Dashboard + Telegram opzionale
Glossario rapido
Prima di iniziare - preparazione obbligatoria
Senza questi tre punti la configurazione non funzionerà. Saltali se usi già attivamente il tuo exchange.
Prep A - Completa il KYC dell'exchange
Obiettivo: Un account exchange completamente verificato (necessario per API e sub-account).
Le API di trading e i sub-account sono disponibili solo per gli utenti exchange completamente verificati.
Prep B - Attiva la 2FA
Obiettivo: Autenticazione a due fattori attiva sul tuo account exchange.
Il tuo exchange richiede la 2FA prima di poter creare qualsiasi chiave API.
Se perdi il telefono senza chiave di backup, perdi l'accesso al tuo account. Una chiave hardware YubiKey offre una protezione ancora più forte.
Prep C - Deposita USDC o FDUSD
Obiettivo: Valuta quote pronta per il trasferimento nel tuo sub-account.
Il bot fa trading contro una valuta quote che deve trovarsi nel sub-account prima dell'avvio.
Configurazione passo passo
Quattordici passaggi dall'acquisto del server a un bot pienamente operativo.
Acquista un server su Zeabur
Obiettivo: Un server attivo in Germania con un proprio indirizzo IPv4.
- ›Apri la dashboard di Zeabur e accedi con Google.
- ›Clicca 'Buy More Servers'.
- ›Seleziona Hetzner in Germania (circa 16 USD / mese).
- ›Specifiche: 4 vCPU, località Germania, IP dedicato.
Rete di sicurezza: entro 7 giorni puoi ottenere il rimborso del server. Puoi anche disattivare l'Auto-Renew se vuoi testare solo per un mese. L'avvio richiede circa 3-4 minuti.
Risultato: Il server è in funzione e l'indirizzo IPv4 è annotato.
Apri il template unCoded
Obiettivo: Il modulo Zeabur aperto e pronto da compilare.
- ›In Zeabur vai su 'Projects' -> 'Generate Project'.
- ›Sotto 'Deploy New Service' cerca 'uncoded'.
- ›Seleziona il server appena acquistato.
Non compilare ancora nulla: raccoglieremo i valori necessari nei prossimi passaggi.
Crea un sub-account sull'exchange
Obiettivo: Un secondo account exchange nettamente separato dal tuo account principale.
- ›Clicca sulla tua immagine del profilo nel tuo exchange (in alto a destra).
- ›Clicca su 'Sub Accounts' (o equivalente) nel menu.
- ›'Create Sub Account' -> 'Create with Mail'.
- ›Inserisci un secondo indirizzo email e una password.
- ›Attiva 'Switchable' per passare da account principale a sub-account con un clic.
Crea una chiave API sul tuo exchange
Obiettivo: API Key e Secret Key inserite nel template Zeabur.
Non attivare mai i permessi di prelievo sull'API. Un trading bot ha bisogno solo dei diritti di lettura + trading. La whitelist IP e il permesso di trading vengono impostati di proposito più avanti, nel Passo 9.
- ›Passa al sub-account (selettore in alto a sinistra).
- ›Profilo -> 'API Management'.
- ›'Create API' -> 'System Generated'.
- ›Assegna un nome come 'uncoded Bot' -> Avanti.
- ›Conferma con 2FA / YubiKey.
- ›Copia API Key e Secret Key nei campi Zeabur 'Exchange API Key' / 'Exchange Secret Key'.
Copia subito la Secret Key: dopo la chiusura della pagina non viene mai più mostrata. Non condividerla con nessuno.
Risultato: API Key e Secret Key sono inserite nel template Zeabur.
Imposta le password della dashboard
Obiettivo: Due password di accesso per la tua futura dashboard.
Il template Zeabur ha due campi password:
Usa password robuste con caratteri speciali. Niente 'Test1' o simili.
- ›Dashboard Admin Password, accesso completo incluse tutte le impostazioni.
- ›Dashboard View Password, sola lettura, ad es. per qualcuno a cui vuoi mostrare il bot.
(Opzionale) Crea un bot Telegram
Obiettivo: Un token bot per le notifiche Telegram.
Se non vuoi le notifiche Telegram, inserisci semplicemente 00 in entrambi i campi Telegram e passa al Passo 8. Con Telegram ricevi un messaggio per ogni trade con profitto, profitto totale e volume.
- ›In Telegram cerca @BotFather.
- ›'Start' -> invia il comando /newbot.
- ›Assegna un nome visualizzato (ad es. 'Uncoded Trading Bot').
- ›Assegna uno username interno (deve terminare con 'bot' ed essere unico a livello globale).
- ›BotFather restituisce un token come 123456789:ABCdefGhi... incollalo nel campo Zeabur 'Telegram Bot Token'.
(Opzionale) Ottieni l'ID del gruppo Telegram
Obiettivo: L'ID del gruppo, incluso il segno meno, inserito nel template Zeabur.
Il segno meno '-' va copiato insieme al numero. Senza, la connessione fallirà.
- ›In Telegram crea un nuovo gruppo (ad es. 'Uncoded Trading').
- ›Aggiungi al gruppo il bot uncoded appena creato.
- ›Aggiungi al gruppo anche il bot di supporto @myidbot.
- ›Promuovi entrambi i bot ad admin (clic destro / pressione prolungata sul bot -> 'Promote to Admin' -> Salva).
- ›Nel gruppo invia /getgroupid a @myidbot.
- ›Riceverai un ID di gruppo con il segno meno, ad es. -1001234567890.
Imposta i domini e avvia il deployment
Obiettivo: Due URL dashboard propri e un deployment in esecuzione.
Nel template sono richiesti due nomi di dominio:
- ›Dominio dashboard (ad es. uncoded-tuonome-1), la dashboard web per la configurazione.
- ›Dominio signal (ad es. uncoded-tuonome-2), endpoint per i segnali TradingView.
- ›Regole: solo minuscole, i due nomi devono essere diversi.
- ›Opzionale: imposta già ora una password TradingView se in seguito userai i segnali TradingView (modificabile in qualsiasi momento).
- ›Seleziona il server corretto in basso e clicca 'Confirm'.
Inserisci l'IP del server nella whitelist dell'exchange (critico!)
Obiettivo: Una chiave API abilitata al trading, utilizzabile solo dal tuo server.
Finché la whitelist IP non è impostata, 'Enable Spot & Margin Trading' sul tuo exchange non è nemmeno selezionabile. È una funzione di sicurezza, non un errore.
- ›In Zeabur -> 'Servers' -> clicca sul tuo server -> copia l'indirizzo IPv4.
- ›Torna sul tuo exchange -> 'API Management' -> clicca 'Edit restrictions' sulla tua chiave API uncoded.
- ›Attiva 'Restrict access to trusted IPs only'.
- ›Inserisci l'IP del server -> Conferma.
- ›Ora puoi spuntare 'Enable Spot & Margin Trading' -> attivalo.
- ›Conferma con 2FA e 'Save'. NON attivare i prelievi via API, solo il trading.
Perché è così sicuro: anche se qualcuno avesse la tua API Key e la Secret Key, non potrebbe fare nulla, solo questo unico IP del server è autorizzato a fare trading.
Accedi alla dashboard
Obiettivo: Accesso alla dashboard unCoded tramite il tuo dominio.
Quando il dominio della dashboard è verde in Zeabur ('Online' / 'Running'), aprilo nel browser e accedi con la password admin del Passo 5.
Scegli modalità di trading e strategia
Obiettivo: Un bot completamente configurato con modalità, valuta quote, coppie e profilo di rischio.
Nella dashboard seleziona nell'ordine:
- ›Tipo di bot: Multi-Token Bot (standard per la maggior parte degli utenti). L'High-Frequency Bot è market making su singolo token, di solito NON è quello che ti serve.
- ›Valuta quote: USDC nell'UE; FDUSD possibile fuori dall'UE (commissioni di trading ridotte / zero).
- ›Coppie di trading: BTC ed ETH sono un buon punto di partenza, alta liquidità, slippage più basso.
- ›Profilo di rischio: Low = conservativo (consigliato per chi inizia). Medium / High = più aggressivo (più split, posizioni più grandi, meno riserva).
- ›-> Conferma -> Avvia.
Collega il tuo account Google
Obiettivo: La tua licenza è associata alla tua identità Google.
- ›Nella dashboard clicca 'Open'.
- ›Accedi con il tuo account Google.
- ›Accetta i Termini di servizio.
- ›Clicca 'Start'.
Prezzi: il bot costa dal 20 al 30% del profitto realizzato. Nessun profitto = nessun costo. I nuovi utenti ricevono attualmente un credito licenza di 25 USD.
Attiva la tua licenza
Obiettivo: Bot associato in modo univoco al tuo account.
Solo l'API Key pubblica, mai la Secret Key.
- ›Nella dashboard clicca 'Top-up License': verrai reindirizzato al tuo account unCoded.
- ›Scorri fino a 'Your IDs'.
- ›Inserisci qui la Exchange API Key pubblica.
Verifica che tutto funzioni
Obiettivo: La certezza che il bot giri correttamente.
- ›Apri il servizio trading bot nel tuo progetto Zeabur -> clicca 'Logs'.
- ›Non devono comparire errori rossi.
- ›I trade sono molto rapidi (circa 40-50 ms ciascuno). Se serve, metti in pausa la vista dei log.
Risultato: Il bot gira in autonomia sul tuo server.
Come riconoscere che tutto funziona
Ecco come capire, nelle prime 1-24 ore, che tutto sta funzionando.
Subito (entro 5 minuti)
- La dashboard mostra 'Bot Status: Running' (verde).
- I log mostrano voci regolari come 'Checking conditions for BTCUSDC...' senza errori rossi.
Entro la prima ora
- Quando le condizioni di mercato corrispondono: nei log compaiono i primi ordini di acquisto.
- Se Telegram è attivo: prima notifica (ad es. 'BUY BTCUSDC at 65,420, Split 1/2').
Entro 24 ore
- Primi trade completati (acquisto + vendita) con indicazione del profitto.
- Le statistiche della dashboard iniziano a riempirsi.
Se dopo 24 ore non è avvenuto nessun trade: non è necessariamente un errore. Con volatilità bassa o impostazioni conservative possono servire da 1 a 3 giorni prima che le prime condizioni di ingresso si verifichino.
Risoluzione dei problemi
Checklist di sicurezza
Ottimizzare le strategie e aspettative realistiche
Personalizza in seguito
- • Cambia modalità (ad es. modalità Basic per i mercati rialzisti).
- • Regola gli split (ad es. 50/50).
- • Cambia strategia per mercati rialzisti / ribassisti.
- • Esplora le strategie pubbliche e la classifica sotto "Backtesting".
Aspettative realistiche
- • Riferimento: circa 17.000 trade / mese, circa 1.200 USD di profitto nel periodo di esempio.
- • Risultati giornalieri tipicamente tra 12 e 27 USD con picchi verso l'alto.
- • Orientamento di massima: 30-40% su base annua nel periodo di esempio. Le performance passate non garantiscono risultati futuri.
- • Il profitto cresce a gradini (le posizioni devono chiudersi), non in modo lineare.
I mercati laterali e ribassisti sono le fasi in cui il bot può battere nettamente l'hodling. Nei bull run estremi l'hodling può occasionalmente vincere, ed è per questo che stop-loss e indicatori di emergenza sono importanti.
Rischi e disclaimer
- Utilizzo:a tuo rischio e pericolo.
- Rendimenti:nessuna garanzia di profitti futuri. I risultati passati non sono una previsione.
- Tasse:questa non è una consulenza fiscale. I profitti di trading possono essere tassabili a seconda del tuo paese.
- Perdite:il trading di criptovalute può portare a perdite fino alla perdita totale del capitale.
- Responsabilità:sei responsabile della tua configurazione, delle chiavi API e del server.
Riferimento rapido
Per configurazioni successive.
- 1Acquista un server Hetzner su Zeabur (4 vCPU, Germania)
- 2Apri il template unCoded
- 3Crea il sub-account sull'exchange + trasferisci USDC / FDUSD
- 4Crea API Key + Secret Key (senza diritti di prelievo)
- 5Imposta le password della dashboard
- 6(Opzionale) Crea il bot Telegram via BotFather
- 7(Opzionale) Ottieni l'ID del gruppo Telegram via @myidbot (includi il meno!)
- 8Imposta i domini dashboard + signal, avvia il deployment
- 9Inserisci l'IP del server nella whitelist dell'exchange + attiva il trading
- 10Accedi alla dashboard
- 11Scegli Multi-Token, valuta quote, coppie e rischio
- 12Collega l'account Google
- 13Attiva la licenza (API Key pubblica)
- 14Verifica i log
Ti serve la documentazione completa?
La documentazione completa è disponibile su /docs.