Guide de configuration d'un bot webhook TradingView

Vous avez construit une alerte sur TradingView qui se déclenche exactement au moment où vous voudriez entrer en position. Le problème : une alerte n'est qu'une notification. Le temps que vous la voyiez et que vous passiez l'ordre, le prix a déjà bougé. Ou bien vous dormiez et vous l'avez complètement manquée.

Un bot webhook TradingView comble cet écart. Au lieu de vous notifier, l'alerte notifie une URL de webhook, une adresse web privée qui appartient à votre bot. Le bot signal de Freya écoute à cette adresse, et dès que votre alerte se déclenche, il passe la transaction automatiquement sur votre exchange. Votre logique de graphique reste sur TradingView ; Freya se charge de l'exécution.

Ce guide couvre les concepts, la configuration pas à pas, ainsi que les connaissances en matière de fiabilité, de sécurité et de dépannage qui maintiennent la connexion active quand cela compte.

Comment fonctionnent les alertes et les webhooks TradingView

Trois éléments composent la chaîne.

L'alerte est une condition que vous définissez sur un graphique TradingView : un prix qui franchit un niveau, un indicateur qui bascule, un script personnalisé qui se déclenche. Seule, elle peut apparaître à l'écran, vous envoyer un e-mail ou une notification sur votre téléphone, mais tout cela exige encore que vous agissiez.

Le webhook est l'option d'automatisation. Quand vous l'activez, TradingView envoie un petit message sur internet vers une URL de votre choix à l'instant où l'alerte se déclenche. L'alerte passe un coup de fil au lieu de vous laisser un mot.

Le bot est le point de réception. Le bot signal de Freya expose une URL de webhook privée ; quand le message arrive, le bot exécute l'action pour laquelle il est configuré sur votre compte d'exchange connecté.

La chaîne complète :

1. Votre condition de graphique devient vraie sur TradingView
2. L'alerte se déclenche et TradingView appelle l'URL de webhook de votre bot
3. Freya reçoit le signal et votre bot passe l'ordre sur votre exchange
4. Votre bot gère ensuite la position selon ses réglages

Le modèle mental essentiel : votre stratégie vit sur TradingView ; Freya est la couche d'exécution. La logique de timing se trouve entièrement à l'intérieur de votre alerte.

Ce que fait le déclencheur webhook de Freya

Sur Freya, l'exécution par webhook est gérée par le bot signal, le type de bot décrit dans le flux de création de bot comme « Exécuter des trades basés sur des signaux webhook ». Contrairement à un déclencheur basé sur un indicateur (RSI, EMA, et ainsi de suite), le déclencheur webhook n'a ni timeframe ni condition configurée à l'intérieur de Freya. La décision du moment de déclenchement appartient entièrement à votre alerte TradingView. Le rôle de Freya, c'est ce qui se passe ensuite.

Il existe deux modes de webhook, et un bot utilise l'un ou l'autre : ils ne peuvent pas être combinés.

• TradingView Webhook (mode Signal personnalisé). Votre bot obtient deux URL : une URL de webhook d'ouverture et une URL de webhook de fermeture. Un message vers l'URL d'ouverture ouvre une position en utilisant les paramètres d'ordre que vous avez configurés dans Freya, à savoir le montant de la transaction ainsi que votre take-profit et votre stop-loss ; un message vers l'URL de fermeture la ferme.

• Mode Risk Ratio. Votre bot obtient une seule URL. Le message d'alerte est une petite charge utile JSON qui transporte vos prix de take-profit et de stop-loss ; l'entrée est prise au marché à l'arrivée du signal. Au lieu d'un montant de transaction, vous définissez un montant de risque fixe (ancré au stop-loss, ou éventuellement au take-profit), et Freya dimensionne la position automatiquement à partir de la distance entre l'entrée et le stop. Il n'y a pas d'URL de fermeture parce que les sorties se gèrent d'elles-mêmes : le take-profit est placé comme ordre limite au prix exact issu de votre signal, et le stop-loss s'exécute comme ordre au marché quand il est déclenché.

