Function commitCreateStopLoss

  • commitCreateStopLoss(
        symbol: string,
        payload?: Partial<CommitPayload>,
    ): Promise<void>

    Reports that the pending position's stop-loss order was actually filled on the exchange (e.g. by candle high/low), forcing a close that bypasses the framework's touch-based SL check (closed-candle granularity).

    The exchange and the strategy are parallel states: the framework evaluates SL/liquidation by closed-candle touch and TP by VWAP, but the real order may fill on high/low. The close is deferred and emitted with closeReason "stop_loss" on the next tick. No-op if no pending signal exists.

    Automatically detects backtest/live mode from execution context.

    Parameters

    • symbol: string

      Trading pair symbol

    • Optionalpayload: Partial<CommitPayload>

      Optional commit payload with id and note

    Returns Promise<void>

    Promise that resolves when the stop-loss fill is queued

    Example

    import { commitCreateStopLoss } from "backtest-kit";

    // Report SL fill confirmed on the exchange
    await commitCreateStopLoss("BTCUSDT", { id: "sl-fill-001" });

Settings

Member Visibility