backtest-kit 4.0.2 → 5.1.0

package/build/index.mjs

@@ -1,6 +1,6 @@
 import { createActivator } from 'di-kit';
 import { scoped } from 'di-scoped';
-import { Subject, makeExtendable, singleshot, getErrorMessage, memoize, not, errorData, trycatch, retry, queued, sleep, randomString, str, isObject, ToolRegistry, typo, and, Source, resolveDocuments, timeout, TIMEOUT_SYMBOL as TIMEOUT_SYMBOL$1, compose, singlerun } from 'functools-kit';
+import { Subject, makeExtendable, singleshot, getErrorMessage, memoize, not, errorData, trycatch, retry, queued, sleep, randomString, str, isObject, ToolRegistry, typo, and, Source, resolveDocuments, timeout, TIMEOUT_SYMBOL as TIMEOUT_SYMBOL$1, compose, BehaviorSubject, waitForNext, singlerun } from 'functools-kit';
 import * as fs from 'fs/promises';
 import fs__default, { stat, opendir, readFile } from 'fs/promises';
 import path, { join, dirname } from 'path';
@@ -69,6 +69,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'),
@@ -134,6 +138,7 @@ const TYPES = {
     ...connectionServices$1,
     ...schemaServices$1,
     ...coreServices$1,
+    ...metaServices$1,
     ...globalServices$1,
     ...commandServices$1,
     ...logicPrivateServices$1,
@@ -450,9 +455,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
@@ -3530,19 +3543,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,
@@ -4250,7 +4250,7 @@ const GET_SIGNAL_FN = 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);
@@ -4274,7 +4274,7 @@ const GET_SIGNAL_FN = 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);
@@ -4294,7 +4294,7 @@ const GET_SIGNAL_FN = 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);
@@ -4364,7 +4364,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 = [];
@@ -4393,7 +4393,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,
@@ -4403,7 +4403,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 = [];
@@ -4431,7 +4431,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,
@@ -4828,10 +4828,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
@@ -4861,7 +4861,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,
@@ -6646,16 +6646,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.
@@ -7428,10 +7428,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;
@@ -7489,7 +7491,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,
@@ -7515,7 +7517,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)
@@ -7553,7 +7555,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;
@@ -7609,10 +7611,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;
@@ -7670,7 +7674,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,
@@ -7696,7 +7700,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)
@@ -7734,7 +7738,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;
@@ -8490,7 +8494,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,
@@ -8505,7 +8509,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;
         }
@@ -8969,7 +8973,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);
@@ -9146,6 +9150,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.
          *
@@ -9159,7 +9165,7 @@ class StrategyConnectionService {
          * @param backtest - Whether running in backtest mode
          * @returns Configured ClientStrategy instance
          */
-        this.getStrategy = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$m(symbol, strategyName, exchangeName, frameName, backtest), (symbol, strategyName, exchangeName, frameName, backtest) => {
+        this.getStrategy = 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,
@@ -9246,6 +9252,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,
@@ -9255,6 +9275,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,
@@ -9264,6 +9297,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,
@@ -9273,6 +9319,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,
@@ -9283,6 +9343,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,
@@ -9293,6 +9367,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,
@@ -9302,6 +9397,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,
@@ -9311,6 +9420,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,
@@ -9318,7 +9448,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.
@@ -9420,6 +9551,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);
             }
@@ -9526,7 +9661,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;
             }
@@ -9595,9 +9730,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).
@@ -9638,7 +9773,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.
@@ -9651,9 +9787,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).
@@ -9694,7 +9830,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.
@@ -9707,9 +9844,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.
@@ -9761,9 +9898,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.
@@ -9814,9 +9951,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.
@@ -9893,9 +10030,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.
@@ -9916,7 +10053,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);
         };
     }
 }
@@ -10657,7 +10795,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);
@@ -10756,7 +10894,7 @@ class RiskConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientRisk instance
          */
