​

État RUNNING - Gestion des Ordres

​

📊 Statut des Tests

​

Tests Frontend (Checkly)

​

Tests Backend (Vitest)

​

🔗 Avant cette étape

• Transition NEW → RUNNING — Comment on arrive en RUNNING depuis NEW.

​

🧭 Diagramme XState (RUNNING) — ordres et erreurs

​

Vue synthétique (Mermaid)

​

🎯 Vue d’ensemble

​

🔍 Gestion des Ordres en RUNNING

​

BUY2 (processBuy2)

• buy2Order.status !== 'closed'
• buy2Order n’existe pas OU prix différent OU annulé

• À chaque nouvelle bougie, le système vérifie si RANGE_FILTER_LOW/HIGH a changé
• Si le nouveau niveau est différent du prix de l’ordre BUY2 en cours :
  • L’ordre BUY2 existant est annulé
  • Un nouvel ordre BUY2 est placé au nouveau niveau RANGE_FILTER_LOW/HIGH
  • L’activité “BUY2_ORDER_UPDATED” est enregistrée avec l’ancien et nouveau prix
• Cette mise à jour évite que l’ordre BUY2 se retrouve sous le trailing stop
• Si l’ordre BUY2 ne peut pas être annulé (déjà exécuté), la mise à jour est ignorée

• Mise à jour de buy2Order, buy2Amount, buy2Price
• Recalcul de relativeEntryPrice (moyenne pondérée de BUY1 et BUY2)
• Mise à jour de relativeAmount via calculateRelativeAmount()
• Recalcul de tp1Amount / tp2Amount via les mêmes helpers que pour BUY1_COMPLETED (70 % / 30 % du montant net vendable après réserve), recalcul des prix tp1Price / tp2Price depuis le nouveau prix d’entrée moyen — reserveAmount n’est pas modifié (fixé à l’étape BUY1)
• L’activité “BUY2_ORDER_EXECUTED” est enregistrée dans le champ activity avec le prix d’exécution et le montant de l’ordre BUY2
• Si l’ordre TP1 n’est pas clos, on annule l’ordre pour placer nouvel ordre TP1 avec le nouveau montant actif
• Si l’ordre TP2 n’est pas clos, on annule l’ordre pour placer nouvel ordre TP2 avec le nouveau montant actif

​

Close partiel (shark / SL BUY1) — closeSwingPositionAtMarket

• amountToClose = min( calculateRelativeAmount , buy1Amount - reserveAmount )

​

TP1 (processTp1)

• tp1Order.status !== 'closed'
• tp1Order n’existe pas OU montant différent OU annulé

• tp1Amount et tp2Amount sont des montants de planification, mis à jour uniquement pendant les étapes BUY (BUY1_COMPLETED / BUY2_ORDER_EXECUTED) et les cas SL documentés.
• processTp1 / processTp2 ne doivent pas recalculer ni ajuster automatiquement tp1Amount / tp2Amount.
• En RUNNING, ces process gèrent le cycle d’ordres TP (fetch/cancel/place) en utilisant les montants déjà établis.

• Archive de TP1 dans archivedTp1Orders (si nécessaire)
• Calcul de relativeAmount via calculateRelativeAmount()
• Si BUY2 pas encore fermé : ajustement de buy2Amount pour inclure le montant TP1 vendu

​

TP2 (processTp2)

• tp2Order.status !== 'closed'
• tp2Order n’existe pas OU montant différent OU annulé

• Archive de TP2 dans archivedTp2Orders (si nécessaire)
• Calcul de relativeAmount via calculateRelativeAmount()
• Si BUY2 pas encore fermé : ajustement de buy2Amount pour inclure le montant TP2 vendu

​

Gestion des Take Profits

• Le montant actif ÉGALE la somme des quantités achetées avec BUY1 et BUY2 moins une réserve correspondant au montant minimum d’un ordre (+ marge). Ce montant actif détermine les quantités vendues pour TP1 et TP2
• Quantités TP1 / TP2 : sur le net vendable (relativeAmount), on calcule TP1 (70 % + précision exchange) ; TP2 = net − TP1. Somme toujours égale au net ; pas d’arrondi séparé sur les 30 %.
• Le prix TP1 correspond à 50% de la moyenne des GAP max des 10 dernières positions et l’activité “TP1_ORDER_PLACED” sont enregistrées dans le champ activity
• Le prix TP2 correspond à 95% de la moyenne des GAP max des 10 dernières positions et l’activité “TP2_ORDER_PLACED” sont enregistrées dans le champ activity
• Les ordres TP sont annulés si la position se ferme et les activités “TP1_ORDER_CANCELED” et “TP2_ORDER_CANCELED” sont enregistrées dans le champ activity