Pas à pas : connecter TradingView à votre bot

Étape 1 : créer un bot signal

Dans le flux de création de bot de Freya, choisissez le type Bot Signal, puis sélectionnez votre compte d'exchange, votre paire de trading et votre direction, comme pour n'importe quel autre bot. Le guide complet dans Comment créer un bot signal sur Freya Finance détaille chaque écran.

Étape 2 : choisir votre mode de signal

Choisissez Signal personnalisé si vous voulez configurer le montant de la transaction, le take-profit et le stop-loss à l'intérieur de Freya et laisser vos alertes dire simplement « ouvrir maintenant » et « fermer maintenant ». Choisissez Risk Ratio si votre stratégie produit un take-profit et un stop-loss par transaction et que vous voulez que le dimensionnement soit géré automatiquement à partir d'un montant de risque fixe.

Étape 3 : copier votre ou vos URL de webhook

À l'étape de la stratégie, Freya génère votre ou vos URL de webhook. Utilisez le bouton de copie : un seul caractère manquant rend l'URL inutilisable. Vous pouvez régénérer n'importe quelle URL plus tard, ce qui en crée une nouvelle et invalide immédiatement l'ancienne.

Étape 4 : créer l'alerte TradingView

Sur votre graphique TradingView, créez une alerte avec la condition qui représente votre entrée. Dans les paramètres de notification de l'alerte, activez l'option URL de webhook et collez l'URL de votre bot : l'URL d'ouverture en mode Signal personnalisé, ou l'URL unique en mode Risk Ratio. Pour des sorties pilotées par alerte en mode Signal personnalisé, créez une deuxième alerte pour votre condition de sortie et pointez-la vers l'URL de fermeture.

Étape 5 : définir le message d'alerte

Le message d'alerte est la charge utile que TradingView livre à votre bot. Utilisez exactement le format fourni par l'écran de configuration de votre bot : en mode Risk Ratio, Freya affiche un Modèle de corps JSON avec un bouton de copie en un clic ; votre alerte doit envoyer cette structure avec vos valeurs de take-profit et de stop-loss renseignées. N'improvisez pas : si le message ne correspond pas à ce que le bot attend, le signal est ignoré au lieu d'être deviné.

Étape 6 : tester avant de passer en réel

Ne connectez jamais un webhook pour ensuite l'oublier. Faites au moins un aller-retour complet avec un petit montant :

