Sistema di inserimento manuale delle operazioni – Guida utente

Panoramica

Il sistema di Inserimento Manuale degli Ordini permette di inserire manualmente opportunità di trading che il bot monitorerà ed eseguirà automaticamente, senza attendere la generazione normale dei segnali. È perfetto quando individuate opportunità durante un'analisi manuale del mercato e non volete che il bot le perda.

Come funziona

🔄 Ricaricamento a caldo automatico

Aggiungete voci al file settings/manual_trade_symbols.yaml mentre il bot è in esecuzione
Le modifiche vengono rilevate automaticamente entro 30 secondi (prossimo ciclo di elaborazione)
Nessun riavvio necessario!

🎯 Flusso di esecuzione degli ordini

Voi aggiungete una voce di trade al file YAML
Il bot rileva la nuova voce al ciclo successivo (≤ 30 secondi)
Il bot valida:
- Il simbolo esiste nella lista di trading del bot
- Non ci sono ordini in corso per quel simbolo
- Condizioni di prezzo soddisfatte (se soglia configurata)
Il bot esegue il trade automaticamente
La voce viene rimossa dal file YAML dopo l'esecuzione riuscita (evita duplicati)

Posizione del file di configurazione

settings/manual_trade_symbols.yaml

Riferimento ai campi

Symbol (Obbligatorio)

Coppia di trading nel formato specifico dell'exchange
Esempi: BTCUSDT, ETHUSDT, 1000PEPEUSDT
Deve corrispondere esattamente a come appare nella lista dei simboli del vostro bot

Price (Obbligatorio)

0 = Il bot recupera e utilizza il prezzo di mercato attuale (consigliato)
> 0 = Usa questo prezzo specifico come riferimento di ingresso
Quando impostato a 0, il bot:
- Recupera il prezzo di mercato attuale
- Aggiorna questo campo nel YAML con il prezzo recuperato
- Usa questo prezzo per i calcoli di soglia nei cicli successivi

Direction (Obbligatorio)

Long = Posizione lunga / acquisto
Short = Posizione corta / vendita

Amount (Obbligatorio)

0 = Usa la dimensionamento posizione predefinito del bot
> 0 = Sovrascrive con un importo specifico (nella valuta di quotazione)
Esempi:
- 1000.0 = Dimensione posizione di 1000 $
- 2500.5 = Dimensione posizione di 2500,50 $

ExecuteThresholdPerfect (Obbligatorio)

0 = Esegue immediatamente (nessun movimento di prezzo richiesto)
> 0 = Attende che il prezzo si muova di questa percentuale prima di eseguire
Per posizioni LONG: Attende che il prezzo SCENDA di questa %
Per posizioni SHORT: Attende che il prezzo SALGA di questa %

Timestamp (Opzionale)

Usare null o omettere completamente il campo
Il bot lo imposta automaticamente durante l'elaborazione della voce
Può essere usato in futuro per validazioni di scadenza

Esempi di utilizzo

