Référence de Configuration

Explication Complète des Champs de Configuration

Le Bot de Trading ByNinja utilise plusieurs modules de configuration pour séparer les responsabilités entre l'exécution des transactions, la connectivité à l'échange et la communication Telegram.

Le système de configuration est volontairement léger et basé sur des fichiers, permettant un déploiement facile, une édition rapide et un comportement de démarrage prévisible.

Configuration Telegram

Le module de configuration Telegram contient tous les paramètres requis pour la communication avec la API Telegram Bot et l’intégration TCP.

TELEGRAM_BOT_TOKEN

Code
TELEGRAM_BOT_TOKEN = "your_telegram_bot_token"

Le jeton du bot Telegram utilisé pour l'authentification auprès de l'API Telegram Bot.

Ce jeton est généré via BotFather dans Telegram et identifie de manière unique l’instance du bot.

Responsabilités :

  • •Authentifie les requêtes API
  • •Permet l'envoi de notifications
  • •Permet la réception des commandes utilisateur
  • •Donne accès aux fonctionnalités du bot Telegram

Important :

  • •Ne jamais exposer le jeton publiquement
  • •Ne jamais le commiter dans des dépôts publics
  • •Le traiter comme un identifiant privé

TELEGRAM_CHAT_ID

Code
TELEGRAM_CHAT_ID = "your_private_telegram_chat_id"

L'identifiant privé du chat Telegram où les notifications et les alertes de trading sont livrées.

Le bot utilise cet ID pour restreindre la communication uniquement au propriétaire autorisé.

Responsabilités :

  • •Achemine les alertes et notifications
  • •Restreint l'accès non autorisé
  • •Permet l'exécution de commandes privées

Utilisation typique :

  • •Notifications de trading personnelles
  • •Gestion à distance du bot
  • •Surveillance de l'exécution des transactions

TCP_SERVER_PORT

Code
TCP_SERVER_PORT = 55110

Définit le port TCP utilisé pour la communication entre le serveur Telegram et le bot de trading.

Les deux applications doivent utiliser la même valeur de port.

Responsabilités :

  • •Transport des messages TCP
  • •Routage des commandes à distance
  • •Transfert de journaux en temps réel

Important :

  • •Le port doit être disponible sur le système
  • •Les règles du pare-feu peuvent nécessiter un ajustement
  • •Les deux processus doivent partager une configuration identique

Configuration Binance

Le module de configuration Binance contient les identifiants d'authentification de l'échange et les paramètres de communication pour le trading.

BINANCE_API_KEY

Code
BINANCE_API_KEY = "your_binance_api_key"

Clé API publique générée à partir du compte Binance.

Utilisée pour authentifier les requêtes auprès des services Binance.

Responsabilités :

  • •Accès aux données de marché
  • •Permissions de passage d'ordres
  • •Accès aux informations du compte

Recommandations de sécurité :

  • •Activer les restrictions IP si possible
  • •Utiliser des permissions de trading uniquement
  • •Éviter d'activer les permissions de retrait

BINANCE_API_SECRET

Code
BINANCE_API_SECRET = "your_binance_api_secret"

Secret API privé associé à la clé API Binance.

Utilisé pour la signature des requêtes et la vérification de l'authentification.

Important :

  • •Doit rester strictement privé
  • •Ne jamais exposer publiquement
  • •Ne jamais l'envoyer via les journaux ou captures d'écran

TCP_SERVER_PORT

Code
TCP_SERVER_PORT = 55110

Définit le port de communication TCP utilisé par le client TCP du bot de trading.

Cette valeur doit correspondre à la configuration du serveur Telegram.

Configuration du Trading

Le module de configuration du trading définit l'allocation du capital, les paires de trading, le comportement de la stratégie et la gestion des risques du portefeuille.

INITIAL_CAPITAL

Code
INITIAL_CAPITAL = 1000.0

Définit le capital de départ virtuel ou suivi pour le système de trading.

Utilisé pour :

  • •Calculs de performance
  • •Calculs de drawdown
  • •Suivi de l'exposition du portefeuille
  • •Statistiques de gestion des risques

La valeur est exprimée en USDT.

TRADING_PAIRS

Code
TRADING_PAIRS = [
    "AVAXUSDT",
    "LINKUSDT",
    "DOTUSDT",
    "XRPUSDT",
    "ATOMUSDT"
]