1. Définissez une condition d'alerte qui, vous le savez, se déclenchera rapidement (un prix franchissant un niveau qu'il est sur le point de toucher)
2. Laissez-la se déclencher, puis vérifiez le journal d'activité de votre bot pour l'événement de signal entrant
3. Confirmez que la position s'est ouverte sur votre exchange avec la taille attendue
4. Déclenchez la fermeture (signal vers l'URL de fermeture, ou le take-profit/stop-loss en mode Risk Ratio) et confirmez que la position s'est bien fermée

Ce n'est qu'après un aller-retour propre que vous devriez rattacher votre vraie stratégie et votre taille réelle.

Un exemple chiffré : dimensionnement en Risk Ratio

Supposons que vous fixiez un risque fixe de 20 $ par transaction, ancré au stop-loss. Votre alerte TradingView se déclenche avec le BTC à 100 000 $, transportant un stop-loss à 98 000 $ et un take-profit à 104 000 $ dans son message.

• Entrée : au marché, exécutée à 100 000 $
• Distance jusqu'au stop-loss : 2 000 $ par BTC (2 %)
• Taille de position : 20 $ de risque ÷ 2 000 $ par BTC = 0,01 BTC (environ 1 000 $ d'exposition)
• Take-profit : ordre limite à 104 000 $. S'il est exécuté, le profit est de 0,01 × 4 000 $ = 40 $, un rendement de 2:1 pour les 20 $ risqués
• Stop-loss : ordre au marché si 98 000 $ se déclenche. Environ les 20 $ que vous avez choisis, plus les frais, et peut-être un peu plus lors d'un mouvement rapide puisqu'un stop déclenché s'exécute au marché

Que votre stop soit à 1 % ou à 5 % de distance, le montant en dollars risqué reste 20 $ parce que la taille s'ajuste. Cette constance est tout l'intérêt du mode Risk Ratio.

Fiabilité : sur quoi vous pouvez et ne pouvez pas compter

Une automatisation n'est fiable que dans la mesure de son maillon le plus faible, et avec les bots webhook, ce maillon se situe généralement en dehors de Freya.

Exigences du forfait TradingView. Les notifications webhook ne sont pas incluses dans tous les forfaits TradingView, et les limites d'alertes ainsi que leur expiration varient aussi selon le niveau. Une alerte qui ne peut pas envoyer de webhooks échoue silencieusement du point de vue du bot. Vérifiez les options d'alerte de votre forfait avant de bâtir votre configuration autour d'elles.

Des retards et des pannes surviennent. La marketplace de Freya signale les stratégies pilotées par webhook avec un avertissement de signal externe : les transactions sont déclenchées par des signaux TradingView ou webhook, et des retards ou des interruptions à la source sont possibles. Si TradingView subit un incident, votre alerte ne se déclenche jamais et le bot, à juste titre, ne fait rien. Freya exécute ce qui arrive ; il ne peut pas exécuter ce qui n'arrive jamais.

Les signaux de fermeture manqués sont le bord le plus tranchant. En mode Signal personnalisé, si votre signal d'ouverture arrive mais que votre signal de fermeture n'arrive jamais, la position reste ouverte. Un stop-loss configuré dans les paramètres d'ordre de votre bot est un filet de sécurité qui ne dépend pas de l'arrivée d'un second webhook : il vaut la peine d'être en place dans la plupart des configurations.

Les alertes à usage unique cessent de se déclencher. Une alerte TradingView réglée pour se déclencher « Une seule fois » est terminée après un seul signal, jusqu'à ce que vous la recréiez. Pour une stratégie récurrente, choisissez une option de déclenchement répété et vérifiez la date d'expiration de l'alerte.

Sécurité : votre URL de webhook est un secret

Une URL de webhook est la clé pour déclencher votre bot. Il n'y a aucun mot de passe par-dessus : la possession de l'URL est l'identifiant.

• Ne partagez ni ne publiez jamais une URL de webhook, pas dans une capture d'écran des paramètres d'alerte, pas dans une mise en page de graphique partagée, ni dans un message de chat demandant de l'aide. Floutez-la ou recadrez-la d'abord.
• Ne la collez que dans des outils que vous contrôlez, comme vos propres alertes TradingView.
• Régénérez-la immédiatement si vous soupçonnez une exposition : l'ancienne URL cesse aussitôt de fonctionner. Mettez ensuite vos alertes à jour avec la nouvelle.

Dépannage : l'alerte s'est déclenchée mais rien ne s'est tradé

La cause figure presque toujours dans une courte liste. Parcourez-la dans l'ordre :

1. Le bot tourne-t-il ? Un bot en pause ou arrêté ignore les signaux entrants : c'est le coupable le plus fréquent.
2. Bonne URL, bon emplacement ? Une alerte d'entrée pointée vers l'URL de fermeture n'ouvrira jamais de position. Confirmez Ouverture contre Fermeture, et confirmez que l'URL a été collée intégralement.
3. Avez-vous régénéré récemment ? La régénération invalide instantanément l'ancienne URL. Si votre alerte détient encore l'ancienne, ses messages ne vont nulle part.
4. Le format du message correspond-il ? Surtout en mode Risk Ratio, le message doit correspondre à la structure JSON de l'écran de configuration de votre bot. Un message malformé est ignoré.
5. Votre forfait TradingView peut-il envoyer des webhooks tout court ? Sinon, l'alerte se déclenche visuellement mais aucun message n'est envoyé. Vérifiez aussi si l'alerte a expiré ou a été réglée sur « Une seule fois ».
6. Minimums de l'exchange. Si votre montant configuré, ou la taille auto-calculée en Risk Ratio, tombe sous la taille d'ordre minimale de la paire, l'exchange rejette l'ordre.

Pour les problèmes de statut de bot au-delà des webhooks, consultez Pourquoi mon bot ne trade-t-il pas ?

Questions fréquentes

Ai-je besoin d'un forfait TradingView payant pour utiliser les bots webhook ?

Si TradingView est votre source de signal, le niveau de forfait compte : les notifications webhook ne font pas partie de tous les forfaits, et les alertes du niveau gratuit ont des limites et des règles d'expiration plus strictes. Avant de bâtir votre automatisation autour des alertes, ouvrez la comparaison des forfaits de TradingView et confirmez que les notifications webhook sont incluses dans le vôtre. Vérifiez aussi votre quota d'alertes si vous faites tourner plusieurs paires. Cela dit, côté bot, peu importe qui envoie le message. Le bot signal de Freya répond aux appels de webhook de n'importe quelle source : une autre plateforme de graphiques, votre propre script, ou tout outil capable d'envoyer un webhook. Un forfait TradingView payant est donc une exigence de la fonction webhook de TradingView, pas de Freya. Si votre forfait n'inclut pas les webhooks, vos alternatives sont de passer à un forfait supérieur, de changer de source de signal, ou de construire la logique à l'intérieur de Freya avec des déclencheurs basés sur des indicateurs au lieu de signaux externes.

Quelle est la différence entre les URL de webhook d'ouverture et de fermeture ?

En mode Signal personnalisé, votre bot expose deux URL distinctes avec deux rôles distincts. Un message vers l'URL de webhook d'ouverture ouvre une position en utilisant les paramètres d'ordre que vous avez configurés dans Freya, à savoir le montant de la transaction plus tout take-profit et stop-loss que vous avez définis. Un message vers l'URL de webhook de fermeture ferme la position que le bot a ouverte. Elles ne sont pas interchangeables : une alerte d'entrée pointée vers l'URL de fermeture n'ouvrira jamais de transaction. Le mode Risk Ratio fonctionne différemment : il n'y a qu'une seule URL, utilisée pour le signal d'entrée, et aucune URL de fermeture n'existe parce que la sortie est gérée automatiquement par le take-profit et le stop-loss transportés dans le message du webhook. Les deux URL peuvent être copiées et régénérées indépendamment ; la régénération crée une nouvelle URL et invalide immédiatement l'ancienne, alors mettez ensuite à jour l'alerte TradingView correspondante.

Mon alerte TradingView peut-elle définir le take-profit et le stop-loss ?

Oui, c'est exactement à cela que sert le mode Risk Ratio. Dans ce mode, votre message d'alerte est une petite charge utile JSON qui transporte les prix de take-profit et de stop-loss, et l'écran de configuration de Freya fournit le Modèle de corps JSON à copier dans votre alerte. Quand le signal arrive, l'entrée est prise au prix du marché, et les sorties sont placées à partir des valeurs de votre signal : le take-profit comme ordre limite au prix exact que vous avez envoyé, et le stop-loss comme ordre au marché quand son prix de déclenchement est atteint. Parce que le stop s'exécute au marché, il peut subir du slippage lors d'un mouvement rapide, comme n'importe quel ordre stop. En mode Signal personnalisé, le webhook ne peut pas définir les niveaux de sortie ; le take-profit et le stop-loss proviennent des paramètres d'ordre que vous configurez à l'intérieur de Freya, et vos alertes se limitent à dire quand ouvrir et quand fermer.

Est-il sûr de coller mon URL de webhook dans TradingView ?

Coller l'URL dans votre propre alerte TradingView est l'usage prévu : c'est l'intégration qui fonctionne comme conçue. Le vrai risque, c'est l'exposition, pas le collage lui-même. Une URL de webhook n'a aucun mot de passe par-dessus : quiconque détient l'URL peut déclencher cette action sur votre bot. Les voies de fuite courantes sont banales : une capture d'écran des paramètres d'alerte partagée dans un chat, une publication publique demandant de l'aide, ou une mise en page de graphique partagée. Traitez chaque URL comme un mot de passe : gardez-la hors des captures d'écran, ne la partagez avec personne, et ne la collez que dans des outils que vous contrôlez personnellement. Si vous soupçonnez un jour qu'une URL a été vue par quelqu'un d'autre, régénérez-la immédiatement (l'ancienne URL cesse de fonctionner au moment où la nouvelle est créée), puis mettez à jour votre alerte avec le remplacement avant que votre prochain signal ne se déclenche.

Pourquoi mon alerte s'est-elle déclenchée mais aucune transaction n'a eu lieu ?

Commencez par le bot lui-même : un bot en pause ou arrêté ignore complètement les signaux, c'est la cause la plus fréquente. Ensuite, vérifiez la tuyauterie : l'alerte doit détenir la bonne URL, complète (Ouverture, pas Fermeture, pour les entrées), et si vous avez régénéré récemment, l'alerte pointe peut-être encore vers l'URL morte. Vérifiez ensuite le message : particulièrement en mode Risk Ratio, la charge utile doit correspondre au modèle JSON de l'écran de configuration de votre bot, sinon le signal est ignoré. Côté TradingView, confirmez que votre forfait envoie bien des webhooks et que l'alerte n'a pas expiré ni tiré son unique déclenchement « Une seule fois ». Enfin, si votre montant, ou la taille auto-calculée en Risk Ratio, est sous le minimum de l'exchange pour la paire, l'ordre est rejeté. Le journal d'activité de votre bot vous indique quel côté a échoué : un signal enregistré signale un problème d'exécution ; l'absence d'entrée de journal signifie que le signal n'est jamais arrivé.

Mes signaux doivent-ils obligatoirement provenir de TradingView ?

Non. TradingView est la source la plus populaire parce que son système d'alertes est flexible et piloté par le graphique, mais le bot signal de Freya répond aux appels de webhook quelle qu'en soit l'origine. Tout outil capable d'envoyer un webhook fonctionne : une autre plateforme de graphiques, un script personnalisé, un screener avec notifications webhook, ou un système de signaux interne. Le contrat est le même dans tous les cas : appeler l'URL d'ouverture ou de fermeture en mode Signal personnalisé, ou envoyer la charge utile JSON attendue avec les valeurs de take-profit et de stop-loss vers l'URL unique en mode Risk Ratio. Deux mises en garde s'appliquent à toute source. Premièrement, la question de la fiabilité ne disparaît pas : votre bot ne peut exécuter que les signaux qui arrivent réellement, donc la disponibilité de votre source est la disponibilité de votre stratégie. Deuxièmement, la règle de sécurité est universelle : quel que soit l'outil que vous utilisez, l'URL de webhook ne va que dans des systèmes que vous contrôlez et auxquels vous faites confiance.

Où aller ensuite

Un bot webhook ne vaut que ce que vaut la stratégie qui l'alimente. Mettez votre logique de signal à l'épreuve de l'histoire avec Comment backtester votre stratégie de trading crypto, et lisez le guide complet dans Comment créer un bot signal sur Freya Finance si vous avez sauté un détail de configuration. Si vous préférez construire la logique d'entrée à l'intérieur de Freya, le Guide de stratégie bot DCA couvre cette approche en profondeur. Et pour les questions de conservation des fonds et de permissions de clé API, consultez Mon argent est-il en sécurité sur Freya Finance ?