Créer une liste d’alertes de prix¶

Une liste d’alertes de prix regroupe les niveaux de cours que vous souhaitez surveiller sans devoir garder le graphique sous les yeux. Ce guide vous aide à sélectionner des symboles, à vérifier leur précision de cotation et leurs horaires de trading, puis à activer une alerte pour chaque niveau. Il se termine par un script qui recrée toute la liste en une seule exécution.

export CTID=letstrade
export ACC=7654321
export PWD_FILE=$HOME/.ctrader/pwd

1. Sélectionner les symboles à surveiller ¶

symbols répertorie tous les instruments disponibles sur le compte. Enregistrez le résultat pour choisir les noms exacts à utiliser dans les étapes suivantes.

ctrader-cli symbols --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC > symbols.txt

Utilisez les noms exactement tels qu’ils apparaissent ici. Si un nom ne correspond pas, la commande renvoie Unknown symbol name.

2. Consulter les cours actuels des symboles sélectionnés ¶

prices renvoie en un seul appel les cours vendeur (Bid) et acheteur (Ask) actuels de plusieurs symboles. Vous pouvez ainsi définir vos niveaux par rapport au marché en temps réel plutôt que de mémoire.

ctrader-cli prices --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --symbols=EURUSD,GBPUSD,XAUUSD

Pour un seul instrument, utilisez plutôt price avec --symbol.

ctrader-cli price --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --symbol=EURUSD

3. Vérifier la précision de cotation du symbole ¶

symbol affiche les informations d’un instrument, notamment le nombre de décimales utilisé pour sa cotation. Adaptez le prix de l’alerte à cette précision pour définir exactement le niveau souhaité.

ctrader-cli symbol --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --symbol=XAUUSD

4. Vérifier les heures d’ouverture du marché ¶

sessions répertorie les séances de trading d’un symbole, avec leurs heures d’ouverture et de fermeture. Un niveau défini pendant une séance fermée ne sera pas testé avant la réouverture du marché. C’est particulièrement important pour les métaux, les indices et les instruments dont la cotation est interrompue le week-end.

ctrader-cli sessions --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --symbol=XAUUSD

5. Activer une alerte pour chaque niveau ¶

alert create prend en paramètres le symbole, le cours et la condition de déclenchement. Ajoutez --message pour décrire l’alerte et reconnaître son objectif lorsqu’elle se déclenche, et --yes pour ignorer la demande de confirmation dans un script.

La condition est above ou below. Les alertes comparent le cours vendeur (Bid) du symbole au niveau défini.

ctrader-cli alert create --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --symbol=EURUSD --price=1.1050 --condition=above \
    --message="EURUSD breaks range high" --yes

Répétez l’opération pour chaque niveau de chaque symbole. Une alerte correspond à un seul niveau de prix sur un seul symbole.

6. Vérifier la liste et supprimer les alertes obsolètes ¶

alerts affiche toutes les alertes actuellement actives sur le compte. Exécutez cette commande après chaque modification pour vérifier que la liste correspond à vos intentions.

ctrader-cli alerts --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q

Supprimez une alerte à l’aide de son identifiant lorsque son niveau a été atteint ou que le scénario envisagé n’est plus pertinent.

ctrader-cli alert delete --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --alert=44556677 --yes

Pour repartir d’une liste vide, all supprime toutes les alertes du compte.

ctrader-cli alert delete all yes --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q

Dans le shell interactif, la même commande s’écrit > alert delete all yes.

7. Recréer toute la liste d’alertes avec un script ¶

Enregistrez la séquence sous le nom price-alert-list.sh. Le script efface les anciennes alertes, active chaque niveau défini dans le tableau PRICE_ALERT_LIST et affiche le résultat. Une seule exécution suffit ainsi pour obtenir la liste configurée au début du script.

Chaque entrée contient un symbole, un prix, une condition et un message, séparés par |.

#!/usr/bin/env bash
set -euo pipefail

CTID=letstrade
ACC=7654321
PWD_FILE=$HOME/.ctrader/pwd

PRICE_ALERT_LIST=(
    "EURUSD|1.1050|above|EURUSD breaks range high"
    "EURUSD|1.0900|below|EURUSD loses range low"
    "XAUUSD|2400.00|above|Gold at round number"
)

cli() {
    ctrader-cli "$@" --ctid="$CTID" --pwd-file="$PWD_FILE" --account="$ACC" -q
}

# Start from a clean list so the array below is the single source of truth.
cli alert delete all yes

# Arm every level in the price-alert list.
for ENTRY in "${PRICE_ALERT_LIST[@]}"; do
    IFS='|' read -r SYMBOL PRICE CONDITION MESSAGE <<< "$ENTRY"
    echo "Arming $SYMBOL at $PRICE ($CONDITION)"
    cli alert create --symbol="$SYMBOL" --price="$PRICE" \
        --condition="$CONDITION" --message="$MESSAGE" --yes
done

# Confirm what is armed.
cli alerts

Exécutez bash price-alert-list.sh chaque fois que vos niveaux changent. Comme le script supprime toutes les alertes avant de les recréer, modifiez le tableau plutôt que d’ajouter des alertes manuellement : elles seraient effacées lors de la prochaine exécution.

La documentation de référence de cTrader CLI présente toutes les options disponibles pour les commandes utilisées dans cette procédure.