Documentation

Moteur de Risque & Référence Webhook

Comment AlgoVesta vérifie chaque signal avant l'exécution, et le payload JSON exact à envoyer depuis TradingView ou toute source webhook. Les noms de champs sont littéraux — copiez-les tels quels.

AlgoVesta exécute des trades depuis trois canaux de déclenchement : un serveur MCP pour les assistants IA, les signaux Telegram et les webhooks TradingView. Quel que soit le canal qui se déclenche, le même moteur de risque côté serveur vérifie l'ordre avant qu'il n'atteigne votre bourse ou votre compte MetaTrader 5. Cette page est le hub de référence technique pour les trois.

Trois façons de déclencher un trade

Chaque canal se termine par le même chemin d'exécution : vérification, dimensionnement, ordre, puis stop-loss et take-profit placés directement sur la plateforme. Choisissez le canal qui correspond à votre façon de travailler.

Serveur MCP pour assistants IA

Connectez Claude, ChatGPT, Cursor ou tout client compatible MCP à vingt outils de trading natifs via une liaison authentifiée unique. Chaque connexion démarre avec un solde fictif de 5 000 $, et les clés réelles sont créées séparément avec un second facteur. L'authentification se fait soit par OAuth 2.1 avec PKCE (S256), soit par un lien secret propre à chaque utilisateur.

Canaux de signaux Telegram

Pointez AlgoVesta vers les canaux de signaux que vous suivez déjà. Les messages sont analysés pour en extraire un symbole, une direction, une entrée, un stop-loss et des objectifs, puis exécutés sur votre bourse ou transmis à MetaTrader 5. Les signaux qui ne peuvent pas être analysés sans ambiguïté sont rejetés plutôt que devinés.

Webhooks TradingView

Envoyez une alerte depuis n'importe quel indicateur, dessin ou stratégie Pine vers votre URL de webhook privée. Le corps de l'alerte doit être du JSON valide au format documenté ci-dessous, et la source de chaque signal auto-tradé est vérifiée avant l'ouverture d'un ordre.

Moteur de Risque : comment un signal est vérifié

Un signal n'est jamais exécuté aveuglément. Avant de placer un ordre, il traverse une couche de vérification multi-module qui le confronte aux conditions de marché en direct et aux limites que vous définissez. Si une règle stricte échoue, le signal est rejeté — pas réduit.

Scoring neuronalun score de confiance de 0–100 issu d'un modèle.
Volume & flux d'ordrespics de volume et déséquilibre des transactions agressives (VPIN).
Régime de marchéclassification tendance vs range vs retour à la moyenne.
Financement et liquidationdynamique du taux de funding et clusters de liquidation.
Cartographie du stop-lossévite de placer des stops dans des clusters de liquidité connus.
Vos règles strictessens, heures de session, limites de position et de drawdown.

L'ensemble exact des modules et des seuils évolue avec l'ajustement de la plateforme. Le principe est constant : vos règles et limites de risque s'appliquent toujours avant qu'un ordre n'atteigne votre exchange.

Perte quotidienne & protection contre le drawdown

Au-delà des vérifications par signal, deux protections au niveau du compte fonctionnent en continu.

Limite de perte quotidienneLorsque votre perte réalisée du jour atteint la limite configurée — un pourcentage du solde ou un montant fixe — AlgoVesta passe en Mode Sécurisé et cesse d'ouvrir de nouvelles positions jusqu'au lendemain.
Dimensionnement selon le drawdownÀ mesure que le drawdown du compte augmente, la taille de position est automatiquement réduite par paliers (prudent → défensif → survie), de sorte qu'une série de pertes réduit votre exposition au lieu de l'aggraver.

Référence du payload webhook

Envoyez un HTTP POST avec un corps JSON vers votre URL webhook AlgoVesta. Depuis TradingView, collez ceci dans le champ message de l'alerte. Les noms de champs doivent correspondre exactement.

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }
ChampRequisDescription
symbolOuiPaire de trading de l'exchange, ex. BTCUSDT.
side / actionOuiSens de l'ordre : buy ou sell.
priceOptionnelPrix de référence d'entrée ; omettre pour une entrée au marché.
stop_lossOptionnelPrix du stop-loss. Recommandé sur chaque signal.
take_profitOptionnelPrix du take-profit. Cibles multiples configurables dans l'app.
marketOptionnelMarché cible : crypto (par défaut) ou forex. Envoyé à MetaTrader 5 lorsque défini sur forex. Jamais déduit du symbole.
lotsOptionnelForex uniquement — taille de la position en lots. Omettez ce champ pour utiliser votre mode de lot/risque configuré.
leverageOptionnelCrypto uniquement — la limite de votre plateforme pour ce symbole s'applique.
amount_usdOptionnelCrypto uniquement — marge, pas le notionnel. Notionnel = marge × effet de levier.
risk_percentOptionnelCrypto uniquement — % du solde à risquer (0,1–50).
quantityOptionnelCrypto uniquement — quantité exacte de contrats. qty, size et contracts sont acceptés comme alias.
take_profitsOptionnelCibles multiples : [{"price":…, "close_pct":…}]. tp1tp5 avec tpN_close fonctionnent aussi.
trailingOptionnel{"trigger_pct":…, "distance_pct":…} — stop suiveur.
breakevenOptionneltrue ou {"trigger_pct":…} — déplace le stop au niveau d'entrée une fois en profit.

