PartialLossContract

Contract for partial loss level events.

Emitted by partialLossSubject when a signal reaches a loss level milestone (-10%, -20%, -30%, etc). Used for tracking partial stop-loss execution and monitoring strategy drawdown.

Events are emitted only once per level per signal (Set-based deduplication in ClientPartial). Multiple levels can be emitted in a single tick if price drops significantly.

Consumers:

• PartialMarkdownService: Accumulates events for report generation
• User callbacks via listenPartialLoss() / listenPartialLossOnce()

Properties

symbol

symbol: string
Copy

Trading pair symbol (e.g., "BTCUSDT"). Identifies which market this loss event belongs to.

strategyName

strategyName: string
Copy

Strategy name that generated this signal. Identifies which strategy execution this loss event belongs to.

exchangeName

exchangeName: string
Copy

Exchange name where this signal is being executed. Identifies which exchange this loss event belongs to.

frameName

frameName: string
Copy

Frame name where this signal is being executed. Identifies which frame this loss event belongs to (empty string for live mode).

data

data: IPublicSignalRow
Copy

Complete signal row data with original prices. Contains all signal information including originalPriceStopLoss, originalPriceTakeProfit, and totalExecuted.

currentPrice

currentPrice: number
Copy

Current market price at which this loss level was reached. Used to calculate actual loss percentage.

level

level: PartialLevel
Copy

Loss level milestone reached (10, 20, 30, 40, 50, 60, 70, 80, 90, or 100). Represents percentage loss relative to entry price (absolute value).

Note: Stored as positive number, but represents negative loss. level=20 means -20% loss from entry price.

backtest

backtest: boolean
Copy

Execution mode flag.

• true: Event from backtest execution (historical candle data)
• false: Event from live trading (real-time tick)

timestamp

timestamp: number
Copy

Event timestamp in milliseconds since Unix epoch.

Timing semantics:

• Live mode: when.getTime() at the moment loss level was detected
• Backtest mode: candle.timestamp of the candle that triggered the level