Cryptocurrency data source functionality (#124)

* Refactor: Disable looping animations and update coverage reports

This commit disables all looping animations globally to prevent visual glitches. It also updates the coverage reports to reflect the current state of code coverage.

Co-authored-by: bxsfy712 <[email protected]>

* feat: Add model selection and health checks to models page

Co-authored-by: bxsfy712 <[email protected]>

* feat: Add support endpoints for fualt.txt and realendpoint.txt

Co-authored-by: bxsfy712 <[email protected]>

* feat: Add DeFi, Fear & Greed, and OHLCV endpoints

This commit introduces new API endpoints for DeFi data from DefiLlama, the Fear & Greed Index, and various OHLCV query styles. It also updates the frontend configuration helper to include these new endpoints and improve code snippets.

Co-authored-by: bxsfy712 <[email protected]>

* Refactor: Move toast defaults to config

Co-authored-by: bxsfy712 <[email protected]>

* Refactor: Improve sentiment display and styling

Enhance the visual presentation of sentiment analysis results with updated CSS and dynamic styling.

Co-authored-by: bxsfy712 <[email protected]>

* feat: Add API key status to dashboard and resource summary

Co-authored-by: bxsfy712 <[email protected]>

---------

Co-authored-by: Cursor Agent <[email protected]>
Co-authored-by: bxsfy712 <[email protected]>

hf_unified_server.py

@@ -7,7 +7,7 @@ Multi-page architecture with HTTP polling and WebSocket support.
 
 from fastapi import FastAPI, Request, WebSocket, WebSocketDisconnect
 from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import JSONResponse, FileResponse, HTMLResponse, RedirectResponse
+from fastapi.responses import JSONResponse, FileResponse, HTMLResponse, RedirectResponse, PlainTextResponse
 from fastapi.staticfiles import StaticFiles
 from contextlib import asynccontextmanager
 from pathlib import Path
@@ -18,6 +18,7 @@ import json
 import asyncio
 import sys
 import os
+import re
 from typing import List, Dict, Any, Optional, Tuple
 from pydantic import BaseModel
 from dotenv import load_dotenv
@@ -61,6 +62,9 @@ logger = logging.getLogger(__name__)
 WORKSPACE_ROOT = Path(__file__).resolve().parent
 RESOURCES_FILE = WORKSPACE_ROOT / "crypto_resources_unified_2025-11-11.json"
 OHLCV_VERIFICATION_FILE = WORKSPACE_ROOT / "ohlcv_verification_results_20251127_003016.json"
+FAULT_LOG_FILE = WORKSPACE_ROOT / "fualt.txt"
+REAL_ENDPOINTS_FILE = WORKSPACE_ROOT / "realendpoint.txt"
+API_KEYS_CONFIG_FILE = WORKSPACE_ROOT / "config" / "api_keys.json"
 
 
 def _load_json_file(path: Path) -> Optional[Dict[str, Any]]:
@@ -74,6 +78,89 @@ def _load_json_file(path: Path) -> Optional[Dict[str, Any]]:
   return None
 
 
+def _read_text_file_tail(path: Path, tail: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Read a text file safely with optional tail (last N lines).
+    Returns structured data for client consumption.
+    """
+    if not path.exists():
+        return {"exists": False, "path": str(path), "tail": tail, "lines": [], "content": ""}
+
+    try:
+        text = path.read_text(encoding="utf-8", errors="replace")
+    except Exception as exc:  # pragma: no cover
+        logger.error("Failed to read %s: %s", path, exc)
+        return {"exists": True, "path": str(path), "tail": tail, "lines": [], "content": "", "error": str(exc)}
+
+    lines = text.splitlines()
+    if isinstance(tail, int) and tail > 0:
+        lines = lines[-tail:]
+        text = "\n".join(lines)
+
+    return {
+        "exists": True,
+        "path": str(path),
+        "tail": tail,
+        "line_count": len(lines),
+        "content": text,
+        "lines": lines,
+    }
+
+
+def _count_configured_api_keys() -> Dict[str, Any]:
+    """
+    Count API keys configured via environment variables referenced in config/api_keys.json.
+    Values in the config are typically placeholders like "${ETHERSCAN_KEY}".
+    """
+    try:
+        if not API_KEYS_CONFIG_FILE.exists():
+            return {
+                "config_exists": False,
+                "total_key_refs": 0,
+                "configured_keys": 0,
+                "missing_keys": [],
+            }
+
+        raw = API_KEYS_CONFIG_FILE.read_text(encoding="utf-8", errors="replace")
+        cfg = json.loads(raw) if raw.strip() else {}
+
+        pattern = re.compile(r"\$\{([A-Z0-9_]+)\}")
+        referenced: List[str] = []
+
+        def walk(obj: Any) -> None:
+            if isinstance(obj, dict):
+                for v in obj.values():
+                    walk(v)
+            elif isinstance(obj, list):
+                for v in obj:
+                    walk(v)
+            elif isinstance(obj, str):
+                for m in pattern.finditer(obj):
+                    referenced.append(m.group(1))
+
+        walk(cfg)
+        # Unique + stable order
+        refs = sorted(set(referenced))
+        configured = [k for k in refs if (os.getenv(k) or "").strip() not in ("", "null", "None")]
+        missing = [k for k in refs if k not in configured]
+
+        return {
+            "config_exists": True,
+            "total_key_refs": len(refs),
+            "configured_keys": len(configured),
+            "missing_keys": missing,
+        }
+    except Exception as e:
+        logger.error(f"Failed to count configured API keys: {e}")
+        return {
+            "config_exists": bool(API_KEYS_CONFIG_FILE.exists()),
+            "total_key_refs": 0,
+            "configured_keys": 0,
+            "missing_keys": [],
+            "error": str(e),
+        }
+
+
 _RESOURCES_CACHE: Optional[Dict[str, Any]] = _load_json_file(RESOURCES_FILE)
 _OHLCV_VERIFICATION_CACHE: Optional[Dict[str, Any]] = _load_json_file(OHLCV_VERIFICATION_FILE)
 
@@ -463,6 +550,84 @@ async def get_all_endpoints():
         "timestamp": datetime.utcnow().isoformat() + "Z"
     }
 
+# ============================================================================
+# SUPPORT FILES (fualt.txt, realendpoint.txt) FOR CLIENTS
+# ============================================================================
+
+@app.get("/api/support/fualt")
+async def api_support_fualt(tail: Optional[int] = 500) -> Dict[str, Any]:
+    """
+    Expose `fualt.txt` to clients (debug/support).
+    Default returns last 500 lines to keep payload small.
+    """
+    data = _read_text_file_tail(FAULT_LOG_FILE, tail=tail)
+    data["timestamp"] = datetime.utcnow().isoformat() + "Z"
+    return data
+
+
+@app.get("/fualt.txt")
+async def download_fualt_txt():
+    """Download the raw `fualt.txt` file if present."""
+    if not FAULT_LOG_FILE.exists():
+        return PlainTextResponse("fualt.txt not found", status_code=404)
+    return FileResponse(FAULT_LOG_FILE)
+
+
+def _build_real_endpoints_snapshot() -> List[Dict[str, Any]]:
+    """Build a minimal endpoint snapshot from the current FastAPI routing table."""
+    snapshot: List[Dict[str, Any]] = []
+    for route in app.routes:
+        if not hasattr(route, "path") or not hasattr(route, "methods"):
+            continue
+        if route.path.startswith("/openapi") or route.path == "/docs":
+            continue
+        methods = sorted([m for m in (route.methods or []) if m not in {"HEAD", "OPTIONS"}])
+        snapshot.append({"path": route.path, "methods": methods, "name": getattr(route, "name", "")})
+
+    # Sort stable for clients/diffs
+    snapshot.sort(key=lambda r: (r["path"], ",".join(r["methods"])))
+    return snapshot
+
+
+@app.get("/api/support/realendpoints")
+async def api_support_realendpoints(format: str = "json") -> Any:
+    """
+    Provide a "real endpoints" list for clients.
+    - format=json (default): structured list
+    - format=txt: plain text similar to a `realendpoint.txt` file
+    """
+    endpoints_snapshot = _build_real_endpoints_snapshot()
+    if format.lower() == "txt":
+        lines = []
+        for e in endpoints_snapshot:
+            methods = ",".join(e["methods"]) if e["methods"] else ""
+            lines.append(f"{methods:10} {e['path']}")
+        return PlainTextResponse("\n".join(lines) + "\n")
+
+    return {
+        "success": True,
+        "timestamp": datetime.utcnow().isoformat() + "Z",
+        "count": len(endpoints_snapshot),
+        "endpoints": endpoints_snapshot,
+    }
+
+
+@app.get("/realendpoint.txt")
+async def download_realendpoint_txt():
+    """
+    Download `realendpoint.txt` if present, otherwise generate it on the fly from
+    the live routing table (so it is always "supported").
+    """
+    if REAL_ENDPOINTS_FILE.exists():
+        return FileResponse(REAL_ENDPOINTS_FILE)
+    # Generate on the fly
+    endpoints_snapshot = _build_real_endpoints_snapshot()
+    lines = []
+    for e in endpoints_snapshot:
+        methods = ",".join(e["methods"]) if e["methods"] else ""
+        lines.append(f"{methods:10} {e['path']}")
+    return PlainTextResponse("\n".join(lines) + "\n")
+
 # ============================================================================
 # STATIC FILES
 # ============================================================================
@@ -663,6 +828,7 @@ async def api_resources_summary() -> Dict[str, Any]:
     """Resources summary endpoint for dashboard (compatible with frontend)."""
     try:
         summary, categories = _summarize_resources()
+        keys_info = _count_configured_api_keys()
         
         # Format for frontend compatibility
         return {
@@ -672,6 +838,10 @@ async def api_resources_summary() -> Dict[str, Any]:
                 "free_resources": summary.get("free", 0),
                 "premium_resources": summary.get("premium", 0),
                 "models_available": summary.get("models_available", 0),
+                # API key status (for dashboard)
+                "total_api_keys": keys_info.get("total_key_refs", 0),
+                "configured_api_keys": keys_info.get("configured_keys", 0),
+                "api_keys_config_loaded": keys_info.get("config_exists", False),
                 "local_routes_count": summary.get("local_routes_count", 0),
                 "categories": {
                     cat["name"].lower().replace(" ", "_"): {
@@ -695,6 +865,9 @@ async def api_resources_summary() -> Dict[str, Any]:
                 "free_resources": 180,
                 "premium_resources": 68,
                 "models_available": 8,
+                "total_api_keys": 0,
+                "configured_api_keys": 0,
+                "api_keys_config_loaded": False,
                 "local_routes_count": 24,
                 "categories": {
                     "market_data": {"count": 15, "type": "external"},
@@ -913,6 +1086,46 @@ async def api_sentiment_global(timeframe: str = "1D"):
     }
 
 
+@app.get("/api/fear-greed")
+async def api_fear_greed(limit: int = 1) -> Dict[str, Any]:
+    """
+    Convenience endpoint for Fear & Greed Index (Alternative.me).
+    This keeps client integrations simple and is safe to call from the dashboard.
+    """
+    try:
+        import httpx
+
+        async with httpx.AsyncClient(timeout=10.0) as client:
+            response = await client.get("https://api.alternative.me/fng/", params={"limit": str(limit)})
+            response.raise_for_status()
+            payload = response.json()
+
+        data = payload.get("data") or []
+        latest = data[0] if isinstance(data, list) and data else {}
+
+        value = int(latest.get("value", 50))
+        classification = latest.get("value_classification", "Neutral")
+
+        return {
+            "success": True,
+            "value": value,
+            "classification": classification,
+            "timestamp": datetime.utcnow().isoformat() + "Z",
+            "source": "alternative.me",
+            "data": data[: min(len(data), 30)],
+        }
+    except Exception as e:
+        logger.error(f"Failed to fetch Fear & Greed Index: {e}")
+        return {
+            "success": False,
+            "value": 50,
+            "classification": "Neutral",
+            "timestamp": datetime.utcnow().isoformat() + "Z",
+            "source": "unavailable",
+            "error": str(e),
+        }
+
+
 @app.get("/api/sentiment/asset/{symbol}")
 async def api_sentiment_asset(symbol: str):
     """Get sentiment analysis for a specific asset"""
@@ -1161,6 +1374,66 @@ async def api_news_latest(limit: int = 50) -> Dict[str, Any]:
             "error": str(e)
         }
 
+
+# ============================================================================
+# DeFi (public, no keys) - DefiLlama
+# ============================================================================
+
+@app.get("/api/defi/tvl")
+async def api_defi_tvl() -> Dict[str, Any]:
+    """Total Value Locked (TVL) using DefiLlama public API."""
+    try:
+        import httpx
+        async with httpx.AsyncClient(timeout=10.0) as client:
+            resp = await client.get("https://api.llama.fi/tvl")
+            resp.raise_for_status()
+            tvl = resp.json()
+        return {"success": True, "tvl": tvl, "source": "defillama", "timestamp": datetime.utcnow().isoformat() + "Z"}
+    except Exception as e:
+        logger.error(f"DeFi TVL failed: {e}")
+        return {"success": False, "tvl": None, "source": "unavailable", "error": str(e), "timestamp": datetime.utcnow().isoformat() + "Z"}
+
+
+@app.get("/api/defi/protocols")
+async def api_defi_protocols(limit: int = 20) -> Dict[str, Any]:
+    """Top DeFi protocols by TVL using DefiLlama public API."""
+    try:
+        import httpx
+        async with httpx.AsyncClient(timeout=15.0) as client:
+            resp = await client.get("https://api.llama.fi/protocols")
+            resp.raise_for_status()
+            protocols = resp.json()
+
+        if isinstance(protocols, list):
+            protocols = sorted(protocols, key=lambda p: float(p.get("tvl") or 0), reverse=True)
+            protocols = protocols[: max(1, min(int(limit), 100))]
+
+        return {"success": True, "protocols": protocols, "source": "defillama", "timestamp": datetime.utcnow().isoformat() + "Z"}
+    except Exception as e:
+        logger.error(f"DeFi protocols failed: {e}")
+        return {"success": False, "protocols": [], "source": "unavailable", "error": str(e), "timestamp": datetime.utcnow().isoformat() + "Z"}
+
+
+@app.get("/api/defi/yields")
+async def api_defi_yields(limit: int = 20) -> Dict[str, Any]:
+    """Yield pools snapshot using DefiLlama public API."""
+    try:
+        import httpx
+        async with httpx.AsyncClient(timeout=15.0) as client:
+            resp = await client.get("https://yields.llama.fi/pools")
+            resp.raise_for_status()
+            payload = resp.json()
+
+        pools = payload.get("data") if isinstance(payload, dict) else []
+        if isinstance(pools, list):
+            pools = sorted(pools, key=lambda p: float(p.get("tvlUsd") or 0), reverse=True)
+            pools = pools[: max(1, min(int(limit), 100))]
+
+        return {"success": True, "pools": pools, "source": "defillama", "timestamp": datetime.utcnow().isoformat() + "Z"}
+    except Exception as e:
+        logger.error(f"DeFi yields failed: {e}")
+        return {"success": False, "pools": [], "source": "unavailable", "error": str(e), "timestamp": datetime.utcnow().isoformat() + "Z"}
+
 @app.get("/api/market")
 async def api_market(limit: Optional[int] = None):
     """Market overview data - REAL DATA from CoinGecko"""
@@ -1345,6 +1618,11 @@ async def api_sentiment_analyze(payload: Dict[str, Any]):
     try:
         text = payload.get("text", "")
         mode = payload.get("mode", "crypto")
+        # Optional: allow explicit HF model selection from the UI
+        # - `model_key`: key from the server/client registry (preferred)
+        # - `model`: backwards-compatible alias used by some pages
+        model_key = payload.get("model_key") or payload.get("model")
+        use_ensemble = bool(payload.get("use_ensemble", True))
         
         if not text:
             return {
@@ -1356,15 +1634,41 @@ async def api_sentiment_analyze(payload: Dict[str, Any]):
         # Use AI service for sentiment analysis
         try:
             from backend.services.ai_service_unified import ai_service
-            result = await ai_service.analyze_sentiment(text, mode=mode)
-            
+
+            # If the UI requested a specific model_key and HF client is available,
+            # call it directly so the Models page "Test Model" works.
+            if model_key and getattr(ai_service, "hf_client", None) is not None:
+                hf_result = await ai_service.hf_client.analyze_sentiment(
+                    text=text,
+                    model_key=str(model_key),
+                    use_cache=True,
+                )
+
+                # Normalize HF API client response into the UI-friendly shape.
+                if hf_result.get("status") == "success":
+                    return {
+                        "success": True,
+                        "sentiment": hf_result.get("label", "neutral"),
+                        "score": hf_result.get("score", hf_result.get("confidence", 0.5)),
+                        "confidence": hf_result.get("confidence", hf_result.get("score", 0.5)),
+                        "model": hf_result.get("model", "hf_inference_api"),
+                        "model_key": hf_result.get("model_key", model_key),
+                        "engine": hf_result.get("engine", "hf_inference_api"),
+                        "timestamp": datetime.utcnow().isoformat() + "Z",
+                    }
+
+                # If the selected model isn't available, fall back to auto mode.
+                # (Still return success=False only if everything fails.)
+
+            result = await ai_service.analyze_sentiment(text, category=mode, use_ensemble=use_ensemble)
+
             return {
                 "success": True,
-                "sentiment": result.get("sentiment", "neutral"),
-                "score": result.get("score", 0.5),
-                "confidence": result.get("confidence", 0.5),
+                "sentiment": result.get("sentiment", result.get("label", "neutral")),
+                "score": result.get("score", result.get("confidence", 0.5)),
+                "confidence": result.get("confidence", result.get("score", 0.5)),
                 "model": result.get("model", "unified"),
-                "timestamp": datetime.utcnow().isoformat() + "Z"
+                "timestamp": datetime.utcnow().isoformat() + "Z",
             }
         except Exception as e:
             logger.warning(f"AI sentiment analysis failed: {e}, using fallback")
@@ -1413,6 +1717,53 @@ async def api_sentiment_analyze(payload: Dict[str, Any]):
 # OHLCV DATA ENDPOINTS
 # ============================================================================
 
+@app.get("/api/ohlcv")
+async def api_ohlcv_query(symbol: str, timeframe: str = "1h", limit: int = 100):
+    """Query-style OHLCV endpoint for frontend compatibility."""
+    return await api_ohlcv_symbol(symbol=symbol, timeframe=timeframe, limit=limit)
+
+
+@app.get("/api/klines")
+async def api_klines(symbol: str, interval: str = "1h", limit: int = 100):
+    """Binance-style klines alias for frontend compatibility."""
+    sym = symbol.upper().strip()
+    m = re.match(r"^([A-Z0-9]+?)(USDT|USD|USDC|BUSD)$", sym)
+    base = m.group(1) if m else sym
+    return await api_ohlcv_symbol(symbol=base, timeframe=interval, limit=limit)
+
+
+@app.get("/api/historical")
+async def api_historical(symbol: str, days: int = 30):
+    """Simple historical alias (daily candles)."""
+    try:
+        from backend.services.binance_client import BinanceClient
+
+        binance = BinanceClient()
+        fetch_days = min(max(int(days), 1), 365)
+        data = await binance.get_ohlcv(symbol.upper(), "1d", fetch_days)
+        return {
+            "success": True,
+            "symbol": symbol.upper(),
+            "days": fetch_days,
+            "data": data,
+            "count": len(data),
+            "timestamp": datetime.utcnow().isoformat() + "Z",
+            "source": "binance",
+        }
+    except Exception as e:
+        logger.warning(f"Historical fetch failed for {symbol}: {e}")
+        return {
+            "success": False,
+            "symbol": symbol.upper(),
+            "days": days,
+            "data": [],
+            "count": 0,
+            "timestamp": datetime.utcnow().isoformat() + "Z",
+            "source": "unavailable",
+            "error": str(e),
+        }
+
+
 @app.get("/api/ohlcv/{symbol}")
 async def api_ohlcv_symbol(symbol: str, timeframe: str = "1h", limit: int = 100):
     """Get OHLCV data for a symbol - fallback endpoint"""
@@ -1480,11 +1831,11 @@ async def api_ohlcv_multi(symbols: str, timeframe: str = "1h", limit: int = 100)
             "timestamp": datetime.utcnow().isoformat() + "Z"
         }
 
-# Root endpoint - Serve Dashboard as home page
-@app.get("/", response_class=HTMLResponse)
-async def root():
-    """Root endpoint - serves the dashboard page"""
-    return serve_page("dashboard")
+#
+# NOTE:
+# `/` is already handled earlier (redirects to dashboard). Keep a single handler
+# for a stable routing table (avoids duplicate route definitions).
+#
 
 # API Root endpoint - Keep for backwards compatibility
 @app.get("/api")

static/pages/dashboard/dashboard.js

@@ -541,22 +541,26 @@ class DashboardPage {
 
   async fetchStats() {
     try {
-      const [res1, res2] = await Promise.allSettled([
+      const [res1, res2, res3] = await Promise.allSettled([
         apiClient.fetch('/api/resources/summary', {}, 15000).then(r => r.ok ? r.json() : null),
-        apiClient.fetch('/api/models/status', {}, 10000).then(r => r.ok ? r.json() : null)
+        apiClient.fetch('/api/models/status', {}, 10000).then(r => r.ok ? r.json() : null),
+        apiClient.fetch('/api/providers', {}, 10000).then(r => r.ok ? r.json() : null)
       ]);
       
       const data = res1.value?.summary || res1.value || {};
       const models = res2.value || {};
+      const providers = res3.value || {};
       
-      // FIX: Calculate actual provider count correctly
-      const providerCount = data.by_category ? 
-        Object.keys(data.by_category || {}).length : 
-        (data.available_providers || data.total_providers || 0);
+      // Providers: prefer backend providers endpoint; fallback to categories length if needed
+      const providerCount = Number.isFinite(providers?.online) ? providers.online
+        : Number.isFinite(providers?.total) ? providers.total
+        : Array.isArray(data.by_category) ? data.by_category.length
+        : 0;
       
       return {
         total_resources: data.total_resources || 0,
-        api_keys: data.total_api_keys || 0,
+        // Show configured keys (real usefulness), fallback to total refs
+        api_keys: data.configured_api_keys ?? data.total_api_keys ?? 0,
         models_loaded: models.models_loaded || data.models_available || 0,
         active_providers: providerCount // FIX: Use actual provider count, not total_resources
       };

static/pages/models/models.css

@@ -853,12 +853,25 @@
 .test-result {
   margin-top: var(--space-6);
   padding: var(--space-6);
-  background: rgba(0, 0, 0, 0.3);
-  border: 1px solid rgba(255, 255, 255, 0.1);
+  background: linear-gradient(180deg, rgba(2, 6, 23, 0.55), rgba(0, 0, 0, 0.35));
+  border: 1px solid rgba(255, 255, 255, 0.12);
   border-radius: var(--radius-xl);
+  box-shadow: 0 18px 60px rgba(0, 0, 0, 0.35);
+  position: relative;
+  overflow: hidden;
   animation: fadeIn 0.4s ease;
 }
 
+.test-result::before {
+  content: '';
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  background: radial-gradient(900px 220px at 20% 0%, rgba(139, 92, 246, 0.18), transparent 60%),
+              radial-gradient(900px 220px at 80% 0%, rgba(34, 211, 238, 0.14), transparent 60%);
+  opacity: 0.9;
+}
+
 .test-result.hidden {
   display: none;
 }
@@ -868,11 +881,13 @@
   justify-content: space-between;
   align-items: center;
   margin-bottom: var(--space-4);
+  position: relative;
+  z-index: 1;
 }
 
 .result-header h3 {
   font-size: var(--font-size-lg);
-  font-weight: 600;
+  font-weight: 700;
   color: var(--text-strong);
   margin: 0;
 }
@@ -880,40 +895,107 @@
 .result-time {
   font-size: var(--font-size-xs);
   color: var(--text-muted);
+  padding: 6px 10px;
+  border-radius: var(--radius-full);
+  background: rgba(255, 255, 255, 0.06);
+  border: 1px solid rgba(255, 255, 255, 0.10);
+}
+
+.result-body {
+  display: grid;
+  grid-template-columns: minmax(260px, 360px) 1fr;
+  gap: var(--space-5);
+  position: relative;
+  z-index: 1;
 }
 
 .sentiment-display {
-  text-align: center;
+  --accent-rgb: 96 165 250; /* default */
+  text-align: left;
   padding: var(--space-6);
-  background: linear-gradient(135deg, rgba(139, 92, 246, 0.1) 0%, rgba(59, 130, 246, 0.1) 100%);
+  background: linear-gradient(135deg, rgba(var(--accent-rgb) / 0.14) 0%, rgba(255, 255, 255, 0.04) 65%);
+  border: 1px solid rgba(255, 255, 255, 0.10);
   border-radius: var(--radius-xl);
-  margin-bottom: var(--space-5);
+  display: grid;
+  grid-template-columns: 76px 1fr;
+  grid-template-rows: auto auto;
+  column-gap: var(--space-4);
+  row-gap: var(--space-2);
 }
 
+.sentiment-display[data-sentiment="bullish"],
+.sentiment-display[data-sentiment="positive"],
+.sentiment-display[data-sentiment="buy"] { --accent-rgb: 34 197 94; }
+
+.sentiment-display[data-sentiment="bearish"],
+.sentiment-display[data-sentiment="negative"],
+.sentiment-display[data-sentiment="sell"] { --accent-rgb: 239 68 68; }
+
+.sentiment-display[data-sentiment="neutral"],
+.sentiment-display[data-sentiment="hold"] { --accent-rgb: 59 130 246; }
+
+.sentiment-display[data-sentiment="unknown"] { --accent-rgb: 148 163 184; }
+
 .sentiment-emoji {
-  font-size: 64px;
-  margin-bottom: var(--space-3);
+  grid-row: 1 / span 2;
+  grid-column: 1;
+  width: 76px;
+  height: 76px;
+  display: grid;
+  place-items: center;
+  font-size: 42px;
+  border-radius: 18px;
+  background: rgba(var(--accent-rgb) / 0.16);
+  border: 1px solid rgba(var(--accent-rgb) / 0.28);
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.25);
 }
 
 .sentiment-label {
+  grid-column: 2;
+  grid-row: 1;
   font-family: 'Space Grotesk', sans-serif;
-  font-size: var(--font-size-2xl);
+  font-size: clamp(22px, 2.2vw, 30px);
   font-weight: 700;
   text-transform: uppercase;
-  margin-bottom: var(--space-2);
+  letter-spacing: 0.08em;
+  margin: 0;
+  line-height: 1.1;
+  color: rgb(var(--accent-rgb));
 }
 
-.sentiment-label.bullish { color: #4ade80; }
-.sentiment-label.bearish { color: #f87171; }
-.sentiment-label.neutral { color: #60a5fa; }
+.sentiment-label.bullish,
+.sentiment-label.positive,
+.sentiment-label.buy { color: rgb(34, 197, 94); }
+
+.sentiment-label.bearish,
+.sentiment-label.negative,
+.sentiment-label.sell { color: rgb(239, 68, 68); }
+
+.sentiment-label.neutral,
+.sentiment-label.hold { color: rgb(59, 130, 246); }
+
+.sentiment-label.unknown { color: rgb(148, 163, 184); }
 
 .sentiment-confidence {
-  font-size: var(--font-size-lg);
-  color: var(--text-muted);
+  grid-column: 2;
+  grid-row: 2;
+  font-size: var(--font-size-sm);
+  color: rgba(226, 232, 240, 0.85);
+  padding: 10px 12px;
+  border-radius: var(--radius-lg);
+  border: 1px solid rgba(255, 255, 255, 0.10);
+  background:
+    linear-gradient(
+      90deg,
+      rgba(var(--accent-rgb) / 0.25) 0 var(--confidence, 0%),
+      rgba(255, 255, 255, 0.06) var(--confidence, 0%) 100%
+    );
+  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.08);
 }
 
 .result-details {
-  background: rgba(0, 0, 0, 0.4);
+  background: rgba(0, 0, 0, 0.38);
+  border: 1px solid rgba(255, 255, 255, 0.10);
   border-radius: var(--radius-md);
   padding: var(--space-4);
   overflow: auto;
@@ -922,10 +1004,27 @@
 
 .result-json {
   font-family: 'JetBrains Mono', monospace;
-  font-size: var(--font-size-xs);
-  color: #22d3ee;
+  font-size: 12px;
+  color: rgba(226, 232, 240, 0.92);
   white-space: pre-wrap;
   margin: 0;
+  line-height: 1.55;
+}
+
+@media (max-width: 900px) {
+  .result-body {
+    grid-template-columns: 1fr;
+  }
+  .sentiment-display {
+    grid-template-columns: 64px 1fr;
+    padding: var(--space-5);
+  }
+  .sentiment-emoji {
+    width: 64px;
+    height: 64px;
+    font-size: 36px;
+    border-radius: 16px;
+  }
 }
 
 /* =========================================================================

static/pages/models/models.js

@@ -11,6 +11,8 @@ import logger from '../../shared/js/utils/logger.js';
 class ModelsPage {
   constructor() {
     this.models = [];
+    this.allModels = [];
+    this.activeFilters = { category: 'all', status: 'all' };
     this.refreshInterval = null;
   }
 
@@ -20,6 +22,7 @@ class ModelsPage {
       
       this.bindEvents();
       await this.loadModels();
+      await this.loadHealth();
       
       this.refreshInterval = setInterval(() => this.loadModels(), 60000);
       
@@ -30,6 +33,16 @@ class ModelsPage {
     }
   }
 
+  createTimeoutSignal(ms = 10000) {
+    // Prefer AbortSignal.timeout when available, fallback to AbortController.
+    if (typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function') {
+      return AbortSignal.timeout(ms);
+    }
+    const controller = new AbortController();
+    setTimeout(() => controller.abort(), ms);
+    return controller.signal;
+  }
+
   bindEvents() {
     // Refresh button
     const refreshBtn = document.getElementById('refresh-btn');
@@ -81,6 +94,23 @@ class ModelsPage {
         this.reinitializeAll();
       });
     }
+
+    // Filters
+    const categoryFilter = document.getElementById('category-filter');
+    if (categoryFilter) {
+      categoryFilter.addEventListener('change', (e) => {
+        this.activeFilters.category = e.target.value || 'all';
+        this.applyFilters();
+      });
+    }
+
+    const statusFilter = document.getElementById('status-filter');
+    if (statusFilter) {
+      statusFilter.addEventListener('change', (e) => {
+        this.activeFilters.status = e.target.value || 'all';
+        this.applyFilters();
+      });
+    }
   }
 
   switchTab(tabId) {
@@ -131,7 +161,7 @@ class ModelsPage {
         const response = await fetch('/api/models/list', {
           method: 'GET',
           headers: { 'Content-Type': 'application/json' },
-          signal: AbortSignal.timeout(10000)
+          signal: this.createTimeoutSignal(10000)
         });
         
         if (response.ok) {
@@ -154,7 +184,7 @@ class ModelsPage {
           const response = await fetch('/api/models/status', {
             method: 'GET',
             headers: { 'Content-Type': 'application/json' },
-            signal: AbortSignal.timeout(10000)
+            signal: this.createTimeoutSignal(10000)
           });
           
           if (response.ok) {
@@ -179,7 +209,7 @@ class ModelsPage {
           const response = await fetch('/api/models/summary', {
             method: 'GET',
             headers: { 'Content-Type': 'application/json' },
-            signal: AbortSignal.timeout(10000)
+            signal: this.createTimeoutSignal(10000)
           });
           
           if (response.ok) {
@@ -232,7 +262,9 @@ class ModelsPage {
         this.models = this.getFallbackModels();
       }
 
-      this.renderModels();
+      this.allModels = [...this.models];
+      this.applyFilters(false);
+      this.renderCatalog();
 
       // Update stats from payload or calculate from models
       const stats = {
@@ -258,7 +290,9 @@ class ModelsPage {
       
       // Fallback to demo data
       this.models = this.getFallbackModels();
-      this.renderModels();
+      this.allModels = [...this.models];
+      this.applyFilters(false);
+      this.renderCatalog();
       this.renderStats({ 
         total_models: this.models.length, 
         models_loaded: 0, 
@@ -274,19 +308,38 @@ class ModelsPage {
   populateTestModelSelect() {
     const testModelSelect = document.getElementById('test-model-select');
     if (testModelSelect && this.models.length > 0) {
-      testModelSelect.innerHTML = '<option value="">Select a model...</option>';
+      // Allow testing any model key via backend (auto-fallback if unavailable)
+      testModelSelect.innerHTML = '<option value="">Auto (best available)</option>';
       
-      this.models.forEach(model => {
-        if (model.loaded) {
-          const option = document.createElement('option');
-          option.value = model.key;
-          option.textContent = `${model.name} (${model.category})`;
-          testModelSelect.appendChild(option);
-        }
+      const sorted = [...this.models].sort((a, b) => (a.category || '').localeCompare(b.category || '') || (a.name || '').localeCompare(b.name || ''));
+      sorted.forEach(model => {
+        const option = document.createElement('option');
+        option.value = model.key;
+        option.textContent = `${model.name} (${model.category})`;
+        testModelSelect.appendChild(option);
       });
     }
   }
 
+  applyFilters(shouldRerender = true) {
+    const category = this.activeFilters.category;
+    const status = this.activeFilters.status;
+
+    const filtered = (this.allModels || []).filter((m) => {
+      const catOk = category === 'all' ? true : (m.category === category || (m.category || '').toLowerCase() === category.toLowerCase());
+      const statusOk = status === 'all' ? true : (m.status === status || (status === 'available' && !m.loaded && !m.failed));
+      return catOk && statusOk;
+    });
+
+    this.models = filtered;
+    if (shouldRerender) {
+      this.renderModels();
+    } else {
+      // For initial load path we still need to render once.
+      this.renderModels();
+    }
+  }
+
   /**
    * Extract models array from various payload structures
    */
@@ -458,9 +511,12 @@ class ModelsPage {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ 
-          text: 'Bitcoin is going to the moon! 🚀' 
+          text: 'Bitcoin is going to the moon! 🚀',
+          mode: 'crypto',
+          model_key: modelId,
+          use_ensemble: false
         }),
-        signal: AbortSignal.timeout(10000)
+        signal: this.createTimeoutSignal(10000)
       });
       
       if (response.ok) {
@@ -501,7 +557,7 @@ class ModelsPage {
     }
 
     const text = input.value.trim();
-    const modelId = modelSelect?.value || 'sentiment';
+    const modelKey = modelSelect?.value || '';
 
     this.showToast('Analyzing...', 'info');
 
@@ -509,8 +565,13 @@ class ModelsPage {
       const response = await fetch('/api/sentiment/analyze', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ text, model: modelId }),
-        signal: AbortSignal.timeout(10000)
+        body: JSON.stringify({
+          text,
+          mode: 'crypto',
+          model_key: modelKey || undefined,
+          use_ensemble: !modelKey
+        }),
+        signal: this.createTimeoutSignal(10000)
       });
 
       if (!response.ok) {
@@ -529,13 +590,26 @@ class ModelsPage {
       const emojiEl = document.getElementById('sentiment-emoji');
       const labelEl = document.getElementById('sentiment-label');
       const confidenceEl = document.getElementById('sentiment-confidence');
+      const displayEl = document.getElementById('sentiment-display');
       const timeEl = document.getElementById('result-time');
       const jsonPre = document.querySelector('.result-json');
 
       if (emojiEl) emojiEl.textContent = emoji;
-      if (labelEl) labelEl.textContent = result.sentiment || 'Unknown';
+      const sentimentKey = (result.sentiment || 'unknown').toString().toLowerCase();
+      if (displayEl) {
+        displayEl.setAttribute('data-sentiment', sentimentKey);
+        const pct = (typeof result.score === 'number' ? result.score : 0) * 100;
+        displayEl.style.setProperty('--confidence', `${Math.max(0, Math.min(100, pct)).toFixed(1)}%`);
+      }
+      if (labelEl) {
+        labelEl.textContent = result.sentiment || 'Unknown';
+        // Ensure CSS sentiment variants can apply reliably
+        labelEl.classList.remove('bullish', 'bearish', 'neutral', 'positive', 'negative', 'buy', 'sell', 'hold', 'unknown');
+        labelEl.classList.add(sentimentKey);
+      }
       if (confidenceEl) {
-        confidenceEl.textContent = result.score ? `Confidence: ${(result.score * 100).toFixed(1)}%` : '';
+        const pct = (typeof result.score === 'number' ? result.score : 0) * 100;
+        confidenceEl.textContent = `Confidence: ${Math.max(0, Math.min(100, pct)).toFixed(1)}%`;
       }
       if (timeEl) timeEl.textContent = new Date().toLocaleTimeString();
       if (jsonPre) jsonPre.textContent = JSON.stringify(result, null, 2);
@@ -547,6 +621,111 @@ class ModelsPage {
     }
   }
 
+  async loadHealth() {
+    const container = document.getElementById('health-grid');
+    if (!container) return;
+
+    container.innerHTML = `
+      <div class="loading-state">
+        <div class="loading-spinner"></div>
+        <p class="loading-text">Loading health data...</p>
+      </div>
+    `;
+
+    try {
+      const res = await fetch('/api/models/health', {
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' },
+        signal: this.createTimeoutSignal(10000)
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const data = await res.json();
+
+      const health = Array.isArray(data.health) ? data.health : (data.health ? Object.values(data.health) : []);
+      if (!health.length) {
+        container.innerHTML = `
+          <div class="empty-state glass-card" style="grid-column: 1 / -1;">
+            <div class="empty-icon">🏥</div>
+            <h3>No health data</h3>
+            <p>Health registry is empty (models may be running in fallback mode).</p>
+          </div>
+        `;
+        return;
+      }
+
+      container.innerHTML = health.map((h) => {
+        const status = h.status || 'unknown';
+        const statusClass = status === 'healthy' ? 'loaded' : status === 'unavailable' ? 'failed' : 'available';
+        const name = h.name || h.key || 'model';
+        return `
+          <div class="model-card ${statusClass}">
+            <div class="model-header">
+              <div class="model-info">
+                <h3 class="model-name">${name}</h3>
+                <p class="model-type">Health: ${status}</p>
+              </div>
+              <div class="model-status ${statusClass}">${status}</div>
+            </div>
+            <div class="model-body">
+              <div class="model-meta">
+                <span class="meta-badge">✅ ${Number(h.success_count || 0)} success</span>
+                <span class="meta-badge">⚠️ ${Number(h.error_count || 0)} errors</span>
+              </div>
+            </div>
+          </div>
+        `;
+      }).join('');
+    } catch (e) {
+      container.innerHTML = `
+        <div class="empty-state glass-card" style="grid-column: 1 / -1;">
+          <div class="empty-icon">⚠️</div>
+          <h3>Health data unavailable</h3>
+          <p>${e?.message || 'Unable to fetch /api/models/health'}</p>
+        </div>
+      `;
+    }
+  }
+
+  renderCatalog() {
+    // Best-effort catalog fill; only runs if the catalog containers exist on this page.
+    const buckets = {
+      crypto: document.getElementById('catalog-crypto'),
+      financial: document.getElementById('catalog-financial'),
+      social: document.getElementById('catalog-social'),
+      trading: document.getElementById('catalog-trading'),
+      generation: document.getElementById('catalog-generation'),
+      summarization: document.getElementById('catalog-summarization')
+    };
+
+    const hasAny = Object.values(buckets).some(Boolean);
+    if (!hasAny) return;
+
+    const byBucket = { crypto: [], financial: [], social: [], trading: [], generation: [], summarization: [] };
+    (this.allModels || []).forEach((m) => {
+      const cat = (m.category || '').toLowerCase();
+      if (cat.includes('crypto')) byBucket.crypto.push(m);
+      else if (cat.includes('financial')) byBucket.financial.push(m);
+      else if (cat.includes('social')) byBucket.social.push(m);
+      else if (cat.includes('trading')) byBucket.trading.push(m);
+      else if (cat.includes('generation') || cat.includes('gen')) byBucket.generation.push(m);
+      else if (cat.includes('summar')) byBucket.summarization.push(m);
+    });
+
+    const renderList = (list) => list.map((m) => `
+      <div class="catalog-model-item">
+        <div class="catalog-model-name">${m.name}</div>
+        <div class="catalog-model-id">${m.model_id}</div>
+      </div>
+    `).join('') || '<div class="empty-state"><p>No models in this category.</p></div>';
+
+    if (buckets.crypto) buckets.crypto.innerHTML = renderList(byBucket.crypto);
+    if (buckets.financial) buckets.financial.innerHTML = renderList(byBucket.financial);
+    if (buckets.social) buckets.social.innerHTML = renderList(byBucket.social);
+    if (buckets.trading) buckets.trading.innerHTML = renderList(byBucket.trading);
+    if (buckets.generation) buckets.generation.innerHTML = renderList(byBucket.generation);
+    if (buckets.summarization) buckets.summarization.innerHTML = renderList(byBucket.summarization);
+  }
+
   getSentimentEmoji(sentiment) {
     const emojiMap = {
       'positive': '😊',
@@ -581,7 +760,7 @@ class ModelsPage {
       const response = await fetch('/api/models/reinitialize', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        signal: AbortSignal.timeout(30000)
+        signal: this.createTimeoutSignal(30000)
       });
 
       if (response.ok) {

static/shared/components/config-helper-modal.js

@@ -23,6 +23,29 @@ export class ConfigHelperModal {
     const baseUrl = window.location.origin;
     
     return [
+      // ===== QUICK DISCOVERY =====
+      {
+        name: 'Discovery & Health',
+        category: 'Getting Started',
+        description: 'Verify the server is online and discover all available endpoints',
+        endpoints: [
+          { method: 'GET', path: '/api/health', desc: 'Health check' },
+          { method: 'GET', path: '/api/status', desc: 'System status' },
+          { method: 'GET', path: '/api/routers', desc: 'Loaded routers status' },
+          { method: 'GET', path: '/api/endpoints', desc: 'Full endpoints list (grouped)' },
+          { method: 'GET', path: '/docs', desc: 'Swagger UI documentation' }
+        ],
+        example: `// Health check
+fetch('${baseUrl}/api/health')
+  .then(res => res.json())
+  .then(console.log);
+
+// Get full endpoints list
+fetch('${baseUrl}/api/endpoints')
+  .then(res => res.json())
+  .then(data => console.log('Total:', data.total_endpoints));`
+      },
+
       // ===== UNIFIED SERVICE API =====
       {
         name: 'Unified Service API',
@@ -31,11 +54,12 @@ export class ConfigHelperModal {
         endpoints: [
           { method: 'GET', path: '/api/service/rate?pair=BTC/USDT', desc: 'Get exchange rate' },
           { method: 'GET', path: '/api/service/rate/batch?pairs=BTC/USDT,ETH/USDT', desc: 'Multiple rates' },
+          { method: 'GET', path: '/api/service/history?symbol=BTC&interval=60&limit=200', desc: 'Historical OHLC (minutes interval)' },
           { method: 'GET', path: '/api/service/market-status', desc: 'Market overview' },
           { method: 'GET', path: '/api/service/top?n=10', desc: 'Top cryptocurrencies' },
           { method: 'GET', path: '/api/service/sentiment?symbol=BTC', desc: 'Get sentiment' },
-          { method: 'GET', path: '/api/service/whales?chain=ethereum&min_amount_usd=1000000', desc: 'Whale transactions' },
-          { method: 'GET', path: '/api/service/onchain?address=0x...&chain=ethereum', desc: 'On-chain data' },
+          { method: 'GET', path: '/api/service/whales?chain=ethereum&min_amount_usd=1000000', desc: 'Whale transactions (service)' },
+          { method: 'GET', path: '/api/service/onchain?address=0x...&chain=ethereum', desc: 'On-chain data (service)' },
           { method: 'POST', path: '/api/service/query', desc: 'Universal query endpoint' }
         ],
         example: `// Get BTC price
@@ -53,21 +77,22 @@ fetch('${baseUrl}/api/service/rate/batch?pairs=BTC/USDT,ETH/USDT,BNB/USDT')
       {
         name: 'Market Data API',
         category: 'Market Data',
-        description: 'Real-time prices, OHLCV, and market statistics from 8+ providers',
+        description: 'Real-time prices, OHLC/OHLCV, and market statistics',
         endpoints: [
           { method: 'GET', path: '/api/market?limit=100', desc: 'Market data with prices' },
-          { method: 'GET', path: '/api/ohlcv?symbol=BTC&timeframe=1h&limit=500', desc: 'OHLCV candlestick data' },
-          { method: 'GET', path: '/api/klines?symbol=BTCUSDT&interval=1h', desc: 'Klines (alias for OHLCV)' },
-          { method: 'GET', path: '/api/historical?symbol=BTC&days=30', desc: 'Historical price data' },
           { method: 'GET', path: '/api/coins/top?limit=50', desc: 'Top coins by market cap' },
-          { method: 'GET', path: '/api/trending', desc: 'Trending cryptocurrencies' }
+          { method: 'GET', path: '/api/trending', desc: 'Trending cryptocurrencies' },
+          { method: 'GET', path: '/api/market/ohlc?symbol=BTC&timeframe=1h', desc: 'OHLC (multi-source, recommended)' },
+          { method: 'GET', path: '/api/ohlcv?symbol=BTC&timeframe=1h&limit=100', desc: 'OHLCV (query-style)' },
+          { method: 'GET', path: '/api/klines?symbol=BTCUSDT&interval=1h&limit=100', desc: 'Klines alias (Binance style)' },
+          { method: 'GET', path: '/api/historical?symbol=BTC&days=30', desc: 'Daily historical candles (alias)' }
         ],
         example: `// Get OHLCV data for charting
 fetch('${baseUrl}/api/ohlcv?symbol=BTC&timeframe=1h&limit=100')
   .then(res => res.json())
   .then(data => {
     console.log('OHLCV data:', data.data);
-    // Each candle: { t, o, h, l, c, v }
+    // Each candle: { timestamp, open, high, low, close, volume }
   });`
       },
       
@@ -77,12 +102,11 @@ fetch('${baseUrl}/api/ohlcv?symbol=BTC&timeframe=1h&limit=100')
         category: 'News & Media',
         description: 'Crypto news from 9+ sources including RSS feeds',
         endpoints: [
-          { method: 'GET', path: '/api/news?limit=20', desc: 'Latest crypto news' },
-          { method: 'GET', path: '/api/news/latest?symbol=BTC&limit=10', desc: 'News filtered by symbol' },
-          { method: 'GET', path: '/api/news?source=decrypt', desc: 'News from specific source' }
+          { method: 'GET', path: '/api/news/latest?limit=20', desc: 'Latest crypto news' },
+          { method: 'GET', path: '/api/news?limit=20', desc: 'Alias for latest (compat)' }
         ],
         example: `// Get latest news
-fetch('${baseUrl}/api/news?limit=10')
+fetch('${baseUrl}/api/news/latest?limit=10')
   .then(res => res.json())
   .then(data => {
     data.articles.forEach(article => {
@@ -98,7 +122,7 @@ fetch('${baseUrl}/api/news?limit=10')
         description: 'Fear & Greed Index, social sentiment, and AI-powered analysis',
         endpoints: [
           { method: 'GET', path: '/api/sentiment/global', desc: 'Global market sentiment' },
-          { method: 'GET', path: '/api/fear-greed', desc: 'Fear & Greed Index' },
+          { method: 'GET', path: '/api/fear-greed', desc: 'Fear & Greed Index (alias)' },
           { method: 'GET', path: '/api/sentiment/asset/{symbol}', desc: 'Asset-specific sentiment' },
           { method: 'POST', path: '/api/sentiment/analyze', desc: 'Analyze custom text' }
         ],
@@ -113,10 +137,10 @@ fetch('${baseUrl}/api/fear-greed')
 fetch('${baseUrl}/api/sentiment/analyze', {
   method: 'POST',
   headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({ text: 'Bitcoin is going to the moon!' })
+  body: JSON.stringify({ text: 'Bitcoin is going to the moon!', mode: 'crypto' })
 })
   .then(res => res.json())
-  .then(data => console.log('Sentiment:', data.label, data.score));`
+  .then(data => console.log('Sentiment:', data.sentiment, data.score));`
       },
       
       // ===== ON-CHAIN ANALYTICS =====
@@ -125,19 +149,13 @@ fetch('${baseUrl}/api/sentiment/analyze', {
         category: 'Analytics',
         description: 'Blockchain data, whale tracking, and network statistics',
         endpoints: [
-          { method: 'GET', path: '/api/whale', desc: 'Whale transactions' },
-          { method: 'GET', path: '/api/whales/transactions?limit=50', desc: 'Recent whale moves' },
-          { method: 'GET', path: '/api/whales/stats?hours=24', desc: 'Whale activity statistics' },
-          { method: 'GET', path: '/api/blockchain/gas?chain=ethereum', desc: 'Gas prices' }
+          { method: 'GET', path: '/api/service/whales?chain=ethereum&min_amount_usd=1000000&limit=20', desc: 'Whale transactions (service)' },
+          { method: 'GET', path: '/api/service/onchain?address=0x...&chain=ethereum', desc: 'On-chain snapshot (service)' }
         ],
         example: `// Get whale transactions
 fetch('${baseUrl}/api/service/whales?chain=ethereum&min_amount_usd=1000000&limit=20')
   .then(res => res.json())
-  .then(data => {
-    data.data.forEach(tx => {
-      console.log('Whale:', tx.amount_usd, 'USD', tx.chain);
-    });
-  });`
+  .then(data => console.log(data));`
       },
       
       // ===== TECHNICAL ANALYSIS =====
@@ -172,6 +190,28 @@ fetch('${baseUrl}/api/technical/ta-quick', {
     console.log('Entry Range:', data.entry_range);
   });`
       },
+
+      // ===== INDICATORS =====
+      {
+        name: 'Indicator Services API',
+        category: 'Analysis Services',
+        description: 'Technical indicators (RSI, MACD, SMA/EMA, BB, ATR, StochRSI) + comprehensive signals',
+        endpoints: [
+          { method: 'GET', path: '/api/indicators/services', desc: 'List available indicator services' },
+          { method: 'GET', path: '/api/indicators/rsi?symbol=BTC&timeframe=1h&period=14', desc: 'RSI' },
+          { method: 'GET', path: '/api/indicators/macd?symbol=BTC&timeframe=1h', desc: 'MACD' },
+          { method: 'GET', path: '/api/indicators/comprehensive?symbol=BTC&timeframe=1h', desc: 'Comprehensive indicator analysis' }
+        ],
+        example: `// List indicator services
+fetch('${baseUrl}/api/indicators/services')
+  .then(r => r.json())
+  .then(console.log);
+
+// RSI
+fetch('${baseUrl}/api/indicators/rsi?symbol=BTC&timeframe=1h&period=14')
+  .then(r => r.json())
+  .then(console.log);`
+      },
       
       // ===== AI MODELS =====
       {
@@ -181,15 +221,16 @@ fetch('${baseUrl}/api/technical/ta-quick', {
         endpoints: [
           { method: 'GET', path: '/api/models/status', desc: 'Models status' },
           { method: 'GET', path: '/api/models/list', desc: 'List all models' },
+          { method: 'GET', path: '/api/models/summary', desc: 'Models grouped by category (frontend-ready)' },
           { method: 'GET', path: '/api/models/health', desc: 'Model health check' },
-          { method: 'POST', path: '/api/models/reinit-all', desc: 'Reinitialize models' },
+          { method: 'POST', path: '/api/models/reinitialize', desc: 'Reinitialize models (UI button)' },
           { method: 'POST', path: '/api/ai/decision', desc: 'AI trading decision' }
         ],
         example: `// Get AI trading decision
 fetch('${baseUrl}/api/ai/decision', {
   method: 'POST',
   headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({ symbol: 'BTC', timeframe: '1h' })
+  body: JSON.stringify({ symbol: 'BTC', horizon: 'swing', risk_tolerance: 'moderate' })
 })
   .then(res => res.json())
   .then(data => {
@@ -203,21 +244,36 @@ fetch('${baseUrl}/api/ai/decision', {
       {
         name: 'DeFi Data API',
         category: 'DeFi Services',
-        description: 'DefiLlama TVL, protocols, yields, and stablecoins',
+        description: 'DefiLlama public endpoints (no API key): TVL, protocols, yields',
         endpoints: [
           { method: 'GET', path: '/api/defi/tvl', desc: 'Total Value Locked' },
           { method: 'GET', path: '/api/defi/protocols?limit=20', desc: 'Top DeFi protocols' },
-          { method: 'GET', path: '/api/defi/yields', desc: 'DeFi yields' }
+          { method: 'GET', path: '/api/defi/yields?limit=20', desc: 'DeFi yield pools' }
         ],
         example: `// Get DeFi TVL data
 fetch('${baseUrl}/api/defi/protocols?limit=10')
   .then(res => res.json())
   .then(data => {
-    data.protocols.forEach(p => {
+    (data.protocols || []).forEach(p => {
       console.log(p.name, '- TVL:', p.tvl);
     });
   });`
       },
+
+      // ===== TRADING & BACKTESTING =====
+      {
+        name: 'Trading & Backtesting API',
+        category: 'Trading',
+        description: 'Historical backtests and strategy runs (uses exchange/data fallbacks)',
+        endpoints: [
+          { method: 'GET', path: '/api/trading/backtest/historical/BTCUSDT?timeframe=1h&days=30', desc: 'Historical candles for backtest' },
+          { method: 'GET', path: '/api/trading/backtest/run/BTCUSDT?strategy=sma_crossover&days=30&initial_capital=10000', desc: 'Run a backtest strategy' }
+        ],
+        example: `// Run SMA crossover backtest
+fetch('${baseUrl}/api/trading/backtest/run/BTCUSDT?strategy=sma_crossover&days=30&initial_capital=10000')
+  .then(r => r.json())
+  .then(console.log);`
+      },
       
       // ===== RESOURCES & MONITORING =====
       {
@@ -248,39 +304,23 @@ fetch('${baseUrl}/api/resources/stats')
     console.log('Success Rate:', data.success_rate + '%');
   });`
       },
-      
-      // ===== WEBSOCKET =====
+
+      // ===== SUPPORT / DEBUG =====
       {
-        name: 'WebSocket API (Optional)',
-        category: 'Real-time Services',
-        description: 'Optional real-time streaming via WebSocket (HTTP polling recommended)',
+        name: 'Support & Debug API',
+        category: 'System Services',
+        description: 'Client-accessible support files and real endpoint list',
         endpoints: [
-          { method: 'WS', path: '/ws/master', desc: 'Master endpoint (all services)' },
-          { method: 'WS', path: '/ws/live', desc: 'Live market data' },
-          { method: 'WS', path: '/ws/ai/data', desc: 'AI model updates' },
-          { method: 'WS', path: '/ws/monitoring', desc: 'System monitoring' }
+          { method: 'GET', path: '/api/support/realendpoints', desc: 'Endpoints list (JSON)' },
+          { method: 'GET', path: '/api/support/realendpoints?format=txt', desc: 'Endpoints list (TXT)' },
+          { method: 'GET', path: '/realendpoint.txt', desc: 'Download endpoints list (TXT)' },
+          { method: 'GET', path: '/api/support/fualt?tail=200', desc: 'Tail of fault log (JSON)' },
+          { method: 'GET', path: '/fualt.txt', desc: 'Download full fault log (TXT)' }
         ],
-        example: `// WebSocket connection (optional - HTTP works fine)
-const ws = new WebSocket('wss://${window.location.host}/ws/master');
-
-ws.onopen = () => {
-  ws.send(JSON.stringify({
-    action: 'subscribe',
-    service: 'market_data'
-  }));
-};
-
-ws.onmessage = (event) => {
-  const data = JSON.parse(event.data);
-  console.log('Real-time update:', data);
-};
-
-// Alternative: HTTP polling (recommended)
-setInterval(async () => {
-  const data = await fetch('${baseUrl}/api/market?limit=100')
-    .then(r => r.json());
-  console.log('Market data:', data);
-}, 30000);`
+        example: `// Fetch tail of fualt.txt
+fetch('${baseUrl}/api/support/fualt?tail=200')
+  .then(r => r.json())
+  .then(data => console.log(data.content));`
       }
     ];
   }
@@ -324,7 +364,7 @@ setInterval(async () => {
         
         <div class="config-helper-body">
           <div class="config-helper-intro">
-            <p>Access <strong>40+ data providers</strong> through our unified API. Copy and paste these examples to get started.</p>
+            <p>Use this guide to integrate quickly. Every endpoint listed below exists in the server and is safe to copy.</p>
             <div class="config-helper-base-url">
               <strong>Base URL:</strong> 
               <code>${window.location.origin}</code>
@@ -336,10 +376,44 @@ setInterval(async () => {
               </button>
             </div>
             <div class="config-helper-stats">
-              <span>📊 8+ Market Providers</span>
-              <span>📰 9+ News Sources</span>
-              <span>🎭 4+ Sentiment APIs</span>
-              <span>🔗 4+ On-Chain APIs</span>
+              <span>✅ Copy-ready URLs</span>
+              <span>✅ Copy-ready code snippets</span>
+              <span>✅ `/api/endpoints` for discovery</span>
+              <span>✅ `/docs` for Swagger</span>
+            </div>
+
+            <div class="config-helper-snippets">
+              <div class="snippet-card">
+                <div class="snippet-head">
+                  <span>cURL</span>
+                  <button class="copy-btn">Copy</button>
+                </div>
+                <pre><code>curl -s '${window.location.origin}/api/health' | jq .</code></pre>
+              </div>
+              <div class="snippet-card">
+                <div class="snippet-head">
+                  <span>JavaScript (fetch)</span>
+                  <button class="copy-btn">Copy</button>
+                </div>
+                <pre><code>fetch('${window.location.origin}/api/market?limit=10')
+  .then(r => r.json())
+  .then(console.log);</code></pre>
+              </div>
+              <div class="snippet-card">
+                <div class="snippet-head">
+                  <span>Python (requests)</span>
+                  <button class="copy-btn">Copy</button>
+                </div>
+                <pre><code>import requests
+print(requests.get('${window.location.origin}/api/market?limit=10', timeout=10).json())</code></pre>
+              </div>
+              <div class="snippet-card">
+                <div class="snippet-head">
+                  <span>Optional HF Token</span>
+                  <button class="copy-btn">Copy</button>
+                </div>
+                <pre><code>export HF_TOKEN='YOUR_TOKEN_HERE'</code></pre>
+              </div>
             </div>
           </div>
 
@@ -358,7 +432,12 @@ setInterval(async () => {
     modal.querySelectorAll('.copy-btn').forEach(btn => {
       btn.addEventListener('click', (e) => {
         e.stopPropagation();
-        const text = btn.getAttribute('data-copy');
+        let text = btn.getAttribute('data-copy');
+        if (!text) {
+          // Snippet cards copy their visible code block
+          const codeEl = btn.closest('.snippet-card')?.querySelector('pre code');
+          text = codeEl?.textContent || '';
+        }
         this.copyToClipboard(text, btn);
       });
     });
@@ -450,7 +529,20 @@ setInterval(async () => {
 
   async copyToClipboard(text, button) {
     try {
-      await navigator.clipboard.writeText(text);
+      if (navigator.clipboard?.writeText) {
+        await navigator.clipboard.writeText(text);
+      } else {
+        // Fallback for older browsers / restricted contexts
+        const ta = document.createElement('textarea');
+        ta.value = text;
+        ta.setAttribute('readonly', '');
+        ta.style.position = 'fixed';
+        ta.style.left = '-9999px';
+        document.body.appendChild(ta);
+        ta.select();
+        document.execCommand('copy');
+        ta.remove();
+      }
       
       // Visual feedback
       const originalHTML = button.innerHTML;
@@ -609,6 +701,42 @@ style.textContent = `
     border-radius: 4px;
   }
 
+  .config-helper-snippets {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 12px;
+    margin-top: 12px;
+  }
+
+  .snippet-card {
+    background: var(--bg-secondary, #f8fdfc);
+    border: 1px solid var(--border-light, #e5e7eb);
+    border-radius: 12px;
+    padding: 12px;
+    overflow: hidden;
+  }
+
+  .snippet-head {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    font-size: 12px;
+    font-weight: 700;
+    color: var(--text-secondary, #6b7280);
+    margin-bottom: 8px;
+  }
+
+  .snippet-card pre {
+    margin: 0;
+    background: #0b1220;
+    color: #e2e8f0;
+    padding: 10px;
+    border-radius: 10px;
+    overflow-x: auto;
+    font-size: 12px;
+    line-height: 1.5;
+  }
+
   .service-category {
     margin-bottom: 24px;
   }
@@ -806,6 +934,10 @@ style.textContent = `
     .config-helper-stats {
       flex-direction: column;
     }
+
+    .config-helper-snippets {
+      grid-template-columns: 1fr;
+    }
   }
 `;
 document.head.appendChild(style);

static/shared/css/global.css

@@ -231,3 +231,42 @@ input::placeholder {
   clip: rect(0, 0, 0, 0);
   border: 0;
 }
+
+/* ==========================================================================
+   Disable "blinking" (looping) animations globally
+   --------------------------------------------------------------------------
+   Many pages/components use infinite pulse/shimmer/gradient animations that can
+   look like blinking. We stop ALL looping animations across the app, but keep
+   loading spinners rotating so users still get feedback during async loads.
+   ========================================================================== */
+
+/* Stop all looping animations (including on pseudo-elements) */
+html body *,
+html body *::before,
+html body *::after {
+  animation-iteration-count: 1 !important;
+}
+
+/* Keep true loading spinners rotating */
+html body .spinner,
+html body .loading-spinner,
+html body .spinner-icon,
+html body .spinner::before,
+html body .spinner::after,
+html body .loading-spinner::before,
+html body .loading-spinner::after,
+html body .spinner-icon::before,
+html body .spinner-icon::after {
+  animation-iteration-count: infinite !important;
+}
+
+/* Explicitly disable LIVE badge blinking (header/sidebar). Some pages load
+   global.css async; this hard-stop prevents any repeated pulsing. */
+html body .live-badge,
+html body .live-dot,
+html body .live-pulse,
+html body .live-badge-enhanced,
+html body .live-badge-enhanced .live-pulse,
+html body .live-badge-enhanced .live-text {
+  animation: none !important;
+}

static/shared/js/components/toast.js

@@ -5,10 +5,22 @@
 
 import { CONFIG } from '../core/config.js';
 
+const TOAST_DEFAULTS = {
+  MAX_VISIBLE: 3,
+  DEFAULT_DURATION: 3500,
+  ERROR_DURATION: 6000,
+};
+
+// CONFIG.TOAST is optional in some builds/pages; keep Toast resilient.
+const TOAST_CONFIG = {
+  ...TOAST_DEFAULTS,
+  ...(CONFIG?.TOAST || {}),
+};
+
 export class Toast {
   static container = null;
   static toasts = [];
-  static maxToasts = CONFIG.TOAST.MAX_VISIBLE;
+  static maxToasts = TOAST_CONFIG.MAX_VISIBLE;
 
   /**
    * Initialize toast container
@@ -35,7 +47,9 @@ export class Toast {
       id: Date.now() + Math.random(),
       message,
       type,
-      duration: options.duration || (type === 'error' ? CONFIG.TOAST.ERROR_DURATION : CONFIG.TOAST.DEFAULT_DURATION),
+      duration:
+        options.duration ??
+        (type === 'error' ? TOAST_CONFIG.ERROR_DURATION : TOAST_CONFIG.DEFAULT_DURATION),
       dismissible: options.dismissible !== false,
       action: options.action || null,
     };

static/shared/js/core/config.js

@@ -77,6 +77,10 @@ export const API_ENDPOINTS = {
   resourcesCategory: '/api/resources/category',
   resourcesApis: '/api/resources/apis',
   providers: '/api/providers',
+
+  // Support / Debug (client-consumable)
+  supportFualt: '/api/support/fualt',
+  supportRealEndpoints: '/api/support/realendpoints',
   
   // Advanced
   multiSourceData: '/api/multi-source/data',
@@ -204,6 +208,12 @@ export const CONFIG = {
   MAX_RETRIES: 3,
   RETRY_DELAY: 1000,
   RETRIES: 3,
+  // UI defaults (used by shared components like toast)
+  TOAST: {
+    MAX_VISIBLE: 3,
+    DEFAULT_DURATION: 3500,
+    ERROR_DURATION: 6000
+  },
   IS_HUGGINGFACE: IS_HUGGINGFACE,
   IS_LOCALHOST: IS_LOCALHOST,
   ENVIRONMENT: IS_HUGGINGFACE ? 'huggingface' : IS_LOCALHOST ? 'local' : 'production'

static/shared/js/core/support-client.js

@@ -0,0 +1,26 @@
+/**
+ * Support Client
+ * Client-facing helpers for fualt.txt + realendpoint.txt support endpoints.
+ */
+
+import { API_ENDPOINTS } from './config.js';
+
+export class SupportClient {
+  static async getFualt({ tail = 500 } = {}) {
+    const url = `${API_ENDPOINTS.supportFualt}?tail=${encodeURIComponent(tail)}`;
+    const res = await fetch(url, { headers: { 'Content-Type': 'application/json' } });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return await res.json();
+  }
+
+  static async getRealEndpoints({ format = 'json' } = {}) {
+    const url = `${API_ENDPOINTS.supportRealEndpoints}?format=${encodeURIComponent(format)}`;
+    const res = await fetch(url, { headers: { 'Content-Type': 'application/json' } });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    if (format === 'txt') return await res.text();
+    return await res.json();
+  }
+}
+
+export default SupportClient;
+