market-data-analyzer 2.1.0 → 2.1.1

package/src/tools/crypto_analysis.ts

@@ -1,221 +0,0 @@
-/**
- * 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.market_cap > 0 ? ((coin.total_volume / coin.market_cap) * 100).toFixed(2) : "N/A"}% |`);
-  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 && coin.max_supply > 0) {
-    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.market_cap > 0 ? coin.total_volume / coin.market_cap : 0;
-  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 };
-}

package/src/tools/market_overview.ts

@@ -1,236 +0,0 @@
-/**
- * market_overview -- Current market snapshot.
- *
- * Fetches live data for major indices, sector ETFs, and VIX
- * from Yahoo Finance to build a comprehensive market summary.
- */
-
-import { yahooQuote } from "../utils/api.js";
-import { formatCurrency, formatVolume } from "../utils/math.js";
-
-/** Index/ETF symbols to track */
-const INDEX_SYMBOLS = [
-  "^GSPC",   // S&P 500
-  "^IXIC",   // NASDAQ Composite
-  "^DJI",    // Dow Jones
-  "^RUT",    // Russell 2000
-  "^VIX",    // VIX
-  "^TNX",    // 10-Year Treasury Yield
-];
-
-/** Sector ETFs (SPDR Select Sector) */
-const SECTOR_ETFS = [
-  { symbol: "XLK", name: "Technology" },
-  { symbol: "XLV", name: "Healthcare" },
-  { symbol: "XLF", name: "Financials" },
-  { symbol: "XLY", name: "Consumer Discretionary" },
-  { symbol: "XLP", name: "Consumer Staples" },
-  { symbol: "XLE", name: "Energy" },
-  { symbol: "XLI", name: "Industrials" },
-  { symbol: "XLU", name: "Utilities" },
-  { symbol: "XLRE", name: "Real Estate" },
-  { symbol: "XLB", name: "Materials" },
-  { symbol: "XLC", name: "Communication Services" },
-];
-
-/** Other reference symbols */
-const OTHER_SYMBOLS = [
-  "BTC-USD",  // Bitcoin
-  "ETH-USD",  // Ethereum
-  "GC=F",     // Gold futures
-  "CL=F",     // Crude oil WTI
-];
-
-export async function handleMarketOverview(): Promise<string> {
-  // Fetch all data in parallel
-  const allSymbols = [
-    ...INDEX_SYMBOLS,
-    ...SECTOR_ETFS.map((s) => s.symbol),
-    ...OTHER_SYMBOLS,
-  ];
-
-  const quotes = await yahooQuote(allSymbols);
-  const quoteMap = new Map(quotes.map((q) => [q.symbol, q]));
-
-  const lines: string[] = [];
-
-  lines.push("# Market Overview");
-  lines.push("");
-  lines.push(`*Live data as of ${new Date().toISOString().slice(0, 16)} UTC*`);
-  lines.push("");
-
-  // Major Indices
-  lines.push("## Major Indices");
-  lines.push("");
-  lines.push("| Index | Value | Change | Change % |");
-  lines.push("|-------|-------|--------|----------|");
-
-  const indexNames: Record<string, string> = {
-    "^GSPC": "S&P 500",
-    "^IXIC": "NASDAQ Composite",
-    "^DJI": "Dow Jones Industrial",
-    "^RUT": "Russell 2000",
-    "^VIX": "CBOE Volatility (VIX)",
-    "^TNX": "10-Year Treasury Yield",
-  };
-
-  for (const sym of INDEX_SYMBOLS) {
-    const q = quoteMap.get(sym);
-    if (!q || q.regularMarketPrice == null) continue;
-    const name = indexNames[sym] ?? q.shortName ?? sym;
-    const price = q.regularMarketPrice;
-    const change = q.regularMarketChange ?? 0;
-    const changePct = q.regularMarketChangePercent ?? 0;
-    const sign = change >= 0 ? "+" : "";
-    const fmtPrice = price > 100
-      ? price.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })
-      : price.toFixed(2);
-    lines.push(`| ${name} | ${fmtPrice} | ${sign}${change.toFixed(2)} | ${sign}${changePct.toFixed(2)}% |`);
-  }
-  lines.push("");
-
-  // VIX interpretation
-  const vix = quoteMap.get("^VIX");
-  if (vix?.regularMarketPrice != null) {
-    const vixVal = vix.regularMarketPrice;
-    lines.push("### VIX Interpretation");
-    lines.push("");
-    if (vixVal < 15) {
-      lines.push(`VIX at ${vixVal.toFixed(2)} -- **Low volatility.** Market complacency; conditions are calm.`);
-    } else if (vixVal < 20) {
-      lines.push(`VIX at ${vixVal.toFixed(2)} -- **Normal.** Typical market conditions.`);
-    } else if (vixVal < 25) {
-      lines.push(`VIX at ${vixVal.toFixed(2)} -- **Elevated.** Increasing uncertainty and hedging activity.`);
-    } else if (vixVal < 30) {
-      lines.push(`VIX at ${vixVal.toFixed(2)} -- **High.** Significant fear in the market.`);
-    } else {
-      lines.push(`VIX at ${vixVal.toFixed(2)} -- **Very high.** Extreme fear; possible market stress event.`);
-    }
-    lines.push("");
-  }
-
-  // Sector Performance
-  lines.push("## Sector Performance");
-  lines.push("");
-  lines.push("| Sector | ETF | Price | Change % |");
-  lines.push("|--------|-----|-------|----------|");
-
-  const sectorData: Array<{ name: string; symbol: string; changePct: number }> = [];
-  for (const etf of SECTOR_ETFS) {
-    const q = quoteMap.get(etf.symbol);
-    if (!q || q.regularMarketPrice == null) continue;
-    const changePct = q.regularMarketChangePercent ?? 0;
-    const sign = changePct >= 0 ? "+" : "";
-    lines.push(`| ${etf.name} | ${etf.symbol} | $${q.regularMarketPrice.toFixed(2)} | ${sign}${changePct.toFixed(2)}% |`);
-    sectorData.push({ name: etf.name, symbol: etf.symbol, changePct });
-  }
-  lines.push("");
-
-  // Sector breadth
-  if (sectorData.length > 0) {
-    const positive = sectorData.filter((s) => s.changePct > 0).length;
-    const negative = sectorData.filter((s) => s.changePct < 0).length;
-    const bestSector = [...sectorData].sort((a, b) => b.changePct - a.changePct)[0]!;
-    const worstSector = [...sectorData].sort((a, b) => a.changePct - b.changePct)[0]!;
-
-    lines.push("### Sector Breadth");
-    lines.push("");
-    lines.push(`- Sectors advancing: ${positive}/${sectorData.length}`);
-    lines.push(`- Sectors declining: ${negative}/${sectorData.length}`);
-    lines.push(`- Best: **${bestSector.name}** (${bestSector.changePct >= 0 ? "+" : ""}${bestSector.changePct.toFixed(2)}%)`);
-    lines.push(`- Worst: **${worstSector.name}** (${worstSector.changePct >= 0 ? "+" : ""}${worstSector.changePct.toFixed(2)}%)`);
-    lines.push("");
-  }
-
-  // Crypto & Commodities
-  lines.push("## Crypto & Commodities");
-  lines.push("");
-  lines.push("| Asset | Price | Change % |");
-  lines.push("|-------|-------|----------|");
-
-  const otherNames: Record<string, string> = {
-    "BTC-USD": "Bitcoin",
-    "ETH-USD": "Ethereum",
-    "GC=F": "Gold",
-    "CL=F": "Crude Oil WTI",
-  };
-
-  for (const sym of OTHER_SYMBOLS) {
-    const q = quoteMap.get(sym);
-    if (!q || q.regularMarketPrice == null) continue;
-    const name = otherNames[sym] ?? q.shortName ?? sym;
-    const changePct = q.regularMarketChangePercent ?? 0;
-    const sign = changePct >= 0 ? "+" : "";
-    lines.push(`| ${name} | $${q.regularMarketPrice.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} | ${sign}${changePct.toFixed(2)}% |`);
-  }
-  lines.push("");
-
-  // Market Breadth / Sentiment estimate
-  lines.push("## Market Sentiment");
-  lines.push("");
-
-  const spx = quoteMap.get("^GSPC");
-  const spxChange = spx?.regularMarketChangePercent ?? 0;
-  const vixVal = vix?.regularMarketPrice ?? 20;
-
-  let sentimentScore = 50;
-
-  // SPX contribution
-  if (spxChange > 1) sentimentScore += 15;
-  else if (spxChange > 0.5) sentimentScore += 10;
-  else if (spxChange > 0) sentimentScore += 5;
-  else if (spxChange < -1) sentimentScore -= 15;
-  else if (spxChange < -0.5) sentimentScore -= 10;
-  else if (spxChange < 0) sentimentScore -= 5;
-
-  // VIX contribution
-  if (vixVal < 15) sentimentScore += 10;
-  else if (vixVal < 20) sentimentScore += 5;
-  else if (vixVal > 30) sentimentScore -= 15;
-  else if (vixVal > 25) sentimentScore -= 10;
-  else if (vixVal > 20) sentimentScore -= 5;
-
-  // Sector breadth
-  if (sectorData.length > 0) {
-    const posRatio = sectorData.filter((s) => s.changePct > 0).length / sectorData.length;
-    if (posRatio > 0.7) sentimentScore += 10;
-    else if (posRatio > 0.5) sentimentScore += 5;
-    else if (posRatio < 0.3) sentimentScore -= 10;
-  }
-
-  sentimentScore = Math.max(0, Math.min(100, sentimentScore));
-  const sentiment = sentimentScore >= 60 ? "BULLISH" : sentimentScore <= 40 ? "BEARISH" : "NEUTRAL";
-
-  lines.push(`**Sentiment: ${sentiment}** (Score: ${sentimentScore}/100)`);
-  lines.push("");
-
-  // Key observations
-  lines.push("## Key Observations");
-  lines.push("");
-
-  if (spx) {
-    const val = spx.regularMarketPrice?.toLocaleString("en-US", { minimumFractionDigits: 2 }) ?? "N/A";
-    lines.push(`- S&P 500 at ${val} (${spxChange >= 0 ? "+" : ""}${spxChange.toFixed(2)}%).`);
-  }
-
-  const btc = quoteMap.get("BTC-USD");
-  if (btc && btc.regularMarketChangePercent != null && Math.abs(btc.regularMarketChangePercent) > 2) {
-    lines.push(`- Crypto ${btc.regularMarketChangePercent > 0 ? "rallying" : "selling off"}: Bitcoin ${btc.regularMarketChangePercent >= 0 ? "+" : ""}${btc.regularMarketChangePercent.toFixed(1)}%.`);
-  }
-
-  const oil = quoteMap.get("CL=F");
-  if (oil && oil.regularMarketChangePercent != null && Math.abs(oil.regularMarketChangePercent) > 1) {
-    lines.push(`- Oil ${oil.regularMarketChangePercent > 0 ? "rising" : "falling"} (${oil.regularMarketChangePercent >= 0 ? "+" : ""}${oil.regularMarketChangePercent.toFixed(1)}%).`);
-  }
-
-  const gold = quoteMap.get("GC=F");
-  if (gold && gold.regularMarketChangePercent != null && gold.regularMarketChangePercent > 0.5) {
-    lines.push(`- Gold up ${gold.regularMarketChangePercent.toFixed(1)}% -- possible flight to safety.`);
-  }
-
-  if (vixVal > 25) {
-    lines.push("- Elevated VIX suggests caution; hedging demand is high.");
-  }
-
-  return lines.join("\n");
-}

