Système de saisie manuelle des transactions – Guide de l’utilisateur

Aperçu

Le système d'Entrée Manuelle de Trade vous permet d'injecter manuellement des opportunités de trading que le bot surveillera et exécutera automatiquement, sans attendre la génération normale de signaux. C'est idéal lorsque vous repérez des opportunités lors d'une revue manuelle du marché et que vous ne voulez pas que le bot les rate.

Fonctionnement

🔄 Rechargement à chaud automatique

Ajoutez des entrées dans settings/manual_trade_symbols.yaml pendant que le bot est en cours d'exécution
Les modifications sont détectées automatiquement en moins de 30 secondes (prochain cycle de traitement)
Pas besoin de redémarrer !

🎯 Flux d'exécution des trades

Vous ajoutez une entrée de trade dans le fichier YAML
Le bot détecte la nouvelle entrée au prochain cycle (≤ 30 secondes)
Le bot valide :
- Le symbole existe dans la liste de trading du bot
- Aucun ordre en cours pour ce symbole
- Les conditions de prix sont remplies (si seuil configuré)
Le bot exécute le trade automatiquement
L'entrée est supprimée du fichier YAML après exécution réussie (évite les doublons)

Emplacement du fichier de configuration

settings/manual_trade_symbols.yaml

Référence des champs

Symbol (Requis)

Paire de trading au format spécifique à l'échange
Exemples : BTCUSDT, ETHUSDT, 1000PEPEUSDT
Doit correspondre exactement à ce qui apparaît dans la liste des symboles de votre bot

Price (Requis)

0 = Le bot récupère et utilise le prix actuel du marché (recommandé)
> 0 = Utilise ce prix spécifique comme référence d'entrée
Lorsque défini à 0, le bot va :
- Récupérer le prix actuel du marché
- Mettre à jour ce champ dans le YAML avec le prix récupéré
- Utiliser ce prix pour les calculs de seuil lors des cycles suivants

Direction (Requis)

Long = Position d'achat / longue
Short = Position de vente / courte

Amount (Requis)

0 = Utilise la taille de position par défaut du bot
> 0 = Remplace par un montant spécifique (en devise de cotation)
Exemples :
- 1000.0 = Taille de position de 1000 $
- 2500.5 = Taille de position de 2500,50 $

ExecuteThresholdPerfect (Requis)

0 = Exécute immédiatement (aucun mouvement de prix requis)
> 0 = Attend que le prix bouge de ce pourcentage avant d'exécuter
Pour les positions LONG : Attend que le prix BAISSE de ce %
Pour les positions SHORT : Attend que le prix MONTE de ce %

Timestamp (Optionnel)

Utilisez null ou omettez complètement le champ
Le bot le définit automatiquement lors du traitement de l'entrée
Peut être utilisé ultérieurement pour une validation d'expiration

Exemples d'utilisation

Exemple 1 : Entrée immédiate (Repérez une opportunité MAINTENANT)

Trades:
 - Symbol: 'BTCUSDT'
 Price: 0 # Utilise le prix actuel
 Direction: Long # Position longue
 Amount: 0 # Utilise la taille par défaut
 ExecuteThresholdPerfect: 0 # Exécute immédiatement
 Timestamp: null

Cas d'utilisation : Vous repérez une cassure haussière sur BTC et voulez entrer maintenant.

Exemple 2 : Acheter le dip (Stratégie de repli de 5 %)

Trades:
 - Symbol: 'ETHUSDT'
 Price: 0 # Le bot récupérera le prix actuel (ex. 3000 $)
 Direction: Long
 Amount: 1000 # Position de 1000 $
 ExecuteThresholdPerfect: 5 # Attend une baisse de 5 % (exécution vers ~2850 $)
 Timestamp: null

Cas d'utilisation : ETH semble fort mais légèrement suracheté. Vous voulez acheter s'il replie de 5 %.

Exemple 3 : Achat agressif du dip (Retracement de 10 %)

Trades:
 - Symbol: '1000PEPEUSDT'
 Price: 0
 Direction: Long
 Amount: 2000 # Position de 2000 $
 ExecuteThresholdPerfect: 10 # Attend une baisse de 10 %
 Timestamp: null

Cas d'utilisation : PEPE monte fort. Vous voulez accumuler s'il y a un repli significatif.

Exemple 4 : Shorter la pompe (Attendre une hausse de 3 %)

