market-data-analyzer 2.0.0

package/src/tools/analyze_stock.ts

@@ -0,0 +1,204 @@
+/**
+ * analyze_stock -- Deep analysis of a stock symbol.
+ *
+ * Fetches live data from Yahoo Finance, computes SMA 20/50/200, RSI,
+ * MACD, and support/resistance levels.
+ */
+
+import { yahooQuote, yahooChart } from "../utils/api.js";
+import {
+  sma,
+  rsi,
+  macd,
+  lastValue,
+  findSupportResistance,
+  formatCurrency,
+  formatVolume,
+} from "../utils/math.js";
+
+export async function handleAnalyzeStock(symbol: string): Promise<string> {
+  // Fetch quote and 6-month daily chart in parallel
+  const [quotes, chart] = await Promise.all([
+    yahooQuote([symbol]),
+    yahooChart(symbol, "6mo", "1d"),
+  ]);
+
+  const quote = quotes[0];
+  if (!quote || !quote.regularMarketPrice) {
+    throw new Error(`No quote data found for symbol "${symbol}". Verify the ticker is correct.`);
+  }
+
+  if (chart.length < 5) {
+    throw new Error(`Insufficient price history for "${symbol}" (got ${chart.length} data points).`);
+  }
+
+  const closes = chart.map((p) => p.close);
+  const highs = chart.map((p) => p.high);
+  const lows = chart.map((p) => p.low);
+  const currentPrice = quote.regularMarketPrice;
+
+  // Compute indicators
+  const sma20 = lastValue(sma(closes, Math.min(20, closes.length)));
+  const sma50 = closes.length >= 50 ? lastValue(sma(closes, 50)) : null;
+  const sma200 = closes.length >= 200 ? lastValue(sma(closes, 200)) : null;
+  const rsi14 = closes.length >= 15 ? lastValue(rsi(closes, 14)) : null;
+
+  let macdResult: { line: number; signal: number; histogram: number } | null = null;
+  if (closes.length >= 35) {
+    const m = macd(closes);
+    const mLine = lastValue(m.line);
+    const mSignal = lastValue(m.signal);
+    const mHist = lastValue(m.histogram);
+    if (mLine !== null && mSignal !== null && mHist !== null) {
+      macdResult = { line: mLine, signal: mSignal, histogram: mHist };
+    }
+  }
+
+  // Support & resistance
+  const sr = findSupportResistance(highs, lows, closes);
+
+  // Build output
+  const lines: string[] = [];
+  const name = quote.longName ?? quote.shortName ?? symbol;
+  const change = quote.regularMarketChange ?? 0;
+  const changePct = quote.regularMarketChangePercent ?? 0;
+
+  lines.push(`# Stock Analysis: ${name} (${symbol})`);
+  lines.push("");
+
+  // Price overview
+  lines.push("## Price Overview");
+  lines.push("");
+  lines.push("| Metric | Value |");
+  lines.push("|--------|-------|");
+  lines.push(`| Current Price | $${currentPrice.toFixed(2)} |`);
+  lines.push(`| Change | ${change >= 0 ? "+" : ""}$${change.toFixed(2)} (${changePct >= 0 ? "+" : ""}${changePct.toFixed(2)}%) |`);
+  lines.push(`| Day Range | $${(quote.regularMarketDayLow ?? 0).toFixed(2)} - $${(quote.regularMarketDayHigh ?? 0).toFixed(2)} |`);
+  lines.push(`| 52-Week Range | $${(quote.fiftyTwoWeekLow ?? 0).toFixed(2)} - $${(quote.fiftyTwoWeekHigh ?? 0).toFixed(2)} |`);
+  lines.push(`| Volume | ${formatVolume(quote.regularMarketVolume ?? 0)} |`);
+  lines.push(`| Market Cap | ${formatCurrency(quote.marketCap ?? 0)} |`);
+  if (quote.trailingPE) lines.push(`| P/E (Trailing) | ${quote.trailingPE.toFixed(2)} |`);
+  if (quote.forwardPE) lines.push(`| P/E (Forward) | ${quote.forwardPE.toFixed(2)} |`);
+  if (quote.trailingAnnualDividendYield) {
+    lines.push(`| Dividend Yield | ${(quote.trailingAnnualDividendYield * 100).toFixed(2)}% |`);
+  }
+  lines.push("");
+
+  // Moving averages
+  lines.push("## Moving Averages");
+  lines.push("");
+  lines.push("| Indicator | Value | Signal |");
+  lines.push("|-----------|-------|--------|");
+
+  if (sma20 !== null) {
+    const sig = currentPrice > sma20 ? "BULLISH (price above)" : currentPrice < sma20 ? "BEARISH (price below)" : "NEUTRAL";
+    lines.push(`| SMA(20) | $${sma20.toFixed(2)} | ${sig} |`);
+  }
+  if (sma50 !== null) {
+    const sig = currentPrice > sma50 ? "BULLISH (price above)" : currentPrice < sma50 ? "BEARISH (price below)" : "NEUTRAL";
+    lines.push(`| SMA(50) | $${sma50.toFixed(2)} | ${sig} |`);
+  }
+  if (sma200 !== null) {
+    const sig = currentPrice > sma200 ? "BULLISH (price above)" : currentPrice < sma200 ? "BEARISH (price below)" : "NEUTRAL";
+    lines.push(`| SMA(200) | $${sma200.toFixed(2)} | ${sig} |`);
+  }
+  if (quote.fiftyDayAverage) {
+    lines.push(`| Yahoo 50-Day Avg | $${quote.fiftyDayAverage.toFixed(2)} | -- |`);
+  }
+  if (quote.twoHundredDayAverage) {
+    lines.push(`| Yahoo 200-Day Avg | $${quote.twoHundredDayAverage.toFixed(2)} | -- |`);
+  }
+
+  // Golden/Death cross
+  if (sma50 !== null && sma200 !== null) {
+    if (sma50 > sma200) {
+      lines.push("");
+      lines.push("**Golden Cross**: 50-day SMA is above 200-day SMA -- historically bullish signal.");
+    } else if (sma50 < sma200) {
+      lines.push("");
+      lines.push("**Death Cross**: 50-day SMA is below 200-day SMA -- historically bearish signal.");
+    }
+  }
+  lines.push("");
+
+  // RSI
+  if (rsi14 !== null) {
+    lines.push("## RSI (14-period)");
+    lines.push("");
+    lines.push(`**RSI: ${rsi14.toFixed(1)}**`);
+    lines.push("");
+    if (rsi14 >= 70) {
+      lines.push("Interpretation: **OVERBOUGHT** (RSI >= 70). The stock may be overvalued and due for a pullback.");
+    } else if (rsi14 <= 30) {
+      lines.push("Interpretation: **OVERSOLD** (RSI <= 30). The stock may be undervalued and due for a bounce.");
+    } else if (rsi14 >= 60) {
+      lines.push("Interpretation: Bullish momentum (RSI in 60-70 range).");
+    } else if (rsi14 <= 40) {
+      lines.push("Interpretation: Bearish momentum (RSI in 30-40 range).");
+    } else {
+      lines.push("Interpretation: Neutral momentum (RSI in 40-60 range).");
+    }
+    lines.push("");
+  }
+
+  // MACD
+  if (macdResult) {
+    lines.push("## MACD (12, 26, 9)");
+    lines.push("");
+    lines.push("| Component | Value |");
+    lines.push("|-----------|-------|");
+    lines.push(`| MACD Line | ${macdResult.line.toFixed(4)} |`);
+    lines.push(`| Signal Line | ${macdResult.signal.toFixed(4)} |`);
+    lines.push(`| Histogram | ${macdResult.histogram.toFixed(4)} |`);
+    lines.push("");
+    if (macdResult.histogram > 0) {
+      lines.push("Interpretation: **BULLISH** -- MACD is above signal line, positive momentum.");
+    } else {
+      lines.push("Interpretation: **BEARISH** -- MACD is below signal line, negative momentum.");
+    }
+    lines.push("");
+  }
+
+  // Support & Resistance
+  lines.push("## Support & Resistance Levels");
+  lines.push("");
+  if (sr.resistance.length > 0) {
+    lines.push("**Resistance:**");
+    for (const r of sr.resistance) {
+      const distPct = ((r - currentPrice) / currentPrice * 100).toFixed(1);
+      lines.push(`- $${r.toFixed(2)} (+${distPct}% from current)`);
+    }
+  } else {
+    lines.push("**Resistance:** No clear resistance levels identified in recent data.");
+  }
+  lines.push("");
+  if (sr.support.length > 0) {
+    lines.push("**Support:**");
+    for (const s of sr.support) {
+      const distPct = ((currentPrice - s) / currentPrice * 100).toFixed(1);
+      lines.push(`- $${s.toFixed(2)} (-${distPct}% from current)`);
+    }
+  } else {
+    lines.push("**Support:** No clear support levels identified in recent data.");
+  }
+  lines.push("");
+
+  // Signal summary
+  lines.push("## Signal Summary");
+  lines.push("");
+  let bullishCount = 0;
+  let bearishCount = 0;
+
+  if (sma20 !== null) { if (currentPrice > sma20) bullishCount++; else bearishCount++; }
+  if (sma50 !== null) { if (currentPrice > sma50) bullishCount++; else bearishCount++; }
+  if (sma200 !== null) { if (currentPrice > sma200) bullishCount++; else bearishCount++; }
+  if (rsi14 !== null) { if (rsi14 < 30) bullishCount++; else if (rsi14 > 70) bearishCount++; }
+  if (macdResult) { if (macdResult.histogram > 0) bullishCount++; else bearishCount++; }
+
+  const total = bullishCount + bearishCount;
+  const consensus = bullishCount > bearishCount ? "BULLISH" : bearishCount > bullishCount ? "BEARISH" : "NEUTRAL";
+  lines.push(`Bullish signals: ${bullishCount}/${total} | Bearish signals: ${bearishCount}/${total}`);
+  lines.push(`**Overall technical consensus: ${consensus}**`);
+
+  return lines.join("\n");
+}