package/src/tools/screen_stocks.ts

@@ -1,156 +0,0 @@
-/**
- * screen_stocks -- Screen stocks by criteria using Yahoo Finance data.
- *
- * Fetches live quotes for a universe of popular stocks and filters
- * by market cap, P/E ratio, sector, volume, etc.
- */
-
-import { yahooScreener, POPULAR_SYMBOLS, SYMBOL_SECTORS } from "../utils/api.js";
-import { formatCurrency, formatVolume } from "../utils/math.js";
-import type { YahooQuote } from "../types.js";
-
-export interface ScreenCriteria {
-  min_market_cap?: number;
-  max_market_cap?: number;
-  min_pe?: number;
-  max_pe?: number;
-  sector?: string;
-  min_volume?: number;
-  min_price?: number;
-  max_price?: number;
-  limit?: number;
-}
-
-export async function handleScreenStocks(criteria: ScreenCriteria): Promise<string> {
-  // Fetch quotes for the full symbol universe
-  let quotes = await yahooScreener(POPULAR_SYMBOLS);
-
-  // Apply filters
-  if (criteria.min_market_cap !== undefined) {
-    quotes = quotes.filter((q) => (q.marketCap ?? 0) >= criteria.min_market_cap!);
-  }
-  if (criteria.max_market_cap !== undefined) {
-    quotes = quotes.filter((q) => (q.marketCap ?? Infinity) <= criteria.max_market_cap!);
-  }
-  if (criteria.min_pe !== undefined) {
-    quotes = quotes.filter((q) => q.trailingPE != null && q.trailingPE >= criteria.min_pe!);
-  }
-  if (criteria.max_pe !== undefined) {
-    quotes = quotes.filter((q) => q.trailingPE != null && q.trailingPE <= criteria.max_pe!);
-  }
-  if (criteria.sector !== undefined) {
-    const sectorLower = criteria.sector.toLowerCase();
-    quotes = quotes.filter((q) => {
-      const sector = q.sector ?? SYMBOL_SECTORS[q.symbol]?.sector ?? "";
-      const industry = q.industry ?? SYMBOL_SECTORS[q.symbol]?.industry ?? "";
-      return sector.toLowerCase().includes(sectorLower) ||
-        industry.toLowerCase().includes(sectorLower);
-    });
-  }
-  if (criteria.min_volume !== undefined) {
-    quotes = quotes.filter((q) => (q.regularMarketVolume ?? 0) >= criteria.min_volume!);
-  }
-  if (criteria.min_price !== undefined) {
-    quotes = quotes.filter((q) => (q.regularMarketPrice ?? 0) >= criteria.min_price!);
-  }
-  if (criteria.max_price !== undefined) {
-    quotes = quotes.filter((q) => (q.regularMarketPrice ?? Infinity) <= criteria.max_price!);
-  }
-
-  // Sort by market cap descending
-  quotes.sort((a, b) => (b.marketCap ?? 0) - (a.marketCap ?? 0));
-
-  // Limit results
-  const limit = criteria.limit ?? 25;
-  const total = quotes.length;
-  quotes = quotes.slice(0, limit);
-
-  return formatScreenResults(quotes, criteria, total);
-}
-
-function formatScreenResults(
-  quotes: YahooQuote[],
-  criteria: ScreenCriteria,
-  totalMatches: number,
-): string {
-  const lines: string[] = [];
-
-  lines.push("# Stock Screener Results");
-  lines.push("");
-
-  // Filters applied
-  const filters: string[] = [];
-  if (criteria.min_market_cap) filters.push(`Min Mkt Cap: ${formatCurrency(criteria.min_market_cap)}`);
-  if (criteria.max_market_cap) filters.push(`Max Mkt Cap: ${formatCurrency(criteria.max_market_cap)}`);
-  if (criteria.min_pe) filters.push(`Min P/E: ${criteria.min_pe}`);
-  if (criteria.max_pe) filters.push(`Max P/E: ${criteria.max_pe}`);
-  if (criteria.sector) filters.push(`Sector: ${criteria.sector}`);
-  if (criteria.min_volume) filters.push(`Min Volume: ${formatVolume(criteria.min_volume)}`);
-  if (criteria.min_price) filters.push(`Min Price: $${criteria.min_price}`);
-  if (criteria.max_price) filters.push(`Max Price: $${criteria.max_price}`);
-
-  if (filters.length > 0) {
-    lines.push(`**Filters:** ${filters.join(" | ")}`);
-  } else {
-    lines.push("**Filters:** None (showing full universe)");
-  }
-  lines.push(`**Matches:** ${totalMatches} stocks (showing top ${quotes.length})`);
-  lines.push("");
-
-  if (quotes.length === 0) {
-    lines.push("_No stocks match the specified criteria. Try broadening your filters._");
-    return lines.join("\n");
-  }
-
-  // Results table
-  lines.push("| Symbol | Name | Price | Chg% | Volume | Mkt Cap | P/E | Sector |");
-  lines.push("|--------|------|-------|------|--------|---------|-----|--------|");
-
-  for (const q of quotes) {
-    const price = q.regularMarketPrice?.toFixed(2) ?? "N/A";
-    const changePct = q.regularMarketChangePercent != null
-      ? `${q.regularMarketChangePercent >= 0 ? "+" : ""}${q.regularMarketChangePercent.toFixed(2)}%`
-      : "N/A";
-    const vol = q.regularMarketVolume ? formatVolume(q.regularMarketVolume) : "N/A";
-    const cap = q.marketCap ? formatCurrency(q.marketCap) : "N/A";
-    const pe = q.trailingPE?.toFixed(1) ?? "N/A";
-    const name = (q.shortName ?? q.longName ?? q.symbol).slice(0, 25);
-    const sector = q.sector ?? SYMBOL_SECTORS[q.symbol]?.sector ?? "--";
-
-    lines.push(`| ${q.symbol} | ${name} | $${price} | ${changePct} | ${vol} | ${cap} | ${pe} | ${sector} |`);
-  }
-
-  lines.push("");
-
-  // Quick stats
-  const withPE = quotes.filter((q) => q.trailingPE != null);
-  if (withPE.length > 0) {
-    const avgPE = withPE.reduce((s, q) => s + q.trailingPE!, 0) / withPE.length;
-    const minPE = Math.min(...withPE.map((q) => q.trailingPE!));
-    const maxPE = Math.max(...withPE.map((q) => q.trailingPE!));
-    lines.push("## P/E Statistics");
-    lines.push("");
-    lines.push(`- Average P/E: ${avgPE.toFixed(1)}`);
-    lines.push(`- P/E Range: ${minPE.toFixed(1)} - ${maxPE.toFixed(1)}`);
-    lines.push("");
-  }
-
-  // Top gainers/losers in results
-  const sorted = [...quotes].filter((q) => q.regularMarketChangePercent != null);
-  if (sorted.length >= 3) {
-    sorted.sort((a, b) => (b.regularMarketChangePercent ?? 0) - (a.regularMarketChangePercent ?? 0));
-    const top3 = sorted.slice(0, 3);
-    const bottom3 = sorted.slice(-3).reverse();
-
-    lines.push("## Notable Movers (within results)");
-    lines.push("");
-    lines.push("**Top gainers:** " + top3.map((q) =>
-      `${q.symbol} (${q.regularMarketChangePercent! >= 0 ? "+" : ""}${q.regularMarketChangePercent!.toFixed(2)}%)`
-    ).join(", "));
-    lines.push("**Top losers:** " + bottom3.map((q) =>
-      `${q.symbol} (${q.regularMarketChangePercent!.toFixed(2)}%)`
-    ).join(", "));
-  }
-
-  return lines.join("\n");
-}