Liste des symboles de cryptomonnaies surveillés et tradés par le système.

Chaque symbole doit également exister dans le dictionnaire TRADING_PARAMETERS

Responsabilités :

  • •Définit les marchés de trading actifs
  • •Contrôle les abonnements aux symboles
  • •Permet l'exécution de la stratégie par symbole

Conseil Pro : Utilisez un Éditeur de Code

Pour une bien meilleure expérience de modification des fichiers de configuration, nous vous recommandons d’utiliser un éditeur de code professionnel comme Visual Studio Code.

Download VS Code ↗

Référence des Paramètres de Trading

Chaque paire de trading contient un profil de configuration de stratégie indépendant.

Cette conception permet à chaque marché d’utiliser des paramètres personnalisés de volatilité, de tendance et de risque.

lot_size

Code
"lot_size": 0.5

Quantité minimale d'ordre pour la paire de trading.

La valeur doit respecter les exigences de taille de lot de la bourse Binance.

Objectif :

  • •Empêche les tailles d'ordre invalides
  • •Garantit la compatibilité avec l'échange
  • •Contrôle la précision minimale des transactions

position_size

Code
"position_size": 18.0

Allocation de capital maximale en USDT pour une seule entrée en position.

Objectif :

  • •Contrôle l'exposition de la position
  • •Limite le risque par transaction
  • •Empêche la sur-allocation

Des valeurs plus élevées augmentent :

  • •Profit potentiel
  • •Perte potentielle
  • •Exposition du portefeuille

take_profit_percent

Code
"take_profit_percent": 2.81

Pourcentage de profit cible par rapport au prix d'entrée.

Lorsque le marché atteint ce niveau, le bot clôture la position avec profit.

Objectif :

  • •Verrouille les gains
  • •Définit l'objectif de récompense
  • •Standardise les sorties

Exemple :

  • •Entrée à 100 USDT
  • •Take profit à 2,81%
  • •Cible de sortie = 102,81 USDT

stop_loss_percent

Code
"stop_loss_percent": 1.41

Pourcentage de perte maximale autorisée en dessous du prix d'entrée.

La position est automatiquement clôturée si le marché évolue défavorablement.

Objectif :

  • •Limite le risque à la baisse
  • •Protège le capital de trading
  • •Empêche les drawdowns importants

Exemple :

  • •Entrée à 100 USDT
  • •Stop loss à 1,41%
  • •Sortie à 98,59 USDT

trail_activation_percent

Code
"trail_activation_percent": 1.3

Seuil de profit requis avant d’activer le système de trailing stop.

Avant l'activation :

  • •Le stop loss standard est utilisé

Après l'activation :

  • •La protection dynamique par trailing commence

Objectif :

  • •Protège les transactions rentables
  • •Permet aux profits de courir
  • •Réduit les sorties prématurées

trail_distance_percent

Code
"trail_distance_percent": 0.8

Distance entre le plus haut actuel du marché et le niveau du trailing stop.

Objectif :

  • •Protège les profits latents
  • •Permet un mouvement naturel du marché
  • •Crée des sorties dynamiques

Valeurs plus petites :

  • •Protection plus stricte
  • •Sorties plus rapides
  • •Comportement plus sensible

Valeurs plus grandes :

  • •Plus de flexibilité
  • •Durée de transaction plus longue
  • •Tolérance accrue aux retracements

trail_tight_distance_percent

Code
"trail_tight_distance_percent": 0.5

Une distance de trailing stop plus serrée utilisée dans des conditions de résistance ou de retournement plus fortes.

Objectif :

  • •Protection agressive des profits
  • •Sorties plus rapides près de la résistance
  • •Réduction des profits rendus

min_ema200_3m_slope

Code
"min_ema200_3m_slope": -0.008

Pente minimale autorisée de la EMA200 sur 3 minutes.

Utilisé comme filtre de tendance sur une période plus longue.

Objectif :

  • •Évite de trader pendant les fortes baisses
  • •Filtre les structures de marché faibles
  • •Améliore l'alignement sur la tendance

min_ema20_1m_slope

Code
"min_ema20_1m_slope": 0.01

Pente minimale requise pour la EMA20 sur 1 minute.

