SignalPingContract

Signal pending-ping sync event.

Emitted on every live tick while a pending signal (open position) is being monitored, BEFORE the framework evaluates TP/SL/time completion. It asks the external order management system whether the corresponding order is STILL pending (open) on the exchange.

Listener contract (mirrors syncSubject semantics):

• Return true (or do nothing) — the order is still open on the exchange, keep monitoring.
• Return false OR throw — the order is no longer open on the exchange (filled, cancelled, liquidated externally). The framework closes the pending signal with closeReason "closed".

Backtest never emits this event — there is no live exchange to query.

Consumers:

• Broker adapter via onOrderCheck (syncPendingSubject subscription)
• Registered actions via orderCheck / onOrderCheck

Properties

action

action: "signal-ping"
Copy

Discriminator for pending-ping action

symbol

symbol: string
Copy

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

strategyName

strategyName: string
Copy

Strategy name that generated this signal

exchangeName

exchangeName: string
Copy

Exchange name where signal was executed

frameName

frameName: string
Copy

Timeframe name (empty string in live mode)

backtest

backtest: boolean
Copy

Whether this event is from backtest mode (true) or live mode (false) — always false in practice

signalId

signalId: string
Copy

Unique signal identifier (UUID v4)

timestamp

timestamp: number
Copy

Timestamp from execution context (tick's when)

signal

signal: IPublicSignalRow
Copy

Complete public signal row at the moment of this event

currentPrice

currentPrice: number
Copy

Market price at the moment of the ping (VWAP)

pnl

pnl: IStrategyPnL
Copy

Unrealized PNL of the open position at the moment of the ping

peakProfit

peakProfit: IStrategyPnL
Copy

Peak profit achieved during the life of this position up to this event

maxDrawdown

maxDrawdown: IStrategyPnL
Copy

Maximum drawdown experienced during the life of this position up to this event

position

position: "long" | "short"
Copy

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

priceOpen

priceOpen: number
Copy

Effective entry price (may differ from priceOpen after DCA averaging)

priceTakeProfit

priceTakeProfit: number
Copy

Effective take profit price (may differ from original after trailing)

priceStopLoss

priceStopLoss: number
Copy

Effective stop loss price (may differ from original after trailing)

originalPriceTakeProfit

originalPriceTakeProfit: number
Copy

Original take profit price before any trailing adjustments

originalPriceStopLoss

originalPriceStopLoss: number
Copy

Original stop loss price before any trailing adjustments

originalPriceOpen

originalPriceOpen: number
Copy

Original entry price before any DCA averaging (initial priceOpen)

scheduledAt

scheduledAt: number
Copy

Signal creation timestamp in milliseconds

pendingAt

pendingAt: number
Copy

Position activation timestamp in milliseconds

totalEntries

totalEntries: number
Copy

Total number of DCA entries (_entry.length). 1 = no averaging done.

totalPartials

totalPartials: number
Copy

Total number of partial closes executed (_partial.length). 0 = none.