analyze

Instructions

Implementation Reference

• index.js:166-225 (handler)

  The `technicalAnalysis` function that executes the analyze tool logic. Computes RSI (14-period), SMA (20/50), volatility (log-returns annualized), z-score, trend direction, and price vs SMA comparison.

  function technicalAnalysis(candles) {
    const closes = candles.map(c => c.close);
    const n = closes.length;
    if (n < 14) return { error: 'Need at least 14 candles for analysis' };
  
    // SMA
    const sma20 = closes.slice(-20).reduce((a, b) => a + b, 0) / Math.min(20, n);
    const sma50 = n >= 50 ? closes.slice(-50).reduce((a, b) => a + b, 0) / 50 : null;
  
    // RSI (14-period)
    let gains = 0, losses = 0;
    for (let i = n - 14; i < n; i++) {
      const diff = closes[i] - closes[i - 1];
      if (diff > 0) gains += diff;
      else losses -= diff;
    }
    const avgGain = gains / 14;
    const avgLoss = losses / 14;
    const rs = avgLoss === 0 ? 100 : avgGain / avgLoss;
    const rsi = 100 - (100 / (1 + rs));
  
    // Volatility
    const returns = [];
    for (let i = 1; i < n; i++) {
      returns.push(Math.log(closes[i] / closes[i - 1]));
    }
    const mean = returns.reduce((a, b) => a + b, 0) / returns.length;
    const variance = returns.reduce((a, b) => a + (b - mean) ** 2, 0) / returns.length;
    const volatility = Math.sqrt(variance);
  
    // Z-score
    const allMean = closes.reduce((a, b) => a + b, 0) / n;
    const std = Math.sqrt(closes.reduce((a, b) => a + (b - allMean) ** 2, 0) / n);
    const zscore = std > 0 ? (closes[n - 1] - allMean) / std : 0;
  
    // Trend
    const recent = closes.slice(-5);
    const older = closes.slice(-10, -5);
    const recentAvg = recent.reduce((a, b) => a + b, 0) / recent.length;
    const olderAvg = older.length > 0 ? older.reduce((a, b) => a + b, 0) / older.length : recentAvg;
  
    const current = closes[n - 1];
  
    return {
      current_price: current,
      sma_20: Math.round(sma20 * 100) / 100,
      sma_50: sma50 ? Math.round(sma50 * 100) / 100 : 'insufficient data',
      rsi_14: Math.round(rsi * 100) / 100,
      rsi_signal: rsi > 70 ? 'OVERBOUGHT' : rsi < 30 ? 'OVERSOLD' : 'NEUTRAL',
      volatility: Math.round(volatility * 10000) / 10000,
      volatility_annualized: Math.round(volatility * Math.sqrt(365 * 24) * 10000) / 100 + '%',
      zscore: Math.round(zscore * 100) / 100,
      zscore_signal: zscore > 2 ? 'EXTENDED HIGH' : zscore < -2 ? 'EXTENDED LOW' : 'NORMAL',
      trend: recentAvg > olderAvg * 1.01 ? 'UPTREND' : recentAvg < olderAvg * 0.99 ? 'DOWNTREND' : 'SIDEWAYS',
      price_vs_sma20: current > sma20 ? 'ABOVE' : 'BELOW',
      high: Math.max(...closes),
      low: Math.min(...closes),
      range_pct: ((Math.max(...closes) - Math.min(...closes)) / Math.min(...closes) * 100).toFixed(2) + '%',
    };
  }

• index.js:288-297 (schema)

  Schema definition for the 'analyze' tool: requires 'symbol' (string) and optional 'days' (number, default 30).

  name: 'analyze',
  description: 'Technical analysis for any crypto: RSI, SMA, volatility, z-score, trend direction. Actionable signals included.',
  inputSchema: {
    type: 'object',
    properties: {
      symbol: { type: 'string', description: 'Crypto symbol' },
      days: { type: 'number', description: 'Lookback period in days (default: 30)' }
    },
    required: ['symbol']
  }

• index.js:287-298 (registration)

  Registration of the 'analyze' tool in the getToolDefinitions() array of tool definitions.

  {
    name: 'analyze',
    description: 'Technical analysis for any crypto: RSI, SMA, volatility, z-score, trend direction. Actionable signals included.',
    inputSchema: {
      type: 'object',
      properties: {
        symbol: { type: 'string', description: 'Crypto symbol' },
        days: { type: 'number', description: 'Lookback period in days (default: 30)' }
      },
      required: ['symbol']
    }
  },

• index.js:335-338 (handler)

  The tool call handler for 'analyze' in handleToolCall() switch case. Fetches candles then delegates to technicalAnalysis().

  case 'analyze': {
    const candles = await getCryptoCandles(args.symbol, '1h', args.days || 30);
    return technicalAnalysis(candles);
  }

• index.js:80-99 (helper)

  The getCryptoCandles helper that fetches OHLCV data from CoinGecko, called by the analyze handler to provide candle data for analysis.

  async function getCryptoCandles(symbol, interval = '1h', days = 7) {
    const id = symbol.toLowerCase().replace('usdt', '').replace('usd', '');
    const idMap = {
      btc: 'bitcoin', eth: 'ethereum', sol: 'solana', doge: 'dogecoin',
      xrp: 'ripple', bnb: 'binancecoin', ada: 'cardano', avax: 'avalanche-2',
    };
    const coinId = idMap[id] || id;
  
    const data = await fetch(
      `https://api.coingecko.com/api/v3/coins/${coinId}/ohlc?vs_currency=usd&days=${days}`
    );
  
    return data.map(c => ({
      time: new Date(c[0]).toISOString(),
      open: c[1],
      high: c[2],
      low: c[3],
      close: c[4],
    }));
  }