Utilisé pour la confirmation de momentum à court terme.

Objectif :

  • •Détecte une accélération haussière
  • •Confirme un momentum haussier
  • •Filtre les conditions de marché plates

min_ema50_1m_slope

Code
"min_ema50_1m_slope": 0.005

Pente minimale requise pour la EMA50 sur 1 minute.

Agit comme une confirmation de tendance supplémentaire.

Objectif :

  • •Confirme la direction à moyen terme
  • •Réduit les faux signaux
  • •Améliore la qualité d'entrée

volume_spike_coeff

Code
"volume_spike_coeff": 1.2

Multiplicateur de volume requis par rapport au volume moyen.

Le bot ne passe des ordres que si le volume actuel dépasse le seuil configuré.

Objectif :

  • •Détecte une forte participation au marché
  • •Évite les entrées à faible liquidité
  • •Confirme la force de la cassure

Exemple :

  • •Volume moyen = 1000
  • •Coefficient = 1,2
  • •Volume requis = 1200+

max_candle_size

Code
"max_candle_size": 0.8

Pourcentage de taille de bougie maximum autorisé avant de bloquer l'entrée.

Objectif :

  • •Évite d'entrer après des bougies surdimensionnées
  • •Empêche de courir après des mouvements excessifs
  • •Réduit les entrées FOMO

min_ema50_ema200_distance

Code
"min_ema50_ema200_distance": 0.06

Distance en pourcentage minimale requise entre EMA50 et EMA200.

Objectif :

  • •Confirme la séparation de la tendance du marché
  • •Filtre les tendances faibles
  • •Valide la structure de la tendance

Des distances plus élevées indiquent généralement des tendances plus fortes.

min_ema20_ema50_distance

Code
"min_ema20_ema50_distance": 0.10

Distance minimale requise entre les indicateurs EMA20 et EMA50.

Objectif :

  • •Confirme la force du momentum à court terme
  • •Filtre les entrées faibles
  • •Améliore la qualité du signal

Référence des Paramètres de Risque

Le système de gestion des risques protège à la fois les symboles individuels et le portefeuille entier.

max_portfolio_exposure

Code
"max_portfolio_exposure": 90.0

Pourcentage maximum du capital du portefeuille pouvant être simultanément alloué aux positions ouvertes.

Objectif :

  • •Empêche la surexposition
  • •Maintient une liquidité de réserve
  • •Réduit le risque systémique

max_consecutive_losses

Code
"max_consecutive_losses": 10

Nombre maximum de pertes consécutives autorisées avant que le trading ne s'interrompe pour le symbole.

Objectif :

  • •Détecte les conditions de marché instables
  • •Empêche une logique de surenchère émotionnelle
  • •Limite les périodes de dégradation de la stratégie

max_daily_drawdown_per_symbol

Code
"max_daily_drawdown_per_symbol": 3.0

Pourcentage de perte quotidienne maximum autorisé pour une paire de trading individuelle.

Si dépassé :

  • •Le trading pour le symbole est temporairement arrêté

Objectif :

  • •Limite les dégâts spécifiques au symbole
  • •Empêche les pertes répétées sur des marchés instables

max_total_drawdown_per_symbol

Code
"max_total_drawdown_per_symbol": 6.0

Pourcentage de perte cumulée maximum autorisé pour une paire de trading sur toutes les sessions.

Objectif :

  • •Détecte les symboles sous-performants de manière constante
  • •Empêche l'érosion du capital à long terme

max_daily_drawdown

Code
"max_daily_drawdown": 5.0

Pourcentage de perte de portefeuille quotidienne maximale autorisé.

Si dépassé :

  • •Toute activité de trading s'arrête

Objectif :

  • •Protège le portefeuille pendant les conditions de marché extrêmes
  • •Limite les pertes quotidiennes catastrophiques

max_total_drawdown

Code
"max_total_drawdown": 10.0

Drawdown cumulé maximum du portefeuille sur l’ensemble du cycle de vie du trading.

Objectif :

  • •Agit comme un mécanisme final de protection du capital
  • •Empêche l'échec complet de la stratégie
  • •Applique une discipline de risque à long terme

Une fois atteint :

  • •Les opérations de trading doivent rester désactivées jusqu’à ce qu’une révision manuelle soit effectuée.