​

Historique candles

• Champ JSON swingPosition.candles : objet { [timeframe]: bougie[] }, clés typiques "5m" (timeframe du webhook / position) et "1m" (shark mode).
• Webhook TradingView : à chaque traitement d’une position active, append de la bougie correspondant au timeframe (source: tradingViewWebhook).
• Shark mode (sharkModeCron) : append de la dernière bougie 1m exchange, avec snapshot Heikin Ashi (heikinAshi, source: sharkModeCron).
• Dédoublonnage par openTime sur une même clé (remplace l’entrée si replay), 500 bougies max par timeframe (FIFO).

​

💰 ÉVOLUTION DES PRIX ET CALCULS FINANCIERS

​

Calcul des Prix TP1/TP2

// Formule de calcul des prix TP
const avgMaxPnl = position.avgMaxPnlForPair || 2.0; // PnL maximum historique

// Pour LONG (achat)
tp1Price = relativeEntryPrice * (1 + (0.5 * avgMaxPnl / 100))   // 50% du PnL max
tp2Price = relativeEntryPrice * (1 + (0.95 * avgMaxPnl / 100))  // 95% du PnL max

// Pour SHORT (vente)
tp1Price = relativeEntryPrice * (1 - (0.5 * avgMaxPnl / 100))   // 50% du PnL max
tp2Price = relativeEntryPrice * (1 - (0.95 * avgMaxPnl / 100))  // 95% du PnL max

​

Évolution de relativeEntryPrice

// Calcul du prix d'entrée pondéré
const totalBuy1Cost = buy1Amount * buy1Price;
const totalBuy2Cost = buy2Amount * buy2Price;
relativeEntryPrice = (totalBuy1Cost + totalBuy2Cost) / (buy1Amount + buy2Amount);

​

Calcul des Quantités TP

// Quantités fixes basées sur le total calculé
const calculatedRelativeAmount = calculateRelativeAmount(position)
tp1Amount = calculatedRelativeAmount * 0.7;  // 70% du total
tp2Amount = calculatedRelativeAmount * 0.3;  // 30% du total

​

🦈 Gestion du Shark Mode

​

Activation du Shark Mode

• Position en statut RUNNING ou NEW
• Évolution du prix ≥ 0.5% par rapport au prix d’entrée (avgEntryPrice ou relativeEntryPrice)
• Calcul basé sur les bougies Heikin Ashi 1m

• sharkModeEnabled = true
• sharkModeEnabledAt = Date.now()
• Ajout d’une activité SHARK_MODE_ACTIVATED avec le pourcentage d’évolution

​

Mise à Jour du Stop Loss en Shark Mode

• sharkModeCron.ts s’exécute chaque minute pour surveiller les positions actives et gérer le SL agressif
• tradingview.ts (webhook) reçoit les bougies toutes les 5 minutes pour traiter les positions et créer de nouvelles positions
• Cette différence de fréquence peut créer des situations où sharkModeCron.ts détecte un SL touché et crée un ordre Close avec slMode = 'SL_BUY1', mais le webhook TradingView arrive 5 minutes plus tard et doit respecter ce slMode pour ne pas fermer incorrectement la position

• LONG : SL = haLow (low de la dernière bougie Heikin Ashi)
• SHORT : SL = haHigh (high de la dernière bougie Heikin Ashi)
• Le SL ne peut que se rapprocher du prix (monter pour LONG, descendre pour SHORT)

​

Gestion du SL Touché en Shark Mode

• SL_BUY1 : SL de BUY1 touché (BUY2 non fermé) - Position reste en RUNNING
• SL_BUY2 : SL de BUY2 touché (BUY2 fermé) - Position passe en CLOSED après l’exécution de l’ordre Close

​

Cas 1 : SL de BUY1 touché (BUY2 non fermé)

