@catalyst-team/poly-sdk 0.4.0 → 0.4.3

package/dist/src/services/smart-money-service.js

@@ -25,6 +25,78 @@
  * ⚠️ Activity WebSocket 不会广播用户自己的交易！
  * 验证跟单结果请使用 TradingService.getTrades()
  */
+/**
+ * Keywords for market categorization by category
+ */
+export const CATEGORY_KEYWORDS = {
+    crypto: /\b(btc|bitcoin|eth|ethereum|sol|solana|xrp|crypto|doge|ada|matic)\b/i,
+    politics: /\b(trump|biden|election|president|senate|congress|vote|political|maga|democrat|republican)\b/i,
+    sports: /\b(nfl|nba|mlb|nhl|super bowl|world cup|championship|game|match|ufc|soccer|football|basketball)\b/i,
+    economics: /\b(fed|interest rate|inflation|gdp|recession|economic|unemployment|cpi)\b/i,
+    entertainment: /\b(oscar|grammy|movie|twitter|celebrity|entertainment|netflix|spotify)\b/i,
+    science: /\b(spacex|nasa|ai|openai|google|apple|tesla|tech|technology|science)\b/i,
+    other: /.*/, // Matches everything as fallback
+};
+/**
+ * Categorize a market based on its title
+ *
+ * @param title - Market title to categorize
+ * @returns The market category
+ *
+ * @example
+ * ```typescript
+ * import { categorizeMarket } from '@catalyst-team/poly-sdk';
+ *
+ * categorizeMarket('Will BTC hit $100k?'); // 'crypto'
+ * categorizeMarket('Trump wins 2024?');    // 'politics'
+ * categorizeMarket('Lakers win NBA?');     // 'sports'
+ * categorizeMarket('Random event?');       // 'other'
+ * ```
+ */
+export function categorizeMarket(title) {
+    const lowerTitle = title.toLowerCase();
+    // Check each category in priority order
+    if (CATEGORY_KEYWORDS.crypto.test(lowerTitle))
+        return 'crypto';
+    if (CATEGORY_KEYWORDS.politics.test(lowerTitle))
+        return 'politics';
+    if (CATEGORY_KEYWORDS.sports.test(lowerTitle))
+        return 'sports';
+    if (CATEGORY_KEYWORDS.economics.test(lowerTitle))
+        return 'economics';
+    if (CATEGORY_KEYWORDS.entertainment.test(lowerTitle))
+        return 'entertainment';
+    if (CATEGORY_KEYWORDS.science.test(lowerTitle))
+        return 'science';
+    return 'other';
+}
+// ============================================================================
+// Report Types (02-smart-money)
+// ============================================================================
+/**
+ * Category color scheme for charts
+ */
+export const CATEGORY_COLORS = {
+    crypto: '#f7931a', // Bitcoin orange
+    politics: '#3b82f6', // Blue
+    sports: '#22c55e', // Green
+    entertainment: '#a855f7', // Purple
+    economics: '#eab308', // Yellow
+    science: '#06b6d4', // Cyan
+    other: '#6b7280', // Gray
+};
+/**
+ * Category labels for display
+ */
+export const CATEGORY_LABELS = {
+    crypto: 'Crypto',
+    politics: 'Politics',
+    sports: 'Sports',
+    entertainment: 'Entertainment',
+    economics: 'Economics',
+    science: 'Science',
+    other: 'Other',
+};
 // ============================================================================
 // SmartMoneyService
 // ============================================================================