Esempio 1: Ingresso immediato (Cogliete un'opportunità ORA)

Trades:
 - Symbol: 'BTCUSDT'
 Price: 0 # Usa il prezzo attuale
 Direction: Long # Vai long
 Amount: 0 # Usa la dimensione predefinita
 ExecuteThresholdPerfect: 0 # Esegui immediatamente
 Timestamp: null

Caso d'uso: Vedete BTC rompere al rialzo e volete entrare ora.

Esempio 2: Compra il calo (Strategia di pullback del 5%)

Trades:
 - Symbol: 'ETHUSDT'
 Price: 0 # Il bot recupererà il prezzo attuale (es. $3000)
 Direction: Long
 Amount: 1000 # Posizione da $1000
 ExecuteThresholdPerfect: 5 # Attende un calo del 5% (esecuzione a ~$2850)
 Timestamp: null

Caso d'uso: ETH sembra forte ma leggermente ipercomprato. Volete comprare se ritraccia del 5%.

Esempio 3: Compra aggressivo il calo (Ritracciamento del 10%)

Trades:
 - Symbol: '1000PEPEUSDT'
 Price: 0
 Direction: Long
 Amount: 2000 # Posizione da $2000
 ExecuteThresholdPerfect: 10 # Attende un calo del 10%
 Timestamp: null

Caso d'uso: PEPE sta pompando forte. Volete accumulare in caso di un ritracciamento significativo.

Esempio 4: Shorta il pump (Attendi rialzo del 3%)

Trades:
 - Symbol: 'SOLUSDT'
 Price: 0 # Il bot recupera il prezzo attuale (es. $100)
 Direction: Short # Posizione short
 Amount: 1500
 ExecuteThresholdPerfect: 3 # Esegue quando il prezzo sale del 3% (a ~$103)
 Timestamp: null

Caso d'uso: SOL sembra ipercomprato. Volete shortare se pompa ancora del 3%.

Esempio 5: Ingressi multipli a livelli diversi

Trades:
  # Ingresso immediato
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 500
 ExecuteThresholdPerfect: 0 # Entra ora
 Timestamp: null
  # Aggiungi altro su calo del 5%
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 1000
 ExecuteThresholdPerfect: 5 # Aggiungi alla posizione su calo del 5%
 Timestamp: null
  # Aggiungi ancora di più su calo del 10%
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 1500
 ExecuteThresholdPerfect: 10 # Accumulazione pesante su calo del 10%
 Timestamp: null

Caso d'uso: Dollar-cost averaging (DCA) su BTC a più livelli di prezzo.

Note importanti

✅ COSA FARE

✅ Mantenere il file YAML valido (indentazione corretta, nessun errore di sintassi)
✅ Usare null per Timestamp (non None)
✅ Usare Long o Short per Direction (non 0 o 1)
✅ Verificare che i nomi dei simboli corrispondano esattamente al formato dell'exchange
✅ Attendere almeno 30 secondi dopo l'aggiunta affinché il bot li rilevi

❌ COSA NON FARE

❌ Non usare None per Timestamp (usare null o ometterlo)
❌ Non usare 0 o 1 per Direction (usare Long o Short)
❌ Non aggiungere voci per simboli non monitorati dal bot
❌ Non modificare il file mentre il bot lo sta salvando (raro rischio di race condition)

🔒 Funzionalità di sicurezza

Nessuna esecuzione duplicata: Le voci vengono rimosse dopo l'esecuzione
Nessun conflitto: Non esegue se il simbolo ha già ordini in corso
Validazione prezzo: Recupera e aggiorna automaticamente i prezzi quando impostato a 0
Tracciamento timestamp: Il bot registra quando ogni voce è stata creata

📊 Monitoraggio

Controllate i log per vedere quando le voci vengono elaborate:

logs/orders.YYYY-MM-DD.log - Tutte le esecuzioni di trade (formato JSON)
logs/trade_summary.YYYY-MM-DD.log - Riassunti di alto livello
logs/debug.YYYY-MM-DD.log - Elaborazione dettagliata (se modalità debug attiva)

Esempio di flusso di lavoro

Passo 1: State analizzando i grafici e vedete ETHUSDT rompere una resistenza

# Aggiungere in manual_trade_symbols.yaml
Trades:
 - Symbol: 'ETHUSDT'
 Price: 0
 Direction: Long
 Amount: 1000
 ExecuteThresholdPerfect: 0
 Timestamp: null

Passo 2: Salvate il file (il bot continua a funzionare)

Passo 3: Entro 30 secondi il bot:

Carica il file
Recupera il prezzo attuale di ETH (es. $3000)
Aggiorna il campo Price a 3000 nel YAML
Imposta Timestamp all'ora corrente
Verifica che non ci siano ordini in corso su ETHUSDT
Esegue il trade
Rimuove la voce dal YAML

Passo 4: Controllate i log per confermare l'esecuzione

✅ Trade eseguito con successo per ETHUSDT
💾 Configurazione trades manuali aggiornata e salvata (trades eseguiti rimossi)

Consigli pro

💡 Per mercati volatili: Usate soglie più alte (10-20%) per catturare ingressi migliori

💡 Per opportunità immediate: Usate ExecuteThresholdPerfect: 0 e Amount: 0 per ingressi rapidi con dimensione standard

💡 Per scaling in: Aggiungete più voci con soglie crescenti per lo stesso simbolo

💡 Per la gestione del rischio: Usate importi specifici invece di 0 per controllare con precisione le dimensioni delle posizioni

💡 Per più simboli: Raggruppate strategie simili nel YAML per una gestione più semplice

Ricordate: Questo sistema è pensato per integrare la vostra analisi manuale, non per sostituirla. Usatelo con giudizio per catturare opportunità che il bot potrebbe perdere durante i suoi normali cicli di generazione segnali! 🚀