• ✅ Le status reste RUNNING (ne pas passer en CLOSED)
• ✅ Définir slMode = SL_BUY1 pour marquer que c’est un SL de BUY1
• ✅ Créer un ordre Close pour vendre relativeAmount (si > 0)
• ✅ Ajouter une activité BUY1_SL_TOUCHED avec indication “SL de BUY1”
• ✅ Utiliser processClose() pour créer l’ordre Close (position reste en RUNNING) — annule TP1 et TP2 ouverts
• ✅ Tant que slMode === SL_BUY1 et que BUY2 n’est pas exécuté (buy2Order.status !== 'closed') : ne pas replacer TP1 ni TP2 (processTp1 / processTp2 court-circuitent). Reprise du placement TP après exécution de BUY2 (BUY2 closed)
• ✅ Même après l’exécution de l’ordre Close : La position reste en RUNNING si slMode === 'SL_BUY1' et buy2IsClosed === false

​

Cas 2 : SL de BUY2 touché (BUY2 fermé)

• ✅ Définir slMode = SL_BUY2 pour marquer que c’est un SL de BUY2
• ✅ Créer un ordre Close pour vendre relativeAmount + reserveAmount (si relativeAmount > 0)
• ✅ Ajouter une activité BUY2_SL_TOUCHED avec indication “SL de BUY2”
• ✅ Utiliser processClose() pour gérer la fermeture (annulation TP1/TP2, création ordre market)
• ✅ Après l’exécution de l’ordre Close : La position passe directement en CLOSED (fermeture complète)

if (closeOrder.status === 'closed') {
  if (slMode === 'SL_BUY2') {
    // SL_BUY2 : Fermeture complète (relativeAmount + reserveAmount vendus)
    status = CLOSED
    closedReason = REACHED_STOP_LOSS
  } else if (slMode === 'SL_BUY1' && !buy2IsClosed) {
    // SL_BUY1 : Position reste en RUNNING (seulement relativeAmount vendu)
    status = RUNNING
  } else {
    // Fermeture normale (changement de tendance) ou SL_BUY2
    status = CLOSED
    closedReason = TREND_CHANGED | REACHED_STOP_LOSS
  }
}

​

📋 Variantes de Workflow

​

Variante 1 : Workflow Standard (Sans BUY2)

BUY1 (market) → TP1 (70%) → TP2 (30%) → CLOSE (reserveAmount)

​

Variante 2 : Workflow Standard avec BUY2

BUY1 (market) → BUY2 (limit) → TP1 (70% total) → TP2 (30% total) → CLOSE (reserveAmount)

​

Variante 3 : TP1 fermé avant BUY2

BUY1 → TP1 fermé → BUY2 amount += TP1 amount → BUY2 fermé → Nouveaux TP1/TP2

• TP1 archivé dans archivedTp1Orders
• buy2Amount ajusté avec tp1Amount
• BUY2 ordre remplacé avec nouveau montant
• Les montants TP existants restent la référence (pas de recalcul automatique dans processTp1/processTp2)

​

Variante 4 : BUY2 fermé avant TP1/TP2

BUY1 → BUY2 fermé → TP1 fermé → TP2 fermé → CLOSE

• relativeEntryPrice recalculé (moyenne pondérée)
• Les montants TP restent ceux planifiés en amont
• TP1/TP2 archivés quand fermés

​

🔧 Fonctions de Vérification

​

calculateRelativeAmount()

relativeAmount = 0

// Ajouter les achats fermés
+ (buy1Amount si buy1Order.status === 'closed')
+ (buy2Amount si buy2Order.status === 'closed')

// Soustraire les réserves et ventes
- reserveAmount
- (tp1Amount si tp1Order.status === 'closed')
- (tp2Amount si tp2Order.status === 'closed')
- (tp1Amount des archivedTp1Orders fermés)
- (tp2Amount des archivedTp2Orders fermés)
- (slAmount si slOrder.status === 'closed')
- (closeAmount si closeOrder.status === 'closed')

return Math.max(0, relativeAmount) // Ne jamais retourner négatif

​

🧪 Tests

​

Tests Frontend

// @checkly frequency: 10min
// @checkly locations: paris, new-york
// @checkly alertChannels: linear
// @checkly tags: production, positions

​

Tests Backend

npm run test -- running-state

​

🔗 Navigation

• Vue d’ensemble : Retour à la vue d’ensemble
• État NEW : Création de position
• État CLOSED : Conditions de fermeture