backtest-kit 4.0.1 → 4.0.2

package/build/index.cjs

@@ -6630,6 +6630,18 @@ class ClientStrategy {
         }
         return entries.map((e) => e.price);
     }
+    /**
+     * 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 symbol - Trading pair symbol
+     * @returns Promise resolving to array of partial close records or null
+     */
     async getPositionPartials(symbol) {
         this.params.logger.debug("ClientStrategy getPositionPartials", { symbol });
         if (!this._pendingSignal) {
@@ -6637,6 +6649,34 @@ class ClientStrategy {
         }
         return this._pendingSignal._partial ?? [];
     }
+    /**
+     * 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 symbol - Trading pair symbol
+     * @returns Promise resolving to array of entry records or null
+     *
+     * @example
+     * // No DCA: [{ price: 43000, cost: 100 }]
+     * // One DCA: [{ price: 43000, cost: 100 }, { price: 42000, cost: 100 }]
+     */
+    async getPositionEntries(symbol) {
+        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 entries.map(({ price, cost }) => ({ price, cost }));
+    }
     /**
      * Performs a single tick of strategy execution.
      *
@@ -9291,6 +9331,15 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionPartials(symbol);
         };
+        this.getPositionEntries = async (backtest, symbol, context) => {
+            this.loggerService.log("strategyConnectionService getPositionEntries", {
+                symbol,
+                context,
+                backtest,
+            });
+            const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
+            return await strategy.getPositionEntries(symbol);
+        };
         /**
          * Retrieves the currently active scheduled signal for the strategy.
          * If no scheduled signal exists, returns null.
@@ -12980,6 +13029,14 @@ class StrategyCoreService {
             await this.validate(context);
             return await this.strategyConnectionService.getPositionPartials(backtest, symbol, context);
         };
+        this.getPositionEntries = async (backtest, symbol, context) => {
+            this.loggerService.log("strategyCoreService getPositionEntries", {
+                symbol,
+                context,
+            });
+            await this.validate(context);
+            return await this.strategyConnectionService.getPositionEntries(backtest, symbol, context);
+        };
         /**
          * Retrieves the currently active scheduled signal for the symbol.
          * If no scheduled signal exists, returns null.
@@ -34032,6 +34089,7 @@ const BACKTEST_METHOD_NAME_GET_POSITION_PNL_PERCENT = "BacktestUtils.getPosition
 const BACKTEST_METHOD_NAME_GET_POSITION_PNL_COST = "BacktestUtils.getPositionPnlCost";
 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_BREAKEVEN = "Backtest.commitBreakeven";
 const BACKTEST_METHOD_NAME_CANCEL_SCHEDULED = "Backtest.commitCancelScheduled";
 const BACKTEST_METHOD_NAME_CLOSE_PENDING = "Backtest.commitClosePending";
@@ -34787,6 +34845,41 @@ class BacktestUtils {
             }
             return await bt.strategyCoreService.getPositionPartials(true, symbol, context);
         };
+        /**
+         * Returns the list of DCA entry prices and costs for the current pending signal.
+         *
+         * Each element represents a single position entry — the initial open or a subsequent
+         * DCA entry added via commitAverageBuy.
+         *
+         * Returns null if no pending signal exists.
+         * Returns a single-element array if no DCA entries were made.
+         *
+         * Each entry contains:
+         * - `price` — execution price of this entry
+         * - `cost` — dollar cost allocated to this entry (e.g. 100 for $100)
+         *
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, and frameName
+         * @returns Array of entry records, or null if no active position
+         */
+        this.getPositionEntries = async (symbol, context) => {
+            bt.loggerService.info(BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES, {
+                symbol,
+                context,
+            });
+            bt.strategyValidationService.validate(context.strategyName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES);
+            bt.exchangeValidationService.validate(context.exchangeName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES));
+            }
+            return await bt.strategyCoreService.getPositionEntries(true, symbol, context);
+        };
         /**
          * Stops the strategy from generating new signals.
          *
@@ -35809,6 +35902,7 @@ const LIVE_METHOD_NAME_GET_POSITION_PNL_PERCENT = "LiveUtils.getPositionPnlPerce
 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_BREAKEVEN = "Live.commitBreakeven";
 const LIVE_METHOD_NAME_CANCEL_SCHEDULED = "Live.cancelScheduled";
 const LIVE_METHOD_NAME_CLOSE_PENDING = "Live.closePending";
@@ -36623,6 +36717,45 @@ class LiveUtils {
                 frameName: "",
             });
         };
+        /**
+         * Returns the list of DCA entry prices and costs for the current pending signal.
+         *
+         * Each element represents a single position entry — the initial open or a subsequent
+         * DCA entry added via commitAverageBuy.
+         *
+         * Returns null if no pending signal exists.
+         * Returns a single-element array if no DCA entries were made.
+         *
+         * Each entry contains:
+         * - `price` — execution price of this entry
+         * - `cost` — dollar cost allocated to this entry (e.g. 100 for $100)
+         *
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName and exchangeName
+         * @returns Array of entry records, or null if no active position
+         */
+        this.getPositionEntries = async (symbol, context) => {
+            bt.loggerService.info(LIVE_METHOD_NAME_GET_POSITION_ENTRIES, {
+                symbol,
+                context,
+            });
+            bt.strategyValidationService.validate(context.strategyName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES);
+            bt.exchangeValidationService.validate(context.exchangeName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES));
+            }
+            return await bt.strategyCoreService.getPositionEntries(false, symbol, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: "",
+            });
+        };
         /**
          * Stops the strategy from generating new signals.
          *

package/build/index.mjs

@@ -6610,6 +6610,18 @@ class ClientStrategy {
         }
         return entries.map((e) => e.price);
     }
+    /**
+     * 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 symbol - Trading pair symbol
+     * @returns Promise resolving to array of partial close records or null
+     */
     async getPositionPartials(symbol) {
         this.params.logger.debug("ClientStrategy getPositionPartials", { symbol });
         if (!this._pendingSignal) {
@@ -6617,6 +6629,34 @@ class ClientStrategy {
         }
         return this._pendingSignal._partial ?? [];
     }
+    /**
+     * 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 symbol - Trading pair symbol
+     * @returns Promise resolving to array of entry records or null
+     *
+     * @example
+     * // No DCA: [{ price: 43000, cost: 100 }]
+     * // One DCA: [{ price: 43000, cost: 100 }, { price: 42000, cost: 100 }]
+     */
+    async getPositionEntries(symbol) {
+        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 entries.map(({ price, cost }) => ({ price, cost }));
+    }
     /**
      * Performs a single tick of strategy execution.
      *
@@ -9271,6 +9311,15 @@ class StrategyConnectionService {
             const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
             return await strategy.getPositionPartials(symbol);
         };
+        this.getPositionEntries = async (backtest, symbol, context) => {
+            this.loggerService.log("strategyConnectionService getPositionEntries", {
+                symbol,
+                context,
+                backtest,
+            });
+            const strategy = this.getStrategy(symbol, context.strategyName, context.exchangeName, context.frameName, backtest);
+            return await strategy.getPositionEntries(symbol);
+        };
         /**
          * Retrieves the currently active scheduled signal for the strategy.
          * If no scheduled signal exists, returns null.
@@ -12960,6 +13009,14 @@ class StrategyCoreService {
             await this.validate(context);
             return await this.strategyConnectionService.getPositionPartials(backtest, symbol, context);
         };
+        this.getPositionEntries = async (backtest, symbol, context) => {
+            this.loggerService.log("strategyCoreService getPositionEntries", {
+                symbol,
+                context,
+            });
+            await this.validate(context);
+            return await this.strategyConnectionService.getPositionEntries(backtest, symbol, context);
+        };
         /**
          * Retrieves the currently active scheduled signal for the symbol.
          * If no scheduled signal exists, returns null.
@@ -34012,6 +34069,7 @@ const BACKTEST_METHOD_NAME_GET_POSITION_PNL_PERCENT = "BacktestUtils.getPosition
 const BACKTEST_METHOD_NAME_GET_POSITION_PNL_COST = "BacktestUtils.getPositionPnlCost";
 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_BREAKEVEN = "Backtest.commitBreakeven";
 const BACKTEST_METHOD_NAME_CANCEL_SCHEDULED = "Backtest.commitCancelScheduled";
 const BACKTEST_METHOD_NAME_CLOSE_PENDING = "Backtest.commitClosePending";
@@ -34767,6 +34825,41 @@ class BacktestUtils {
             }
             return await bt.strategyCoreService.getPositionPartials(true, symbol, context);
         };
+        /**
+         * Returns the list of DCA entry prices and costs for the current pending signal.
+         *
+         * Each element represents a single position entry — the initial open or a subsequent
+         * DCA entry added via commitAverageBuy.
+         *
+         * Returns null if no pending signal exists.
+         * Returns a single-element array if no DCA entries were made.
+         *
+         * Each entry contains:
+         * - `price` — execution price of this entry
+         * - `cost` — dollar cost allocated to this entry (e.g. 100 for $100)
+         *
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName, exchangeName, and frameName
+         * @returns Array of entry records, or null if no active position
+         */
+        this.getPositionEntries = async (symbol, context) => {
+            bt.loggerService.info(BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES, {
+                symbol,
+                context,
+            });
+            bt.strategyValidationService.validate(context.strategyName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES);
+            bt.exchangeValidationService.validate(context.exchangeName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, BACKTEST_METHOD_NAME_GET_POSITION_ENTRIES));
+            }
+            return await bt.strategyCoreService.getPositionEntries(true, symbol, context);
+        };
         /**
          * Stops the strategy from generating new signals.
          *
@@ -35789,6 +35882,7 @@ const LIVE_METHOD_NAME_GET_POSITION_PNL_PERCENT = "LiveUtils.getPositionPnlPerce
 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_BREAKEVEN = "Live.commitBreakeven";
 const LIVE_METHOD_NAME_CANCEL_SCHEDULED = "Live.cancelScheduled";
 const LIVE_METHOD_NAME_CLOSE_PENDING = "Live.closePending";
@@ -36603,6 +36697,45 @@ class LiveUtils {
                 frameName: "",
             });
         };
+        /**
+         * Returns the list of DCA entry prices and costs for the current pending signal.
+         *
+         * Each element represents a single position entry — the initial open or a subsequent
+         * DCA entry added via commitAverageBuy.
+         *
+         * Returns null if no pending signal exists.
+         * Returns a single-element array if no DCA entries were made.
+         *
+         * Each entry contains:
+         * - `price` — execution price of this entry
+         * - `cost` — dollar cost allocated to this entry (e.g. 100 for $100)
+         *
+         * @param symbol - Trading pair symbol
+         * @param context - Execution context with strategyName and exchangeName
+         * @returns Array of entry records, or null if no active position
+         */
+        this.getPositionEntries = async (symbol, context) => {
+            bt.loggerService.info(LIVE_METHOD_NAME_GET_POSITION_ENTRIES, {
+                symbol,
+                context,
+            });
+            bt.strategyValidationService.validate(context.strategyName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES);
+            bt.exchangeValidationService.validate(context.exchangeName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES);
+            {
+                const { riskName, riskList, actions } = bt.strategySchemaService.get(context.strategyName);
+                riskName &&
+                    bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES);
+                riskList &&
+                    riskList.forEach((riskName) => bt.riskValidationService.validate(riskName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES));
+                actions &&
+                    actions.forEach((actionName) => bt.actionValidationService.validate(actionName, LIVE_METHOD_NAME_GET_POSITION_ENTRIES));
+            }
+            return await bt.strategyCoreService.getPositionEntries(false, symbol, {
+                strategyName: context.strategyName,
+                exchangeName: context.exchangeName,
+                frameName: "",
+            });
+        };
         /**
          * Stops the strategy from generating new signals.
          *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backtest-kit",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "description": "A TypeScript library for trading system backtest",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -2850,6 +2850,23 @@ interface IStrategy {
      * Returns null if no pending signal exists.
      */
     getPositionPnlCost: (symbol: string, currentPrice: number) => Promise<number | null>;
