Spécifications des messages d'alerte de trading du Signal Bot

Introduction

Un aperçu express du Pine Script : "Strategy" vs "Indicator"

Avec le lancement de Signal Bots, les utilisateurs de TradingView peuvent désormais publier leurs signaux et créer un Signal Bot sur BloFin. Dans ce guide, nous allons passer en revue les différentes spécifications des messages d'alerte que BloFin prend en charge pour les utilisateurs.

Pour ceux qui connaissent bien PineScript et qui utilisent exclusivement des scripts de stratégie pour envoyer des signaux, nous avons méticuleusement conçu un format avec des spécifications exclusives. Ce format intègre de manière transparente les paramètres de stratégie de PineScript, ce qui vous permet de transmettre des signaux de trading avec une facilité remarquable. Si vous êtes un utilisateur natif de la stratégie PineScript, ce format sera votre compagnon idéal, fournissant une approche simplifiée pour fusionner vos scripts de stratégie avec les paramètres de stratégie de TradingView.

Les stratégies de Pine Script servent à faire du backtesting sur des données historiques ainsi que des tests anticipés sur des marchés en live. En plus d'effectuer des calculs d'indicateurs, les stratégies comprennent des appels aux strategy.*() functions qui transmettent les ordres de transaction au Pine Script's broker emulator. Cet émulateur peut alors simuler l'exécution de ces ordres. Les résultats des backtests sont visualisés dans l'onglet "Strategy Tester" situé en bas de la chart, à côté de l'onglet "Pine Script Editor".

D'autre part, les indicateurs Pine Script impliquent également des calculs, mais ils ne sont pas destinés à être utilisés dans des scénarios de backtesting. En raison de leur indépendance par rapport à l'émulateur du broker, les indicateurs consomment moins de ressources et s'exécutent plus rapidement. 

Il est important de remarquer que vous avez la possibilité d'utiliser l'un ou l'autre des formats. En fonction des messages que vous transmettrez, le système discernera intelligemment le format utilisé et analysera vos messages en conséquence. Ce traitement intelligent garantit une expérience transparente, quelle que soit l'approche choisie.

Utilisateurs de la stratégie PineScript

Les spécifications suivantes sont spécialement conçues pour les utilisateurs qui composent leurs algorithmes à l'aide de stratégies PineScript et principalement avec la strategy.* function. Ce format est dédié à recevoir les valeurs des paramètres de la stratégie, garantissant ainsi une adaptabilité parfaite. Pour une compréhension plus approfondie des scripts de stratégie et du processus d'envoi d'alertes à l'aide de variables pouvant recevoir la stratégie, vous pouvez trouver des informations supplémentaires sur TradingView via ce lien.

Aperçu des spécifications d'AlertMsg

InvestmentType sera défini par défaut sur "percentage_investment" si le signal est considéré comme un signal d'entrée et en "percentage_position" si le signal est considéré comme un signal de sortie. Il est toutefois fortement recommandé de définir cette valeur pour "base" et le montant à "{{strategy.order.contracts}}" pour une compatibilité maximale avec votre stratégie TradingView.

1. Spécification de l’AlertMsg - id

id - L'identifiant de l'ordre

