OrderCheckContract

Signal order-ping sync event.

Emitted on every live tick while a signal is being monitored, BEFORE the framework evaluates completion. It asks the external order management system whether the corresponding order is STILL open on the exchange. Fires for BOTH monitored states, discriminated by type:

• type: "active" — a pending signal (open position); the order backing the position.
• type: "schedule" — a scheduled signal; the resting entry order awaiting activation.

Listener contract (resolved into IBrokerOrderVerdict):

• Return true (or do nothing) — the order is still open on the exchange, keep monitoring; the consecutive-failure counter (attempt) resets to 0.
• Throw OrderDeletedError — the CONFIRMED "order not found by id" (filled, cancelled, liquidated externally): terminal AT ONCE, bypassing the tolerance counter. For "active" the framework closes the pending signal with closeReason "closed"; for "schedule" it cancels the scheduled signal (reason "user").
• Return false OR throw a plain Error / OrderTransientError — the check FAILED transiently (network blip, exchange 5xx): TOLERATED, the order is assumed still open and the next ping carries attempt incremented, up to CC_ORDER_CHECK_RETRY_ATTEMPTS consecutive failures before the terminal action above fires (with the config at 0 any failure is terminal on the spot — legacy).
• Throw OrderRejectedError — protocol violation in this channel, degrades to transient. NOTE for "schedule": if the resting order actually FILLED, confirm it via activateScheduled/commitActivateScheduled instead of failing the ping — a failed ping is a terminal cancel, not an activation.

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

Consumers:

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

Properties

action

action: "signal-ping"
Copy

Discriminator for pending-ping action

type

type: "schedule" | "active"
Copy

Monitored state: "active" — open position order, "schedule" — resting entry order

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

attempt

attempt: number
Copy

Number of CONSECUTIVE prior failed checks for this signal (0 = first check / healthy). Managed by the framework: a failed check (false/non-typed throw) increments the counter carried by the next ping while the failure is tolerated as transient (CC_ORDER_CHECK_RETRY_ATTEMPTS); a successful check resets it to 0.

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.