-        this.getRisk = memoize(([riskName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$l(riskName, exchangeName, frameName, backtest), (riskName, exchangeName, frameName, backtest) => {
+        this.getRisk = 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,
@@ -10824,7 +10962,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 {
@@ -10844,7 +10982,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";
 /**
@@ -11256,6 +11393,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);
         }
     }
@@ -11718,19 +11860,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.
      *
@@ -12300,7 +12429,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);
@@ -12351,7 +12480,7 @@ class ActionConnectionService {
          * @param backtest - True if backtest mode, false if live mode
          * @returns Configured ClientAction instance
          */
-        this.getAction = memoize(([actionName, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$k(actionName, strategyName, exchangeName, frameName, backtest), (actionName, strategyName, exchangeName, frameName, backtest) => {
+        this.getAction = 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,
@@ -12561,7 +12690,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;
             }
@@ -12579,7 +12708,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;
 };
 /**
@@ -12603,7 +12732,7 @@ class ExchangeCoreService {
          * @param exchangeName - Name of the exchange to validate
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = memoize(([exchangeName]) => CREATE_KEY_FN$j(exchangeName), async (exchangeName) => {
+        this.validate = memoize(([exchangeName]) => CREATE_KEY_FN$l(exchangeName), async (exchangeName) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$2, {
                 exchangeName,
             });
@@ -12855,7 +12984,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);
@@ -12887,7 +13016,7 @@ class StrategyCoreService {
          * @param context - Execution context with strategyName, exchangeName, frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$i(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$k(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE$1, {
                 context,
             });
@@ -13722,7 +13851,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);
@@ -13748,7 +13877,7 @@ class RiskGlobalService {
          * @param payload - Payload with riskName, exchangeName and frameName
          * @returns Promise that resolves when validation is complete
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$h(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$j(context), async (context) => {
             this.loggerService.log("riskGlobalService validate", {
                 context,
             });
@@ -13826,7 +13955,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);
@@ -13870,7 +13999,7 @@ class ActionCoreService {
          * @param context - Strategy execution context with strategyName, exchangeName and frameName
          * @returns Promise that resolves when all validations complete
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$g(context), async (context) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$i(context), async (context) => {
             this.loggerService.log(METHOD_NAME_VALIDATE, {
                 context,
             });
@@ -18405,7 +18534,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);
@@ -18644,7 +18773,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 = 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 = 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.
@@ -18801,7 +18930,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 {
@@ -18863,7 +18992,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);
@@ -19346,7 +19475,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 = 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 = 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.
@@ -19564,7 +19693,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 {
@@ -19584,7 +19713,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);
@@ -19875,7 +20004,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 = 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 = 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.
@@ -20078,7 +20207,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 {
@@ -20098,7 +20227,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);
@@ -20346,7 +20475,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 = 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 = 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.
@@ -20513,7 +20642,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 {
@@ -20983,7 +21112,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);
@@ -21350,7 +21479,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 = memoize(([exchangeName, frameName, backtest]) => CREATE_KEY_FN$b(exchangeName, frameName, backtest), (exchangeName, frameName, backtest) => new HeatmapStorage(exchangeName, frameName, backtest));
+        this.getStorage = 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.
@@ -21545,7 +21674,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 {
@@ -22576,7 +22705,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.
  *
@@ -22698,7 +22827,7 @@ class PartialConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientPartial instance with logger and event emitters
          */
-        this.getPartial = memoize(([signalId, backtest]) => CREATE_KEY_FN$a(signalId, backtest), (signalId, backtest) => {
+        this.getPartial = memoize(([signalId, backtest]) => CREATE_KEY_FN$c(signalId, backtest), (signalId, backtest) => {
             return new ClientPartial({
                 signalId,
                 logger: this.loggerService,
@@ -22788,7 +22917,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);
         };
     }
@@ -22804,7 +22933,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);
@@ -23029,7 +23158,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 = 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 = 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.
@@ -23239,7 +23368,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 {
@@ -23255,7 +23384,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);
@@ -23329,7 +23458,7 @@ class PartialGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$8(context), (context, methodName) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$a(context), (context, methodName) => {
             this.loggerService.log("partialGlobalService validate", {
                 context,
                 methodName,
@@ -23784,7 +23913,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.
  *
@@ -23870,7 +23999,7 @@ class BreakevenConnectionService {
          * Key format: "signalId:backtest" or "signalId:live"
          * Value: ClientBreakeven instance with logger and event emitter
          */
-        this.getBreakeven = memoize(([signalId, backtest]) => CREATE_KEY_FN$7(signalId, backtest), (signalId, backtest) => {
+        this.getBreakeven = memoize(([signalId, backtest]) => CREATE_KEY_FN$9(signalId, backtest), (signalId, backtest) => {
             return new ClientBreakeven({
                 signalId,
                 logger: this.loggerService,
@@ -23931,7 +24060,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);
         };
     }
@@ -23947,7 +24076,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);
@@ -24124,7 +24253,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 = 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 = 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.
@@ -24313,7 +24442,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 {
@@ -24329,7 +24458,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);
@@ -24403,7 +24532,7 @@ class BreakevenGlobalService {
          * @param context - Context with strategyName, exchangeName and frameName
          * @param methodName - Name of the calling method for error tracking
          */
-        this.validate = memoize(([context]) => CREATE_KEY_FN$5(context), (context, methodName) => {
+        this.validate = memoize(([context]) => CREATE_KEY_FN$7(context), (context, methodName) => {
             this.loggerService.log("breakevenGlobalService validate", {
                 context,
                 methodName,
@@ -24623,7 +24752,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);
@@ -24792,7 +24921,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 = 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 = 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.
@@ -24981,7 +25110,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 {
@@ -27669,7 +27798,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);
@@ -27917,7 +28046,7 @@ class StrategyMarkdownService {
          *
          * @internal
          */
-        this.getStorage = 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 = 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.
          *
@@ -28485,7 +28614,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 {
@@ -28593,7 +28722,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);
@@ -28725,7 +28854,7 @@ class ReportStorage {
 class SyncMarkdownService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
-        this.getStorage = 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 = 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 = singleshot(() => {
             this.loggerService.log("syncMarkdownService init");
             const unsubscribe = syncSubject.subscribe(this.tick);
@@ -28800,7 +28929,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 {
@@ -28810,6 +28939,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 = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$3(symbol, strategyName, exchangeName, frameName, backtest), () => new 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 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 = memoize(([symbol, strategyName, exchangeName, frameName, backtest]) => CREATE_KEY_FN$2(symbol, strategyName, exchangeName, frameName, backtest), () => new 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 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());
 }
@@ -28842,6 +29240,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());
@@ -28933,6 +29335,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),
@@ -28997,6 +29403,7 @@ const backtest = {
     ...connectionServices,
     ...schemaServices,
     ...coreServices,
+    ...metaServices,
     ...globalServices,
     ...commandServices,
     ...logicPrivateServices,
@@ -31761,6 +32168,11 @@ BrokerBase = 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";
@@ -31786,6 +32198,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.
  *
@@ -32062,6 +32476,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,
@@ -32141,6 +32556,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,
@@ -32192,6 +32608,7 @@ async function commitTrailingStopCost(symbol, newStopLossPrice) {
         currentPrice,
         newStopLossPrice,
         position: signal.position,
+        takeProfitPrice: signal.priceTakeProfit,
         context: { exchangeName, frameName, strategyName },
         backtest: isBacktest,
     });
@@ -32241,6 +32658,7 @@ async function commitTrailingTakeCost(symbol, newTakeProfitPrice) {
         percentShift,
         currentPrice,
         newTakeProfitPrice,
+        takeProfitPrice: signal.priceTakeProfit,
         position: signal.position,
         context: { exchangeName, frameName, strategyName },
         backtest: isBacktest,
@@ -32567,6 +32985,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,
@@ -32581,6 +33024,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,
@@ -32595,6 +33060,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,
@@ -32609,6 +33096,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()) {
@@ -32758,6 +33268,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()) {
@@ -32844,6 +33377,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";
 /**
@@ -34070,6 +34701,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";
@@ -34257,6 +34890,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);
@@ -34860,6 +35507,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.
          *
@@ -35349,6 +36080,7 @@ class BacktestUtils {
                 percentShift,
                 currentPrice,
                 newStopLossPrice: slPercentShiftToPrice(percentShift, signal.priceStopLoss, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: true,
@@ -35433,6 +36165,7 @@ class BacktestUtils {
                 percentShift,
                 currentPrice,
                 newTakeProfitPrice: tpPercentShiftToPrice(percentShift, signal.priceTakeProfit, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: true,
@@ -35487,6 +36220,7 @@ class BacktestUtils {
                 currentPrice,
                 newStopLossPrice,
                 position: signal.position,
+                takeProfitPrice: signal.priceTakeProfit,
                 context,
                 backtest: true,
             });
@@ -35540,6 +36274,7 @@ class BacktestUtils {
                 currentPrice,
                 newTakeProfitPrice,
                 position: signal.position,
+                takeProfitPrice: signal.priceTakeProfit,
                 context,
                 backtest: true,
             });
@@ -35883,6 +36618,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";
@@ -36071,6 +36808,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);
@@ -36736,6 +37487,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.
          *
@@ -37318,6 +38161,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newStopLossPrice: slPercentShiftToPrice(percentShift, signal.priceStopLoss, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -37417,6 +38261,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newTakeProfitPrice: tpPercentShiftToPrice(percentShift, signal.priceTakeProfit, effectivePriceOpen, signal.position),
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -37486,6 +38331,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newStopLossPrice,
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -37555,6 +38401,7 @@ class LiveUtils {
                 percentShift,
                 currentPrice,
                 newTakeProfitPrice,
+                takeProfitPrice: signal.priceTakeProfit,
                 position: signal.position,
                 context,
                 backtest: false,
@@ -40123,6 +40970,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);
@@ -43090,13 +43951,15 @@ class NotificationMemoryBacktestUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = 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
@@ -43205,8 +44068,10 @@ class NotificationDummyBacktestUtils {
         /**
          * No-op handler for signal sync event.
          */
-        this.handleSync = async () => {
-        };
+        this.handleSync = trycatch(async () => {
+        }, {
+            defaultValue: null,
+        });
         /**
          * No-op handler for risk rejection event.
          */
@@ -43345,7 +44210,7 @@ class NotificationPersistBacktestUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = trycatch(async (data) => {
             bt.loggerService.info(NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_SYNC, {
                 signalId: data.signalId,
                 action: data.action,
@@ -43353,7 +44218,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
@@ -43536,13 +44403,15 @@ class NotificationMemoryLiveUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = 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
@@ -43651,8 +44520,10 @@ class NotificationDummyLiveUtils {
         /**
          * No-op handler for signal sync event.
          */
-        this.handleSync = async () => {
-        };
+        this.handleSync = trycatch(async () => {
+        }, {
+            defaultValue: null,
+        });
         /**
          * No-op handler for risk rejection event.
          */
@@ -43792,7 +44663,7 @@ class NotificationPersistLiveUtils {
          * Handles signal sync events (signal-open, signal-close).
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = trycatch(async (data) => {
             bt.loggerService.info(NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_SYNC, {
                 signalId: data.signalId,
                 action: data.action,
@@ -43800,7 +44671,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
@@ -43962,9 +44835,11 @@ class NotificationBacktestAdapter {
          * Proxies call to the underlying notification adapter.
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = trycatch(async (data) => {
             return await this._notificationBacktestUtils.handleSync(data);
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * Proxies call to the underlying notification adapter.
@@ -44106,9 +44981,11 @@ class NotificationLiveAdapter {
          * Proxies call to the underlying notification adapter.
          * @param data - The signal sync contract data
          */
-        this.handleSync = async (data) => {
+        this.handleSync = trycatch(async (data) => {
             return await this._notificationLiveUtils.handleSync(data);
-        };
+        }, {
+            defaultValue: null,
+        });
         /**
          * Handles risk rejection event.
          * Proxies call to the underlying notification adapter.
@@ -45465,4 +46342,4 @@ const percentValue = (yesterdayValue, todayValue) => {
     return yesterdayValue / todayValue - 1;
 };
 
-export { ActionBase, Backtest, Breakeven, Broker, BrokerBase, Cache, Constant, Exchange, ExecutionContextService, Heat, Live, Log, Markdown, MarkdownFileBase, MarkdownFolderBase, MethodContextService, Notification, NotificationBacktest, NotificationLive, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PersistStorageAdapter, PositionSize, Report, ReportBase, Risk, Schedule, Storage, StorageBacktest, StorageLive, Strategy, Sync, Walker, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, dumpMessages, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionAveragePrice, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getRawCandles, getRiskSchema, getScheduledSignal, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, roundTicks, set, setColumns, setConfig, setLogger, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, waitForCandle, warmCandles };
+export { ActionBase, Backtest, Breakeven, Broker, BrokerBase, Cache, Constant, Exchange, ExecutionContextService, Heat, Live, Log, Markdown, MarkdownFileBase, MarkdownFolderBase, MethodContextService, Notification, NotificationBacktest, NotificationLive, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistCandleAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistNotificationAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PersistStorageAdapter, PositionSize, Report, ReportBase, Risk, Schedule, Storage, StorageBacktest, StorageLive, Strategy, Sync, Walker, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, dumpMessages, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionAveragePrice, getPositionEntryOverlap, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getRawCandles, getRiskSchema, getScheduledSignal, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasTradeContext, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, roundTicks, set, setColumns, setConfig, setLogger, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, waitForCandle, warmCandles };