{{strategy.order.id}} - renvoie l'ID de l'ordre exécuté (la string utilisée comme premier paramètre dans l'un des appels de fonction générant des ordres : strategy.entry, strategy.exit ou strategy.order).

2. Spécification d’AlertMsg - action

action - Acheter ou vendre ?

{{strategy.order.action}} - renvoie la string "buy" ou "sell" pour l'ordre exécuté.

3. Spécification d’AlertMsg - marketPosition

marketPosition - État de la position prévue (lors de l'exécution de l'ordre)

{{strategy.market_position}} renvoie la position actuelle de la stratégie sous forme d’une string de caractères : "long", "flat", or "short".

4. Specification d’AlertMsg  - prevMarketPosition

prevMarketPosition - État de la position précédente (avant l'exécution de l'ordre)

{{strategy.prev_market_position}} renvoie la position précédente de la stratégie sous forme d’une string de caractères: "long", "flat", or "short".

5. Spécification d’AlertMsg  - instrument

Format 1: ticker - TradingView valeurs du placeholder 

Un 'standard placeholder'* est un texte littéral entouré de doubles accolades et inclus dans un message d'alerte.

"{{ticker}}" renvoie le Ticker de l'instrument sur lequel l'alerte a été générée.

Par exemple: "BTCUSDT.P", "ETHUSDT.P".

Le Placeholder Standard pour accéder aux variables dans PineScript. Pour en savoir plus, cliquez ici.

Format 2: Format des instruments BloFin

Instrument ID, ou "instId" dans l'API BloFin.

Par exemple: "BTC-USDT", "ETH-USDT".

6. Spécification d’AlertMsg  - signalToken

Le jeton est une mesure de sécurité qui garantit que les demandes entrantes sont légitimes et autorisées. Ce signalToken sera généré automatiquement lorsque l'utilisateur crée avec succès un nouveau signal sur notre plateforme, et il doit être copié dans le message d'alerte de TradingView.

Comment localiser votre signalToken pour un signal déjà existant ?

1. Consultez la section Détails de votre signal

2. Localisez votre signalToken dans la section des messages d'alerte recommandés.

7. Specification d’AlertMsg - timestamp

timenow - Valeurs du placeholder de TradingView

Un standard placeholder'* est un texte littéral entouré de doubles accolades qui est inclus dans un message d'alerte.

"{{timenow}}" renvoie l'heure actuelle et l'heure exacte à laquelle l'alerte a été générée, en UTC et au format yyyy-MM-ddTHH: mm: ssZ

Par exemple: "2023-06-01T17:38:10Z"

Pour en savoir plus sur le Standard Placeholder pour accéder aux variables dans PineScript, cliquez ici.

8. Spécification d’AlertMsg - maxLag

 maxLag - Délai maximum acceptable

Le terme "maxLag" désigne le retard ou la latence maximale admissible, mesuré en secondes, avant qu'un signal de trading ne soit considéré comme nul. Le calcul du maxLag consiste à déterminer la différence de temps entre le moment où le signal a été envoyé par TradingView (en utilisant le champ "timestamp" dans le message d'alerte) et le moment où il a été reçu sur BloFin en vue de l'exécution d'un ordre.

Par défaut, cette valeur est fixée à 60 secondes. La définition d'une valeur maxLag permet de s'assurer que le Signal Bot fonctionne en temps voulu, en évitant d'agir sur des signaux obsolètes ou potentiellement inexacts qui peuvent ne plus refléter les conditions actuelles du marché.

9. Spécification d’AlertMsg  - investmentType & amount

Remarque importante : pour garantir une compatibilité optimale avec votre stratégie TradingView, nous vous recommandons vivement de configurer investmentType comme "base" et de définir le montant de "{{strategy.order.contracts}}". En suivant cette approche, le nombre d'ordres sur BloFin s'alignera sur les nombres d'ordres spécifiés dans votre stratégie TradingView.

investmentType and Amount

(POUR LES SIGNAUX D'ENTRÉE UNIQUEMENT)

• base: Montant en devise de base (choix recommandé)
• margin: Marge investie dans la devise de cotation
• contract: Le nombre déterminé de contrats
• percentage_balance: Basé sur le % du solde disponible (c'est-à-dire la marge disponible pour l'ouverture de nouvelles positions)
• percentage_investment: Basé sur le % de la marge initiale investie lors de la création du bot. Les marges supplémentaires ajoutées par la suite ne seront pas comptabilisées.

(UNIQUEMENT POUR LES SIGNAUX DE SORTIE)

• base: Montant en devise de base (choix recommandé)
• percentage_position: Sur la base du pourcentage de positions ouvertes