Comment créer un bot Signal sur Freya Finance

#Comment créer un bot Signal sur Freya Finance

Un bot Signal exécute des trades lorsqu'il reçoit un signal externe — le plus souvent depuis une alerte TradingView envoyée à un webhook. Au lieu de construire la logique d'entrée à l'intérieur de Freya (comme le fait un bot DCA), vous apportez vos propres signaux depuis une autre plateforme, et le bot Signal les transforme en trades réels sur votre exchange.

Si vous avez déjà une stratégie ou une configuration d'indicateur en laquelle vous avez confiance ailleurs, le bot Signal est la façon de l'automatiser sur Freya. (Si vous préférez construire la logique à l'intérieur de Freya, commencez plutôt par Comment créer votre premier bot DCA.)

---

#Ce qu'est un bot Signal

Avec un bot DCA, vous configurez les conditions d'entrée à l'intérieur de Freya. Un bot Signal est l'inverse : la décision du moment d'entrer ou de sortir vient de l'extérieur — votre plateforme de graphiques, votre propre script, ou tout outil capable d'envoyer un webhook. Lorsque ce signal arrive, le bot Signal place le trade. C'est le pont entre votre stratégie externe et l'exécution en direct sur votre exchange.

#Un aperçu rapide des étapes

1. Créez un bot et choisissez le type Bot Signal, puis sélectionnez votre paire de trading et votre direction.
2. Choisissez un mode de signal — Signal personnalisé, ou Risk Ratio (où le webhook porte votre take-profit et votre stop-loss).
3. Copiez votre ou vos URL de webhook — Signal personnalisé vous donne une URL d'Ouverture et une de Fermeture ; Risk Ratio vous donne une seule URL.
4. Connectez votre source de signal — collez ces URL dans votre alerte TradingView (ou un autre outil).
5. Définissez vos paramètres d'ordre et lancez. À partir de là, vos signaux pilotent le bot.

#Étape 1 : choisir le type Bot Signal

Dans le flux de création de bot, sélectionnez Bot Signal (« Exécuter des trades basés sur des signaux webhook »), puis choisissez votre paire de trading et votre direction comme pour n'importe quel autre bot.

#Étape 2 : choisir un mode de signal

Le mode de signal contrôle la façon dont votre bot interprète les signaux qu'il reçoit. Il existe deux modes, et vous en choisissez un — ils ne peuvent pas être combinés :

• Signal personnalisé — votre bot agit sur les signaux d'ouverture et de fermeture que vous envoyez via webhook (par exemple, depuis une alerte TradingView), et c'est vous qui configurez les ordres dans Freya : le montant à trader ainsi que votre take-profit et votre stop-loss.
• Risk Ratio — le payload du webhook porte les prix de take-profit et de stop-loss ; l'entrée est prise au prix du marché au moment où le signal se déclenche. Au lieu de choisir un montant de trade, vous fixez un montant de risque fixe par trade, et Freya calcule automatiquement la taille de position à partir de la distance entre l'entrée et le stop-loss. Le résultat : si le stop-loss est touché, vous perdez à peu près le montant de risque exact que vous avez choisi. Le take-profit est placé comme un ordre limite au prix du webhook (il se remplit donc sans slippage) ; le stop-loss s'exécute comme un ordre au marché lorsqu'il est déclenché, donc — comme tout stop — il peut subir du slippage lors d'un mouvement rapide.

Choisissez le mode qui correspond à la façon dont vos signaux sont construits.

#Pourquoi le mode Risk Ratio est puissant

Le mode Risk Ratio renverse le dimensionnement de position. Normalement, vous choisissez une taille de position et acceptez la perte qu'implique le stop-loss. En mode Risk Ratio, vous choisissez la perte que vous êtes prêt à subir, et la taille de position est calibrée en conséquence automatiquement. Cela rend votre risque par trade constant, quelle que soit la distance du stop-loss — une approche disciplinée qu'utilisent les professionnels. Vous définissez le type de risque et le montant fixe à l'étape de la stratégie ; le montant du trade s'affiche alors comme dynamique, car il est calculé au moment où le webhook arrive.

#Étape 3 : obtenir vos URL de webhook

Les URL que vous obtenez dépendent de votre mode :

• En mode Signal personnalisé, votre bot reçoit une URL de webhook d'Ouverture (l'appeler ouvre une position) et une URL de webhook de Fermeture distincte (l'appeler ferme la position).
• En mode Risk Ratio, vous obtenez une seule URL de webhook pour le signal d'entrée. La position est ensuite clôturée automatiquement par le take-profit et le stop-loss portés dans le webhook, il n'y a donc pas d'URL de Fermeture distincte. Le signal est envoyé sous forme d'un petit message JSON qui inclut les valeurs de take-profit et de stop-loss.

Vous pouvez copier une URL et la régénérer quand vous le souhaitez. La régénération crée une URL toute neuve et invalide immédiatement l'ancienne — utile si une URL a été exposée.

#Étape 4 : connecter votre source de signal

Collez votre ou vos URL de webhook dans votre source de signal. Avec TradingView, par exemple, vous créez une alerte et définissez son URL de webhook sur l'URL de votre bot. En mode Signal personnalisé, vous utilisez l'URL d'Ouverture pour les entrées et l'URL de Fermeture pour les sorties ; en mode Risk Ratio, vous utilisez le webhook unique et incluez votre take-profit et votre stop-loss dans le message de l'alerte. Lorsque votre condition d'alerte se déclenche, TradingView appelle le webhook et votre bot agit en conséquence.

#Étape 5 : définir vos paramètres d'ordre

Configurez la façon dont le bot dimensionne et place ses ordres. En mode Signal personnalisé, vous définissez le montant du trade ainsi que votre take-profit et votre stop-loss. En mode Risk Ratio, vous définissez plutôt votre montant de risque fixe (le montant du trade devient dynamique, et le take-profit et le stop-loss viennent du webhook). Lancez ensuite le bot — il reste tranquille jusqu'à l'arrivée d'un signal, puis il exécute.

#Garder vos webhooks sécurisés

C'est l'habitude la plus importante avec les bots Signal : vos URL de webhook sont des secrets. Quiconque détient une URL peut déclencher cette action sur votre bot, alors :

• Ne partagez ni ne publiez jamais vos URL de webhook publiquement.
• Ne les collez que dans des outils de confiance comme vos propres alertes TradingView.
• Régénérez immédiatement si vous soupçonnez qu'une URL a été exposée — l'ancienne cesse de fonctionner aussitôt.

#Questions fréquentes

#Qu'est-ce qu'un bot Signal sur Freya Finance ?

Un bot Signal exécute des trades basés sur des signaux externes envoyés à un webhook — par exemple, une alerte TradingView. Plutôt que de décider quand trader à l'intérieur de Freya, il attend votre signal puis ouvre ou ferme une position sur votre exchange. C'est idéal si vous générez déjà des signaux sur une autre plateforme.

#Comment connecter TradingView à mon bot Signal ?

Choisissez le mode Signal personnalisé, copiez les URL de webhook d'Ouverture et de Fermeture de votre bot, et collez-les dans vos alertes TradingView (l'URL d'Ouverture pour les entrées, l'URL de Fermeture pour les sorties). En mode Risk Ratio, vous utilisez plutôt une seule URL de webhook et incluez le take-profit et le stop-loss dans le message de l'alerte. Lorsqu'une alerte se déclenche, TradingView appelle le webhook et votre bot trade.