@@ -32,21 +104,30 @@ export class SmartMoneyService {
     walletService;
     realtimeService;
     tradingService;
+    dataApi;
     config;
     smartMoneyCache = new Map();
     smartMoneySet = new Set();
     cacheTimestamp = 0;
     activeSubscription = null;
     tradeHandlers = new Set();
-    constructor(walletService, realtimeService, tradingService, config = {}) {
+    constructor(walletService, realtimeService, tradingService, config = {}, dataApi) {
         this.walletService = walletService;
         this.realtimeService = realtimeService;
         this.tradingService = tradingService;
+        this.dataApi = dataApi ?? null;
         this.config = {
             minPnl: config.minPnl ?? 1000,
             cacheTtl: config.cacheTtl ?? 300000,
         };
     }
+    /**
+     * Set DataApiClient for report generation
+     * This allows setting the client after construction
+     */
+    setDataApiClient(dataApi) {
+        this.dataApi = dataApi;
+    }
     // ============================================================================
     // Smart Money Info
     // ============================================================================
@@ -360,8 +441,8 @@ export class SmartMoneyService {
         const limit = Math.min(options.limit ?? 50, 500);
         const sortBy = options.sortBy ?? 'pnl';
         const offset = Math.min(options.offset ?? 0, 10000);
-        const entries = await this.walletService.getLeaderboardByPeriod(period, limit, sortBy, 'OVERALL', offset);
-        return entries.map(e => ({
+        const result = await this.walletService.fetchLeaderboardByPeriod(period, limit, sortBy, 'OVERALL', offset);
+        const entries = result.entries.map(e => ({
             address: e.address,
             rank: e.rank,
             pnl: e.pnl,
@@ -369,7 +450,25 @@ export class SmartMoneyService {
             tradeCount: e.tradeCount,
             userName: e.userName,
             profileImage: e.profileImage,
+            // 社交信息
+            xUsername: e.xUsername,
+            verifiedBadge: e.verifiedBadge,
+            // Extended fields
+            totalPnl: e.totalPnl,
+            realizedPnl: e.realizedPnl,
+            unrealizedPnl: e.unrealizedPnl,
+            buyCount: e.buyCount,
+            sellCount: e.sellCount,
+            buyVolume: e.buyVolume,
+            sellVolume: e.sellVolume,
+            makerVolume: e.makerVolume,
+            takerVolume: e.takerVolume,
         }));
+        return {
+            entries,
+            hasMore: result.hasMore,
+            request: result.request,
+        };
     }
     // ============================================================================
     // Wallet Report - 钱包报告
@@ -564,6 +663,773 @@ export class SmartMoneyService {
         };
     }
     // ============================================================================
+    // Report Generation (02-smart-money)
+    // ============================================================================
+    /**
+     * Get daily wallet report
+     *
+     * @param address - Wallet address
+     * @param date - Date for the report (default: today)
+     *
+     * @example
+     * ```typescript
+     * const report = await sdk.smartMoney.getDailyReport('0x...', new Date('2026-01-08'));
+     * console.log(report.summary.realizedPnL);
+     * ```
+     */
+    async getDailyReport(address, date) {
+        const targetDate = date || new Date();
+        const dateStr = this.formatDate(targetDate);
+        // Get start/end of day in Unix seconds
+        const startOfDay = new Date(targetDate);
+        startOfDay.setHours(0, 0, 0, 0);
+        const endOfDay = new Date(targetDate);
+        endOfDay.setHours(23, 59, 59, 999);
+        const startTimestamp = Math.floor(startOfDay.getTime() / 1000);
+        const endTimestamp = Math.floor(endOfDay.getTime() / 1000);
+        // Fetch activities for the day
+        const activitySummary = await this.walletService.getWalletActivity(address, {
+            start: startTimestamp,
+            end: endTimestamp,
+            limit: 500,
+        });
+        // Fetch closed positions for the day
+        const closedPositions = this.dataApi
+            ? await this.dataApi.getClosedPositions(address, {
+                sortBy: 'TIMESTAMP',
+                sortDirection: 'DESC',
+                limit: 50,
+            })
+            : [];
+        // Filter closed positions for today
+        const todaysClosed = closedPositions.filter(p => {
+            const posDate = new Date(p.timestamp);
+            return posDate >= startOfDay && posDate <= endOfDay;
+        });
+        // Calculate summary
+        const trades = activitySummary.activities.filter(a => a.type === 'TRADE');
+        const buys = trades.filter(t => t.side === 'BUY');
+        const sells = trades.filter(t => t.side === 'SELL');
+        const summary = {
+            totalTrades: trades.length,
+            buyCount: buys.length,
+            sellCount: sells.length,
+            buyVolume: buys.reduce((sum, t) => sum + (t.usdcSize || 0), 0),
+            sellVolume: sells.reduce((sum, t) => sum + (t.usdcSize || 0), 0),
+            realizedPnL: todaysClosed.reduce((sum, p) => sum + p.realizedPnl, 0),
+            positionsClosed: todaysClosed.length,
+            positionsOpened: buys.filter(b => {
+                // Count unique new positions (approximate)
+                return !sells.some(s => s.conditionId === b.conditionId);
+            }).length,
+        };
+        // Calculate category breakdown
+        const categoryBreakdown = this.calculateCategoryBreakdownFromActivities(trades);
+        // Get significant trades (top 10 by value)
+        const significantTrades = trades
+            .map(t => ({
+            market: t.title || '',
+            conditionId: t.conditionId,
+            outcome: t.outcome || '',
+            side: t.side,
+            price: t.price,
+            size: t.size,
+            usdcValue: t.usdcSize || t.size * t.price,
+            timestamp: new Date(t.timestamp),
+        }))
+            .sort((a, b) => b.usdcValue - a.usdcValue)
+            .slice(0, 10);
+        // New positions
+        const newPositions = buys
+            .filter(b => !sells.some(s => s.conditionId === b.conditionId))
+            .slice(0, 10)
+            .map(b => ({
+            market: b.title || '',
+            conditionId: b.conditionId,
+            outcome: b.outcome || '',
+            size: b.size,
+            avgPrice: b.price,
+        }));
+        // Closed markets
+        const closedMarkets = todaysClosed.map(p => ({
+            market: p.title,
+            conditionId: p.conditionId,
+            outcome: p.outcome,
+            realizedPnL: p.realizedPnl,
+            closePrice: p.curPrice,
+        }));
+        return {
+            address,
+            reportDate: dateStr,
+            generatedAt: new Date(),
+            summary,
+            categoryBreakdown,
+            significantTrades,
+            newPositions,
+            closedMarkets,
+        };
+    }
+    /**
+     * Get wallet lifecycle report
+     *
+     * @param address - Wallet address
+     * @param options - Report options with progress callback
+     *
+     * @example
+     * ```typescript
+     * const report = await sdk.smartMoney.getLifecycleReport('0x...', {
+     *   onProgress: (p, msg) => console.log(`${p * 100}%: ${msg}`)
+     * });
+     * console.log(report.performance.winRate);
+     * ```
+     */
+    async getLifecycleReport(address, options) {
+        const { onProgress } = options || {};
+        // 1. Get basic info
+        onProgress?.(0.1, 'Fetching profile...');
+        const profile = await this.walletService.getWalletProfile(address);
+        // 2. Get all closed positions (paginated)
+        onProgress?.(0.2, 'Fetching closed positions...');
+        const closedPositions = await this.fetchAllClosedPositions(address);
+        // 3. Get current positions
+        onProgress?.(0.6, 'Fetching current positions...');
+        const currentPositions = await this.walletService.getWalletPositions(address);
+        // 4. Calculate metrics
+        onProgress?.(0.8, 'Calculating metrics...');
+        const performance = this.calculatePerformanceMetricsFromClosed(closedPositions, currentPositions);
+        const categoryDistribution = this.calculateCategoryDistributionFromClosed(closedPositions);
+        const topMarkets = this.getTopMarkets(closedPositions, 10);
+        const worstMarkets = this.getWorstMarkets(closedPositions, 10);
+        const patterns = this.analyzeTradingPatterns(closedPositions, currentPositions);
+        // 5. Determine data range
+        let firstActivityAt = new Date();
+        let lastActivityAt = new Date();
+        let totalDays = 0;
+        if (closedPositions.length > 0) {
+            const timestamps = closedPositions.map(p => p.timestamp);
+            firstActivityAt = new Date(Math.min(...timestamps));
+            lastActivityAt = new Date(Math.max(...timestamps));
+            totalDays = Math.ceil((lastActivityAt.getTime() - firstActivityAt.getTime()) / (1000 * 60 * 60 * 24));
+        }
+        // 6. Current positions summary
+        const currentPosCategories = this.calculateCategoryDistributionFromPositions(currentPositions);
+        const currentPositionsSummary = {
+            count: currentPositions.length,
+            totalValue: currentPositions.reduce((sum, p) => sum + (p.currentValue ?? p.size * (p.curPrice ?? 0)), 0),
+            unrealizedPnL: currentPositions.reduce((sum, p) => sum + (p.cashPnl ?? 0), 0),
+            categories: currentPosCategories,
+        };
+        onProgress?.(1.0, 'Report generated');
+        return {
+            address,
+            generatedAt: new Date(),
+            dataRange: {
+                firstActivityAt,
+                lastActivityAt,
+                totalDays,
+            },
+            performance,
+            categoryDistribution,
+            topMarkets,
+            worstMarkets,
+            patterns,
+            currentPositions: currentPositionsSummary,
+        };
+    }
+    /**
+     * Get wallet chart data
+     *
+     * @param address - Wallet address
+     *
+     * @example
+     * ```typescript
+     * const chartData = await sdk.smartMoney.getWalletChartData('0x...');
+     * // Use chartData.tradeDistribution with recharts
+     * ```
+     */
+    async getWalletChartData(address) {
+        // Fetch data
+        const closedPositions = await this.fetchAllClosedPositions(address);
+        const currentPositions = await this.walletService.getWalletPositions(address);
+        // Trade distribution (by count)
+        const tradeDistribution = this.buildPieChart('Trade Distribution', closedPositions.map(p => ({ title: p.title, value: 1 })), 'count');
+        // Position distribution (by value)
+        const positionDistribution = this.buildPieChart('Position Distribution', currentPositions.map(p => ({
+            title: p.title,
+            value: p.currentValue ?? p.size * (p.curPrice ?? 0),
+        })), 'value');
+        // Profit distribution (by PnL)
+        const profitPositions = closedPositions.filter(p => p.realizedPnl > 0);
+        const profitDistribution = this.buildPieChart('Profit Distribution', profitPositions.map(p => ({ title: p.title, value: p.realizedPnl })), 'pnl');
+        // Determine data range
+        let fromDate = new Date();
+        let toDate = new Date();
+        if (closedPositions.length > 0) {
+            const timestamps = closedPositions.map(p => p.timestamp);
+            fromDate = new Date(Math.min(...timestamps));
+            toDate = new Date(Math.max(...timestamps));
+        }
+        return {
+            tradeDistribution,
+            positionDistribution,
+            profitDistribution,
+            metadata: {
+                address,
+                generatedAt: new Date(),
+                dataRange: { from: fromDate, to: toDate },
+            },
+        };
+    }
+    /**
+     * Generate a text analysis report for a wallet
+     *
+     * @param address - Wallet address
+     * @param options - Report options with progress callback
+     *
+     * @example
+     * ```typescript
+     * const textReport = await sdk.smartMoney.generateTextReport('0x...');
+     * console.log(textReport.markdown);
+     * ```
+     */
+    async generateTextReport(address, options) {
+        const { onProgress } = options || {};
+        // Get lifecycle report data
+        onProgress?.(0.1, 'Fetching wallet data...');
+        const report = await this.getLifecycleReport(address, {
+            onProgress: (p, msg) => onProgress?.(0.1 + p * 0.7, msg),
+        });
+        // Get chart data for category distribution
+        onProgress?.(0.8, 'Analyzing patterns...');
+        const chartData = await this.getWalletChartData(address);
+        // Generate text report
+        onProgress?.(0.9, 'Generating report...');
+        const markdown = this.buildTextReport(address, report, chartData);
+        onProgress?.(1.0, 'Report complete');
+        return {
+            address,
+            generatedAt: new Date(),
+            markdown,
+            metrics: {
+                totalPnL: report.performance.realizedPnL + report.currentPositions.unrealizedPnL,
+                winRate: report.performance.winRate,
+                profitFactor: report.performance.profitFactor,
+                totalMarketsTraded: report.performance.totalMarketsTraded,
+                totalDays: report.dataRange.totalDays,
+            },
+        };
+    }
+    /**
+     * Build markdown text report from data
+     */
+    buildTextReport(address, report, chartData) {
+        const { performance, categoryDistribution, topMarkets, worstMarkets, patterns, currentPositions, dataRange } = report;
+        const totalPnL = performance.realizedPnL + currentPositions.unrealizedPnL;
+        const formatPnL = (v) => v >= 0 ? `+$${v.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}` : `-$${Math.abs(v).toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+        const formatPercent = (v) => `${(v * 100).toFixed(1)}%`;
+        const formatDate = (d) => d.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+        // Determine trading style
+        const tradingStyle = this.analyzeTradingStyle(patterns, categoryDistribution);
+        const riskAssessment = this.assessRisk(performance, patterns, categoryDistribution);
+        const recommendation = this.generateRecommendation(performance, riskAssessment, tradingStyle);
+        const sections = [];
+        // Header
+        sections.push(`# Wallet Analysis Report\n`);
+        sections.push(`**Address**: \`${address.slice(0, 10)}...${address.slice(-8)}\``);
+        sections.push(`**Report Date**: ${formatDate(new Date())}`);
+        sections.push(`**Data Range**: ${formatDate(dataRange.firstActivityAt)} - ${formatDate(dataRange.lastActivityAt)} (${dataRange.totalDays} days)\n`);
+        // Executive Summary
+        sections.push(`## Executive Summary\n`);
+        sections.push(`| Metric | Value |`);
+        sections.push(`|--------|-------|`);
+        sections.push(`| Total PnL | ${formatPnL(totalPnL)} |`);
+        sections.push(`| Realized PnL | ${formatPnL(performance.realizedPnL)} |`);
+        sections.push(`| Unrealized PnL | ${formatPnL(currentPositions.unrealizedPnL)} |`);
+        sections.push(`| Win Rate | ${formatPercent(performance.winRate)} |`);
+        sections.push(`| Profit Factor | ${performance.profitFactor.toFixed(2)} |`);
+        sections.push(`| Markets Traded | ${performance.totalMarketsTraded} |`);
+        sections.push(`| Current Positions | ${currentPositions.count} |`);
+        sections.push(``);
+        // Trading Style
+        sections.push(`## Trading Style Analysis\n`);
+        sections.push(`- **Position Preference**: ${tradingStyle.positionPreference}`);
+        sections.push(`- **Trading Frequency**: ${tradingStyle.tradingFrequency}`);
+        sections.push(`- **Position Management**: ${tradingStyle.positionManagement}`);
+        sections.push(`- **Primary Focus**: ${tradingStyle.primaryFocus}`);
+        sections.push(``);
+        // Category Distribution
+        sections.push(`## Market Category Distribution\n`);
+        sections.push(`| Category | Trades | PnL | Share |`);
+        sections.push(`|----------|--------|-----|-------|`);
+        for (const cat of categoryDistribution.slice(0, 6)) {
+            sections.push(`| ${CATEGORY_LABELS[cat.category]} | ${cat.tradeCount} | ${formatPnL(cat.pnl)} | ${cat.percentage.toFixed(1)}% |`);
+        }
+        sections.push(``);
+        // Top Markets
+        if (topMarkets.length > 0) {
+            sections.push(`## Best Performing Markets\n`);
+            for (let i = 0; i < Math.min(5, topMarkets.length); i++) {
+                const m = topMarkets[i];
+                sections.push(`${i + 1}. **${m.market}**: ${formatPnL(m.pnl)}`);
+            }
+            sections.push(``);
+        }
+        // Worst Markets
+        if (worstMarkets.length > 0) {
+            sections.push(`## Worst Performing Markets\n`);
+            for (let i = 0; i < Math.min(5, worstMarkets.length); i++) {
+                const m = worstMarkets[i];
+                sections.push(`${i + 1}. **${m.market}**: ${formatPnL(m.pnl)}`);
+            }
+            sections.push(``);
+        }
+        // Risk Assessment
+        sections.push(`## Risk Assessment\n`);
+        sections.push(`- **Concentration Risk**: ${riskAssessment.concentrationRisk}`);
+        sections.push(`- **Drawdown Risk**: ${riskAssessment.drawdownRisk}`);
+        sections.push(`- **Overall Risk Level**: ${riskAssessment.overallRisk}`);
+        sections.push(``);
+        // Copy Trading Recommendation
+        sections.push(`## Copy Trading Recommendation\n`);
+        sections.push(`**Verdict**: ${recommendation.verdict}\n`);
+        sections.push(`${recommendation.reasoning}\n`);
+        if (recommendation.suitableMarkets.length > 0) {
+            sections.push(`**Suitable Markets**: ${recommendation.suitableMarkets.join(', ')}`);
+        }
+        if (recommendation.avoidMarkets.length > 0) {
+            sections.push(`**Markets to Avoid**: ${recommendation.avoidMarkets.join(', ')}`);
+        }
+        if (recommendation.warnings.length > 0) {
+            sections.push(`\n**Warnings**:`);
+            for (const w of recommendation.warnings) {
+                sections.push(`- ${w}`);
+            }
+        }
+        return sections.join('\n');
+    }
+    /**
+     * Analyze trading style from patterns
+     */
+    analyzeTradingStyle(patterns, categoryDistribution) {
+        // Position preference
+        let positionPreference;
+        if (patterns.preferredSide === 'YES') {
+            positionPreference = 'YES-biased (tends to bet on positive outcomes)';
+        }
+        else if (patterns.preferredSide === 'NO') {
+            positionPreference = 'NO-biased (tends to bet against outcomes)';
+        }
+        else {
+            positionPreference = 'Balanced (no strong directional bias)';
+        }
+        // Trading frequency
+        let tradingFrequency;
+        if (patterns.avgTradesPerDay > 10) {
+            tradingFrequency = 'High-frequency (>10 trades/day)';
+        }
+        else if (patterns.avgTradesPerDay > 3) {
+            tradingFrequency = 'Active (3-10 trades/day)';
+        }
+        else if (patterns.avgTradesPerDay > 1) {
+            tradingFrequency = 'Moderate (1-3 trades/day)';
+        }
+        else {
+            tradingFrequency = 'Low-frequency (<1 trade/day)';
+        }
+        // Position management
+        let positionManagement;
+        if (patterns.positionConcentration > 0.5) {
+            positionManagement = 'Concentrated (high single-position exposure)';
+        }
+        else if (patterns.positionConcentration > 0.25) {
+            positionManagement = 'Moderate diversification';
+        }
+        else {
+            positionManagement = 'Well-diversified';
+        }
+        // Primary focus
+        const topCategory = categoryDistribution[0];
+        const primaryFocus = topCategory
+            ? `${CATEGORY_LABELS[topCategory.category]} (${topCategory.percentage.toFixed(0)}% of trades)`
+            : 'Diversified';
+        return {
+            positionPreference,
+            tradingFrequency,
+            positionManagement,
+            primaryFocus,
+        };
+    }
+    /**
+     * Assess risk profile
+     */
+    assessRisk(performance, patterns, categoryDistribution) {
+        // Concentration risk
+        const topCategoryShare = categoryDistribution[0]?.percentage || 0;
+        let concentrationRisk;
+        if (topCategoryShare > 70) {
+            concentrationRisk = 'High (>70% in single category)';
+        }
+        else if (topCategoryShare > 50) {
+            concentrationRisk = 'Medium (50-70% in top category)';
+        }
+        else {
+            concentrationRisk = 'Low (well diversified)';
+        }
+        // Drawdown risk
+        const maxLossRatio = performance.maxLoss / Math.max(Math.abs(performance.realizedPnL), 1);
+        let drawdownRisk;
+        if (maxLossRatio > 0.5) {
+            drawdownRisk = 'High (max loss >50% of total PnL)';
+        }
+        else if (maxLossRatio > 0.25) {
+            drawdownRisk = 'Medium';
+        }
+        else {
+            drawdownRisk = 'Low';
+        }
+        // Overall risk
+        let overallRisk;
+        if (performance.winRate < 0.4 || performance.profitFactor < 1) {
+            overallRisk = 'HIGH - Unprofitable strategy';
+        }
+        else if (performance.winRate < 0.5 || performance.profitFactor < 1.5) {
+            overallRisk = 'MEDIUM - Moderate performance';
+        }
+        else if (patterns.positionConcentration > 0.5) {
+            overallRisk = 'MEDIUM - High concentration';
+        }
+        else {
+            overallRisk = 'LOW - Solid track record';
+        }
+        return { concentrationRisk, drawdownRisk, overallRisk };
+    }
+    /**
+     * Generate copy trading recommendation
+     */
+    generateRecommendation(performance, risk, style) {
+        const warnings = [];
+        const suitableMarkets = [];
+        const avoidMarkets = [];
+        // Determine verdict
+        let verdict;
+        let reasoning;
+        if (performance.winRate >= 0.6 && performance.profitFactor >= 1.5) {
+            verdict = 'RECOMMENDED';
+            reasoning = `This wallet shows consistent profitability with a ${(performance.winRate * 100).toFixed(0)}% win rate and ${performance.profitFactor.toFixed(1)}x profit factor. The trading pattern is suitable for copy trading.`;
+        }
+        else if (performance.winRate >= 0.5 && performance.profitFactor >= 1.2) {
+            verdict = 'CAUTIOUSLY RECOMMENDED';
+            reasoning = `This wallet is profitable but with moderate consistency. Consider following with smaller position sizes.`;
+        }
+        else if (performance.realizedPnL > 0) {
+            verdict = 'NOT RECOMMENDED';
+            reasoning = `While overall profitable, the low win rate (${(performance.winRate * 100).toFixed(0)}%) or profit factor (${performance.profitFactor.toFixed(1)}x) suggests inconsistent performance.`;
+        }
+        else {
+            verdict = 'AVOID';
+            reasoning = `This wallet has negative overall performance. Not suitable for copy trading.`;
+        }
+        // Add warnings
+        if (risk.overallRisk.includes('HIGH')) {
+            warnings.push('High risk profile detected');
+        }
+        if (performance.losingMarkets > performance.winningMarkets) {
+            warnings.push('More losing markets than winning markets');
+        }
+        if (style.tradingFrequency.includes('High-frequency')) {
+            warnings.push('High-frequency trading may incur significant fees when copying');
+        }
+        return {
+            verdict,
+            reasoning,
+            suitableMarkets,
+            avoidMarkets,
+            warnings,
+        };
+    }
+    // ============================================================================
+    // Report Helper Methods
+    // ============================================================================
+    /**
+     * Categorize market based on title keywords
+     */
+    categorizeMarket(title) {
+        const lowerTitle = title.toLowerCase();
+        // Crypto
+        if (/\b(btc|bitcoin|eth|ethereum|sol|solana|xrp|crypto|doge|ada|matic)\b/.test(lowerTitle)) {
+            return 'crypto';
+        }
+        // Politics
+        if (/\b(trump|biden|election|president|senate|congress|vote|political|maga|democrat|republican)\b/.test(lowerTitle)) {
+            return 'politics';
+        }
+        // Sports
+        if (/\b(nfl|nba|mlb|nhl|super bowl|world cup|championship|game|match|ufc|soccer|football|basketball)\b/.test(lowerTitle)) {
+            return 'sports';
+        }
+        // Economics
+        if (/\b(fed|interest rate|inflation|gdp|recession|economic|unemployment|cpi)\b/.test(lowerTitle)) {
+            return 'economics';
+        }
+        // Entertainment
+        if (/\b(oscar|grammy|movie|twitter|celebrity|entertainment|netflix|spotify)\b/.test(lowerTitle)) {
+            return 'entertainment';
+        }
+        // Science
+        if (/\b(spacex|nasa|ai|openai|google|apple|tesla|tech|technology|science)\b/.test(lowerTitle)) {
+            return 'science';
+        }
+        return 'other';
+    }
+    /**
+     * Fetch all closed positions with pagination
+     */
+    async fetchAllClosedPositions(address) {
+        if (!this.dataApi) {
+            return [];
+        }
+        const allPositions = [];
+        let offset = 0;
+        const limit = 50;
+        const maxIterations = 200; // Max 10000 positions
+        for (let i = 0; i < maxIterations; i++) {
+            const result = await this.dataApi.getClosedPositions(address, {
+                limit,
+                offset,
+                sortBy: 'TIMESTAMP',
+                sortDirection: 'DESC',
+            });
+            if (result.length === 0)
+                break;
+            allPositions.push(...result);
+            offset += limit;
+            // If less than limit returned, we've reached the end
+            if (result.length < limit)
+                break;
+        }
+        return allPositions;
+    }
+    /**
+     * Calculate performance metrics from closed positions
+     */
+    calculatePerformanceMetricsFromClosed(closedPositions, currentPositions) {
+        const wins = closedPositions.filter(p => p.realizedPnl > 0);
+        const losses = closedPositions.filter(p => p.realizedPnl < 0);
+        const totalWinAmount = wins.reduce((sum, p) => sum + p.realizedPnl, 0);
+        const totalLossAmount = Math.abs(losses.reduce((sum, p) => sum + p.realizedPnl, 0));
+        const realizedPnL = closedPositions.reduce((sum, p) => sum + p.realizedPnl, 0);
+        const unrealizedPnL = currentPositions.reduce((sum, p) => sum + (p.cashPnl ?? 0), 0);
+        return {
+            totalPnL: realizedPnL + unrealizedPnL,
+            realizedPnL,
+            unrealizedPnL,
+            totalVolume: closedPositions.reduce((sum, p) => sum + p.totalBought, 0),
+            winRate: closedPositions.length > 0 ? wins.length / closedPositions.length : 0,
+            profitFactor: totalLossAmount > 0 ? totalWinAmount / totalLossAmount : totalWinAmount,
+            avgWin: wins.length > 0 ? totalWinAmount / wins.length : 0,
+            avgLoss: losses.length > 0 ? totalLossAmount / losses.length : 0,
+            maxWin: wins.length > 0 ? Math.max(...wins.map(p => p.realizedPnl)) : 0,
+            maxLoss: losses.length > 0 ? Math.max(...losses.map(p => Math.abs(p.realizedPnl))) : 0,
+            totalMarketsTraded: closedPositions.length,
+            winningMarkets: wins.length,
+            losingMarkets: losses.length,
+        };
+    }
+    /**
+     * Calculate category distribution from closed positions
+     */
+    calculateCategoryDistributionFromClosed(positions) {
+        const categoryMap = new Map();
+        for (const pos of positions) {
+            const category = this.categorizeMarket(pos.title);
+            const current = categoryMap.get(category) || { count: 0, volume: 0, pnl: 0 };
+            categoryMap.set(category, {
+                count: current.count + 1,
+                volume: current.volume + pos.totalBought,
+                pnl: current.pnl + pos.realizedPnl,
+            });
+        }
+        const total = positions.length;
+        return Array.from(categoryMap.entries())
+            .map(([category, stats]) => ({
+            category,
+            tradeCount: stats.count,
+            volume: stats.volume,
+            pnl: stats.pnl,
+            percentage: total > 0 ? (stats.count / total) * 100 : 0,
+        }))
+            .sort((a, b) => b.tradeCount - a.tradeCount);
+    }
+    /**
+     * Calculate category distribution from current positions
+     */
+    calculateCategoryDistributionFromPositions(positions) {
+        const categoryMap = new Map();
+        for (const pos of positions) {
+            const category = this.categorizeMarket(pos.title || '');
+            const current = categoryMap.get(category) || { count: 0, volume: 0, pnl: 0 };
+            categoryMap.set(category, {
+                count: current.count + 1,
+                volume: current.volume + (pos.currentValue ?? pos.size * (pos.curPrice ?? 0)),
+                pnl: current.pnl + (pos.cashPnl ?? 0),
+            });
+        }
+        const total = positions.length;
+        return Array.from(categoryMap.entries())
+            .map(([category, stats]) => ({
+            category,
+            tradeCount: stats.count,
+            volume: stats.volume,
+            pnl: stats.pnl,
+            percentage: total > 0 ? (stats.count / total) * 100 : 0,
+        }))
+            .sort((a, b) => b.tradeCount - a.tradeCount);
+    }
+    /**
+     * Calculate category breakdown from activity trades
+     */
+    calculateCategoryBreakdownFromActivities(trades) {
+        const categoryMap = new Map();
+        for (const trade of trades) {
+            const category = this.categorizeMarket(trade.title || '');
+            const current = categoryMap.get(category) || { count: 0, volume: 0 };
+            categoryMap.set(category, {
+                count: current.count + 1,
+                volume: current.volume + (trade.usdcSize || trade.size * trade.price),
+            });
+        }
+        const total = trades.length;
+        return Array.from(categoryMap.entries())
+            .map(([category, stats]) => ({
+            category,
+            tradeCount: stats.count,
+            volume: stats.volume,
+            pnl: 0, // Not available from trades
+            percentage: total > 0 ? (stats.count / total) * 100 : 0,
+        }))
+            .sort((a, b) => b.tradeCount - a.tradeCount);
+    }
+    /**
+     * Get top markets by PnL
+     */
+    getTopMarkets(positions, limit) {
+        return positions
+            .filter(p => p.realizedPnl > 0)
+            .sort((a, b) => b.realizedPnl - a.realizedPnl)
+            .slice(0, limit)
+            .map(p => ({
+            market: p.title,
+            conditionId: p.conditionId,
+            category: this.categorizeMarket(p.title),
+            pnl: p.realizedPnl,
+            volume: p.totalBought,
+            tradeCount: 1, // Each closed position is one market
+            outcome: 'win',
+            avgPrice: p.avgPrice,
+            closePrice: p.curPrice,
+        }));
+    }
+    /**
+     * Get worst markets by PnL
+     */
+    getWorstMarkets(positions, limit) {
+        return positions
+            .filter(p => p.realizedPnl < 0)
+            .sort((a, b) => a.realizedPnl - b.realizedPnl)
+            .slice(0, limit)
+            .map(p => ({
+            market: p.title,
+            conditionId: p.conditionId,
+            category: this.categorizeMarket(p.title),
+            pnl: p.realizedPnl,
+            volume: p.totalBought,
+            tradeCount: 1,
+            outcome: 'lose',
+            avgPrice: p.avgPrice,
+            closePrice: p.curPrice,
+        }));
+    }
+    /**
+     * Analyze trading patterns
+     */
+    analyzeTradingPatterns(closedPositions, currentPositions) {
+        // Calculate average trades per day/week
+        let avgTradesPerDay = 0;
+        let avgTradesPerWeek = 0;
+        if (closedPositions.length > 0) {
+            const timestamps = closedPositions.map(p => p.timestamp);
+            const firstDate = new Date(Math.min(...timestamps));
+            const lastDate = new Date(Math.max(...timestamps));
+            const totalDays = Math.max(1, Math.ceil((lastDate.getTime() - firstDate.getTime()) / (1000 * 60 * 60 * 24)));
+            avgTradesPerDay = closedPositions.length / totalDays;
+            avgTradesPerWeek = avgTradesPerDay * 7;
+        }
+        // Determine preferred side
+        const yesPositions = currentPositions.filter(p => p.outcome?.toLowerCase() === 'yes' || p.outcome?.toLowerCase() === 'up');
+        const noPositions = currentPositions.filter(p => p.outcome?.toLowerCase() === 'no' || p.outcome?.toLowerCase() === 'down');
+        let preferredSide = 'balanced';
+        if (yesPositions.length > noPositions.length * 1.5) {
+            preferredSide = 'YES';
+        }
+        else if (noPositions.length > yesPositions.length * 1.5) {
+            preferredSide = 'NO';
+        }
+        // Average position size
+        const avgPositionSize = closedPositions.length > 0
+            ? closedPositions.reduce((sum, p) => sum + p.totalBought, 0) / closedPositions.length
+            : 0;
+        // Top categories
+        const categoryStats = this.calculateCategoryDistributionFromClosed(closedPositions);
+        const topCategories = categoryStats
+            .slice(0, 3)
+            .map(c => c.category);
+        // Position concentration (max single position share)
+        const totalValue = currentPositions.reduce((sum, p) => sum + (p.currentValue ?? p.size * (p.curPrice ?? 0)), 0);
+        const maxPositionValue = currentPositions.length > 0
+            ? Math.max(...currentPositions.map(p => p.currentValue ?? p.size * (p.curPrice ?? 0)))
+            : 0;
+        const positionConcentration = totalValue > 0 ? maxPositionValue / totalValue : 0;
+        return {
+            avgTradesPerDay,
+            avgTradesPerWeek,
+            preferredSide,
+            avgPositionSize,
+            avgHoldingDays: 0, // Would need more data to calculate
+            topCategories,
+            positionConcentration,
+        };
+    }
+    /**
+     * Build pie chart data
+     */
+    buildPieChart(name, items, _valueField) {
+        const categoryMap = new Map();
+        for (const item of items) {
+            const category = this.categorizeMarket(item.title);
+            const current = categoryMap.get(category) || 0;
+            categoryMap.set(category, current + item.value);
+        }
+        const total = Array.from(categoryMap.values()).reduce((a, b) => a + b, 0);
+        const data = Array.from(categoryMap.entries())
+            .map(([category, value]) => ({
+            name: CATEGORY_LABELS[category],
+            value,
+            percentage: total > 0 ? (value / total) * 100 : 0,
+            color: CATEGORY_COLORS[category],
+        }))
+            .sort((a, b) => b.value - a.value);
+        return { name, data, total };
+    }
+    /**
+     * Format date as YYYY-MM-DD
+     */
+    formatDate(date) {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        const day = String(date.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    // ============================================================================
     // Utilities
     // ============================================================================
     isCacheValid() {