Payload webhook TradingView

Objectif

Cette page documente le contrat public WebhookIngress pour les alertes TradingView. Ce n'est pas le payload des ordres manuels du dashboard.

Chemin d'accès

• Dans l'espace client : Mes comptes > ouvrir un compte de trading > copier la clé d'accès.
• Dans TradingView : Alerte > Notifications > coller https://webhook.theconnector.fr/VOTRE_CLE_D_ACCES dans Webhook URL.
• Dans le champ Message de TradingView, coller le JSON.

JSON minimal

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 20,
  "tp": 40
}

Champs lus par WebhookIngress

• action est obligatoire. Alias acceptés : side, type, command, msgtype.
• symbol est obligatoire pour les commandes trading. Alias acceptés : pair, ticker, instrument, market, asset.
• risk est transmis comme risque numérique. Pour des lots exacts, utilisez volume, lot, lots ou fixedVolume.
• sl et tp sont les noms actuels de stop loss / take profit. Alias acceptés : stoploss, stop_loss, takeprofit, take_profit.
• price sert uniquement aux ordres pending : buystop, buylimit, sellstop, selllimit.
• ticket, orderId, order_id, positionId ou position_id servent uniquement si l'instruction vise un ordre ou une position connue.
• account / accountCode et platform sont optionnels avec l'URL du compte ; ils servent surtout aux routages partagés.
• streamId ou id peut être envoyé pour le suivi. S'il manque, le serveur crée un identifiant.
• tag (alias comment) nomme la stratégie à laquelle appartient l'alerte. À l'entrée, il est écrit dans le commentaire de la position chez le courtier ; à la fermeture, il restreint la fermeture aux positions portant ce nom, donc plusieurs stratégies peuvent partager un compte et un symbole. Il est mis en minuscules et coupé à 12 caractères, et il est honoré à partir du robot 0.0.21 — en dessous, une fermeture nommée est refusée plutôt que jouée sur la position d'une autre stratégie. Si vous envoyez votre propre streamId, il remplace celui qui est généré et le nom n'atteint jamais le commentaire de la position : omettez streamId quand vous utilisez des noms.
• clientRequestedAtUtc, requestedAtUtc ou requestedAt peuvent être envoyés comme horodatage UTC informatif.

Alternative en une ligne

JSON est recommandé, mais WebhookIngress accepte aussi le texte séparé par virgules :

buy,EURUSD,risk=1,sl=20,tp=40

À ne pas envoyer

Ne vous basez pas sur ttl_ms, vol_lots, sl_pips ou tp_pips : le parser WebhookIngress actuel ne lit pas ces noms. Utilisez le mode de prix du compte pour définir comment sl, tp et price sont interprétés par le robot.

Scripts tiers existants

Ne partez pas du principe qu'un message prévu pour un autre connecteur est compatible tel quel. Gardez la logique de stratégie si besoin, mais vérifiez et adaptez les champs TradingView ci-dessus.