#Quelle est la différence entre le mode Signal personnalisé et le mode Risk Ratio ?

En mode Signal personnalisé, le bot agit sur les signaux d'ouverture et de fermeture que vous envoyez via webhook, et vous configurez vous-même les ordres — le montant du trade ainsi que votre take-profit et votre stop-loss. En mode Risk Ratio, le payload du webhook porte les prix de take-profit et de stop-loss (l'entrée est prise au marché au moment où le signal se déclenche), et au lieu d'un montant de trade vous fixez un montant de risque fixe — Freya dimensionne alors la position automatiquement à partir de la distance entre l'entrée et le stop-loss, de sorte qu'un stop-out vous coûte à peu près le risque exact que vous avez choisi. Les deux modes ne peuvent pas être combinés ; choisissez celui qui correspond à la façon dont vos signaux sont construits.

#Comment fonctionne le dimensionnement de position en mode Risk Ratio ?

Vous fixez un montant de risque fixe par trade. Lorsque le signal se déclenche, Freya prend l'entrée au prix du marché et lit le stop-loss depuis le webhook, puis calcule la taille de position de sorte que la perte au stop-loss soit égale à votre risque choisi. Cela garde votre risque par trade constant, que le stop soit large ou serré — vous décidez la perte que vous êtes prêt à subir, et la taille suit.

#Mes URL de webhook sont-elles secrètes ?

Oui — traitez-les comme des mots de passe. Quiconque détient une URL de webhook pourrait déclencher cette action sur votre bot. Ne les partagez jamais, ne les collez que dans des outils de confiance, et régénérez une URL immédiatement si vous pensez qu'elle a été exposée. La régénération invalide l'ancienne URL aussitôt.

#J'ai envoyé un signal mais rien ne s'est passé — pourquoi ?

Vérifiez que vous avez utilisé la bonne URL de webhook (Ouverture ou Fermeture), que votre mode de signal correspond à la configuration de votre alerte, et que le bot tourne et n'est pas en pause. Si vous avez récemment régénéré une URL, assurez-vous que votre source de signal utilise bien la nouvelle. Pour l'état général du bot, consultez Pourquoi mon bot ne trade-t-il pas ?.

#Le webhook peut-il définir mon take-profit et mon stop-loss ?

Oui, si vous utilisez le mode Risk Ratio. Dans ce mode, les valeurs de take-profit et de stop-loss viennent du payload du webhook plutôt que d'être saisies manuellement dans Freya, ce qui permet à votre stratégie externe de contrôler les sorties.