package/src/tools/compare_assets.ts

@@ -0,0 +1,181 @@
+/**
+ * compare_assets -- Compare 2-5 assets side by side.
+ *
+ * Fetches price history from Yahoo Finance, computes returns, volatility,
+ * correlation, and Sharpe ratio approximation.
+ */
+
+import { yahooChart, yahooQuote } from "../utils/api.js";
+import {
+  pricesToReturns,
+  mean,
+  stdDev,
+  correlation,
+  maxDrawdown,
+  sharpeRatio,
+  formatPct,
+} from "../utils/math.js";
+
+export async function handleCompareAssets(
+  symbols: string[],
+  period: string = "6mo",
+): Promise<string> {
+  if (symbols.length < 2 || symbols.length > 5) {
+    throw new Error("Compare requires 2-5 symbols.");
+  }
+
+  // Fetch chart data and quotes in parallel
+  const [charts, quotes] = await Promise.all([
+    Promise.all(symbols.map((s) => yahooChart(s, period, "1d"))),
+    yahooQuote(symbols),
+  ]);
+
+  const quoteMap = new Map(quotes.map((q) => [q.symbol, q]));
+
+  // Build per-asset metrics
+  const TRADING_DAYS = 252;
+  const assetMetrics: Array<{
+    symbol: string;
+    name: string;
+    currentPrice: number;
+    totalReturn: number;
+    annualizedReturn: number;
+    volatility: number;
+    sharpe: number;
+    mdd: number;
+    returns: number[];
+  }> = [];
+
+  for (let i = 0; i < symbols.length; i++) {
+    const sym = symbols[i];
+    const chart = charts[i];
+    const quote = quoteMap.get(sym);
+
+    if (chart.length < 5) {
+      throw new Error(`Insufficient data for ${sym} (got ${chart.length} points). Try a longer period.`);
+    }
+
+    const closes = chart.map((p) => p.close);
+    const returns = pricesToReturns(closes);
+    const avgDailyReturn = mean(returns);
+    const dailyVol = stdDev(returns);
+    const totalReturn = (closes[closes.length - 1] - closes[0]) / closes[0];
+
+    assetMetrics.push({
+      symbol: sym,
+      name: quote?.shortName ?? quote?.longName ?? sym,
+      currentPrice: quote?.regularMarketPrice ?? closes[closes.length - 1],
+      totalReturn,
+      annualizedReturn: avgDailyReturn * TRADING_DAYS,
+      volatility: dailyVol * Math.sqrt(TRADING_DAYS),
+      sharpe: sharpeRatio(returns),
+      mdd: maxDrawdown(closes),
+      returns,
+    });
+  }
+
+  // Correlation matrix
+  const correlations: Array<{ a: string; b: string; corr: number }> = [];
+  for (let i = 0; i < assetMetrics.length; i++) {
+    for (let j = i + 1; j < assetMetrics.length; j++) {
+      correlations.push({
+        a: assetMetrics[i].symbol,
+        b: assetMetrics[j].symbol,
+        corr: correlation(assetMetrics[i].returns, assetMetrics[j].returns),
+      });
+    }
+  }
+
+  // Format output
+  const lines: string[] = [];
+
+  lines.push("# Asset Comparison");
+  lines.push("");
+  lines.push(`**Assets:** ${symbols.join(", ")}`);
+  lines.push(`**Period:** ${period}`);
+  lines.push("");
+
+  // Performance table (transposed)
+  lines.push("## Performance Comparison");
+  lines.push("");
+  lines.push("| Metric | " + assetMetrics.map((a) => a.symbol).join(" | ") + " |");
+  lines.push("| --- | " + assetMetrics.map(() => "---").join(" | ") + " |");
+  lines.push("| Name | " + assetMetrics.map((a) => a.name.slice(0, 20)).join(" | ") + " |");
+  lines.push("| Current Price | " + assetMetrics.map((a) => `$${a.currentPrice.toFixed(2)}`).join(" | ") + " |");
+  lines.push("| Total Return | " + assetMetrics.map((a) => formatPct(a.totalReturn)).join(" | ") + " |");
+  lines.push("| Annualized Return | " + assetMetrics.map((a) => formatPct(a.annualizedReturn)).join(" | ") + " |");
+  lines.push("| Volatility (Ann.) | " + assetMetrics.map((a) => formatPct(a.volatility)).join(" | ") + " |");
+  lines.push("| Sharpe Ratio | " + assetMetrics.map((a) => a.sharpe.toFixed(3)).join(" | ") + " |");
+  lines.push("| Max Drawdown | " + assetMetrics.map((a) => formatPct(-a.mdd)).join(" | ") + " |");
+  lines.push("");
+
+  // Rankings
+  lines.push("## Rankings");
+  lines.push("");
+
+  const byReturn = [...assetMetrics].sort((a, b) => b.totalReturn - a.totalReturn);
+  const bySharpe = [...assetMetrics].sort((a, b) => b.sharpe - a.sharpe);
+  const byVol = [...assetMetrics].sort((a, b) => a.volatility - b.volatility);
+  const byDD = [...assetMetrics].sort((a, b) => a.mdd - b.mdd);
+
+  lines.push("| Rank | Best Return | Best Sharpe | Lowest Vol | Smallest DD |");
+  lines.push("|------|-------------|-------------|------------|-------------|");
+  for (let i = 0; i < assetMetrics.length; i++) {
+    lines.push(
+      `| ${i + 1} | ${byReturn[i].symbol} (${formatPct(byReturn[i].totalReturn)}) | ${bySharpe[i].symbol} (${bySharpe[i].sharpe.toFixed(3)}) | ${byVol[i].symbol} (${formatPct(byVol[i].volatility)}) | ${byDD[i].symbol} (${formatPct(-byDD[i].mdd)}) |`,
+    );
+  }
+  lines.push("");
+
+  // Correlation matrix
+  lines.push("## Correlation Matrix");
+  lines.push("");
+
+  const syms = assetMetrics.map((a) => a.symbol);
+  lines.push("| | " + syms.join(" | ") + " |");
+  lines.push("| --- | " + syms.map(() => "---").join(" | ") + " |");
+
+  for (let i = 0; i < syms.length; i++) {
+    const row = [syms[i]];
+    for (let j = 0; j < syms.length; j++) {
+      if (i === j) {
+        row.push("1.000");
+      } else {
+        const pair = correlations.find(
+          (c) =>
+            (c.a === syms[i] && c.b === syms[j]) ||
+            (c.a === syms[j] && c.b === syms[i]),
+        );
+        row.push(pair ? pair.corr.toFixed(3) : "N/A");
+      }
+    }
+    lines.push("| " + row.join(" | ") + " |");
+  }
+  lines.push("");
+
+  // Correlation insight
+  const avgCorr = correlations.length > 0
+    ? mean(correlations.map((c) => c.corr))
+    : 0;
+  lines.push(`**Average correlation:** ${avgCorr.toFixed(3)}`);
+  if (avgCorr > 0.7) {
+    lines.push("These assets are highly correlated -- limited diversification benefit.");
+  } else if (avgCorr > 0.3) {
+    lines.push("Moderate correlation -- some diversification benefit.");
+  } else if (avgCorr > -0.1) {
+    lines.push("Low correlation -- good diversification potential.");
+  } else {
+    lines.push("Negative correlation -- excellent diversification. These assets tend to move in opposite directions.");
+  }
+  lines.push("");
+
+  // Summary
+  lines.push("## Summary");
+  lines.push("");
+  lines.push(`- **Highest return:** ${byReturn[0].symbol} (${formatPct(byReturn[0].totalReturn)})`);
+  lines.push(`- **Best risk-adjusted:** ${bySharpe[0].symbol} (Sharpe: ${bySharpe[0].sharpe.toFixed(3)})`);
+  lines.push(`- **Lowest volatility:** ${byVol[0].symbol} (${formatPct(byVol[0].volatility)})`);
+  lines.push(`- **Smallest drawdown:** ${byDD[0].symbol} (${formatPct(-byDD[0].mdd)})`);
+
+  return lines.join("\n");
+}

