backtest-kit 4.0.2 → 5.1.0

package/build/index.cjs

@@ -89,6 +89,10 @@ const coreServices$1 = {
     actionCoreService: Symbol('actionCoreService'),
     frameCoreService: Symbol('frameCoreService'),
 };
+const metaServices$1 = {
+    priceMetaService: Symbol('priceMetaService'),
+    timeMetaService: Symbol('timeMetaService'),
+};
 const globalServices$1 = {
     sizingGlobalService: Symbol('sizingGlobalService'),
     riskGlobalService: Symbol('riskGlobalService'),
@@ -154,6 +158,7 @@ const TYPES = {
     ...connectionServices$1,
     ...schemaServices$1,
     ...coreServices$1,
+    ...metaServices$1,
     ...globalServices$1,
     ...commandServices$1,
     ...logicPrivateServices$1,
@@ -470,9 +475,17 @@ const GLOBAL_CONFIG = {
      * Allows to commitAverageBuy if currentPrice is not the lowest price since entry, but still lower than priceOpen.
      * This can help improve average entry price in cases where price has rebounded after entry but is still below priceOpen, without waiting for a new lower price.
      *
-     * Default: true (DCA logic enabled everywhere, not just when antirecord is broken)
+     * Default: false (DCA logic enabled only when antirecord is broken)
      */
     CC_ENABLE_DCA_EVERYWHERE: false,
+    /**
+     * Enables PPPL (Partial Profit, Partial Loss) logic even if this breaks a direction of exits
+     * Allows to take partial profit or loss on a position even if it results in a mix of profit and loss exits
+     * This can help lock in profits or cut losses on part of the position without waiting for a perfect exit scenario.
+     *
+     * Default: false (PPPL logic is only applied when it does not break the direction of exits, ensuring clearer profit/loss outcomes)
+     */
+    CC_ENABLE_PPPL_EVERYWHERE: false,
     /**
      * Cost of entering a position (in USD).
      * This is used as a default value for calculating position size and risk management when cost data is not provided by the strategy
@@ -3550,19 +3563,6 @@ const beginTime = (run) => (...args) => {
     return fn();
 };
 
-/**
- * Retrieves the current timestamp for debugging purposes.
- * If an execution context is active (e.g., during a backtest), it returns the timestamp from the context to ensure consistency with the simulated time.
- * Can be empty (undefined) if not called from strategy async context, as it's intended for debugging and not critical for logic.
- * @return {number | undefined} The current timestamp in milliseconds from the execution context, or undefined if not available.
- */
-const getDebugTimestamp = () => {
-    if (ExecutionContextService.hasContext()) {
-        return bt.executionContextService.context.when.getTime();
-    }
-    return undefined;
-};
-
 const INTERVAL_MINUTES$6 = {
     "1m": 1,
     "3m": 3,
@@ -4270,7 +4270,7 @@ const GET_SIGNAL_FN = functoolsKit.trycatch(async (self) => {
                 pendingAt: currentTime, // Для immediate signal оба времени одинаковые
                 timestamp: currentTime,
                 _isScheduled: false,
-                _entry: [{ price: signal.priceOpen, cost: signal.cost ?? GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, debugTimestamp: currentTime }],
+                _entry: [{ price: signal.priceOpen, cost: signal.cost ?? GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, timestamp: currentTime }],
             };
             // Валидируем сигнал перед возвратом
             VALIDATE_SIGNAL_FN(signalRow, currentPrice, false);
@@ -4294,7 +4294,7 @@ const GET_SIGNAL_FN = functoolsKit.trycatch(async (self) => {
             pendingAt: SCHEDULED_SIGNAL_PENDING_MOCK, // Временно, обновится при активации
             timestamp: currentTime,
             _isScheduled: true,
-            _entry: [{ price: signal.priceOpen, cost: signal.cost ?? GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, debugTimestamp: currentTime }],
+            _entry: [{ price: signal.priceOpen, cost: signal.cost ?? GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, timestamp: currentTime }],
         };
         // Валидируем сигнал перед возвратом
         VALIDATE_SIGNAL_FN(scheduledSignalRow, currentPrice, true);
@@ -4314,7 +4314,7 @@ const GET_SIGNAL_FN = functoolsKit.trycatch(async (self) => {
         pendingAt: currentTime, // Для immediate signal оба времени одинаковые
         timestamp: currentTime,
         _isScheduled: false,
-        _entry: [{ price: currentPrice, cost: signal.cost ?? GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, debugTimestamp: currentTime }],
+        _entry: [{ price: currentPrice, cost: signal.cost ?? GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, timestamp: currentTime }],
     };
     // Валидируем сигнал перед возвратом
     VALIDATE_SIGNAL_FN(signalRow, currentPrice, false);
@@ -4384,7 +4384,7 @@ const WAIT_FOR_DISPOSE_FN$1 = async (self) => {
     self.params.logger.debug("ClientStrategy dispose");
     await self.params.onDispose(self.params.execution.context.symbol, self.params.strategyName, self.params.exchangeName, self.params.method.context.frameName, self.params.execution.context.backtest);
 };
-const PARTIAL_PROFIT_FN = (self, signal, percentToClose, currentPrice) => {
+const PARTIAL_PROFIT_FN = (self, signal, percentToClose, currentPrice, timestamp) => {
     // Initialize partial array if not present
     if (!signal._partial)
         signal._partial = [];
@@ -4413,7 +4413,7 @@ const PARTIAL_PROFIT_FN = (self, signal, percentToClose, currentPrice) => {
         entryCountAtClose,
         currentPrice,
         costBasisAtClose: remainingCostBasis,
-        debugTimestamp: getDebugTimestamp(),
+        timestamp,
     });
     self.params.logger.info("PARTIAL_PROFIT_FN executed", {
         signalId: signal.id,
@@ -4423,7 +4423,7 @@ const PARTIAL_PROFIT_FN = (self, signal, percentToClose, currentPrice) => {
     });
     return true;
 };
-const PARTIAL_LOSS_FN = (self, signal, percentToClose, currentPrice) => {
+const PARTIAL_LOSS_FN = (self, signal, percentToClose, currentPrice, timestamp) => {
     // Initialize partial array if not present
     if (!signal._partial)
         signal._partial = [];
@@ -4451,7 +4451,7 @@ const PARTIAL_LOSS_FN = (self, signal, percentToClose, currentPrice) => {
         currentPrice,
         entryCountAtClose,
         costBasisAtClose: remainingCostBasis,
-        debugTimestamp: getDebugTimestamp(),
+        timestamp,
     });
     self.params.logger.warn("PARTIAL_LOSS_FN executed", {
         signalId: signal.id,
@@ -4848,10 +4848,10 @@ const BREAKEVEN_FN = (self, signal, currentPrice) => {
     });
     return true;
 };
-const AVERAGE_BUY_FN = (self, signal, currentPrice, cost = GLOBAL_CONFIG.CC_POSITION_ENTRY_COST) => {
+const AVERAGE_BUY_FN = (self, signal, currentPrice, timestamp, cost = GLOBAL_CONFIG.CC_POSITION_ENTRY_COST) => {
     // Ensure _entry is initialized (handles signals loaded from disk without _entry)
     if (!signal._entry || signal._entry.length === 0) {
-        signal._entry = [{ price: signal.priceOpen, cost: GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, debugTimestamp: getDebugTimestamp() }];
+        signal._entry = [{ price: signal.priceOpen, cost: GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, timestamp }];
     }
     if (signal.position === "long") {
         // LONG: new entry must beat the all-time low — strictly below every prior entry price
@@ -4881,7 +4881,7 @@ const AVERAGE_BUY_FN = (self, signal, currentPrice, cost = GLOBAL_CONFIG.CC_POSI
             return false;
         }
     }
-    signal._entry.push({ price: currentPrice, cost, debugTimestamp: getDebugTimestamp() });
+    signal._entry.push({ price: currentPrice, cost, timestamp });
     self.params.logger.info("AVERAGE_BUY_FN executed", {
         signalId: signal.id,
         position: signal.position,
@@ -6666,16 +6666,16 @@ class ClientStrategy {
      * // No DCA: [{ price: 43000, cost: 100 }]
      * // One DCA: [{ price: 43000, cost: 100 }, { price: 42000, cost: 100 }]
      */
-    async getPositionEntries(symbol) {
+    async getPositionEntries(symbol, timestamp) {
         this.params.logger.debug("ClientStrategy getPositionEntries", { symbol });
         if (!this._pendingSignal) {
             return null;
         }
         const entries = this._pendingSignal._entry;
         if (!entries || entries.length === 0) {
-            return [{ price: this._pendingSignal.priceOpen, cost: GLOBAL_CONFIG.CC_POSITION_ENTRY_COST }];
+            return [{ price: this._pendingSignal.priceOpen, cost: GLOBAL_CONFIG.CC_POSITION_ENTRY_COST, timestamp }];
         }
-        return entries.map(({ price, cost }) => ({ price, cost }));
+        return entries.map(({ price, cost, timestamp }) => ({ price, cost, timestamp }));
     }
     /**
      * Performs a single tick of strategy execution.
@@ -7448,10 +7448,12 @@ class ClientStrategy {
         if (typeof currentPrice !== "number" || !isFinite(currentPrice) || currentPrice <= 0)
             return false;
         const effectivePriceOpen = getEffectivePriceOpen(this._pendingSignal);
-        if (this._pendingSignal.position === "long" && currentPrice <= effectivePriceOpen)
-            return false;
-        if (this._pendingSignal.position === "short" && currentPrice >= effectivePriceOpen)
-            return false;
+        if (!GLOBAL_CONFIG.CC_ENABLE_PPPL_EVERYWHERE) {
+            if (this._pendingSignal.position === "long" && currentPrice <= effectivePriceOpen)
+                return false;
+            if (this._pendingSignal.position === "short" && currentPrice >= effectivePriceOpen)
+                return false;
+        }
         const effectiveTakeProfit = this._pendingSignal._trailingPriceTakeProfit ?? this._pendingSignal.priceTakeProfit;
         if (this._pendingSignal.position === "long" && currentPrice >= effectiveTakeProfit)
             return false;
@@ -7509,7 +7511,7 @@ class ClientStrategy {
      * // success3 = false (skipped, would exceed 100%)
      * ```
      */
-    async partialProfit(symbol, percentToClose, currentPrice, backtest) {
+    async partialProfit(symbol, percentToClose, currentPrice, backtest, timestamp) {
         this.params.logger.debug("ClientStrategy partialProfit", {
             symbol,
             percentToClose,
@@ -7535,7 +7537,7 @@ class ClientStrategy {
             throw new Error(`ClientStrategy partialProfit: currentPrice must be a positive finite number, got ${currentPrice}`);
         }
         // Validation: currentPrice must be moving toward TP (profit direction)
-        {
+        if (!GLOBAL_CONFIG.CC_ENABLE_PPPL_EVERYWHERE) {
             const effectivePriceOpen = getEffectivePriceOpen(this._pendingSignal);
             if (this._pendingSignal.position === "long") {
                 // For LONG: currentPrice must be higher than effectivePriceOpen (moving toward TP)
@@ -7573,7 +7575,7 @@ class ClientStrategy {
             return false;
         }
         // Execute partial close logic
-        const wasExecuted = PARTIAL_PROFIT_FN(this, this._pendingSignal, percentToClose, currentPrice);
+        const wasExecuted = PARTIAL_PROFIT_FN(this, this._pendingSignal, percentToClose, currentPrice, timestamp);
         // If partial was not executed (exceeded 100%), return false without persistence
         if (!wasExecuted) {
             return false;
@@ -7629,10 +7631,12 @@ class ClientStrategy {
         if (typeof currentPrice !== "number" || !isFinite(currentPrice) || currentPrice <= 0)
             return false;
         const effectivePriceOpen = getEffectivePriceOpen(this._pendingSignal);
-        if (this._pendingSignal.position === "long" && currentPrice >= effectivePriceOpen)
-            return false;
-        if (this._pendingSignal.position === "short" && currentPrice <= effectivePriceOpen)
-            return false;
+        if (!GLOBAL_CONFIG.CC_ENABLE_PPPL_EVERYWHERE) {
+            if (this._pendingSignal.position === "long" && currentPrice >= effectivePriceOpen)
+                return false;
+            if (this._pendingSignal.position === "short" && currentPrice <= effectivePriceOpen)
+                return false;
+        }
         const effectiveStopLoss = this._pendingSignal._trailingPriceStopLoss ?? this._pendingSignal.priceStopLoss;
         if (this._pendingSignal.position === "long" && currentPrice <= effectiveStopLoss)
             return false;
@@ -7690,7 +7694,7 @@ class ClientStrategy {
      * // success3 = false (skipped, would exceed 100%)
      * ```
      */
-    async partialLoss(symbol, percentToClose, currentPrice, backtest) {
+    async partialLoss(symbol, percentToClose, currentPrice, backtest, timestamp) {
         this.params.logger.debug("ClientStrategy partialLoss", {
             symbol,
             percentToClose,
@@ -7716,7 +7720,7 @@ class ClientStrategy {
             throw new Error(`ClientStrategy partialLoss: currentPrice must be a positive finite number, got ${currentPrice}`);
         }
         // Validation: currentPrice must be moving toward SL (loss direction)
-        {
+        if (!GLOBAL_CONFIG.CC_ENABLE_PPPL_EVERYWHERE) {
             const effectivePriceOpen = getEffectivePriceOpen(this._pendingSignal);
             if (this._pendingSignal.position === "long") {
                 // For LONG: currentPrice must be lower than effectivePriceOpen (moving toward SL)
@@ -7754,7 +7758,7 @@ class ClientStrategy {
             return false;
         }
         // Execute partial close logic
-        const wasExecuted = PARTIAL_LOSS_FN(this, this._pendingSignal, percentToClose, currentPrice);
+        const wasExecuted = PARTIAL_LOSS_FN(this, this._pendingSignal, percentToClose, currentPrice, timestamp);
         // If partial was not executed (exceeded 100%), return false without persistence
         if (!wasExecuted) {
             return false;
@@ -8510,7 +8514,7 @@ class ClientStrategy {
      * @param backtest - Whether running in backtest mode
      * @returns Promise<boolean> - true if entry added, false if rejected by direction check
      */
-    async averageBuy(symbol, currentPrice, backtest, cost = GLOBAL_CONFIG.CC_POSITION_ENTRY_COST) {
+    async averageBuy(symbol, currentPrice, backtest, timestamp, cost = GLOBAL_CONFIG.CC_POSITION_ENTRY_COST) {
         this.params.logger.debug("ClientStrategy averageBuy", {
             symbol,
             currentPrice,
@@ -8525,7 +8529,7 @@ class ClientStrategy {
             throw new Error(`ClientStrategy averageBuy: currentPrice must be a positive finite number, got ${currentPrice}`);
         }
         // Execute averaging logic
-        const result = AVERAGE_BUY_FN(this, this._pendingSignal, currentPrice, cost);
+        const result = AVERAGE_BUY_FN(this, this._pendingSignal, currentPrice, timestamp, cost);
         if (!result) {
             return false;
         }
@@ -8989,7 +8993,7 @@ const GET_RISK_FN = (dto, backtest, exchangeName, frameName, self) => {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$m = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$o = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -9166,6 +9170,8 @@ class StrategyConnectionService {
         this.partialConnectionService = inject(TYPES.partialConnectionService);
         this.breakevenConnectionService = inject(TYPES.breakevenConnectionService);
         this.actionCoreService = inject(TYPES.actionCoreService);
+        this.timeMetaService = inject(TYPES.timeMetaService);
+        this.priceMetaService = inject(TYPES.priceMetaService);
         /**
          * Retrieves memoized ClientStrategy instance for given symbol-strategy pair with exchange and frame isolation.
          *
@@ -9179,7 +9185,7 @@ class StrategyConnectionService {
          * @param backtest - Whether running in backtest mode
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
+        this.getStrategy = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$o(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
             const { riskName = "", riskList = [], getSignal, interval, callbacks, } = this.strategySchemaService.get(strategyName);
             return new ClientStrategy({
                 symbol,
@@ -9266,6 +9272,20 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getTotalCostClosed(symbol);
         };
+        /**
+         * Returns the effective (DCA-averaged) entry price for the current pending signal.
+         *
+         * This is the harmonic mean of all _entry prices, which is the correct
+         * cost-basis price used in all PNL calculations.
+         * With no DCA entries, equals the original priceOpen.
+         *
+         * Returns null if no pending signal exists.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to effective entry price or null
+         */
         this.getPositionAveragePrice = async (backtest, symbol, context) => {
             this.loggerService.log("strategyConnectionService getPositionAveragePrice", {
                 symbol,
@@ -9275,6 +9295,19 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionAveragePrice(symbol);
         };
+        /**
+         * Returns the number of DCA entries made for the current pending signal.
+         *
+         * 1 = original entry only (no DCA).
+         * Increases by 1 with each successful commitAverageBuy().
+         *
+         * Returns null if no pending signal exists.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to entry count or null
+         */
         this.getPositionInvestedCount = async (backtest, symbol, context) => {
             this.loggerService.log("strategyConnectionService getPositionInvestedCount", {
                 symbol,
@@ -9284,6 +9317,19 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionInvestedCount(symbol);
         };
+        /**
+         * Returns the total invested cost basis in dollars for the current pending signal.
+         *
+         * Equal to entryCount × $100 (COST_BASIS_PER_ENTRY).
+         * 1 entry = $100, 2 entries = $200, etc.
+         *
+         * Returns null if no pending signal exists.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to total invested cost in dollars or null
+         */
         this.getPositionInvestedCost = async (backtest, symbol, context) => {
             this.loggerService.log("strategyConnectionService getPositionInvestedCost", {
                 symbol,
@@ -9293,6 +9339,20 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionInvestedCost(symbol);
         };
+        /**
+         * Returns the unrealized PNL percentage for the current pending signal at currentPrice.
+         *
+         * Accounts for partial closes, DCA entries, slippage and fees
+         * (delegates to toProfitLossDto).
+         *
+         * Returns null if no pending signal exists.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Current market price
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to pnlPercentage or null
+         */
         this.getPositionPnlPercent = async (backtest, symbol, currentPrice, context) => {
             this.loggerService.log("strategyConnectionService getPositionPnlPercent", {
                 symbol,
@@ -9303,6 +9363,20 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionPnlPercent(symbol, currentPrice);
         };
+        /**
+         * Returns the unrealized PNL in dollars for the current pending signal at currentPrice.
+         *
+         * Calculated as: pnlPercentage / 100 × totalInvestedCost
+         * Accounts for partial closes, DCA entries, slippage and fees.
+         *
+         * Returns null if no pending signal exists.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Current market price
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to pnl in dollars or null
+         */
         this.getPositionPnlCost = async (backtest, symbol, currentPrice, context) => {
             this.loggerService.log("strategyConnectionService getPositionPnlCost", {
                 symbol,
@@ -9313,6 +9387,27 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionPnlCost(symbol, currentPrice);
         };
+        /**
+         * Returns the list of DCA entry prices for the current pending signal.
+         *
+         * The first element is always the original priceOpen (initial entry).
+         * Each subsequent element is a price added by commitAverageBuy().
+         *
+         * Returns null if no pending signal exists.
+         * Returns a single-element array [priceOpen] if no DCA entries were made.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to array of entry prices or null
+         *
+         * @example
+         * ```typescript
+         * // No DCA: [43000]
+         * // One DCA: [43000, 42000]
+         * // Two DCA: [43000, 42000, 41500]
+         * ```
+         */
         this.getPositionLevels = async (backtest, symbol, context) => {
             this.loggerService.log("strategyConnectionService getPositionLevels", {
                 symbol,
@@ -9322,6 +9417,20 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionLevels(symbol);
         };
+        /**
+         * Returns the list of partial closes for the current pending signal.
+         *
+         * Each entry records a partial profit or loss close event with its type,
+         * percent closed, price at close, cost basis snapshot, and entry count at close.
+         *
+         * Returns null if no pending signal exists.
+         * Returns an empty array if no partial closes have been executed.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to array of partial close records or null
+         */
         this.getPositionPartials = async (backtest, symbol, context) => {
             this.loggerService.log("strategyConnectionService getPositionPartials", {
                 symbol,
@@ -9331,6 +9440,27 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionPartials(symbol);
         };
+        /**
+         * Returns the list of DCA entry prices and costs for the current pending signal.
+         *
+         * Each entry records the price and cost of a single position entry.
+         * The first element is always the original priceOpen (initial entry).
+         * Each subsequent element is an entry added by averageBuy().
+         *
+         * Returns null if no pending signal exists.
+         * Returns a single-element array [{ price: priceOpen, cost }] if no DCA entries were made.
+         *
+         * @param backtest - Whether running in backtest mode
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, frameName
+         * @returns Promise resolving to array of entry records or null
+         *
+         * @example
+         * ```typescript
+         * // No DCA: [{ price: 43000, cost: 100 }]
+         * // One DCA: [{ price: 43000, cost: 100 }, { price: 42000, cost: 100 }]
+         * ```
+         */
         this.getPositionEntries = async (backtest, symbol, context) => {
             this.loggerService.log("strategyConnectionService getPositionEntries", {
                 symbol,
@@ -9338,7 +9468,8 @@ class StrategyConnectionService {
                 backtest,
             });
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return await strategy.getPositionEntries(symbol);
+            const timestamp = await this.timeMetaService.getTimestamp(symbol, context, backtest);
+            return await strategy.getPositionEntries(symbol, timestamp);
         };
         /**
          * Retrieves the currently active scheduled signal for the strategy.
@@ -9440,6 +9571,10 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             await strategy.waitForInit();
             const tick = await strategy.tick(symbol, context.strategyName);
+            {
+                this.priceMetaService.next(symbol, tick.currentPrice, context, backtest);
+                this.timeMetaService.next(symbol, tick.createdAt, context, backtest);
+            }
             {
                 await CALL_SIGNAL_EMIT_FN(this, tick, context, backtest, symbol);
             }
@@ -9546,7 +9681,7 @@ class StrategyConnectionService {
                 }
                 return;
             }
-            const key = CREATE_KEY_FN$m(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$o(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getStrategy.has(key)) {
                 return;
             }
@@ -9615,9 +9750,9 @@ class StrategyConnectionService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise<boolean> - true if `partialProfit` would execute, false otherwise
          */
-        this.validatePartialProfit = (backtest, symbol, percentToClose, currentPrice, context) => {
+        this.validatePartialProfit = async (backtest, symbol, percentToClose, currentPrice, context) => {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return Promise.resolve(strategy.validatePartialProfit(symbol, percentToClose, currentPrice));
+            return await strategy.validatePartialProfit(symbol, percentToClose, currentPrice);
         };
         /**
          * Executes partial close at profit level (moving toward TP).
@@ -9658,7 +9793,8 @@ class StrategyConnectionService {
                 backtest,
             });
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return await strategy.partialProfit(symbol, percentToClose, currentPrice, backtest);
+            const timestamp = await this.timeMetaService.getTimestamp(symbol, context, backtest);
+            return await strategy.partialProfit(symbol, percentToClose, currentPrice, backtest, timestamp);
         };
         /**
          * Checks whether `partialLoss` would succeed without executing it.
@@ -9671,9 +9807,9 @@ class StrategyConnectionService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise<boolean> - true if `partialLoss` would execute, false otherwise
          */
-        this.validatePartialLoss = (backtest, symbol, percentToClose, currentPrice, context) => {
+        this.validatePartialLoss = async (backtest, symbol, percentToClose, currentPrice, context) => {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return Promise.resolve(strategy.validatePartialLoss(symbol, percentToClose, currentPrice));
+            return await strategy.validatePartialLoss(symbol, percentToClose, currentPrice);
         };
         /**
          * Executes partial close at loss level (moving toward SL).
@@ -9714,7 +9850,8 @@ class StrategyConnectionService {
                 backtest,
             });
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return await strategy.partialLoss(symbol, percentToClose, currentPrice, backtest);
+            const timestamp = await this.timeMetaService.getTimestamp(symbol, context, backtest);
+            return await strategy.partialLoss(symbol, percentToClose, currentPrice, backtest, timestamp);
         };
         /**
          * Checks whether `trailingStop` would succeed without executing it.
@@ -9727,9 +9864,9 @@ class StrategyConnectionService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise<boolean> - true if `trailingStop` would execute, false otherwise
          */
-        this.validateTrailingStop = (backtest, symbol, percentShift, currentPrice, context) => {
+        this.validateTrailingStop = async (backtest, symbol, percentShift, currentPrice, context) => {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return Promise.resolve(strategy.validateTrailingStop(symbol, percentShift, currentPrice));
+            return await strategy.validateTrailingStop(symbol, percentShift, currentPrice);
         };
         /**
          * Adjusts the trailing stop-loss distance for an active pending signal.
@@ -9781,9 +9918,9 @@ class StrategyConnectionService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise<boolean> - true if `trailingTake` would execute, false otherwise
          */
-        this.validateTrailingTake = (backtest, symbol, percentShift, currentPrice, context) => {
+        this.validateTrailingTake = async (backtest, symbol, percentShift, currentPrice, context) => {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return Promise.resolve(strategy.validateTrailingTake(symbol, percentShift, currentPrice));
+            return await strategy.validateTrailingTake(symbol, percentShift, currentPrice);
         };
         /**
          * Adjusts the trailing take-profit distance for an active pending signal.
@@ -9834,9 +9971,9 @@ class StrategyConnectionService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise<boolean> - true if `breakeven` would execute, false otherwise
          */
-        this.validateBreakeven = (backtest, symbol, currentPrice, context) => {
+        this.validateBreakeven = async (backtest, symbol, currentPrice, context) => {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return Promise.resolve(strategy.validateBreakeven(symbol, currentPrice));
+            return await strategy.validateBreakeven(symbol, currentPrice);
         };
         /**
          * Delegates to ClientStrategy.breakeven() with current execution context.
@@ -9913,9 +10050,9 @@ class StrategyConnectionService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise<boolean> - true if `averageBuy` would execute, false otherwise
          */
-        this.validateAverageBuy = (backtest, symbol, currentPrice, context) => {
+        this.validateAverageBuy = async (backtest, symbol, currentPrice, context) => {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return Promise.resolve(strategy.validateAverageBuy(symbol, currentPrice));
+            return await strategy.validateAverageBuy(symbol, currentPrice);
         };
         /**
          * Adds a new DCA entry to the active pending signal.
@@ -9936,7 +10073,8 @@ class StrategyConnectionService {
                 backtest,
             });
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
-            return await strategy.averageBuy(symbol, currentPrice, backtest, cost);
+            const timestamp = await this.timeMetaService.getTimestamp(symbol, context, backtest);
+            return await strategy.averageBuy(symbol, currentPrice, backtest, timestamp, cost);
         };
     }
 }
@@ -10677,7 +10815,7 @@ class ClientRisk {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$l = (riskName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$n = (riskName, exchangeName, frameName, backtest) => {
     const parts = [riskName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -10776,7 +10914,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$l(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
+        this.getRisk = functoolsKit.memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$n(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
             const schema = this.riskSchemaService.get(riskName);
             return new ClientRisk({
                 ...schema,
@@ -10844,7 +10982,7 @@ class RiskConnectionService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$l(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$n(payload.riskName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getRisk.clear(key);
             }
             else {
@@ -10864,7 +11002,6 @@ const METHOD_NAME_PARTIAL_LOSS_AVAILABLE = "ActionBase.partialLossAvailable";
 const METHOD_NAME_PING_SCHEDULED = "ActionBase.pingScheduled";
 const METHOD_NAME_PING_ACTIVE = "ActionBase.pingActive";
 const METHOD_NAME_RISK_REJECTION = "ActionBase.riskRejection";
-const METHOD_NAME_SIGNAL_SYNC = "ActionBase.signalSync";
 const METHOD_NAME_DISPOSE = "ActionBase.dispose";
 const DEFAULT_SOURCE = "default";
 /**
@@ -11276,6 +11413,11 @@ class ActionProxy {
      */
     async signalSync(event) {
         if (this._target.signalSync) {
+            console.error("Action::signalSync is unwanted cause exchange integration should be implemented in Broker.useBrokerAdapter as an infrastructure domain layer");
+            console.error("If you need to implement custom logic on signal open/close, please use signal(), signalBacktest(), signalLive()");
+            console.error("If Action::signalSync throws the exchange will not execute the order!");
+            console.error("");
+            console.error("You have been warned!");
             await this._target.signalSync(event);
         }
     }
@@ -11738,19 +11880,6 @@ class ActionBase {
             source,
         });
     }
-    /**
-     * Gate for position open/close via limit order. Default allows all.
-     * Throw to reject — framework retries next tick.
-     *
-     * NOTE: Exceptions are NOT swallowed — they propagate to CREATE_SYNC_FN.
-     *
-     * @param event - Sync event with action "signal-open" or "signal-close"
-     */
-    signalSync(_event, source = DEFAULT_SOURCE) {
-        bt.loggerService.info(METHOD_NAME_SIGNAL_SYNC, {
-            source,
-        });
-    }
     /**
      * Cleans up resources and subscriptions when action handler is disposed.
      *
@@ -12320,7 +12449,7 @@ class ClientAction {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$k = (actionName, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$m = (actionName, strategyName, exchangeName, frameName, backtest) => {
     const parts = [actionName, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -12371,7 +12500,7 @@ class ActionConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientAction instance
          */
-        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$k(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
+        this.getAction = functoolsKit.memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
             const schema = this.actionSchemaService.get(actionName);
             return new ClientAction({
                 ...schema,
@@ -12581,7 +12710,7 @@ class ActionConnectionService {
                 await Promise.all(actions.map(async (action) => await action.dispose()));
                 return;
             }
-            const key = CREATE_KEY_FN$k(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            const key = CREATE_KEY_FN$m(payload.actionName, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
             if (!this.getAction.has(key)) {
                 return;
             }
@@ -12599,7 +12728,7 @@ const METHOD_NAME_VALIDATE$2 = "exchangeCoreService validate";
  * @param exchangeName - Exchange name
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$j = (exchangeName) => {
+const CREATE_KEY_FN$l = (exchangeName) => {
     return exchangeName;
 };
 /**
@@ -12623,7 +12752,7 @@ class ExchangeCoreService {
          * @param exchangeName - Name of the exchange to validate
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$j(exchangeName), async (exchangeName) => {
+        this.validate = functoolsKit.memoize(([exchangeName]) => CREATE_KEY_FN$l(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 exchangeName,
             });
@@ -12875,7 +13004,7 @@ const METHOD_NAME_VALIDATE$1 = "strategyCoreService validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$i = (context) => {
+const CREATE_KEY_FN$k = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -12907,7 +13036,7 @@ class StrategyCoreService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$i(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$k(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -13742,7 +13871,7 @@ class SizingGlobalService {
  * @param context - Context with riskName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$h = (context) => {
+const CREATE_KEY_FN$j = (context) => {
     const parts = [context.riskName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -13768,7 +13897,7 @@ class RiskGlobalService {
          * @param payload - Payload with riskName, exchangeName and frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$h(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$j(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -13846,7 +13975,7 @@ const METHOD_NAME_VALIDATE = "actionCoreService validate";
  * @param context - Execution context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$g = (context) => {
+const CREATE_KEY_FN$i = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -13890,7 +14019,7 @@ class ActionCoreService {
          * @param context - Strategy execution context with strategyName, exchangeName and frameName
          * @returns Promise that resolves when all validations complete
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$g(context), async (context) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$i(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -18425,7 +18554,7 @@ const Markdown = new MarkdownAdapter();
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$f = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$h = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -18664,7 +18793,7 @@ class BacktestMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$f(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$8(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$h(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$8(symbol, strategyName, exchangeName, frameName));
         /**
          * Processes tick events and accumulates closed signals.
          * Should be called from IStrategyCallbacks.onTick.
@@ -18821,7 +18950,7 @@ class BacktestMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$f(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$h(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -18883,7 +19012,7 @@ class BacktestMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$e = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$g = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -19366,7 +19495,7 @@ class LiveMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$e(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$7(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$g(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$7(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to live signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -19584,7 +19713,7 @@ class LiveMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$e(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$g(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -19604,7 +19733,7 @@ class LiveMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$d = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$f = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -19895,7 +20024,7 @@ class ScheduleMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$6(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$f(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$6(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to signal emitter to receive scheduled signal events.
          * Protected against multiple subscriptions.
@@ -20098,7 +20227,7 @@ class ScheduleMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$d(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$f(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -20118,7 +20247,7 @@ class ScheduleMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$c = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$e = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -20366,7 +20495,7 @@ class PerformanceMarkdownService {
          * Memoized function to get or create PerformanceStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$c(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new PerformanceStorage(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$e(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new PerformanceStorage(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to performance emitter to receive performance events.
          * Protected against multiple subscriptions.
@@ -20533,7 +20662,7 @@ class PerformanceMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$c(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$e(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -21003,7 +21132,7 @@ class WalkerMarkdownService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$b = (exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$d = (exchangeName, frameName, backtest) => {
     const parts = [exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -21370,7 +21499,7 @@ class HeatMarkdownService {
          * Memoized function to get or create HeatmapStorage for exchange, frame and backtest mode.
          * Each exchangeName + frameName + backtest mode combination gets its own isolated heatmap storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
+        this.getStorage = functoolsKit.memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$d(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
         /**
          * Subscribes to signal emitter to receive tick events.
          * Protected against multiple subscriptions.
@@ -21565,7 +21694,7 @@ class HeatMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$b(payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$d(payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -22596,7 +22725,7 @@ class ClientPartial {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$a = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$c = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting profit events to partialProfitSubject.
  *
@@ -22718,7 +22847,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$a(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$c(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -22808,7 +22937,7 @@ class PartialConnectionService {
             const partial = this.getPartial(data.id, backtest);
             await partial.waitForInit(symbol, data.strategyName, data.exchangeName, backtest);
             await partial.clear(symbol, data, priceClose, backtest);
-            const key = CREATE_KEY_FN$a(data.id, backtest);
+            const key = CREATE_KEY_FN$c(data.id, backtest);
             this.getPartial.clear(key);
         };
     }
@@ -22824,7 +22953,7 @@ class PartialConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$9 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$b = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -23049,7 +23178,7 @@ class PartialMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$9(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$4(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$4(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to partial profit/loss signal emitters to receive events.
          * Protected against multiple subscriptions.
@@ -23259,7 +23388,7 @@ class PartialMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$9(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$b(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -23275,7 +23404,7 @@ class PartialMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$8 = (context) => {
+const CREATE_KEY_FN$a = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -23349,7 +23478,7 @@ class PartialGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$8(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$a(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -23804,7 +23933,7 @@ class ClientBreakeven {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$7 = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
+const CREATE_KEY_FN$9 = (signalId, backtest) => `${signalId}:${backtest ? "backtest" : "live"}`;
 /**
  * Creates a callback function for emitting breakeven events to breakevenSubject.
  *
@@ -23890,7 +24019,7 @@ class BreakevenConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientBreakeven instance with logger and event emitter
          */
-        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$7(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = functoolsKit.memoize(([signalId, backtest]) => CREATE_KEY_FN$9(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -23951,7 +24080,7 @@ class BreakevenConnectionService {
             const breakeven = this.getBreakeven(data.id, backtest);
             await breakeven.waitForInit(symbol, data.strategyName, data.exchangeName, backtest);
             await breakeven.clear(symbol, data, priceClose, backtest);
-            const key = CREATE_KEY_FN$7(data.id, backtest);
+            const key = CREATE_KEY_FN$9(data.id, backtest);
             this.getBreakeven.clear(key);
         };
     }
@@ -23967,7 +24096,7 @@ class BreakevenConnectionService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$6 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$8 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -24144,7 +24273,7 @@ class BreakevenMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$6(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$8(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$3(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to breakeven signal emitter to receive events.
          * Protected against multiple subscriptions.
@@ -24333,7 +24462,7 @@ class BreakevenMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$6(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$8(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -24349,7 +24478,7 @@ class BreakevenMarkdownService {
  * @param context - Context with strategyName, exchangeName, frameName
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$5 = (context) => {
+const CREATE_KEY_FN$7 = (context) => {
     const parts = [context.strategyName, context.exchangeName];
     if (context.frameName)
         parts.push(context.frameName);
@@ -24423,7 +24552,7 @@ class BreakevenGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$5(context), (context, methodName) => {
+        this.validate = functoolsKit.memoize(([context]) => CREATE_KEY_FN$7(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -24643,7 +24772,7 @@ class ConfigValidationService {
  * @param backtest - Whether running in backtest mode
  * @returns Unique string key for memoization
  */
-const CREATE_KEY_FN$4 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$6 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -24812,7 +24941,7 @@ class RiskMarkdownService {
          * Memoized function to get or create ReportStorage for a symbol-strategy-exchange-frame-backtest combination.
          * Each combination gets its own isolated storage instance.
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$4(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$2(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$6(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage$2(symbol, strategyName, exchangeName, frameName));
         /**
          * Subscribes to risk rejection emitter to receive rejection events.
          * Protected against multiple subscriptions.
@@ -25001,7 +25130,7 @@ class RiskMarkdownService {
                 payload,
             });
             if (payload) {
-                const key = CREATE_KEY_FN$4(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$6(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -27689,7 +27818,7 @@ class SyncReportService {
  * @returns Colon-separated key string for memoization
  * @internal
  */
-const CREATE_KEY_FN$3 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$5 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -27937,7 +28066,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$3(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$1(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$5(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName) => new ReportStorage$1(symbol, strategyName, exchangeName, frameName));
         /**
          * Records a cancel-scheduled event when a scheduled signal is cancelled.
          *
@@ -28505,7 +28634,7 @@ class StrategyMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("strategyMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$3(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$5(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -28613,7 +28742,7 @@ class StrategyMarkdownService {
  * Creates a unique key for memoizing ReportStorage instances.
  * Key format: "symbol:strategyName:exchangeName[:frameName]:backtest|live"
  */
-const CREATE_KEY_FN$2 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+const CREATE_KEY_FN$4 = (symbol, strategyName, exchangeName, frameName, backtest) => {
     const parts = [symbol, strategyName, exchangeName];
     if (frameName)
         parts.push(frameName);
@@ -28745,7 +28874,7 @@ class ReportStorage {
 class SyncMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$2(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
+        this.getStorage = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$4(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => new ReportStorage(symbol, strategyName, exchangeName, frameName));
         this.subscribe = functoolsKit.singleshot(() => {
             this.loggerService.log("syncMarkdownService init");
             const unsubscribe = syncSubject.subscribe(this.tick);
@@ -28820,7 +28949,7 @@ class SyncMarkdownService {
         this.clear = async (payload) => {
             this.loggerService.log("syncMarkdownService clear", { payload });
             if (payload) {
-                const key = CREATE_KEY_FN$2(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+                const key = CREATE_KEY_FN$4(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
                 this.getStorage.clear(key);
             }
             else {
@@ -28830,6 +28959,275 @@ class SyncMarkdownService {
     }
 }
 
+const LISTEN_TIMEOUT$1 = 120000;
+/**
+ * Creates a unique memoization key for a price stream.
+ * Key format: "symbol:strategyName:exchangeName[:frameName]:backtest|live"
+ *
+ * @param symbol - Trading pair symbol (e.g., "BTCUSDT")
+ * @param strategyName - Strategy identifier
+ * @param exchangeName - Exchange identifier
+ * @param frameName - Frame identifier (omitted when empty)
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$3 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+    const parts = [symbol, strategyName, exchangeName];
+    if (frameName)
+        parts.push(frameName);
+    parts.push(backtest ? "backtest" : "live");
+    return parts.join(":");
+};
+/**
+ * Service for tracking the latest market price per symbol-strategy-exchange-frame combination.
+ *
+ * Maintains a memoized BehaviorSubject per unique key that is updated on every strategy tick
+ * by StrategyConnectionService. Consumers can synchronously read the last known price or
+ * await the first value if none has arrived yet.
+ *
+ * Primary use case: providing the current price outside of a tick execution context,
+ * e.g., when a command is triggered between ticks.
+ *
+ * Features:
+ * - One BehaviorSubject per (symbol, strategyName, exchangeName, frameName, backtest) key
+ * - Falls back to ExchangeConnectionService.getAveragePrice when called inside an execution context
+ * - Waits up to LISTEN_TIMEOUT ms for the first price if none is cached yet
+ * - clear() disposes the BehaviorSubject for a single key or all keys
+ *
+ * Architecture:
+ * - Registered as singleton in DI container
+ * - Updated by StrategyConnectionService after each tick
+ * - Cleared by Backtest/Live/Walker at strategy start to prevent stale data
+ *
+ * @example
+ * ```typescript
+ * const price = await backtest.priceMetaService.getCurrentPrice("BTCUSDT", context, false);
+ * ```
+ */
+class PriceMetaService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.exchangeConnectionService = inject(TYPES.exchangeConnectionService);
+        /**
+         * Memoized factory for BehaviorSubject streams keyed by (symbol, strategyName, exchangeName, frameName, backtest).
+         *
+         * Each subject holds the latest currentPrice emitted by the strategy iterator for that key.
+         * Instances are cached until clear() is called.
+         */
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$3(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        /**
+         * Returns the current market price for the given symbol and context.
+         *
+         * When called inside an execution context (i.e., during a signal handler or action),
+         * delegates to ExchangeConnectionService.getAveragePrice for the live exchange price.
+         * Otherwise, reads the last value from the cached BehaviorSubject. If no value has
+         * been emitted yet, waits up to LISTEN_TIMEOUT ms for the first tick before throwing.
+         *
+         * @param symbol - Trading pair symbol (e.g., "BTCUSDT")
+         * @param context - Strategy, exchange, and frame identifiers
+         * @param backtest - True if backtest mode, false if live mode
+         * @returns Current market price in quote currency
+         * @throws When no price arrives within LISTEN_TIMEOUT ms
+         */
+        this.getCurrentPrice = async (symbol, context, backtest) => {
+            this.loggerService.log("priceMetaService getCurrentPrice", {
+                symbol,
+                context,
+                backtest,
+            });
+            if (ExecutionContextService.hasContext() &&
+                MethodContextService.hasContext()) {
+                return await this.exchangeConnectionService.getAveragePrice(symbol);
+            }
+            const source = this.getSource(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
+            if (source.data) {
+                return source.data;
+            }
+            console.warn(`PriceMetaService: No currentPrice available for ${CREATE_KEY_FN$3(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
+            const currentPrice = await functoolsKit.waitForNext(source, (data) => !!data, LISTEN_TIMEOUT$1);
+            if (typeof currentPrice === "symbol") {
+                throw new Error(`PriceMetaService: Timeout while waiting for currentPrice for ${CREATE_KEY_FN$3(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
+            }
+            return currentPrice;
+        };
+        /**
+         * Pushes a new price value into the BehaviorSubject for the given key.
+         *
+         * Called by StrategyConnectionService after each strategy tick to keep
+         * the cached price up to date.
+         *
+         * @param symbol - Trading pair symbol (e.g., "BTCUSDT")
+         * @param currentPrice - The latest price from the tick
+         * @param context - Strategy, exchange, and frame identifiers
+         * @param backtest - True if backtest mode, false if live mode
+         */
+        this.next = async (symbol, currentPrice, context, backtest) => {
+            this.loggerService.log("priceMetaService next", {
+                symbol,
+                currentPrice,
+                context,
+                backtest,
+            });
+            const source = this.getSource(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
+            source.next(currentPrice);
+        };
+        /**
+         * Disposes cached BehaviorSubject(s) to free memory and prevent stale data.
+         *
+         * When called without arguments, clears all memoized price streams.
+         * When called with a payload, clears only the stream for the specified key.
+         * Should be called at strategy start (Backtest/Live/Walker) to reset state.
+         *
+         * @param payload - Optional key to clear a single stream; omit to clear all
+         */
+        this.clear = (payload) => {
+            this.loggerService.log("priceMetaService clear", {
+                payload
+            });
+            if (!payload) {
+                this.getSource.clear();
+                return;
+            }
+            const key = CREATE_KEY_FN$3(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            this.getSource.clear(key);
+        };
+    }
+}
+
+const LISTEN_TIMEOUT = 120000;
+/**
+ * Creates a unique memoization key for a timestamp stream.
+ * Key format: "symbol:strategyName:exchangeName[:frameName]:backtest|live"
+ *
+ * @param symbol - Trading pair symbol (e.g., "BTCUSDT")
+ * @param strategyName - Strategy identifier
+ * @param exchangeName - Exchange identifier
+ * @param frameName - Frame identifier (omitted when empty)
+ * @param backtest - Whether running in backtest mode
+ * @returns Unique string key for memoization
+ */
+const CREATE_KEY_FN$2 = (symbol, strategyName, exchangeName, frameName, backtest) => {
+    const parts = [symbol, strategyName, exchangeName];
+    if (frameName)
+        parts.push(frameName);
+    parts.push(backtest ? "backtest" : "live");
+    return parts.join(":");
+};
+/**
+ * Service for tracking the latest candle timestamp per symbol-strategy-exchange-frame combination.
+ *
+ * Maintains a memoized BehaviorSubject per unique key that is updated on every strategy tick
+ * by StrategyConnectionService. Consumers can synchronously read the last known timestamp or
+ * await the first value if none has arrived yet.
+ *
+ * Primary use case: providing the current candle time outside of a tick execution context,
+ * e.g., when a command is triggered between ticks.
+ *
+ * Features:
+ * - One BehaviorSubject per (symbol, strategyName, exchangeName, frameName, backtest) key
+ * - Falls back to ExecutionContextService.context.when when called inside an execution context
+ * - Waits up to LISTEN_TIMEOUT ms for the first timestamp if none is cached yet
+ * - clear() disposes the BehaviorSubject for a single key or all keys
+ *
+ * Architecture:
+ * - Registered as singleton in DI container
+ * - Updated by StrategyConnectionService after each tick
+ * - Cleared by Backtest/Live/Walker at strategy start to prevent stale data
+ *
+ * @example
+ * ```typescript
+ * const ts = await backtest.timeMetaService.getTimestamp("BTCUSDT", context, false);
+ * ```
+ */
+class TimeMetaService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.executionContextService = inject(TYPES.executionContextService);
+        /**
+         * Memoized factory for BehaviorSubject streams keyed by (symbol, strategyName, exchangeName, frameName, backtest).
+         *
+         * Each subject holds the latest createdAt timestamp emitted by the strategy iterator for that key.
+         * Instances are cached until clear() is called.
+         */
+        this.getSource = functoolsKit.memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$2(symbol, strategyName, exchangeName, frameName, backtest), () => new functoolsKit.BehaviorSubject());
+        /**
+         * Returns the current candle timestamp (in milliseconds) for the given symbol and context.
+         *
+         * When called inside an execution context (i.e., during a signal handler or action),
+         * reads the timestamp directly from ExecutionContextService.context.when.
+         * Otherwise, reads the last value from the cached BehaviorSubject. If no value has
+         * been emitted yet, waits up to LISTEN_TIMEOUT ms for the first tick before throwing.
+         *
+         * @param symbol - Trading pair symbol (e.g., "BTCUSDT")
+         * @param context - Strategy, exchange, and frame identifiers
+         * @param backtest - True if backtest mode, false if live mode
+         * @returns Unix timestamp in milliseconds of the latest processed candle
+         * @throws When no timestamp arrives within LISTEN_TIMEOUT ms
+         */
+        this.getTimestamp = async (symbol, context, backtest) => {
+            this.loggerService.log("timeMetaService getTimestamp", {
+                symbol,
+                context,
+                backtest,
+            });
+            if (ExecutionContextService.hasContext()) {
+                return this.executionContextService.context.when.getTime();
+            }
+            const source = this.getSource(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
+            if (source.data) {
+                return source.data;
+            }
+            console.warn(`TimeMetaService: No timestamp available for ${CREATE_KEY_FN$2(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}. Trying to fetch from strategy iterator as a fallback...`);
+            const timestamp = await functoolsKit.waitForNext(source, (data) => !!data, LISTEN_TIMEOUT);
+            if (typeof timestamp === "symbol") {
+                throw new Error(`TimeMetaService: Timeout while waiting for timestamp for ${CREATE_KEY_FN$2(symbol, context.strategyName, context.exchangeName, context.frameName, backtest)}`);
+            }
+            return timestamp;
+        };
+        /**
+         * Pushes a new timestamp value into the BehaviorSubject for the given key.
+         *
+         * Called by StrategyConnectionService after each strategy tick to keep
+         * the cached timestamp up to date.
+         *
+         * @param symbol - Trading pair symbol (e.g., "BTCUSDT")
+         * @param timestamp - The createdAt timestamp from the tick (milliseconds)
+         * @param context - Strategy, exchange, and frame identifiers
+         * @param backtest - True if backtest mode, false if live mode
+         */
+        this.next = async (symbol, timestamp, context, backtest) => {
+            this.loggerService.log("timeMetaService next", {
+                symbol,
+                timestamp,
+                context,
+                backtest,
+            });
+            const source = this.getSource(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
+            source.next(timestamp);
+        };
+        /**
+         * Disposes cached BehaviorSubject(s) to free memory and prevent stale data.
+         *
+         * When called without arguments, clears all memoized timestamp streams.
+         * When called with a payload, clears only the stream for the specified key.
+         * Should be called at strategy start (Backtest/Live/Walker) to reset state.
+         *
+         * @param payload - Optional key to clear a single stream; omit to clear all
+         */
+        this.clear = (payload) => {
+            this.loggerService.log("timeMetaService clear", {
+                payload,
+            });
+            if (!payload) {
+                this.getSource.clear();
+                return;
+            }
+            const key = CREATE_KEY_FN$2(payload.symbol, payload.strategyName, payload.exchangeName, payload.frameName, payload.backtest);
+            this.getSource.clear(key);
+        };
+    }
+}
+
 {
     provide(TYPES.loggerService, () => new LoggerService());
 }
@@ -28862,6 +29260,10 @@ class SyncMarkdownService {
     provide(TYPES.actionCoreService, () => new ActionCoreService());
     provide(TYPES.frameCoreService, () => new FrameCoreService());
 }
+{
+    provide(TYPES.priceMetaService, () => new PriceMetaService());
+    provide(TYPES.timeMetaService, () => new TimeMetaService());
+}
 {
     provide(TYPES.sizingGlobalService, () => new SizingGlobalService());
     provide(TYPES.riskGlobalService, () => new RiskGlobalService());
@@ -28953,6 +29355,10 @@ const coreServices = {
     actionCoreService: inject(TYPES.actionCoreService),
     frameCoreService: inject(TYPES.frameCoreService),
 };
+const metaServices = {
+    timeMetaService: inject(TYPES.timeMetaService),
+    priceMetaService: inject(TYPES.priceMetaService),
+};
 const globalServices = {
     sizingGlobalService: inject(TYPES.sizingGlobalService),
     riskGlobalService: inject(TYPES.riskGlobalService),
@@ -29017,6 +29423,7 @@ const backtest = {
     ...connectionServices,
     ...schemaServices,
     ...coreServices,
+    ...metaServices,
     ...globalServices,
     ...commandServices,
     ...logicPrivateServices,
@@ -31781,6 +32188,11 @@ BrokerBase = functoolsKit.makeExtendable(BrokerBase);
  */
 const Broker = new BrokerAdapter();
 
+const POSITION_OVERLAP_LADDER_DEFAULT = {
+    upperPercent: 1.5,
+    lowerPercent: 1.5,
+};
+
 const CANCEL_SCHEDULED_METHOD_NAME = "strategy.commitCancelScheduled";
 const CLOSE_PENDING_METHOD_NAME = "strategy.commitClosePending";
 const PARTIAL_PROFIT_METHOD_NAME = "strategy.commitPartialProfit";
@@ -31806,6 +32218,8 @@ const GET_POSITION_PNL_PERCENT_METHOD_NAME = "strategy.getPositionPnlPercent";
 const GET_POSITION_PNL_COST_METHOD_NAME = "strategy.getPositionPnlCost";
 const GET_POSITION_LEVELS_METHOD_NAME = "strategy.getPositionLevels";
 const GET_POSITION_PARTIALS_METHOD_NAME = "strategy.getPositionPartials";
+const GET_POSITION_ENTRY_OVERLAP_METHOD_NAME = "strategy.getPositionEntryOverlap";
+const GET_POSITION_PARTIAL_OVERLAP_METHOD_NAME = "strategy.getPositionPartialOverlap";
 /**
  * Cancels the scheduled signal without stopping the strategy.
  *
@@ -32082,6 +32496,7 @@ async function commitTrailingStop(symbol, percentShift, currentPrice) {
         percentShift,
         currentPrice,
         newStopLossPrice: slPercentShiftToPrice(percentShift, signal.priceStopLoss, effectivePriceOpen, signal.position),
+        takeProfitPrice: signal.priceTakeProfit,
         position: signal.position,
         context: { exchangeName, frameName, strategyName },
         backtest: isBacktest,
@@ -32161,6 +32576,7 @@ async function commitTrailingTake(symbol, percentShift, currentPrice) {
         percentShift,
         currentPrice,
         newTakeProfitPrice: tpPercentShiftToPrice(percentShift, signal.priceTakeProfit, effectivePriceOpen, signal.position),
+        takeProfitPrice: signal.priceTakeProfit,
         position: signal.position,
         context: { exchangeName, frameName, strategyName },
         backtest: isBacktest,
@@ -32212,6 +32628,7 @@ async function commitTrailingStopCost(symbol, newStopLossPrice) {
         currentPrice,
         newStopLossPrice,
         position: signal.position,
+        takeProfitPrice: signal.priceTakeProfit,
         context: { exchangeName, frameName, strategyName },
         backtest: isBacktest,
     });
@@ -32261,6 +32678,7 @@ async function commitTrailingTakeCost(symbol, newTakeProfitPrice) {
         percentShift,
         currentPrice,
         newTakeProfitPrice,
+        takeProfitPrice: signal.priceTakeProfit,
         position: signal.position,
         context: { exchangeName, frameName, strategyName },
         backtest: isBacktest,
@@ -32587,6 +33005,31 @@ async function getBreakeven(symbol, currentPrice) {
     const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
     return await bt.strategyCoreService.getBreakeven(isBacktest, symbol, currentPrice, { exchangeName, frameName, strategyName });
 }
+/**
+ * Returns the effective (DCA-weighted) entry price for the current pending signal.
+ *
+ * Uses cost-weighted harmonic mean: Σcost / Σ(cost/price).
+ * When partial closes exist, the price is computed iteratively using
+ * costBasisAtClose snapshots from each partial, then blended with any
+ * DCA entries added after the last partial.
+ * With no DCA entries, equals the original priceOpen.
+ *
+ * Returns null if no pending signal exists.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to effective entry price or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionAveragePrice } from "backtest-kit";
+ *
+ * const avgPrice = await getPositionAveragePrice("BTCUSDT");
+ * // No DCA: avgPrice === priceOpen
+ * // After DCA at lower price: avgPrice < priceOpen
+ * ```
+ */
 async function getPositionAveragePrice(symbol) {
     bt.loggerService.info(GET_POSITION_AVERAGE_PRICE_METHOD_NAME, {
         symbol,
@@ -32601,6 +33044,28 @@ async function getPositionAveragePrice(symbol) {
     const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
     return await bt.strategyCoreService.getPositionAveragePrice(isBacktest, symbol, { exchangeName, frameName, strategyName });
 }
+/**
+ * Returns the number of DCA entries made for the current pending signal.
+ *
+ * 1 = original entry only (no DCA).
+ * Increases by 1 with each successful commitAverageBuy().
+ *
+ * Returns null if no pending signal exists.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to entry count or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionInvestedCount } from "backtest-kit";
+ *
+ * const count = await getPositionInvestedCount("BTCUSDT");
+ * // No DCA: count === 1
+ * // After one DCA: count === 2
+ * ```
+ */
 async function getPositionInvestedCount(symbol) {
     bt.loggerService.info(GET_POSITION_INVESTED_COUNT_METHOD_NAME, {
         symbol,
@@ -32615,6 +33080,28 @@ async function getPositionInvestedCount(symbol) {
     const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
     return await bt.strategyCoreService.getPositionInvestedCount(isBacktest, symbol, { exchangeName, frameName, strategyName });
 }
+/**
+ * Returns the total invested cost basis in dollars for the current pending signal.
+ *
+ * Equal to the sum of all _entry costs (Σ entry.cost).
+ * Each entry cost is set at the time of commitAverageBuy (defaults to CC_POSITION_ENTRY_COST).
+ *
+ * Returns null if no pending signal exists.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to total invested cost in dollars or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionInvestedCost } from "backtest-kit";
+ *
+ * const cost = await getPositionInvestedCost("BTCUSDT");
+ * // No DCA, default cost: cost === 100
+ * // After one DCA with default cost: cost === 200
+ * ```
+ */
 async function getPositionInvestedCost(symbol) {
     bt.loggerService.info(GET_POSITION_INVESTED_COST_METHOD_NAME, {
         symbol,
@@ -32629,6 +33116,29 @@ async function getPositionInvestedCost(symbol) {
     const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
     return await bt.strategyCoreService.getPositionInvestedCost(isBacktest, symbol, { exchangeName, frameName, strategyName });
 }
+/**
+ * Returns the unrealized PNL percentage for the current pending signal at current market price.
+ *
+ * Accounts for partial closes, DCA entries, slippage and fees
+ * (delegates to toProfitLossDto).
+ *
+ * Returns null if no pending signal exists.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ * Automatically fetches current price via getAveragePrice.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to PNL percentage or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionPnlPercent } from "backtest-kit";
+ *
+ * const pnlPct = await getPositionPnlPercent("BTCUSDT");
+ * // LONG at 100, current=105: pnlPct ≈ 5
+ * // LONG at 100, current=95: pnlPct ≈ -5
+ * ```
+ */
 async function getPositionPnlPercent(symbol) {
     bt.loggerService.info(GET_POSITION_PNL_PERCENT_METHOD_NAME, { symbol });
     if (!ExecutionContextService.hasContext()) {
@@ -32778,6 +33288,29 @@ async function commitPartialLossCost(symbol, dollarAmount) {
     });
     return await bt.strategyCoreService.partialLoss(isBacktest, symbol, percentToClose, currentPrice, { exchangeName, frameName, strategyName });
 }
+/**
+ * Returns the unrealized PNL in dollars for the current pending signal at current market price.
+ *
+ * Calculated as: pnlPercentage / 100 × totalInvestedCost.
+ * Accounts for partial closes, DCA entries, slippage and fees.
+ *
+ * Returns null if no pending signal exists.
+ *
+ * Automatically detects backtest/live mode from execution context.
+ * Automatically fetches current price via getAveragePrice.
+ *
+ * @param symbol - Trading pair symbol
+ * @returns Promise resolving to PNL in dollars or null
+ *
+ * @example
+ * ```typescript
+ * import { getPositionPnlCost } from "backtest-kit";
+ *
+ * const pnlCost = await getPositionPnlCost("BTCUSDT");
+ * // LONG at 100, invested $100, current=105: pnlCost ≈ 5
+ * // LONG at 100, invested $200 (DCA), current=95: pnlCost ≈ -10
+ * ```
+ */
 async function getPositionPnlCost(symbol) {
     bt.loggerService.info(GET_POSITION_PNL_COST_METHOD_NAME, { symbol });
     if (!ExecutionContextService.hasContext()) {
@@ -32864,6 +33397,104 @@ async function getPositionPartials(symbol) {
     const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
     return await bt.strategyCoreService.getPositionPartials(isBacktest, symbol, { exchangeName, frameName, strategyName });
 }
+/**
+ * Checks whether the current price falls within the tolerance zone of any existing DCA entry level.
+ * Use this to prevent duplicate DCA entries at the same price area.
+ *
+ * Returns true if currentPrice is within [level - lowerStep, level + upperStep] for any level,
+ * where step = level * percent / 100.
+ * Returns false if no pending signal exists.
+ *
+ * @param symbol - Trading pair symbol
+ * @param currentPrice - Price to check against existing DCA levels
+ * @param ladder - Tolerance zone config; percentages in 0–100 format (default: 1.5% up and down)
+ * @returns Promise<boolean> - true if price overlaps an existing entry level (DCA not recommended)
+ *
+ * @example
+ * ```typescript
+ * import { getPositionEntryOverlap } from "backtest-kit";
+ *
+ * // LONG with levels [43000, 42000], check if 42100 is too close to 42000
+ * const overlap = await getPositionEntryOverlap("BTCUSDT", 42100, { upperPercent: 5, lowerPercent: 5 });
+ * // overlap = true (42100 is within 5% of 42000 = [39900, 44100])
+ * if (!overlap) {
+ *   await commitAverageBuy("BTCUSDT");
+ * }
+ * ```
+ */
+async function getPositionEntryOverlap(symbol, currentPrice, ladder = POSITION_OVERLAP_LADDER_DEFAULT) {
+    bt.loggerService.info(GET_POSITION_ENTRY_OVERLAP_METHOD_NAME, {
+        symbol,
+        currentPrice,
+        ladder,
+    });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("getPositionEntryOverlap requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("getPositionEntryOverlap requires a method context");
+    }
+    const { backtest: isBacktest } = bt.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
+    const levels = await bt.strategyCoreService.getPositionLevels(isBacktest, symbol, { exchangeName, frameName, strategyName });
+    if (!levels) {
+        return false;
+    }
+    return levels.some((level) => {
+        const upperStep = (level * ladder.upperPercent) / 100;
+        const lowerStep = (level * ladder.lowerPercent) / 100;
+        return currentPrice >= level - lowerStep && currentPrice <= level + upperStep;
+    });
+}
+/**
+ * Checks whether the current price falls within the tolerance zone of any existing partial close price.
+ * Use this to prevent duplicate partial closes at the same price area.
+ *
+ * Returns true if currentPrice is within [partial.currentPrice - lowerStep, partial.currentPrice + upperStep]
+ * for any partial, where step = partial.currentPrice * percent / 100.
+ * Returns false if no pending signal exists or no partials have been executed yet.
+ *
+ * @param symbol - Trading pair symbol
+ * @param currentPrice - Price to check against existing partial close prices
+ * @param ladder - Tolerance zone config; percentages in 0–100 format (default: 1.5% up and down)
+ * @returns Promise<boolean> - true if price overlaps an existing partial price (partial not recommended)
+ *
+ * @example
+ * ```typescript
+ * import { getPositionPartialOverlap } from "backtest-kit";
+ *
+ * // Partials at [45000], check if 45100 is too close
+ * const overlap = await getPositionPartialOverlap("BTCUSDT", 45100, { upperPercent: 1.5, lowerPercent: 1.5 });
+ * // overlap = true (45100 is within 1.5% of 45000)
+ * if (!overlap) {
+ *   await commitPartialProfit("BTCUSDT", 50);
+ * }
+ * ```
+ */
+async function getPositionPartialOverlap(symbol, currentPrice, ladder = POSITION_OVERLAP_LADDER_DEFAULT) {
+    bt.loggerService.info(GET_POSITION_PARTIAL_OVERLAP_METHOD_NAME, {
+        symbol,
+        currentPrice,
+        ladder,
+    });
+    if (!ExecutionContextService.hasContext()) {
+        throw new Error("getPositionPartialOverlap requires an execution context");
+    }
+    if (!MethodContextService.hasContext()) {
+        throw new Error("getPositionPartialOverlap requires a method context");
+    }
+    const { backtest: isBacktest } = bt.executionContextService.context;
+    const { exchangeName, frameName, strategyName } = bt.methodContextService.context;
+    const partials = await bt.strategyCoreService.getPositionPartials(isBacktest, symbol, { exchangeName, frameName, strategyName });
+    if (!partials) {
+        return false;
+    }
+    return partials.some((partial) => {
+        const upperStep = (partial.currentPrice * ladder.upperPercent) / 100;
+        const lowerStep = (partial.currentPrice * ladder.lowerPercent) / 100;
+        return currentPrice >= partial.currentPrice - lowerStep && currentPrice <= partial.currentPrice + upperStep;
+    });
+}
 
 const STOP_STRATEGY_METHOD_NAME = "control.stopStrategy";
 /**
@@ -34090,6 +34721,8 @@ const BACKTEST_METHOD_NAME_GET_POSITION_PNL_COST = "BacktestUtils.getPositionPnl
 const BACKTEST_METHOD_NAME_GET_POSITION_LEVELS = "BacktestUtils.getPositionLevels";
 const BACKTEST_METHOD_NAME_GET_POSITION_PARTIALS = "BacktestUtils.getPositionPartials";
 const BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES = "BacktestUtils.getPositionEntries";
+const BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP = "BacktestUtils.getPositionEntryOverlap";
+const BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP = "BacktestUtils.getPositionPartialOverlap";
 const BACKTEST_METHOD_NAME_BREAKEVEN = "Backtest.commitBreakeven";
 const BACKTEST_METHOD_NAME_CANCEL_SCHEDULED = "Backtest.commitCancelScheduled";
 const BACKTEST_METHOD_NAME_CLOSE_PENDING = "Backtest.commitClosePending";
@@ -34277,6 +34910,20 @@ class BacktestInstance {
                     frameName: context.frameName,
                     backtest: true,
                 });
+                bt.timeMetaService.clear({
+                    symbol,
+                    strategyName: context.strategyName,
+                    exchangeName: context.exchangeName,
+                    frameName: context.frameName,
+                    backtest: true,
+                });
+                bt.priceMetaService.clear({
+                    symbol,
+                    strategyName: context.strategyName,
+                    exchangeName: context.exchangeName,
+                    frameName: context.frameName,
+                    backtest: true,
+                });
             }
             {
                 const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
@@ -34880,6 +35527,90 @@ class BacktestUtils {
             }
             return await bt.strategyCoreService.getPositionEntries(true, symbol, context);
         };
+        /**
+         * Checks whether the current price falls within the tolerance zone of any existing DCA entry level.
+         * Use this to prevent duplicate DCA entries at the same price area.
+         *
+         * Returns true if currentPrice is within [level - lowerStep, level + upperStep] for any level,
+         * where step = level * percent / 100.
+         * Returns false if no pending signal exists.
+         *
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Price to check against existing DCA levels
+         * @param context - Execution context with strategyName, exchangeName, and frameName
+         * @param ladder - Tolerance zone config; percentages in 0–100 format (default: 1.5% up and down)
+         * @returns true if price overlaps an existing entry level (DCA not recommended)
+         */
+        this.getPositionEntryOverlap = async (symbol, currentPrice, context, ladder = POSITION_OVERLAP_LADDER_DEFAULT) => {
+            bt.loggerService.info(BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP, {
+                symbol,
+                currentPrice,
+                context,
+                ladder,
+            });
+            bt.strategyValidationService.validate(context.strategyName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP);
+            bt.exchangeValidationService.validate(context.exchangeName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP));
+            }
+            const levels = await bt.strategyCoreService.getPositionLevels(true, symbol, context);
+            if (!levels) {
+                return false;
+            }
+            return levels.some((level) => {
+                const upperStep = (level * ladder.upperPercent) / 100;
+                const lowerStep = (level * ladder.lowerPercent) / 100;
+                return currentPrice >= level - lowerStep && currentPrice <= level + upperStep;
+            });
+        };
+        /**
+         * Checks whether the current price falls within the tolerance zone of any existing partial close price.
+         * Use this to prevent duplicate partial closes at the same price area.
+         *
+         * Returns true if currentPrice is within [partial.currentPrice - lowerStep, partial.currentPrice + upperStep]
+         * for any partial, where step = partial.currentPrice * percent / 100.
+         * Returns false if no pending signal exists or no partials have been executed yet.
+         *
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Price to check against existing partial close prices
+         * @param context - Execution context with strategyName, exchangeName, and frameName
+         * @param ladder - Tolerance zone config; percentages in 0–100 format (default: 1.5% up and down)
+         * @returns true if price overlaps an existing partial price (partial not recommended)
+         */
+        this.getPositionPartialOverlap = async (symbol, currentPrice, context, ladder = POSITION_OVERLAP_LADDER_DEFAULT) => {
+            bt.loggerService.info(BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP, {
+                symbol,
+                currentPrice,
+                context,
+                ladder,
+            });
+            bt.strategyValidationService.validate(context.strategyName, BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP);
+            bt.exchangeValidationService.validate(context.exchangeName, BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, BACKTEST_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP));
+            }
+            const partials = await bt.strategyCoreService.getPositionPartials(true, symbol, context);
+            if (!partials) {
+                return false;
+            }
+            return partials.some((partial) => {
+                const upperStep = (partial.currentPrice * ladder.upperPercent) / 100;
+                const lowerStep = (partial.currentPrice * ladder.lowerPercent) / 100;
+                return currentPrice >= partial.currentPrice - lowerStep && currentPrice <= partial.currentPrice + upperStep;
+            });
+        };
         /**
          * Stops the strategy from generating new signals.
          *
@@ -35369,6 +36100,7 @@ class BacktestUtils {
                 percentShift,
                 currentPrice,
                 newStopLossPrice: slPercentShiftToPrice(percentShift, signal.priceStopLoss, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: true,
@@ -35453,6 +36185,7 @@ class BacktestUtils {
                 percentShift,
                 currentPrice,
                 newTakeProfitPrice: tpPercentShiftToPrice(percentShift, signal.priceTakeProfit, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: true,
@@ -35507,6 +36240,7 @@ class BacktestUtils {
                 currentPrice,
                 newStopLossPrice,
                 position: signal.position,
+                takeProfitPrice: signal.priceTakeProfit,
                 context,
                 backtest: true,
             });
@@ -35560,6 +36294,7 @@ class BacktestUtils {
                 currentPrice,
                 newTakeProfitPrice,
                 position: signal.position,
+                takeProfitPrice: signal.priceTakeProfit,
                 context,
                 backtest: true,
             });
@@ -35903,6 +36638,8 @@ const LIVE_METHOD_NAME_GET_POSITION_PNL_COST = "LiveUtils.getPositionPnlCost";
 const LIVE_METHOD_NAME_GET_POSITION_LEVELS = "LiveUtils.getPositionLevels";
 const LIVE_METHOD_NAME_GET_POSITION_PARTIALS = "LiveUtils.getPositionPartials";
 const LIVE_METHOD_NAME_GET_POSITION_ENTRIES = "LiveUtils.getPositionEntries";
+const LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP = "LiveUtils.getPositionEntryOverlap";
+const LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP = "LiveUtils.getPositionPartialOverlap";
 const LIVE_METHOD_NAME_BREAKEVEN = "Live.commitBreakeven";
 const LIVE_METHOD_NAME_CANCEL_SCHEDULED = "Live.cancelScheduled";
 const LIVE_METHOD_NAME_CLOSE_PENDING = "Live.closePending";
@@ -36091,6 +36828,20 @@ class LiveInstance {
                     frameName: "",
                     backtest: false,
                 });
+                bt.timeMetaService.clear({
+                    symbol,
+                    strategyName: context.strategyName,
+                    exchangeName: context.exchangeName,
+                    frameName: "",
+                    backtest: false,
+                });
+                bt.priceMetaService.clear({
+                    symbol,
+                    strategyName: context.strategyName,
+                    exchangeName: context.exchangeName,
+                    frameName: "",
+                    backtest: false,
+                });
             }
             {
                 const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
@@ -36756,6 +37507,98 @@ class LiveUtils {
                 frameName: "",
             });
         };
+        /**
+         * Checks whether the current price falls within the tolerance zone of any existing DCA entry level.
+         * Use this to prevent duplicate DCA entries at the same price area.
+         *
+         * Returns true if currentPrice is within [level - lowerStep, level + upperStep] for any level,
+         * where step = level * percent / 100.
+         * Returns false if no pending signal exists.
+         *
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Price to check against existing DCA levels
+         * @param context - Execution context with strategyName and exchangeName
+         * @param ladder - Tolerance zone config; percentages in 0–100 format (default: 1.5% up and down)
+         * @returns true if price overlaps an existing entry level (DCA not recommended)
+         */
+        this.getPositionEntryOverlap = async (symbol, currentPrice, context, ladder = POSITION_OVERLAP_LADDER_DEFAULT) => {
+            bt.loggerService.info(LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP, {
+                symbol,
+                currentPrice,
+                context,
+                ladder,
+            });
+            bt.strategyValidationService.validate(context.strategyName, LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP);
+            bt.exchangeValidationService.validate(context.exchangeName, LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, LIVE_METHOD_NAME_GET_POSITION_ENTRY_OVERLAP));
+            }
+            const levels = await bt.strategyCoreService.getPositionLevels(false, symbol, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: "",
+            });
+            if (!levels) {
+                return false;
+            }
+            return levels.some((level) => {
+                const upperStep = (level * ladder.upperPercent) / 100;
+                const lowerStep = (level * ladder.lowerPercent) / 100;
+                return currentPrice >= level - lowerStep && currentPrice <= level + upperStep;
+            });
+        };
+        /**
+         * Checks whether the current price falls within the tolerance zone of any existing partial close price.
+         * Use this to prevent duplicate partial closes at the same price area.
+         *
+         * Returns true if currentPrice is within [partial.currentPrice - lowerStep, partial.currentPrice + upperStep]
+         * for any partial, where step = partial.currentPrice * percent / 100.
+         * Returns false if no pending signal exists or no partials have been executed yet.
+         *
+         * @param symbol - Trading pair symbol
+         * @param currentPrice - Price to check against existing partial close prices
+         * @param context - Execution context with strategyName and exchangeName
+         * @param ladder - Tolerance zone config; percentages in 0–100 format (default: 1.5% up and down)
+         * @returns true if price overlaps an existing partial price (partial not recommended)
+         */
+        this.getPositionPartialOverlap = async (symbol, currentPrice, context, ladder = POSITION_OVERLAP_LADDER_DEFAULT) => {
+            bt.loggerService.info(LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP, {
+                symbol,
+                currentPrice,
+                context,
+                ladder,
+            });
+            bt.strategyValidationService.validate(context.strategyName, LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP);
+            bt.exchangeValidationService.validate(context.exchangeName, LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, LIVE_METHOD_NAME_GET_POSITION_PARTIAL_OVERLAP));
+            }
+            const partials = await bt.strategyCoreService.getPositionPartials(false, symbol, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: "",
+            });
+            if (!partials) {
+                return false;
+            }
+            return partials.some((partial) => {
+                const upperStep = (partial.currentPrice * ladder.upperPercent) / 100;
+                const lowerStep = (partial.currentPrice * ladder.lowerPercent) / 100;
+                return currentPrice >= partial.currentPrice - lowerStep && currentPrice <= partial.currentPrice + upperStep;
+            });
+        };
         /**
          * Stops the strategy from generating new signals.
          *
@@ -37338,6 +38181,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newStopLossPrice: slPercentShiftToPrice(percentShift, signal.priceStopLoss, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -37437,6 +38281,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newTakeProfitPrice: tpPercentShiftToPrice(percentShift, signal.priceTakeProfit, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -37506,6 +38351,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newStopLossPrice,
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -37575,6 +38421,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newTakeProfitPrice,
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -40143,6 +40990,20 @@ class WalkerInstance {
                         frameName: walkerSchema.frameName,
                         backtest: true,
                     });
+                    bt.timeMetaService.clear({
+                        symbol,
+                        strategyName,
+                        exchangeName: walkerSchema.exchangeName,
+                        frameName: walkerSchema.frameName,
+                        backtest: true,
+                    });
+                    bt.priceMetaService.clear({
+                        symbol,
+                        strategyName,
+                        exchangeName: walkerSchema.exchangeName,
+                        frameName: walkerSchema.frameName,
+                        backtest: true,
+                    });
                 }
                 {
                     const { riskName, riskList, actions } = bt.strategySchemaService.get(strategyName);
@@ -43110,13 +43971,15 @@ class NotificationMemoryBacktestUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = functoolsKit.trycatch(async (data) => {
             bt.loggerService.info(NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_SYNC, {
                 signalId: data.signalId,
                 action: data.action,
             });
             this._addNotification(CREATE_SIGNAL_SYNC_NOTIFICATION_FN(data));
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * @param data - The risk contract data
@@ -43225,8 +44088,10 @@ class NotificationDummyBacktestUtils {
         /**
          * No-op handler for signal sync event.
          */
-        this.handleSync = async () => {
-        };
+        this.handleSync = functoolsKit.trycatch(async () => {
+        }, {
+            defaultValue: null,
+        });
         /**
          * No-op handler for risk rejection event.
          */
@@ -43365,7 +44230,7 @@ class NotificationPersistBacktestUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = functoolsKit.trycatch(async (data) => {
             bt.loggerService.info(NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_SYNC, {
                 signalId: data.signalId,
                 action: data.action,
@@ -43373,7 +44238,9 @@ class NotificationPersistBacktestUtils {
             await this.waitForInit();
             this._addNotification(CREATE_SIGNAL_SYNC_NOTIFICATION_FN(data));
             await this._updateNotifications();
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * @param data - The risk contract data
@@ -43556,13 +44423,15 @@ class NotificationMemoryLiveUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = functoolsKit.trycatch(async (data) => {
             bt.loggerService.info(NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_SYNC, {
                 signalId: data.signalId,
                 action: data.action,
             });
             this._addNotification(CREATE_SIGNAL_SYNC_NOTIFICATION_FN(data));
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * @param data - The risk contract data
@@ -43671,8 +44540,10 @@ class NotificationDummyLiveUtils {
         /**
          * No-op handler for signal sync event.
          */
-        this.handleSync = async () => {
-        };
+        this.handleSync = functoolsKit.trycatch(async () => {
+        }, {
+            defaultValue: null,
+        });
         /**
          * No-op handler for risk rejection event.
          */
@@ -43812,7 +44683,7 @@ class NotificationPersistLiveUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = functoolsKit.trycatch(async (data) => {
             bt.loggerService.info(NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_SYNC, {
                 signalId: data.signalId,
                 action: data.action,
@@ -43820,7 +44691,9 @@ class NotificationPersistLiveUtils {
             await this.waitForInit();
             this._addNotification(CREATE_SIGNAL_SYNC_NOTIFICATION_FN(data));
             await this._updateNotifications();
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * @param data - The risk contract data
@@ -43982,9 +44855,11 @@ class NotificationBacktestAdapter {
          * Proxies call to the underlying notification adapter.
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = functoolsKit.trycatch(async (data) => {
             return await this._notificationBacktestUtils.handleSync(data);
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * Proxies call to the underlying notification adapter.
@@ -44126,9 +45001,11 @@ class NotificationLiveAdapter {
          * Proxies call to the underlying notification adapter.
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = functoolsKit.trycatch(async (data) => {
             return await this._notificationLiveUtils.handleSync(data);
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * Proxies call to the underlying notification adapter.
@@ -45575,9 +46452,11 @@ exports.getNextCandles = getNextCandles;
 exports.getOrderBook = getOrderBook;
 exports.getPendingSignal = getPendingSignal;
 exports.getPositionAveragePrice = getPositionAveragePrice;
+exports.getPositionEntryOverlap = getPositionEntryOverlap;
 exports.getPositionInvestedCost = getPositionInvestedCost;
 exports.getPositionInvestedCount = getPositionInvestedCount;
 exports.getPositionLevels = getPositionLevels;
+exports.getPositionPartialOverlap = getPositionPartialOverlap;
 exports.getPositionPartials = getPositionPartials;
 exports.getPositionPnlCost = getPositionPnlCost;
 exports.getPositionPnlPercent = getPositionPnlPercent;