Documentation · Référence

Référence de syntaxe des commandes

Commandes, alias et exemples acceptés par le parser WebhookIngress actuel.

Vidéo YouTube (domaine sans cookie), chargée seulement quand vous lancez la lecture.
Tutoriel sans voix — tout est écrit à l'écran.

Objectif

Cette référence liste les commandes et alias acceptés par WebhookIngress. Elle décrit l'entrée webhook TradingView, pas les ordres manuels du dashboard.

Le constructeur de message du dashboard
Le constructeur de message du dashboard

Commandes marché et pending

  • buy accepte aussi long.
  • sell accepte aussi short.
  • buystop accepte aussi buy_stop.
  • buylimit accepte aussi buy_limit.
  • sellstop accepte aussi sell_stop.
  • selllimit accepte aussi sell_limit.
  • Un ordre en attente peut porter expiration, sa durée de vie en minutes (robot 0.0.30 ou plus récent) : voir la page du format du webhook.

Clôture, annulation et modification

  • closelong accepte aussi close_long.
  • closeshort accepte aussi close_short.
  • closelongshort accepte aussi close_long_short.
  • cancellong accepte aussi cancel_long.
  • cancelshort accepte aussi cancel_short.
  • newsltplong accepte newsltp_long, breakevenlong, breakeven_long, break_even_long.
  • newsltpshort accepte newsltp_short, breakevenshort, breakeven_short, break_even_short.

Commandes étendues

Les scripts qui utilisent déjà ces commandes et ces noms de paramètres tournent ici sans modification. Les noms sl_pips, sl_price, sl_pct, tp_pips, tp_price, tp_pct, entry_pips, entry_price et vol_lots sont traduits automatiquement, et chaque commande accepte aussi sa forme soulignée (close_all, newsltp_buy_stop, ...). Une exception : une alerte qui mélange les unités de prix (sl_pips avec tp_price, par exemple) est désormais refusée.

  • Sortir puis entrer, en une seule alerte : closelongopenlong, closelongopenshort, closeshortopenlong, closeshortopenshort, closelongshortopenlong, closelongshortopenshort, cancellongbuystop, cancellongbuylimit, cancelshortsellstop, cancelshortselllimit.
  • Tout aplatir : closeall ferme toutes les positions et supprime tous les ordres en attente, tous symboles confondus. closealleaoff fait la même chose puis met le robot en pause.
  • Clôture partielle : closelongpct, closeshortpct. La part vient du réglage de compte Clôture partielle (%) — ces alertes ne la portent pas. Un volume dans l'alerte reste prioritaire.
  • SL/TP sur un ordre en attente : newsltpbuystop, newsltpbuylimit, newsltpsellstop, newsltpselllimit. Elles ne déplacent jamais le prix d'entrée de l'ordre.
  • Couper / reprendre depuis une alerte : eaoff, eaon. La portée est le compte entier.
  • Trailing sur une seule position : trailingoff, trailingon, avec le ticket de l'ordre. Le stop déjà en place ne bouge pas ; le robot cesse simplement de le suivre.
  • Taille écrite dans l'alerte : vol_dollar (montant risqué, en devise du compte), vol_pct_bal_loss (% du solde), vol_pct_eq_loss (% de l'équité), vol_pct_bal_margin (% du solde consommé en marge — une limite d'exposition, qui ignore la distance du stop). L'alerte prime sur les réglages de risque du compte.
  • Protection écrite dans l'alerte : spread plafonne le spread accepté à l'entrée, en pips. betrigger / beoffset remontent le stop au point mort ; trailtrig / traildist / trailstep le font suivre — les cinq en pips, sur cette position seulement. atrtimeframe / atrperiod / atrmultiplier / atrshift / atrtrigger le font suivre à un multiple de l'ATR. Elles fonctionnent même si le trailing du compte est éteint.
  • Version du robot : taille et protection par alerte demandent le robot 0.0.21 ou plus récent. Un robot antérieur les ignore et joue l'alerte avec les réglages du compte.

Plusieurs stratégies sur le même symbole

Deux stratégies qui traitent la même paire vivent sur un seul compte : un closelong sans nom ferme donc la première position acheteuse qu'il trouve — peut-être celle de l'autre stratégie. Nommez chaque stratégie avec tag (alias comment) pour les séparer : à l'entrée, le robot inscrit ce nom dans le commentaire de la position chez le courtier, et une fermeture nommée ne touche que les positions qui le portent.

  • Mettez le même nom dans toutes les alertes d'une stratégie, entrées comme sorties. Une fermeture dont le nom n'est jamais apparu à l'entrée ne ferme rien.
  • Les noms sont mis en minuscules et coupés à 12 caractères ; tout ce qui n'est ni lettre, ni chiffre, ni -, ni _ est retiré. Strat A et strata sont donc le même nom — choisissez des noms courts et distincts.
  • Une fermeture nommée nécessite le robot 0.0.21 ou plus récent. Avec un robot plus ancien, l'alerte est refusée plutôt que jouée sur la position d'une autre stratégie.
  • Le nom suit la réplication : les positions répliquées sur une Cible portent le nom de la Source.
  • N'envoyez pas votre propre streamId avec un nom — il remplace celui qui est généré, et le nom n'atteint alors jamais le commentaire de la position.
  • Sans nom, rien ne change : une fermeture prend toujours la première position dans le sens demandé.

Alerte d'entrée de la stratégie trend :

json
{"action":"buy","symbol":"USDJPY","risk":1,"tag":"trend"}

Son alerte de sortie, qui laisse l'autre stratégie tranquille :

json
{"action":"closelong","symbol":"USDJPY","tag":"trend"}

Exemple marché

json
{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 0.2,
  "tp": 0.4,
  "priceMode": "percent"
}

priceMode donne l'unité de sl, tp et price dans l'alerte elle-même : price, pips ou percent. Ici, le stop est à 0,2 % de l'entrée et l'objectif à 0,4 %, quel que soit le mode de prix du compte ; sans priceMode, c'est le mode de prix du compte qui s'applique.

Le même message, généré par le dashboard — rien à écrire à la main
Le même message, généré par le dashboard — rien à écrire à la main

Exemple pending

json
{
  "action": "buystop",
  "symbol": "EURUSD",
  "price": 1.0875,
  "risk": 1,
  "sl": 1.0840,
  "tp": 1.0940,
  "priceMode": "price"
}

Exemple clôture

json
{
  "action": "closelong",
  "symbol": "EURUSD",
  "ticket": "123456789"
}

Notes parser

  • La clé d'accès se met dans l'URL Webhook : https://webhook.theconnector.fr/VOTRE_CLE_D_ACCES.
  • risk est numérique ; les lots exacts passent par volume, lot, lots ou fixedVolume.
  • price est nécessaire uniquement pour les ordres pending.
  • ttl_ms n'est pas lu par le parser actuel. Chaque prix garde l'unité dans laquelle il est écrit — un suffixe (sl_pips, tp_price…) pour cette seule valeur, sinon priceMode, sinon le mode de prix du compte — et une alerte dont les prix demandent deux unités (sl_pips avec tp_price, par exemple) est refusée, jamais envoyée sans son stop ou son objectif : mettez un suffixe sur tous les prix, ou sur aucun.
  • Une commande arrivée trop tard expire ; elle n'est pas rejouée.

Un cas broker spécifique ? Contacter le support