+    /**
+     * 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 symbol - Trading pair symbol
+     * @returns Promise resolving to array of entry records or null
+     */
+    getPositionEntries: (symbol: string) => Promise<Array<{
+        price: number;
+        cost: number;
+    }> | null>;
     /**
      * Fast backtest using historical candles.
      * Iterates through candles, calculates VWAP, checks TP/SL on each candle.
@@ -4698,7 +4715,7 @@ declare function getTotalCostClosed(symbol: string): Promise<number>;
  * }
  * ```
  */
-declare function getPendingSignal(symbol: string): Promise<ISignalRow>;
+declare function getPendingSignal(symbol: string): Promise<IPublicSignalRow>;
 /**
  * Returns the currently active scheduled signal for the strategy.
  * If no scheduled signal exists, returns null.
@@ -11418,7 +11435,7 @@ declare class BacktestUtils {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<ISignalRow>;
+    }) => Promise<IPublicSignalRow>;
     /**
      * Returns the percentage of the position currently held (not closed).
      * 100 = nothing has been closed (full position), 0 = fully closed.
@@ -11631,6 +11648,31 @@ declare class BacktestUtils {
         entryCountAtClose: number;
         debugTimestamp?: number;
     }[]>;
+    /**
+     * Returns the list of DCA entry prices and costs for the current pending signal.
+     *
+     * Each element represents a single position entry — the initial open or a subsequent
+     * DCA entry added via commitAverageBuy.
+     *
+     * Returns null if no pending signal exists.
+     * Returns a single-element array if no DCA entries were made.
+     *
+     * Each entry contains:
+     * - `price` — execution price of this entry
+     * - `cost` — dollar cost allocated to this entry (e.g. 100 for $100)
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName, exchangeName, and frameName
+     * @returns Array of entry records, or null if no active position
+     */
+    getPositionEntries: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<{
+        price: number;
+        cost: number;
+    }[]>;
     /**
      * Stops the strategy from generating new signals.
      *
@@ -12488,7 +12530,7 @@ declare class LiveUtils {
     getPendingSignal: (symbol: string, currentPrice: number, context: {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
-    }) => Promise<ISignalRow>;
+    }) => Promise<IPublicSignalRow>;
     /**
      * Returns the percentage of the position currently held (not closed).
      * 100 = nothing has been closed (full position), 0 = fully closed.
@@ -12689,6 +12731,30 @@ declare class LiveUtils {
         entryCountAtClose: number;
         debugTimestamp?: number;
     }[]>;
+    /**
+     * Returns the list of DCA entry prices and costs for the current pending signal.
+     *
+     * Each element represents a single position entry — the initial open or a subsequent
+     * DCA entry added via commitAverageBuy.
+     *
+     * Returns null if no pending signal exists.
+     * Returns a single-element array if no DCA entries were made.
+     *
+     * Each entry contains:
+     * - `price` — execution price of this entry
+     * - `cost` — dollar cost allocated to this entry (e.g. 100 for $100)
+     *
+     * @param symbol - Trading pair symbol
+     * @param context - Execution context with strategyName and exchangeName
+     * @returns Array of entry records, or null if no active position
+     */
+    getPositionEntries: (symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+    }) => Promise<{
+        price: number;
+        cost: number;
+    }[]>;
     /**
      * Stops the strategy from generating new signals.
      *
@@ -20652,7 +20718,7 @@ declare class StrategyConnectionService implements TStrategy$1 {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<ISignalRow | null>;
+    }) => Promise<IPublicSignalRow | null>;
     /**
      * Returns the percentage of the position currently held (not closed).
      * 100 = nothing has been closed (full position), 0 = fully closed.
@@ -20724,6 +20790,14 @@ declare class StrategyConnectionService implements TStrategy$1 {
         entryCountAtClose: number;
         debugTimestamp?: number;
     }[]>;
+    getPositionEntries: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<{
+        price: number;
+        cost: number;
+    }[]>;
     /**
      * Retrieves the currently active scheduled signal for the strategy.
      * If no scheduled signal exists, returns null.
@@ -21897,7 +21971,7 @@ declare class StrategyCoreService implements TStrategy {
         strategyName: StrategyName;
         exchangeName: ExchangeName;
         frameName: FrameName;
-    }) => Promise<ISignalRow | null>;
+    }) => Promise<IPublicSignalRow | null>;
     /**
      * Returns the percentage of the position currently held (not closed).
      * 100 = nothing has been closed (full position), 0 = fully closed.
@@ -21969,6 +22043,14 @@ declare class StrategyCoreService implements TStrategy {
         entryCountAtClose: number;
         debugTimestamp?: number;
     }[]>;
+    getPositionEntries: (backtest: boolean, symbol: string, context: {
+        strategyName: StrategyName;
+        exchangeName: ExchangeName;
+        frameName: FrameName;
+    }) => Promise<{
+        price: number;
+        cost: number;
+    }[]>;
     /**
      * Retrieves the currently active scheduled signal for the symbol.
      * If no scheduled signal exists, returns null.