Trades:
 - Symbol: 'SOLUSDT'
 Price: 0 # Le bot récupère le prix actuel (ex. 100 $)
 Direction: Short # Position courte
 Amount: 1500
 ExecuteThresholdPerfect: 3 # Exécute si le prix monte de 3 % (vers ~103 $)
 Timestamp: null

Cas d'utilisation : SOL semble suracheté. Vous voulez shorter s'il pompe encore 3 %.

Exemple 5 : Entrées multiples à différents niveaux

Trades:
  # Entrée immédiate
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 500
 ExecuteThresholdPerfect: 0 # Entrer maintenant
 Timestamp: null
  # Ajouter plus sur repli de 5 %
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 1000
 ExecuteThresholdPerfect: 5 # Ajouter à la position sur repli de 5 %
 Timestamp: null
  # Ajouter encore plus sur repli de 10 %
 - Symbol: 'BTCUSDT'
 Price: 0
 Direction: Long
 Amount: 1500
 ExecuteThresholdPerfect: 10 # Accumulation forte sur repli de 10 %
 Timestamp: null

Cas d'utilisation : Moyenne pondérée par le coût (DCA) sur BTC à plusieurs niveaux de prix.

Notes importantes

✅ À FAIRE

✅ Garder le fichier YAML valide (indentation correcte, pas d'erreurs de syntaxe)
✅ Utiliser null pour Timestamp (pas None)
✅ Utiliser Long ou Short pour Direction (pas 0 ou 1)
✅ Vérifier que les noms de symboles correspondent exactement au format de votre échange
✅ Attendre au moins 30 secondes après ajout pour que le bot les détecte

❌ À NE PAS FAIRE

❌ Ne pas utiliser None pour Timestamp (utilisez null ou omettez)
❌ Ne pas utiliser 0 ou 1 pour Direction (utilisez Long ou Short)
❌ Ne pas ajouter d'entrées pour des symboles non surveillés par le bot
❌ Ne pas modifier le fichier pendant que le bot est en train de l'enregistrer (risque rare de condition de course)

🔒 Fonctionnalités de sécurité

Pas d'exécutions en double : Les entrées sont supprimées après exécution
Pas de conflits : Ne s'exécute pas si le symbole a déjà des ordres en cours
Validation des prix : Récupère et met à jour automatiquement les prix quand défini à 0
Suivi des timestamps : Le bot enregistre quand chaque entrée a été créée

📊 Surveillance

Consultez les logs pour voir quand les entrées sont traitées :

logs/orders.YYYY-MM-DD.log - Toutes les exécutions de trades (format JSON)
logs/trade_summary.YYYY-MM-DD.log - Résumés de haut niveau
logs/debug.YYYY-MM-DD.log - Traitement détaillé (si mode debug activé)

Exemple de flux de travail

Étape 1 : Vous analysez les graphiques et repérez ETHUSDT en train de casser une résistance

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

Étape 2 : Enregistrez le fichier (le bot continue de tourner)

Étape 3 : En moins de 30 secondes, le bot va :

Charger le fichier
Récupérer le prix actuel d'ETH (ex. 3000 $)
Mettre à jour le champ Price à 3000 dans le YAML
Définir Timestamp à l'heure actuelle
Vérifier qu'il n'y a pas d'ordres en cours sur ETHUSDT
Exécuter le trade
Supprimer l'entrée du YAML

Étape 4 : Vérifiez les logs pour confirmer l'exécution

✅ Trade exécuté avec succès pour ETHUSDT
💾 Configuration des trades manuels mise à jour et enregistrée (trades exécutés supprimés)

Astuces de pro

💡 Pour les marchés volatils : Utilisez des seuils plus élevés (10-20 %) pour capturer de meilleures entrées

💡 Pour les opportunités immédiates : Utilisez ExecuteThresholdPerfect: 0 et Amount: 0 pour des entrées rapides avec taille standard

💡 Pour scaler en position : Ajoutez plusieurs entrées avec des seuils croissants pour le même symbole

💡 Pour la gestion du risque : Utilisez des montants spécifiques au lieu de 0 pour contrôler précisément les tailles de position

💡 Pour plusieurs symboles : Regroupez les stratégies similaires dans le YAML pour une gestion plus facile

Souvenez-vous : Ce système est conçu pour compléter votre analyse manuelle, pas pour la remplacer. Utilisez-le judicieusement pour capturer les opportunités que le bot pourrait manquer pendant ses cycles normaux de génération de signaux ! 🚀