package/src/tools/crypto_analysis.ts

@@ -0,0 +1,221 @@
+/**
+ * crypto_analysis -- Crypto-specific analysis using CoinGecko free API.
+ *
+ * Provides price, 24h volume, market dominance, fear/greed index
+ * approximation, and on-chain metrics where available.
+ */
+
+import {
+  coingeckoMarkets,
+  coingeckoGlobal,
+  symbolToCoinGeckoId,
+} from "../utils/api.js";
+import { formatCurrency, formatVolume, formatPct } from "../utils/math.js";
+import type { CoinGeckoMarketData, CoinGeckoGlobalData } from "../types.js";
+
+export async function handleCryptoAnalysis(symbol: string): Promise<string> {
+  const coinId = symbolToCoinGeckoId(symbol);
+
+  // Fetch coin data and global data in parallel
+  const [markets, globalData] = await Promise.all([
+    coingeckoMarkets([coinId]),
+    coingeckoGlobal(),
+  ]);
+
+  const coin = markets[0];
+  if (!coin) {
+    throw new Error(
+      `No data found for "${symbol}" (CoinGecko ID: "${coinId}"). ` +
+      `Try using the full coin name (e.g., "bitcoin", "ethereum") or a common ticker (BTC, ETH, SOL).`,
+    );
+  }
+
+  // Fear & Greed approximation based on available market data
+  const fearGreed = approximateFearGreed(coin, globalData);
+
+  // Dominance
+  const dominance = globalData.market_cap_percentage?.[coin.symbol.toLowerCase()] ?? null;
+
+  // Format output
+  const lines: string[] = [];
+
+  lines.push(`# Crypto Analysis: ${coin.name} (${coin.symbol.toUpperCase()})`);
+  lines.push("");
+
+  // Price overview
+  lines.push("## Price Overview");
+  lines.push("");
+  lines.push("| Metric | Value |");
+  lines.push("|--------|-------|");
+  lines.push(`| Current Price | $${coin.current_price.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 8 })} |`);
+  lines.push(`| 24h Change | ${coin.price_change_24h >= 0 ? "+" : ""}$${coin.price_change_24h.toFixed(2)} (${coin.price_change_percentage_24h >= 0 ? "+" : ""}${coin.price_change_percentage_24h.toFixed(2)}%) |`);
+  if (coin.price_change_percentage_7d_in_currency != null) {
+    lines.push(`| 7d Change | ${formatPct(coin.price_change_percentage_7d_in_currency / 100)} |`);
+  }
+  if (coin.price_change_percentage_30d_in_currency != null) {
+    lines.push(`| 30d Change | ${formatPct(coin.price_change_percentage_30d_in_currency / 100)} |`);
+  }
+  lines.push(`| 24h High | $${coin.high_24h.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 8 })} |`);
+  lines.push(`| 24h Low | $${coin.low_24h.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 8 })} |`);
+  lines.push("");
+
+  // Market metrics
+  lines.push("## Market Metrics");
+  lines.push("");
+  lines.push("| Metric | Value |");
+  lines.push("|--------|-------|");
+  lines.push(`| Market Cap | ${formatCurrency(coin.market_cap)} |`);
+  lines.push(`| Market Cap Rank | #${coin.market_cap_rank} |`);
+  lines.push(`| 24h Volume | ${formatCurrency(coin.total_volume)} |`);
+  lines.push(`| Volume/Market Cap | ${((coin.total_volume / coin.market_cap) * 100).toFixed(2)}% |`);
+  if (dominance !== null) {
+    lines.push(`| Market Dominance | ${dominance.toFixed(2)}% |`);
+  }
+  lines.push(`| Market Cap Change (24h) | ${coin.market_cap_change_percentage_24h >= 0 ? "+" : ""}${coin.market_cap_change_percentage_24h.toFixed(2)}% |`);
+  lines.push("");
+
+  // Supply info
+  lines.push("## Supply");
+  lines.push("");
+  lines.push("| Metric | Value |");
+  lines.push("|--------|-------|");
+  lines.push(`| Circulating Supply | ${coin.circulating_supply.toLocaleString("en-US")} |`);
+  if (coin.total_supply != null) {
+    lines.push(`| Total Supply | ${coin.total_supply.toLocaleString("en-US")} |`);
+  }
+  if (coin.max_supply != null) {
+    lines.push(`| Max Supply | ${coin.max_supply.toLocaleString("en-US")} |`);
+    const pctMined = (coin.circulating_supply / coin.max_supply * 100).toFixed(1);
+    lines.push(`| % Mined/Released | ${pctMined}% |`);
+  }
+  lines.push("");
+
+  // All-time records
+  lines.push("## All-Time Records");
+  lines.push("");
+  lines.push("| Metric | Value |");
+  lines.push("|--------|-------|");
+  lines.push(`| All-Time High | $${coin.ath.toLocaleString("en-US", { minimumFractionDigits: 2 })} |`);
+  lines.push(`| ATH Change | ${coin.ath_change_percentage.toFixed(2)}% |`);
+  lines.push(`| ATH Date | ${new Date(coin.ath_date).toLocaleDateString("en-US")} |`);
+  lines.push(`| All-Time Low | $${coin.atl.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 8 })} |`);
+  lines.push(`| ATL Change | +${coin.atl_change_percentage.toFixed(2)}% |`);
+  lines.push(`| ATL Date | ${new Date(coin.atl_date).toLocaleDateString("en-US")} |`);
+  lines.push("");
+
+  // Fear & Greed approximation
+  lines.push("## Market Sentiment (Approximation)");
+  lines.push("");
+  lines.push(`**Fear & Greed: ${fearGreed.score}/100 -- ${fearGreed.label}**`);
+  lines.push("");
+  lines.push("Factors considered:");
+  for (const factor of fearGreed.factors) {
+    lines.push(`- ${factor}`);
+  }
+  lines.push("");
+  lines.push("*Note: This is an approximation based on available market data, not the official Crypto Fear & Greed Index.*");
+  lines.push("");
+
+  // Global crypto market context
+  lines.push("## Global Crypto Market");
+  lines.push("");
+  const totalMcap = globalData.total_market_cap?.usd ?? 0;
+  const totalVol = globalData.total_volume?.usd ?? 0;
+  const btcDom = globalData.market_cap_percentage?.btc ?? 0;
+  const ethDom = globalData.market_cap_percentage?.eth ?? 0;
+
+  lines.push("| Metric | Value |");
+  lines.push("|--------|-------|");
+  lines.push(`| Total Crypto Market Cap | ${formatCurrency(totalMcap)} |`);
+  lines.push(`| Total 24h Volume | ${formatCurrency(totalVol)} |`);
+  lines.push(`| BTC Dominance | ${btcDom.toFixed(1)}% |`);
+  lines.push(`| ETH Dominance | ${ethDom.toFixed(1)}% |`);
+  lines.push(`| Active Cryptocurrencies | ${globalData.active_cryptocurrencies?.toLocaleString() ?? "N/A"} |`);
+  lines.push(`| Market Cap Change (24h) | ${globalData.market_cap_change_percentage_24h_usd >= 0 ? "+" : ""}${globalData.market_cap_change_percentage_24h_usd.toFixed(2)}% |`);
+
+  return lines.join("\n");
+}
+
+// ---------------------------------------------------------------------------
+// Fear & Greed approximation
+// ---------------------------------------------------------------------------
+
+interface FearGreedResult {
+  score: number;
+  label: string;
+  factors: string[];
+}
+
+function approximateFearGreed(
+  coin: CoinGeckoMarketData,
+  global: CoinGeckoGlobalData,
+): FearGreedResult {
+  let score = 50; // Start neutral
+  const factors: string[] = [];
+
+  // Price momentum (24h change)
+  const change24h = coin.price_change_percentage_24h;
+  if (change24h > 5) {
+    score += 15;
+    factors.push(`Strong 24h gain (${change24h.toFixed(1)}%) -- greed signal`);
+  } else if (change24h > 2) {
+    score += 8;
+    factors.push(`Positive 24h movement (${change24h.toFixed(1)}%) -- mild greed`);
+  } else if (change24h < -5) {
+    score -= 15;
+    factors.push(`Sharp 24h decline (${change24h.toFixed(1)}%) -- fear signal`);
+  } else if (change24h < -2) {
+    score -= 8;
+    factors.push(`Negative 24h movement (${change24h.toFixed(1)}%) -- mild fear`);
+  } else {
+    factors.push(`Flat 24h movement (${change24h.toFixed(1)}%) -- neutral`);
+  }
+
+  // Volume/market cap ratio (higher = more activity = more extreme sentiment)
+  const volMcapRatio = coin.total_volume / coin.market_cap;
+  if (volMcapRatio > 0.15) {
+    score += Math.min(10, Math.round(volMcapRatio * 30));
+    factors.push(`High trading volume (${(volMcapRatio * 100).toFixed(1)}% of mcap) -- elevated activity`);
+  } else if (volMcapRatio < 0.03) {
+    score -= 5;
+    factors.push(`Low trading volume (${(volMcapRatio * 100).toFixed(1)}% of mcap) -- low interest`);
+  }
+
+  // Distance from ATH
+  const athDist = Math.abs(coin.ath_change_percentage);
+  if (athDist < 10) {
+    score += 10;
+    factors.push(`Near all-time high (${athDist.toFixed(0)}% below) -- extreme greed territory`);
+  } else if (athDist < 25) {
+    score += 5;
+    factors.push(`Within 25% of ATH -- greed territory`);
+  } else if (athDist > 70) {
+    score -= 10;
+    factors.push(`Far from ATH (${athDist.toFixed(0)}% below) -- fear territory`);
+  } else if (athDist > 50) {
+    score -= 5;
+    factors.push(`Significantly below ATH (${athDist.toFixed(0)}% below) -- mild fear`);
+  }
+
+  // Overall market direction
+  const marketChange = global.market_cap_change_percentage_24h_usd;
+  if (marketChange > 3) {
+    score += 8;
+    factors.push(`Crypto market rallying (+${marketChange.toFixed(1)}%) -- broad greed`);
+  } else if (marketChange < -3) {
+    score -= 8;
+    factors.push(`Crypto market declining (${marketChange.toFixed(1)}%) -- broad fear`);
+  }
+
+  // Clamp to 0-100
+  score = Math.max(0, Math.min(100, score));
+
+  let label: string;
+  if (score >= 75) label = "Extreme Greed";
+  else if (score >= 55) label = "Greed";
+  else if (score >= 45) label = "Neutral";
+  else if (score >= 25) label = "Fear";
+  else label = "Extreme Fear";
+
+  return { score, label, factors };
+}