Pourquoi mon bot s'est-il mis en pause ou arrêté ?
Quand un bot cesse de faire ce que vous attendez, il s'agit presque toujours de l'une des quelques causes faciles à corriger — généralement quelque chose du côté de l'exchange, comme les fonds ou les permissions de l'API. Ce guide passe en revue chacune d'elles, de la plus courante à la moins courante.
À ne pas confondre avec un bot qui n'ouvre pas de trades. Si votre bot fonctionne correctement mais n'a pas ouvert de position, c'est généralement une question de conditions d'entrée — voir Pourquoi mon bot ne trade-t-il pas ?. Cet article concerne un bot qui s'est mis en pause, arrêté ou a rencontré une erreur.
Key Takeaways
- Un bot passe par des statuts clairs — Actif (en attente d'entrée), Déclenchement, En cours (position ouverte), En pause, Pause en attente et Erreur — et ce guide explique pourquoi l'un d'eux se met en pause, s'arrête ou génère une erreur.
- La raison la plus courante pour laquelle un bot cesse d'exécuter est un solde ou une marge insuffisants sur votre compte d'exchange.
- Les problèmes de clé API — une clé invalide, révoquée ou aux mauvaises permissions, ou un blocage de liste blanche d'IP — arrêtent également un bot ; reconnecter une nouvelle clé lecture-et-trading résout le problème.
- Sur les futures, un levier trop élevé pour la paire ou une incompatibilité du mode de position peut bloquer les ordres.
- De nombreuses erreurs d'exchange (limites de débit, délais d'attente, horloge/horodatage) sont temporaires ; Freya vous avertit lorsqu'un bot échoue afin que vous puissiez agir.
Les statuts du bot en un coup d'œil
- Actif — en ligne et surveillant le marché pour ses conditions d'entrée ; aucune position ouverte encore.
- Déclenchement — les conditions d'entrée ont été remplies ; le bot ouvre sa position.
- En cours — une position est ouverte et le bot gère le deal (ordres de sécurité, take-profit, sorties).
- En pause — vous l'avez mis en pause ; il n'ouvrira pas de nouvelles positions tant que vous ne le reprendrez pas.
- Pause en attente — vous l'avez mis en pause alors qu'une position était ouverte ; il termine de gérer cette position en toute sécurité, puis passe En pause.
- Erreur — il a tenté d'agir mais l'exchange ou une vérification l'a rejeté ; il s'arrête et signale le problème.
- Clôture / Fermé — le bot termine le deal ; une fois terminé, le deal est enregistré dans votre historique.
(Pour la référence complète des statuts avec la distinction ACTIF vs EN COURS, voir Pourquoi mon bot ne trade-t-il pas ?.)
Lorsqu'un bot rencontre un problème dont il ne peut pas se remettre, il passe à un état d'erreur et vous recevez une notification « bot en échec » (si vous avez configuré les notifications) afin de pouvoir le corriger rapidement.
La cause la plus courante : pas assez de solde ou de marge
De loin la raison la plus fréquente pour laquelle un bot cesse de placer des ordres est un solde insuffisant (spot) ou une marge insuffisante (futures) sur votre compte d'exchange. Votre bot a tenté de placer un ordre — un ordre de base, un ordre de moyennage ou un take-profit — et l'exchange a refusé parce que les fonds n'étaient pas disponibles.
Solution : assurez-vous que votre compte d'exchange dispose d'un solde/d'une marge libre suffisant pour couvrir l'ensemble du plan du bot — y compris chaque ordre de moyennage de sa grille. (C'est pourquoi le financement de la grille complète est important ; voir Ordres d'entrée et la grille.)
Problèmes de clé API
Si Freya ne peut plus agir en votre nom, le bot s'arrête. Causes courantes liées à la clé API :
- Clé invalide, révoquée ou régénérée — si vous avez supprimé ou renouvelé la clé sur l'exchange, la copie détenue par Freya ne fonctionne plus.
- Mauvaises permissions — la clé nécessite les permissions lecture et trading (jamais de retrait). Une clé en lecture seule ne peut pas placer d'ordres.
- Blocage de liste blanche d'IP — si vous avez restreint la clé à des IP spécifiques, les IP des serveurs de Freya doivent être autorisées (elles sont affichées lorsque vous connectez l'exchange).
Solution : reconnectez-vous avec une nouvelle clé lecture-et-trading. Voir Comment connecter votre exchange et Gérer vos clés API.
Ordre trop petit
Chaque exchange a une taille d'ordre minimum (une valeur notionnelle minimum). Si le montant de votre ordre — ou un ordre individuel de la grille — tombe en dessous, l'exchange rejette l'ordre.
Solution : augmentez votre montant de trading (ou le volume par ordre) afin que chaque ordre franchisse le minimum de l'exchange.
Spécifique aux futures : levier et mode de position
Sur les futures, deux réglages peuvent bloquer les ordres :
- Levier trop élevé — le levier que vous avez défini dépasse ce que l'exchange autorise pour cette paire. Abaissez-le à un niveau autorisé.
- Incompatibilité du mode de position — votre compte d'exchange est dans un mode de position différent (hedge ou one-way) de celui attendu par le bot. Alignez le mode de position sur l'exchange avec la façon dont le bot trade.
Problèmes temporaires de l'exchange
Certaines erreurs ne sont pas de votre fait et se résolvent souvent d'elles-mêmes :
- Limites de débit — trop de requêtes dans un court laps de temps.
- Délais d'attente / erreurs réseau — un problème de connexion momentané avec l'exchange.
- Erreurs d'horodatage — un problème de synchronisation d'horloge entre les systèmes et l'exchange.
- Exchange occupé / en maintenance — l'exchange lui-même est surchargé ou hors service.
Solution : celles-ci se résolvent généralement toutes seules. Si un bot a généré une erreur pour l'une d'elles, vous pouvez habituellement le reprendre une fois que l'exchange répond de nouveau normalement.
Que faire : une checklist rapide
- Vérifiez le solde/la marge de votre exchange — la cause numéro un. Rechargez si c'est bas.
- Vérifiez votre clé API — toujours valide, permissions lecture-et-trading, IP de Freya autorisées.
- Vérifiez la taille de l'ordre — au-dessus du minimum de l'exchange.
- Sur les futures, confirmez que le levier est dans les limites et que le mode de position correspond.
- S'il s'agissait d'une erreur temporaire, attendez que l'exchange se rétablisse et reprenez le bot.
- Toujours bloqué ? Contactez [email protected].
Questions fréquentes
Pourquoi mon bot s'est-il mis en pause ou arrêté ?
Le plus souvent parce que l'exchange a rejeté un ordre — généralement un solde ou une marge insuffisants, un problème de clé API, ou un ordre en dessous de la taille minimum de l'exchange. Sur les futures, les réglages de levier ou de mode de position peuvent aussi bloquer les ordres. Des problèmes temporaires de l'exchange (limites de débit, délais d'attente) peuvent également arrêter un bot, mais ceux-ci se résolvent généralement d'eux-mêmes.
Que signifie l'état d'erreur de mon bot ?
Il a tenté d'agir mais quelque chose a rejeté l'action, alors il s'est arrêté et a signalé le problème plutôt que de continuer aveuglément. Vous recevrez une notification « bot en échec » (si les notifications sont activées). Corrigez la cause sous-jacente — généralement le solde ou la clé API — et vous pourrez le relancer.
Mon bot indique un solde insuffisant — que dois-je faire ?
Ajoutez des fonds à votre compte d'exchange afin qu'il y ait un solde libre (spot) ou une marge (futures) suffisant pour couvrir les ordres du bot, y compris sa grille d'ordres de moyennage. Le bot n'a pas pu placer un ordre parce que les fonds n'étaient pas disponibles sur l'exchange.
Ma clé API pourrait-elle être en cause ?
Oui — c'est une cause fréquente. Si la clé a été supprimée, régénérée ou définie en lecture seule, ou si elle est restreinte par IP et que les IP des serveurs de Freya ne sont pas autorisées, le bot ne peut pas trader. Reconnectez-vous avec une nouvelle clé disposant des permissions lecture et trading (jamais de retrait).
Mon bot futures ne place pas d'ordres — est-ce le levier ou le mode de position ?
Oui. Si votre levier est supérieur à ce que l'exchange autorise pour cette paire, ou si le mode de position de votre compte (hedge ou one-way) ne correspond pas à la façon dont le bot trade, les ordres sont rejetés. Abaissez le levier à un niveau autorisé et alignez le mode de position sur l'exchange.
Serai-je averti si mon bot échoue ?
Oui — si vous avez configuré les notifications, Freya envoie une alerte « bot en échec » lorsqu'un bot entre dans un état d'erreur, afin que vous puissiez agir rapidement. Voir Comment configurer les notifications.
Mon bot fonctionne mais n'a ouvert aucun trade — est-ce la même chose ?
Non. Un bot en cours qui n'a pas ouvert de position n'a généralement simplement pas encore rempli ses conditions d'entrée — ce point est traité dans Pourquoi mon bot ne trade-t-il pas ?. Cet article concerne un bot qui s'est mis en pause, arrêté ou a rencontré une erreur.