Les préfixes de plateforme sont supprimés : BINANCE:BTCUSDT fonctionne comme BTCUSDT. Pour le champ de direction, direction et type sont acceptés comme alias de action, et close est une valeur valide.

La taille de position, l'effet de levier et le risque par signal peuvent provenir de votre tableau de bord ou du payload — une valeur présente dans le payload est prioritaire. C'est pourquoi l'URL du webhook est un secret : ajoutez une liste blanche d'IP pour qu'AlgoVesta n'exécute automatiquement que les signaux dont la source peut être vérifiée.

Clôturer une position

Envoyez "action": "close" avec le symbole. Toute la position sur ce symbole est clôturée — les clôtures partielles ne sont pas prises en charge ; si vous en demandez une, la position entière est clôturée et le panneau l'indique.

{ "symbol": "BTCUSDT", "action": "close" }

Alertes de stratégie Pine — les sorties sont automatiques

Si vous créez l'alerte à partir d'une strategy() Pine avec « Order fills only », n'envoyez pas action seul : {{strategy.order.action}} renvoie aussi sell lors d'une sortie, ce qui ouvrirait un short au lieu de clôturer. Incluez les champs d'état de position et AlgoVesta déterminera pour vous l'entrée, la sortie et le retournement.

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }
Position après l'exécutionCe que fait AlgoVesta
flat (or position_size = 0)Clôture la position. Aucun ordre inverse n'est ouvert.
Opposé de l'état précédentRetournement — clôture d'abord, puis ouvre la nouvelle direction. Si la clôture échoue, rien n'est ouvert.
Même direction qu'avantTraité comme une entrée dans cette direction.

Le message doit être au format JSON. TradingView envoie le corps de l'alerte en texte brut lorsqu'il ne s'agit pas de JSON valide — son message par défaut (par ex. « BTCUSDT Crossing 1.00 ») ne porte aucune direction et est rejeté. Nous ne devinons jamais sur un texte ambigu ; rejeter un signal est plus sûr que d'ouvrir un ordre dans la mauvaise direction. Notez aussi que TradingView arrête automatiquement les alertes après 15 déclenchements en 3 minutes.

Sans code
N'écrivez pas le JSON à la main — construisez-le visuellement

Réglez la direction, le take-profit / stop-loss (simple ou multi-niveaux), l'effet de levier, la taille de position, le trailing et le breakeven avec de simples boutons. AlgoVesta génère le message d'alerte TradingView exact — copiez-le et collez-le dans votre alerte.

Voir comment fonctionne le générateur visuel → Configuration d'alerte pas à pas →

Questions fréquentes

Quels canaux peuvent déclencher un trade sur AlgoVesta ?

Trois : le serveur MCP utilisé par les assistants IA, les canaux de signaux Telegram et les webhooks TradingView. Un trade peut aussi être ouvert manuellement depuis votre tableau de bord. Chaque canal passe par le même chemin d'exécution et les mêmes contrôles de risque.

Le format JSON du webhook est-il obligatoire pour TradingView ?

Oui. TradingView envoie le corps de l'alerte en texte brut lorsqu'il ne s'agit pas de JSON valide, et son message d'alerte par défaut ne porte aucune direction, il est donc rejeté. Utilisez le format de payload documenté ci-dessus dans la référence de payload webhook, ou construisez-le visuellement et collez le résultat dans votre alerte.

Le moteur de risque s'applique-t-il aussi aux ordres MCP et Telegram ?

Oui — les mêmes contrôles côté serveur s'exécutent sur chaque canal. Votre politique de risque, l'exigence de stop-loss ainsi que vos limites de position et de drawdown sont appliquées avant qu'un ordre n'atteigne une plateforme, qu'il provienne d'un assistant IA, d'un signal Telegram ou d'une alerte TradingView. Aucun prompt ni message ne peut les assouplir.

Où trouver la référence complète des outils MCP ?

La référence développeur MCP documente les 20 outils, les trois scopes, l'authentification OAuth 2.1 et par lien secret, les limites de débit, les codes d'erreur ainsi que les 16 bourses prises en charge plus MetaTrader 5.

Puis-je tester sans argent réel ?

Oui. Chaque connexion MCP démarre avec un solde fictif virtuel de 5 000 $ à des prix de marché réels, et l'automatisation TradingView comme Telegram disposent toutes deux d'un mode démo qui simule l'intégralité du flux, du signal jusqu'à l'ordre. Le trading réel nécessite toujours une clé ou une connexion distincte créée explicitement.