Interface ISignalRow

Complete signal with auto-generated id. Used throughout the system after validation.

interface ISignalRow {
    _isScheduled: boolean;
    _partial?: { percent: number; price: number; type: "profit" | "loss" }[];
    _trailingPriceStopLoss?: number;
    _trailingPriceTakeProfit?: number;
    exchangeName: string;
    frameName: string;
    id: string;
    minuteEstimatedTime: number;
    note?: string;
    pendingAt: number;
    position: "long" | "short";
    priceOpen: number;
    priceStopLoss: number;
    priceTakeProfit: number;
    scheduledAt: number;
    strategyName: string;
    symbol: string;
}

Hierarchy (View Summary)

Properties

_isScheduled: boolean

Internal runtime marker for scheduled signals

_partial?: { percent: number; price: number; type: "profit" | "loss" }[]

History of partial closes for PNL calculation. Each entry contains type (profit/loss), percent closed, and price. Used to calculate weighted PNL: Σ(percent_i × pnl_i) for each partial + (remaining% × final_pnl)

Computed values (derived from this array):

  • _tpClosed: Sum of all "profit" type partial close percentages
  • _slClosed: Sum of all "loss" type partial close percentages
  • _totalClosed: Sum of all partial close percentages (profit + loss)

Type declaration

  • percent: number

    Percentage of position closed (0-100)

  • price: number

    Price at which this partial was executed

  • type: "profit" | "loss"

    Type of partial close: profit (moving toward TP) or loss (moving toward SL)

_trailingPriceStopLoss?: number

Trailing stop-loss price that overrides priceStopLoss when set. Updated by trailing() method based on position type and percentage distance.

  • For LONG: moves upward as price moves toward TP (never moves down)
  • For SHORT: moves downward as price moves toward TP (never moves up) When _trailingPriceStopLoss is set, it replaces priceStopLoss for TP/SL checks. Original priceStopLoss is preserved in persistence but ignored during execution.
_trailingPriceTakeProfit?: number

Trailing take-profit price that overrides priceTakeProfit when set. Created and managed by trailingTake() method for dynamic TP adjustment. Allows moving TP further from or closer to current price based on strategy. Updated by trailingTake() method based on position type and percentage distance.

  • For LONG: can move upward (further) or downward (closer) from entry
  • For SHORT: can move downward (further) or upward (closer) from entry When _trailingPriceTakeProfit is set, it replaces priceTakeProfit for TP/SL checks. Original priceTakeProfit is preserved in persistence but ignored during execution.
exchangeName: string

Unique exchange identifier for execution

frameName: string

Unique frame identifier for execution (empty string for live mode)

id: string

Unique signal identifier (UUID v4 auto-generated)

minuteEstimatedTime: number

Expected duration in minutes before time_expired

note?: string

Human-readable description of signal reason

pendingAt: number

Pending timestamp in milliseconds (when position became pending/active at priceOpen)

position: "long" | "short"

Trade direction: "long" (buy) or "short" (sell)

priceOpen: number

Entry price for the position

priceStopLoss: number

Stop loss exit price (must be < priceOpen for long, > priceOpen for short)

priceTakeProfit: number

Take profit target price (must be > priceOpen for long, < priceOpen for short)

scheduledAt: number

Signal creation timestamp in milliseconds (when signal was first created/scheduled)

strategyName: string

Unique strategy identifier for execution

symbol: string

Trading pair symbol (e.g., "BTCUSDT")