@discomedia/utils 1.0.26 → 1.0.27

package/dist/index-frontend.mjs

@@ -14679,6 +14679,18 @@ Websocket example
    this.log(`Received trade update: event ${update.event} for an order to ${update.order.side} ${update.order.qty} of ${update.order.symbol}`);
   });
   alpacaAPI.connectWebsocket(); // necessary to connect to the WebSocket
+
+Portfolio History examples
+  // Get standard portfolio history
+  const portfolioHistory = await alpacaAPI.getPortfolioHistory({
+    timeframe: '1D',
+    period: '1M'
+  });
+
+  // Get daily portfolio history with current day included (if available from hourly data)
+  const dailyHistory = await alpacaAPI.getPortfolioDailyHistory({
+    period: '1M'
+  });
 */
 class AlpacaTradingAPI {
     static new(credentials) {
@@ -15378,6 +15390,57 @@ class AlpacaTradingAPI {
         const response = await this.makeRequest(`/account/portfolio/history?${queryParams.toString()}`);
         return response;
     }
+    /**
+     * Get portfolio daily history for the account, ensuring the most recent day is included
+     * by combining daily and hourly history if needed.
+     *
+     * This function performs two API calls:
+     * 1. Retrieves daily portfolio history
+     * 2. Retrieves hourly portfolio history to check for more recent data
+     *
+     * If hourly history has timestamps more recent than the last timestamp in daily history,
+     * it appends one additional day to the daily history using the most recent hourly values.
+     *
+     * @param params Parameters for the portfolio history request (same as getPortfolioHistory except timeframe is forced to '1D')
+     * @returns Portfolio history data with daily timeframe, including the most recent day if available from hourly data
+     */
+    async getPortfolioDailyHistory(params) {
+        // Get daily history
+        const dailyParams = { ...params, timeframe: '1D' };
+        const dailyHistory = await this.getPortfolioHistory(dailyParams);
+        // Get hourly history for the last day to check for more recent data
+        const hourlyParams = { timeframe: '1H', period: '1D' };
+        const hourlyHistory = await this.getPortfolioHistory(hourlyParams);
+        // If no hourly history, return daily as-is
+        if (!hourlyHistory.timestamp || hourlyHistory.timestamp.length === 0) {
+            return dailyHistory;
+        }
+        // Get the last timestamp from daily history
+        const lastDailyTimestamp = dailyHistory.timestamp[dailyHistory.timestamp.length - 1];
+        // Check if hourly history has more recent data
+        const recentHourlyData = hourlyHistory.timestamp
+            .map((timestamp, index) => ({ timestamp, index }))
+            .filter(({ timestamp }) => timestamp > lastDailyTimestamp);
+        // If no more recent hourly data, return daily history as-is
+        if (recentHourlyData.length === 0) {
+            return dailyHistory;
+        }
+        // Get the most recent hourly data point
+        const mostRecentHourly = recentHourlyData[recentHourlyData.length - 1];
+        const mostRecentIndex = mostRecentHourly.index;
+        // Calculate the timestamp for the new daily entry (most recent day + 1 day worth of seconds)
+        const oneDayInSeconds = 24 * 60 * 60;
+        const newDailyTimestamp = mostRecentHourly.timestamp + oneDayInSeconds;
+        // Create a new daily history entry with the most recent hourly values
+        const updatedDailyHistory = {
+            ...dailyHistory,
+            timestamp: [...dailyHistory.timestamp, newDailyTimestamp],
+            equity: [...dailyHistory.equity, hourlyHistory.equity[mostRecentIndex]],
+            profit_loss: [...dailyHistory.profit_loss, hourlyHistory.profit_loss[mostRecentIndex]],
+            profit_loss_pct: [...dailyHistory.profit_loss_pct, hourlyHistory.profit_loss_pct[mostRecentIndex]],
+        };
+        return updatedDailyHistory;
+    }
     /**
      * Get option contracts based on specified parameters
      * @param params Parameters to filter option contracts