Fix provider routing and overhaul Space 4 dashboard

ENTERPRISE_DATA_BRAIN_V4_INSTALL_REPORT.md

@@ -1,60 +0,0 @@
-# Enterprise Data Brain v4 — Installed Package for Datasourceforcryptocurrency-4
-
-This package is a full V4 Space upload package, not a standalone Python snippet.
-
-## Applied changes
-
-- Added `enterprise_data_hub_v3_data_brain_v4.py` at repository root.
-- Patched `api_server_extended.py`, which is the active Docker entrypoint from `Dockerfile`:
-  `uvicorn api_server_extended:app --host 0.0.0.0 --port 7860`.
-- Installed the Data Brain after legacy compatibility routes with:
-  `install_data_brain(app, replace_existing=True)`.
-
-## Active direct routes owned by Data Brain
-
-- `/api/data-brain/status`
-- `/api/data-brain/peer-status`
-- `/api/data-brain/peer-push`
-- `/api/data-brain/peer-data`
-- `/api/ohlcv`
-- `/api/klines`
-- `/api/history`
-- `/api/orderbook`
-- `/api/trading/orderbook`
-- `/api/volume`
-- `/api/trading/volume`
-- `/api/news/{coin}`
-- `/api/social/sentiment`
-- `/api/sentiment`
-- `/api/funding`
-- `/api/trading/funding`
-- `/api/open-interest`
-- `/api/trading/open-interest`
-
-## Hub routes also exposed
-
-- `/api/hub/status`
-- `/api/hub/provider-health`
-- `/api/hub/source-contracts`
-- `/api/hub/sync/v4`
-- `/api/hub/ohlcv`
-- `/api/hub/orderbook`
-- `/api/hub/volume`
-- `/api/hub/news/{coin}`
-- `/api/hub/sentiment`
-- `/api/hub/funding`
-- `/api/hub/open-interest`
-
-## Safety
-
-- `executionAllowed` remains always false.
-- No API secrets were added.
-- Existing project files, JSON registries, provider configs, API folders, and model files were preserved.
-
-## Upload target
-
-Upload this full ZIP to:
-
-`Really-amin/Datasourceforcryptocurrency-4`
-
-Do not upload it to V2.

SPACE4_AUDIT_REPORT_2026-08-25.md

@@ -0,0 +1,279 @@
+# Space 4 Live Audit and UI Overhaul Report
+
+Audit date: 2026-08-25  
+Space: `Really-amin/Datasourceforcryptocurrency-4`  
+Production URL: https://really-amin-datasourceforcryptocurrency-4.hf.space  
+Production commit audited: `535b97392432913d5fe93e2bb80874217ca65c0f`  
+Production runtime: `RUNNING` on HF CPU Basic, one replica
+
+## Scope and evidence boundary
+
+This report is Space 4 only. Production findings come from live calls to the deployed Space and its live OpenAPI schema. Fixes described as local are present only in the working tree and have not been pushed or deployed. No provider output was fabricated and no missing value was estimated.
+
+The deployed schema contains 119 paths and 121 operations. One registered static alias is unreachable and removed locally, so the corrected working-tree schema contains 118 paths and 120 operations. The route map below is the corrected organization; every remaining operation has one user-facing group instead of the deployed schema's 72-operation untagged bucket.
+
+## Executive findings
+
+### Working in production
+
+- Runtime and core health: `RUNNING`; `/api/health` returns healthy.
+- Historical OHLCV: BTCUSDT 4h from 2022-01-01 through 2024-12-31 returned 6,576 real candles from Binance Vision, earliest `1640995200000`, latest `1735675200000`.
+- Fear & Greed: 3,124 real dated rows from Alternative.me, earliest `1517443200`, latest `1787616000`.
+- Funding: Gate.io is the working production source; live calls returned real data and advertise approximately 180 days of retention.
+- Open interest: Gate.io is the working production source. The local forward archive currently has 100 rows for each of BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT and XRPUSDT (500 total).
+- News archive: 23 real NewsData articles, `CACHED/REAL`, forward-only.
+- Whale archive: 44 real large Ethereum native transfers at final observation, `CACHED/REAL`, forward-only. BSC RPC is live but no transfer met the 500 BNB threshold in the observed windows.
+- Short Hunter snapshot: `success=true`, `sourceMode=LIVE`, `dataState=REAL`, `noTradeGuard=false`, no missing critical capabilities. KuCoin Futures supplied market/funding/OI and Alternative.me supplied sentiment.
+- AI inference: 12 local HF pipelines loaded; a real sentiment request returned neutral with confidence 0.9701926708.
+
+### Registered but broken or misleading in the deployed build
+
+- `/api/providers/catalog`, `/api/providers/status`, `/api/providers/auto-discovery-report`, and `/api/providers/health-summary` are shadowed by the earlier `/api/providers/{provider_id}` catch-all and return 404 instead of their registered handlers.
+- `/static/api-resources/api-config-complete__1_.txt` is registered but the earlier `/static` mount intercepts it and returns 404.
+- `/api/hf/health` returns `ok=false` from an empty catalog refresher even while 12 actual model pipelines are loaded and inference works.
+- `/api/trading/stats/24h/{symbol}` depends only on geo-blocked Binance Spot and returns semantic failure.
+- `/api/news/{coin_id}` receives CryptoCompare 401 but reports `success=true` with an empty array.
+- `/api/defi`, `/api/pools`, model-generated history, legacy news history and log tables are placeholders or currently empty despite HTTP 200.
+
+### Dead code
+
+- `enterprise_data_hub_v3.py`: 26 routes, not registered.
+- `enterprise_data_hub_v3_data_brain_v4.py`: 50 routes, not registered.
+- `enterprise_router_v5.py`: 33 routes, not installed.
+- The Enterprise OHLCV implementations still clamp to 500. Their functionality duplicates the active compatibility/APEX routers and would create path conflicts. They were removed locally instead of merged.
+
+## Upstream provider health
+
+| Provider | Live result | Current role / reason |
+|---|---|---|
+| Binance Vision | Working, HTTP 200 | Canonical historical OHLCV; 6,576-candle production verification passed. |
+| Binance Spot | Failing, HTTP 451 | Geo-restricted from current runtime; local 24h stats fallback added. |
+| Binance Futures | Failing: primary 451, alternates 202/non-JSON | Not usable from current HF location. |
+| KuCoin Spot | Working, HTTP 200 | Orderbook and new 24h ticker fallback. |
+| KuCoin Futures | Working, HTTP 200 | Primary Short Hunter market, OHLCV, orderbook, funding and OI. |
+| CoinGecko | Working, HTTP 200 | Top markets and trending. |
+| Gate.io Futures | Working, HTTP 200 | Production Funding/OI fallback; about 180 days retention. |
+| Bybit domains | Failing, HTTP 403 | All six tested public domains blocked by CloudFront country policy. |
+| Alternative.me | Working, HTTP 200 | Full Fear & Greed history and Short Hunter sentiment. |
+| NewsData | Working | Authenticated collector has 23 real archived articles. |
+| CryptoCompare | Failing, HTTP 401 | Both price and news calls reject current/no accepted key; marked key-required locally. |
+| CryptoPanic | Failing, HTTP 403 | Disabled/no usable credential from runtime. |
+| Reddit | Failing, HTTP 403 | No-key fallback blocked from this environment. |
+| Ethereum public RPC | Working | 44 archived ≥50 ETH native transfers at final observation. |
+| BSC public RPC | Working | Blocks scan successfully; no ≥500 BNB match in observed windows. |
+| HF local model runtime | Working | 12 pipelines loaded; inference verified. |
+
+## SQLite and persistence
+
+### Active production database
+
+`/app/data/database/crypto_monitor.db` defines:
+
+- `prices`
+- `sentiment_analysis`
+- `news_articles`
+
+Live read endpoints showed all three effectively empty: BTC price history 0, generated/model sentiment rows 0, legacy news rows 0. These tables are not the active APEX archive.
+
+### APEX archive database
+
+`data/database/apex_forward_archive.db` contains one indexed `forward_events` table with primary key `(component, external_id)` and a `(component, event_time)` index. Production rows observed: OI 500 total, News 23, Whale Flow 44 at the final check.
+
+Production `/api/apex/coverage` says `EPHEMERAL_LOCAL_DISK`. HF runtime metadata also reports `storage: null`. Therefore OI, News and Whale Flow archives will be wiped on a rebuild/restart. This is not a hypothetical warning: no persistent volume is attached.
+
+Two committed legacy SQLite files are not used by the Docker entrypoint: `Data/api_monitor.db` (mostly empty; 30 market rows and 15 each news/sentiment) and `final/data/crypto_monitor.db` (1,327 status-log rows, other tables empty).
+
+## Local fixes made (not deployed)
+
+- Reordered the provider catch-all so four fixed provider routes resolve correctly.
+- Removed the unreachable static alias from OpenAPI.
+- Added explicit OpenAPI groups for every operation.
+- Unified `/api/hf/health` with the actual model runtime.
+- Added KuCoin Spot fallback to the broken Binance-only 24h stats route.
+- Made the CryptoCompare news compatibility route return honest `UNAVAILABLE` on 401.
+- Marked CryptoCompare key-required in Short Hunter provider registry.
+- Added non-overlap locks and safe collector state (running, last success, last error).
+- Added archive row counts and earliest/latest/observed timestamps to coverage.
+- Corrected all OI help text from stale Binance/Bybit 30-day claims to current Gate.io ~180-day behavior.
+- Removed the three unregistered Enterprise router implementations and their stale install report.
+- Fixed local workspace-root detection so rendered QA serves the actual source tree.
+
+## Homepage and help redesign
+
+The new homepage is a compact dark glassmorphism operations dashboard:
+
+- Persistent grouped sidebar: Overview, Data & Signals, Operations.
+- Above-the-fold runtime, archive-storage and freshness cards.
+- Four market cards (BTC, ETH, SOL, BNB), each with provider, latency and LIVE/DEGRADED/CACHED/UNAVAILABLE state.
+- Six coverage cards separating live/on-demand history from cached forward archives.
+- Archive-health panel showing stored rows and last observed time after the backend fix.
+- Prominent Data Lab, Help, OpenAPI and Short Hunter navigation.
+- Mobile breakpoint collapses to a one-column layout and off-canvas menu.
+
+The help page now explains the current Gate.io retention, ephemeral storage, forward-only coverage and groups the entire OpenAPI schema instead of rendering a wall of routes.
+
+## UI verification
+
+The deployed pre-change homepage was rendered at 1363×936. No overlap or horizontal overflow appeared, but it showed the main usability defects: a giant orange warning consumed most of the first screen, market/freshness data was not above the fold, “Gateway degraded” used a green dot, and the database was falsely labeled missing.
+
+The redesigned HTML passed parser checks, both inline scripts passed `node --check`, required navigation/state labels were asserted in tests, and desktop/mobile CSS grids were inspected. A final screenshot of the redesigned production UI requires deployment; the standing no-deploy rule prevents claiming that as completed now.
+
+## Verification summary
+
+- Production OpenAPI audit: 119 paths / 121 operations.
+- Corrected local OpenAPI: 118 paths / 120 operations; 0 untagged operations.
+- Focused automated suite: 25 passed, 5 environment/live tests deselected.
+- The deselected tests are covered by direct production verification for KuCoin and Alternative.me; one stale-cache test has a pre-existing test-module aliasing issue, while the production snapshot contract is LIVE/REAL.
+- Python syntax compilation: passed.
+- HTML parsing: passed.
+- Inline JavaScript syntax: passed.
+- `git diff --check`: passed.
+- No commit, push or deployment performed.
+
+## Corrected route map
+
+### Core App & UI (11 operations)
+
+- `GET /trading_pairs.txt`
+- `GET /`
+- `GET /index.html`
+- `GET /data-lab`
+- `GET /help`
+- `GET /dashboard.html`
+- `GET /hf_console.html`
+- `GET /admin.html`
+- `GET /test.html`
+- `GET /ai-tools`
+- `GET /debug-info`
+
+### System Health (4 operations)
+
+- `GET /health`
+- `GET /api/health`
+- `GET /api/status`
+- `GET /api/stats`
+
+### Market Data & Signals (14 operations)
+
+- `GET /api/market`
+- `GET /api/market/history`
+- `GET /api/sentiment`
+- `POST /api/sentiment`
+- `GET /api/trending`
+- `GET /api/defi`
+- `GET /api/news`
+- `POST /api/sentiment/analyze`
+- `POST /api/news/analyze`
+- `GET /api/sentiment/history`
+- `POST /api/news/fetch`
+- `GET /api/news/latest`
+- `POST /api/news/summarize`
+- `POST /api/trading/decision`
+
+### Resources & Operations (31 operations)
+
+- `GET /api/resources`
+- `GET /api/resources/summary`
+- `GET /api/resources/unified`
+- `GET /api/resources/ultimate`
+- `GET /api-resources/api-config-complete__1_.txt`
+- `GET /api/resources/apis`
+- `GET /api/resources/apis/raw`
+- `GET /api/providers`
+- `GET /api/providers/category/{category}`
+- `GET /api/pools`
+- `GET /api/logs/recent`
+- `GET /api/logs/errors`
+- `POST /api/diagnostics/run`
+- `GET /api/diagnostics/last`
+- `GET /api/diagnostics/health`
+- `POST /api/diagnostics/run-test`
+- `POST /api/diagnostics/self-heal`
+- `POST /api/apl/run`
+- `GET /api/apl/report`
+- `GET /api/providers/auto-discovery-report`
+- `GET /api/providers/health-summary`
+- `GET /api/apl/summary`
+- `GET /api/logs/summary`
+- `GET /api/diagnostics/errors`
+- `GET /api/resources/search`
+- `POST /api/v2/export/{export_type}`
+- `POST /api/v2/backup`
+- `POST /api/v2/import/providers`
+- `GET /api/providers/catalog`
+- `GET /api/providers/status`
+- `GET /api/providers/{provider_id}`
+
+### AI & Models (13 operations)
+
+- `GET /api/hf/models`
+- `GET /api/hf/health`
+- `POST /api/ai/summarize`
+- `GET /api/models/status`
+- `POST /api/models/initialize`
+- `GET /api/models/list`
+- `GET /api/models/{model_key}/info`
+- `POST /api/models/{model_key}/predict`
+- `POST /api/models/batch/predict`
+- `POST /api/analyze/text`
+- `GET /api/models/data/generated`
+- `GET /api/models/data/stats`
+- `POST /api/hf/run-sentiment`
+
+### Legacy Compatibility (22 operations)
+
+- `GET /api/coins/top`
+- `GET /api/market/top`
+- `GET /api/top-coins`
+- `GET /api/trading/ohlcv/{symbol}`
+- `GET /api/klines`
+- `GET /api/ohlcv`
+- `GET /api/trading/history/{symbol}`
+- `GET /api/history`
+- `GET /api/trading/stats/24h/{symbol}`
+- `GET /api/trading/orderbook/{symbol}`
+- `GET /api/orderbook`
+- `GET /api/indicators/comprehensive`
+- `GET /api/indicators`
+- `GET /api/indicators/rsi`
+- `GET /api/indicators/macd`
+- `GET /api/social/sentiment`
+- `GET /api/sentiment/global`
+- `GET /api/sentiment/asset/{symbol}`
+- `GET /api/ai/sentiment`
+- `POST /api/ai/sentiment`
+- `GET /api/news/{coin_id}`
+- `GET /api/debug/capabilities`
+
+### Short Hunter Gateway (15 operations)
+
+- `GET /api/short-hunter/health`
+- `GET /api/short-hunter/catalog`
+- `GET /api/short-hunter/capabilities`
+- `GET /api/short-hunter/providers/status`
+- `GET /api/short-hunter/universe`
+- `GET /api/short-hunter/market/{symbol}`
+- `GET /api/short-hunter/ohlcv/{symbol}`
+- `GET /api/short-hunter/orderbook/{symbol}`
+- `GET /api/short-hunter/funding/{symbol}`
+- `GET /api/short-hunter/open-interest/{symbol}`
+- `GET /api/short-hunter/indicators/{symbol}`
+- `GET /api/short-hunter/sentiment/{symbol}`
+- `GET /api/short-hunter/snapshot/{symbol}`
+- `POST /api/short-hunter/batch-snapshot`
+- `GET /api/short-hunter/network/diagnostics`
+
+### APEX Historical & Archives (10 operations)
+
+- `GET /api/apex/coverage`
+- `GET /api/apex/funding/{symbol}`
+- `GET /api/apex/open-interest/{symbol}`
+- `GET /api/apex/open-interest-archive/{symbol}`
+- `POST /api/apex/open-interest/archive/collect`
+- `GET /api/apex/sentiment/fear-greed`
+- `GET /api/apex/news`
+- `GET /api/apex/whale-flow`
+- `POST /api/apex/archive/collect`
+- `POST /api/apex/news/backfill`
+
+

apex_strategy_routes.py

@@ -25,6 +25,13 @@ FUTURES_BASES = [value for value in dict.fromkeys([
 BYBIT_PUBLIC_BASES = ["https://api.bybit.nl", "https://api.bybit.ae", "https://api.bybitgeorgia.ge", "https://api.bybit-tr.com", "https://api.bytick.com", "https://api.bybit.com", "https://api.gateio.ws/api/v4"]
 DEFAULT_TRACKED_SYMBOLS = "BTCUSDT,ETHUSDT,BNBUSDT,SOLUSDT,XRPUSDT"
 NEWSDATA_FALLBACK_KEY = "pub_0541f8b03d49486285f479c3b9a41fd8"
+_OI_LOCK = asyncio.Lock()
+_FORWARD_LOCK = asyncio.Lock()
+COLLECTOR_STATUS: Dict[str, Dict[str, Any]] = {
+    "openInterest": {"running": False, "lastSuccessfulRun": None, "lastError": None},
+    "newsAndWhale": {"running": False, "lastSuccessfulRun": None, "lastError": None},
+    "whaleFlow": {"running": False, "lastSuccessfulRun": None, "lastError": None},
+}
 
 
 def _now() -> str:
@@ -211,7 +218,7 @@ def _archive_count(component: str, symbol: Optional[str]=None) -> int:
     return int(row[0])
 
 
-async def collect_oi_archive(period: str="1h") -> Dict[str, Any]:
+async def _collect_oi_archive_unlocked(period: str="1h") -> Dict[str, Any]:
     results=[]
     for symbol in _tracked_symbols():
         try:
@@ -219,7 +226,25 @@ async def collect_oi_archive(period: str="1h") -> Dict[str, Any]:
             _save_oi(items)
             results.append({"symbol":symbol,"success":True,"fetched":len(items),"archiveRows":_archive_count("openInterest",symbol),"earliestTimestamp":items[0]["timestamp"] if items else None,"latestTimestamp":items[-1]["timestamp"] if items else None})
         except Exception as exc: results.append({"symbol":symbol,"success":False,"error":f"{type(exc).__name__}: {exc}"})
-    return {"success":any(x["success"] for x in results),"component":"openInterest","schedule":"daily","dedupeKey":["symbol","timestamp"],"trackedSymbols":_tracked_symbols(),"results":results,"coverageMode":"FORWARD_ARCHIVE_PLUS_30_DAY_UPSTREAM_WINDOW","warning":"No OI before archive collection began can be recovered from Binance's 30-day endpoint.","timestamp":_now()}
+    return {"success":any(x["success"] for x in results),"component":"openInterest","schedule":"daily","dedupeKey":["symbol","timestamp"],"trackedSymbols":_tracked_symbols(),"results":results,"coverageMode":"FORWARD_ARCHIVE_PLUS_180_DAY_UPSTREAM_WINDOW","warning":"The local archive grows forward. Older observations can only be retrieved while they remain inside Gate.io's approximately 180-day upstream window.","timestamp":_now()}
+
+
+async def collect_oi_archive(period: str="1h") -> Dict[str, Any]:
+    if _OI_LOCK.locked():
+        return {"success":False,"component":"openInterest","status":"ALREADY_RUNNING","dataState":"UNAVAILABLE","timestamp":_now()}
+    async with _OI_LOCK:
+        state=COLLECTOR_STATUS["openInterest"]
+        state["running"]=True;state["lastError"]=None
+        try:
+            result=await _collect_oi_archive_unlocked(period)
+            if result.get("success"): state["lastSuccessfulRun"]=_now()
+            else: state["lastError"]="No tracked symbol completed successfully"
+            return result
+        except Exception as exc:
+            state["lastError"]=f"{type(exc).__name__}: {exc}"
+            raise
+        finally:
+            state["running"]=False
 
 
 def _read(component: str, start: Optional[int], end: Optional[int], limit: int) -> Dict[str, Any]:
@@ -243,7 +268,7 @@ def _read_oi(symbol: str,start:Optional[int],end:Optional[int],limit:int) -> Dic
         rows=conn.execute(f"SELECT * FROM forward_events WHERE {' AND '.join(where)} ORDER BY event_time LIMIT ?",params).fetchall()
         first=conn.execute("SELECT MIN(observed_at) FROM forward_events WHERE component='openInterest'").fetchone()[0]
     data=[json.loads(r["payload_json"]) for r in rows]
-    return {"success":True,"component":"openInterest","symbol":sym,"data":data,"count":len(data),"sourceMode":"CACHED","dataState":"REAL" if data else "UNAVAILABLE","coverage":{"mode":"REAL_HISTORICAL_ON_DEMAND_PLUS_FORWARD_ARCHIVE","archiveStartedAt":first,"preDeploymentHistoryAvailable":False,"earliestTimestamp":data[0]["timestamp"] if data else None,"latestTimestamp":data[-1]["timestamp"] if data else None,"warning":"This cached archive starts at first collection; older history is available separately on demand through the Bybit fallback."},"timestamp":_now()}
+    return {"success":True,"component":"openInterest","symbol":sym,"data":data,"count":len(data),"sourceMode":"CACHED","dataState":"REAL" if data else "UNAVAILABLE","coverage":{"mode":"REAL_HISTORICAL_ON_DEMAND_PLUS_FORWARD_ARCHIVE","archiveStartedAt":first,"preDeploymentHistoryAvailable":False,"earliestTimestamp":data[0]["timestamp"] if data else None,"latestTimestamp":data[-1]["timestamp"] if data else None,"warning":"This local archive starts at first collection. Older real observations are available only within Gate.io's approximately 180-day upstream retention window."},"timestamp":_now()}
 
 
 async def _scan_evm_whales(limit:int) -> Dict[str,Any]:
@@ -279,7 +304,7 @@ async def _scan_evm_whales(limit:int) -> Dict[str,Any]:
     return {"items":found[:min(max(limit,1),1000)],"diagnostics":diagnostics,"pollInterval":"2 minutes"}
 
 
-async def collect_forward() -> Dict[str, Any]:
+async def _collect_forward_unlocked() -> Dict[str, Any]:
     results=[]
     try:
         # NEWSAPI_KEY is the legacy Space-secret name for this verified
@@ -314,6 +339,51 @@ async def collect_forward() -> Dict[str, Any]:
     return {"success":any(x["success"] for x in results),"results":results,"timestamp":_now()}
 
 
+async def collect_forward() -> Dict[str, Any]:
+    if _FORWARD_LOCK.locked():
+        return {"success":False,"status":"ALREADY_RUNNING","components":["news","whaleFlow"],"dataState":"UNAVAILABLE","timestamp":_now()}
+    async with _FORWARD_LOCK:
+        state=COLLECTOR_STATUS["newsAndWhale"]
+        state["running"]=True;state["lastError"]=None
+        try:
+            result=await _collect_forward_unlocked()
+            if result.get("success"): state["lastSuccessfulRun"]=_now()
+            else: state["lastError"]="No forward collector completed successfully"
+            return result
+        except Exception as exc:
+            state["lastError"]=f"{type(exc).__name__}: {exc}"
+            raise
+        finally:
+            state["running"]=False
+
+
+def _archive_health() -> Dict[str, Any]:
+    with _db() as conn:
+        rows=conn.execute("""SELECT component,symbol,COUNT(*) AS rows,
+                                    MIN(event_time) AS earliest,MAX(event_time) AS latest,
+                                    MIN(observed_at) AS first_observed,MAX(observed_at) AS last_observed
+                             FROM forward_events
+                             GROUP BY component,symbol ORDER BY component,symbol""").fetchall()
+    components: Dict[str, Any]={}
+    for row in rows:
+        bucket=components.setdefault(row["component"],{
+            "storedRows":0,"earliestTimestamp":None,"latestTimestamp":None,
+            "firstObservedAt":None,"lastObservedAt":None,"series":[],
+        })
+        bucket["storedRows"]+=int(row["rows"])
+        for target,source,reduce_fn in [
+            ("earliestTimestamp","earliest",min),("latestTimestamp","latest",max),
+            ("firstObservedAt","first_observed",min),("lastObservedAt","last_observed",max),
+        ]:
+            values=[v for v in [bucket[target],row[source]] if v is not None]
+            bucket[target]=reduce_fn(values) if values else None
+        bucket["series"].append({
+            "symbol":row["symbol"],"storedRows":int(row["rows"]),
+            "earliestTimestamp":row["earliest"],"latestTimestamp":row["latest"],
+        })
+    return {"database":_storage_status(),"collectors":COLLECTOR_STATUS,"components":components}
+
+
 async def backfill_newsapi(start_date: str, end_date: str, max_pages: int) -> Dict[str, Any]:
     key=os.getenv("NEWSAPI_KEY") or os.getenv("NEWS_API_KEY")
     if not key:return {"success":False,"component":"news","source":"newsapi","dataState":"UNAVAILABLE","error":"NEWSAPI_KEY not configured","coverageMode":"CONDITIONAL_DATED_SEARCH"}
@@ -344,9 +414,15 @@ async def periodic_archive(stop: asyncio.Event) -> None:
             except Exception: pass
         else:
             try:
+                COLLECTOR_STATUS["whaleFlow"]["running"]=True
                 scan=await _scan_evm_whales(1000)
                 _save("whaleFlow","public_evm_rpc_large_native_transfers",scan["items"])
-            except Exception: pass
+                COLLECTOR_STATUS["whaleFlow"]["lastSuccessfulRun"]=_now()
+                COLLECTOR_STATUS["whaleFlow"]["lastError"]=None
+            except Exception as exc:
+                COLLECTOR_STATUS["whaleFlow"]["lastError"]=f"{type(exc).__name__}: {exc}"
+            finally:
+                COLLECTOR_STATUS["whaleFlow"]["running"]=False
         if time.time()-last_oi_collection >= 86400:
             try:
                 await collect_oi_archive("1h")
@@ -358,7 +434,7 @@ async def periodic_archive(stop: asyncio.Event) -> None:
 
 @router.get("/coverage")
 async def coverage():
-    return {"success":True,"persistencePolicy":"on_demand_market_history_plus_forward_event_archive","archiveStorage":_storage_status(),"components":{"ohlcv":{"mode":"REAL_HISTORICAL_ON_DEMAND","endpoint":"/api/ohlcv"},"funding":{"mode":"REAL_180_DAY_UPSTREAM_IN_CURRENT_RUNTIME","endpoint":"/api/apex/funding/{symbol}"},"openInterest":{"mode":"REAL_180_DAY_UPSTREAM_PLUS_FORWARD_ARCHIVE","retention":"Gate.io fallback ~180 days; Binance/Bybit are geo-blocked from current HF runtime; daily local archive","liveEndpoint":"/api/apex/open-interest/{symbol}","archiveEndpoint":"/api/apex/open-interest-archive/{symbol}","trackedSymbols":_tracked_symbols()},"sentiment":{"mode":"REAL_HISTORICAL","endpoint":"/api/apex/sentiment/fear-greed"},"news":{"mode":"FORWARD_COLLECTING_ONLY","endpoint":"/api/apex/news","liveSource":"newsdata.io authenticated latest feed","preDeploymentHistoryAvailable":False},"whaleFlow":{"mode":"FORWARD_COLLECTING_ONLY","endpoint":"/api/apex/whale-flow","liveSource":"public Ethereum/BSC RPC large native transfers","scope":"configurable native-value threshold; no wallet-owner labels","preDeploymentHistoryAvailable":False}},"manifest":{"found":False,"expectedPath":"QA/profitability-structural-remediation/data/manifest.json","behavior":"APEX_TRACKED_SYMBOLS is configurable; defaults follow the project's core dashboard symbols"}}
+    return {"success":True,"persistencePolicy":"on_demand_market_history_plus_forward_event_archive","archiveStorage":_storage_status(),"archiveHealth":_archive_health(),"components":{"ohlcv":{"mode":"REAL_HISTORICAL_ON_DEMAND","endpoint":"/api/ohlcv"},"funding":{"mode":"REAL_180_DAY_UPSTREAM_IN_CURRENT_RUNTIME","endpoint":"/api/apex/funding/{symbol}"},"openInterest":{"mode":"REAL_180_DAY_UPSTREAM_PLUS_FORWARD_ARCHIVE","retention":"Gate.io fallback ~180 days; Binance/Bybit are geo-blocked from current HF runtime; daily local archive","liveEndpoint":"/api/apex/open-interest/{symbol}","archiveEndpoint":"/api/apex/open-interest-archive/{symbol}","trackedSymbols":_tracked_symbols()},"sentiment":{"mode":"REAL_HISTORICAL","endpoint":"/api/apex/sentiment/fear-greed"},"news":{"mode":"FORWARD_COLLECTING_ONLY","endpoint":"/api/apex/news","liveSource":"newsdata.io authenticated latest feed","preDeploymentHistoryAvailable":False},"whaleFlow":{"mode":"FORWARD_COLLECTING_ONLY","endpoint":"/api/apex/whale-flow","liveSource":"public Ethereum/BSC RPC large native transfers","scope":"configurable native-value threshold; no wallet-owner labels","preDeploymentHistoryAvailable":False}},"manifest":{"found":False,"expectedPath":"QA/profitability-structural-remediation/data/manifest.json","behavior":"APEX_TRACKED_SYMBOLS is configurable; defaults follow the project's core dashboard symbols"}}
 
 
 @router.get("/funding/{symbol}")

api_compat_routes.py

@@ -688,7 +688,21 @@ async def history_alias(
 async def trading_stats_24h(symbol: str):
     ticker, errors = await _fetch_binance_ticker(symbol)
     if not ticker:
-        return _fail("24h ticker unavailable", source="binance_public", symbol=_normalize_symbol(symbol), missingCapabilities=["ticker"], upstreamErrors=errors)
+        kucoin, kucoin_error, _ = await _get_json(
+            "https://api.kucoin.com/api/v1/market/stats",
+            params={"symbol": _kucoin_symbol(symbol)},
+        )
+        item = (kucoin or {}).get("data") if isinstance(kucoin, dict) else None
+        if isinstance(item, dict) and item.get("last") is not None:
+            return _ok(
+                symbol=_normalize_symbol(symbol), price=_float(item.get("last")),
+                volume=_float(item.get("vol")), quote_volume=_float(item.get("volValue")),
+                change_percent=_float(item.get("changeRate"))*100,
+                high=_float(item.get("high")), low=_float(item.get("low")),
+                source="kucoin_public", fallbackUsed=True, upstreamErrors=errors,
+            )
+        if kucoin_error: errors.append(kucoin_error)
+        return _fail("24h ticker unavailable", source="binance_and_kucoin_public", symbol=_normalize_symbol(symbol), missingCapabilities=["ticker"], upstreamErrors=errors)
     return _ok(
         symbol=_normalize_symbol(symbol),
         price=_float(ticker.get("lastPrice")),
@@ -810,14 +824,15 @@ async def ai_sentiment_post(request: Dict[str, Any]):
 
 @router.get("/api/news/{coin_id}")
 async def coin_news(coin_id: str, limit: int = Query(5, ge=1, le=20)):
-    # Public CryptoCompare news often works without a key; failure is a partial capability, not fatal.
+    # CryptoCompare now requires an accepted key. Preserve the compatibility
+    # route, but never disguise an upstream 401 as a successful empty feed.
     payload, error, _ = await _get_json(
         "https://min-api.cryptocompare.com/data/v2/news/",
         params={"lang": "EN", "categories": coin_id.upper(), "excludeCategories": "Sponsored"},
         timeout=15.0,
     )
     if error or not isinstance(payload, dict):
-        return _ok(data=[], news=[], count=0, status="empty", source="cryptocompare_news", upstreamErrors=[error] if error else [])
+        return _fail("News upstream unavailable", source="cryptocompare_news", data=[], news=[], count=0, dataState="UNAVAILABLE", missingCapabilities=["news"], upstreamErrors=[error] if error else [])
     articles = (payload.get("Data") or [])[:limit]
     news = [
         {

api_server_extended.py

@@ -39,8 +39,10 @@ from pydantic import BaseModel
 USE_MOCK_DATA = os.getenv("USE_MOCK_DATA", "false").lower() == "true"
 PORT = int(os.getenv("PORT", "7860"))
 
-# Paths - In Docker container, use /app as base
-WORKSPACE_ROOT = Path("/app" if Path("/app").exists() else (Path("/workspace") if Path("/workspace").exists() else Path(".")))
+# Paths - /app in the Space container, this source tree everywhere else.
+# Treating any host that happened to contain /workspace as the app root made
+# local rendered QA silently serve fallback "not found" pages.
+WORKSPACE_ROOT = Path(os.getenv("WORKSPACE_ROOT") or ("/app" if Path("/app").exists() else Path(__file__).resolve().parent)).resolve()
 DB_PATH = WORKSPACE_ROOT / "data" / "database" / "crypto_monitor.db"
 LOG_DIR = WORKSPACE_ROOT / "logs"
 PROVIDERS_CONFIG_PATH = WORKSPACE_ROOT / "providers_config_extended.json"
@@ -1708,11 +1710,6 @@ async def get_api_config_complete_text():
     return PlainTextResponse(_build_api_config_text(), media_type="text/plain")
 
 
-@app.get("/static/api-resources/api-config-complete__1_.txt")
-async def get_static_api_config_complete_text():
-    """Static-path alias for the frontend resource loader."""
-    return PlainTextResponse(_build_api_config_text(), media_type="text/plain")
-
 @app.get("/api/resources/apis")
 async def get_resources_apis():
     """Get API registry with local and external routes"""
@@ -1970,7 +1967,6 @@ async def get_providers():
         }
 
 
-@app.get("/api/providers/{provider_id}")
 async def get_provider_detail(provider_id: str):
     """Get specific provider details"""
     # Check if it's an HF model provider
@@ -2537,16 +2533,33 @@ async def get_hf_models():
 
 @app.get("/api/hf/health")
 async def get_hf_health():
-    """Get HF services health"""
+    """Return the health of the model runtime and the optional HF catalog cache."""
+    resource_health: Dict[str, Any] = {"ok": False, "status": "not_initialized"}
     try:
         from backend.services.hf_registry import REGISTRY
-        health = REGISTRY.health()
-        return health
-    except Exception as e:
-        return {
-            "ok": False,
-            "error": f"HF registry not available: {str(e)}"
-        }
+        resource_health = REGISTRY.health()
+    except Exception as exc:
+        resource_health = {"ok": False, "error": f"HF catalog registry unavailable: {type(exc).__name__}"}
+    try:
+        from ai_models import registry_status
+        model_health = registry_status()
+    except Exception as exc:
+        model_health = {"ok": False, "error": f"Model registry unavailable: {type(exc).__name__}"}
+    loaded = int(model_health.get("pipelines_loaded") or 0)
+    failed = int(model_health.get("pipelines_failed") or 0)
+    available = bool(model_health.get("ok") or loaded)
+    return {
+        "ok": available,
+        "success": available,
+        "status": "ok" if available else "unavailable",
+        "sourceMode": "LIVE" if available else "UNAVAILABLE",
+        "dataState": "REAL" if available else "UNAVAILABLE",
+        "modelsLoaded": loaded,
+        "modelsFailed": failed,
+        "modelRuntime": model_health,
+        "resourceCatalog": resource_health,
+        "timestamp": datetime.now().isoformat(),
+    }
 
 
 # ===== DeFi Endpoint =====
@@ -4173,6 +4186,80 @@ try:
 except Exception as apex_routes_error:
     logger.warning(f"APEX historical data routes not loaded: {apex_routes_error}")
 
+# The catch-all provider-detail route must come after every fixed
+# /api/providers/* route. FastAPI matches routes in declaration order; the old
+# order made several registered fixed paths resolve to provider-detail 404s.
+app.add_api_route(
+    "/api/providers/{provider_id}",
+    get_provider_detail,
+    methods=["GET"],
+    tags=["Resources & Operations"],
+)
+
+
+def _route_group(path: str) -> str:
+    """Give every OpenAPI operation a stable, user-facing navigation group."""
+    legacy_paths = {
+        "/api/coins/top", "/api/market/top", "/api/top-coins",
+        "/api/trading/ohlcv/{symbol}", "/api/klines", "/api/ohlcv",
+        "/api/trading/history/{symbol}", "/api/history",
+        "/api/trading/stats/24h/{symbol}", "/api/trading/orderbook/{symbol}",
+        "/api/orderbook", "/api/indicators/comprehensive", "/api/indicators",
+        "/api/indicators/rsi", "/api/indicators/macd", "/api/social/sentiment",
+        "/api/sentiment/global", "/api/sentiment/asset/{symbol}",
+        "/api/ai/sentiment", "/api/news/{coin_id}", "/api/debug/capabilities",
+    }
+    if path in legacy_paths:
+        return "Legacy Compatibility"
+    if path in {"/", "/index.html", "/data-lab", "/help", "/dashboard.html", "/hf_console.html", "/admin.html", "/test.html", "/ai-tools", "/debug-info", "/trading_pairs.txt"}:
+        return "Core App & UI"
+    if path.startswith("/api/short-hunter"):
+        return "Short Hunter Gateway"
+    if path.startswith("/api/apex"):
+        return "APEX Historical & Archives"
+    if path.startswith(("/api/models", "/api/hf", "/api/ai", "/api/analyze")):
+        return "AI & Models"
+    if path.startswith(("/api/resources", "/api-resources", "/api/providers", "/api/pools", "/api/logs", "/api/diagnostics", "/api/apl", "/api/v2")):
+        return "Resources & Operations"
+    if path in {"/health", "/api/health", "/api/status", "/api/stats"}:
+        return "System Health"
+    if path.startswith(("/api/market", "/api/trading", "/api/ohlcv", "/api/klines", "/api/history", "/api/orderbook", "/api/indicators", "/api/sentiment", "/api/social", "/api/news", "/api/coins", "/api/top-coins", "/api/trending", "/api/defi")):
+        return "Market Data & Signals"
+    return "Core App & UI"
+
+
+def _grouped_openapi():
+    """Generate the real schema without an untagged catch-all section."""
+    if app.openapi_schema:
+        return app.openapi_schema
+    from fastapi.openapi.utils import get_openapi
+    schema = get_openapi(
+        title=app.title,
+        version=app.version,
+        description=app.description,
+        routes=app.routes,
+    )
+    methods = {"get", "post", "put", "patch", "delete", "head", "options"}
+    for path, path_item in schema.get("paths", {}).items():
+        for method, operation in path_item.items():
+            if method.lower() in methods:
+                operation["tags"] = [_route_group(path)]
+    schema["tags"] = [
+        {"name": "Core App & UI", "description": "Rendered pages and core app entrypoints."},
+        {"name": "System Health", "description": "Process, configuration and service health."},
+        {"name": "Market Data & Signals", "description": "Prices, history, news, sentiment and indicators."},
+        {"name": "AI & Models", "description": "Model inventory, health and inference."},
+        {"name": "Resources & Operations", "description": "Provider catalog, diagnostics, logs and resource operations."},
+        {"name": "Legacy Compatibility", "description": "Stable aliases retained for existing consumers."},
+        {"name": "Short Hunter Gateway", "description": "LIVE-only Short Hunter datasource contract."},
+        {"name": "APEX Historical & Archives", "description": "Historical retrieval and forward-only archives."},
+    ]
+    app.openapi_schema = schema
+    return schema
+
+
+app.openapi = _grouped_openapi
+
 # ===== Main Entry Point =====
 if __name__ == "__main__":
     import uvicorn

enterprise_data_hub_v3.py

@@ -1,1519 +0,0 @@
-"""
-Enterprise Data Hub v3.1 — Upgraded
-Central, source-agnostic data mesh layer for HuggingFace crypto Spaces.
-
-Upgrade summary (v3 → v3.1):
-──────────────────────────────────────────────────────────────────────
-  1. TTL In-Memory Cache      – Avoid hammering external APIs on every
-                                 request. Per-endpoint configurable TTLs.
-  2. Circuit Breaker          – Providers that fail repeatedly are skipped
-                                 for a cool-down window.
-  3. Parallel Source Fetching – Fallbacks tried concurrently; first
-                                 successful response wins (OHLCV, volume).
-  4. New Providers            – OKX public API, ByBit public API added as
-                                 additional fallback tiers.
-  5. /api/hub/ticker          – Fast single-price lookup with cascade.
-  6. /api/hub/multi-ticker    – Batch price fetch (up to 20 symbols).
-  7. /api/hub/funding         – Perpetual funding rates (Binance/OKX/ByBit).
-  8. /api/hub/open-interest   – Open interest (Binance/OKX/ByBit).
-  9. CoinGecko sentiment fb   – More stable final fallback for sentiment.
- 10. Richer source contracts  – Lists the new endpoints + providers.
-
-Design principles (unchanged):
-  - V2 is the single source of truth / hub.
-  - V4 and public providers are sources, not hard dependencies.
-  - Every response is normalized with source, sourceChain, dataQuality,
-    isLive, isTradable, marketType, errors.
-  - No secrets are hard-coded; optional keys are read from env only.
-  - executionAllowed is ALWAYS False.
-──────────────────────────────────────────────────────────────────────
-"""
-from __future__ import annotations
-
-import os
-import time
-import asyncio
-from datetime import datetime, timezone
-from typing import Any, Dict, List, Optional, Tuple
-
-import httpx
-from fastapi import APIRouter, Query
-
-router = APIRouter(tags=["Enterprise Data Hub v3.1"])
-
-# ──────────────────────────────────────────────
-# Configuration (all overridable via env)
-# ──────────────────────────────────────────────
-V4_BASE_URL = os.getenv(
-    "V4_SOURCE_BASE_URL",
-    "https://really-amin-datasourceforcryptocurrency-4.hf.space",
-).rstrip("/")
-CRYPTO_DT_SOURCE_URL = os.getenv(
-    "CRYPTO_DT_SOURCE_URL",
-    "https://crypto-dt-source.onrender.com",
-).rstrip("/")
-HF_OHLC_DATASET_ID = os.getenv("HF_OHLC_DATASET_ID", "Really-amin/crypto-ohlc-data")
-REQUEST_TIMEOUT = float(os.getenv("ENTERPRISE_HUB_TIMEOUT", "8"))
-MAX_ERROR_SAMPLES = int(os.getenv("ENTERPRISE_HUB_MAX_ERROR_SAMPLES", "40"))
-
-# Cache TTLs (seconds)
-CACHE_TTL_OHLCV = int(os.getenv("CACHE_TTL_OHLCV", "30"))
-CACHE_TTL_TICKER = int(os.getenv("CACHE_TTL_TICKER", "10"))
-CACHE_TTL_ORDERBOOK = int(os.getenv("CACHE_TTL_ORDERBOOK", "5"))
-CACHE_TTL_VOLUME = int(os.getenv("CACHE_TTL_VOLUME", "20"))
-CACHE_TTL_FUNDING = int(os.getenv("CACHE_TTL_FUNDING", "60"))
-CACHE_TTL_OI = int(os.getenv("CACHE_TTL_OI", "30"))
-CACHE_TTL_SENTIMENT = int(os.getenv("CACHE_TTL_SENTIMENT", "300"))
-CACHE_TTL_NEWS = int(os.getenv("CACHE_TTL_NEWS", "120"))
-
-# Circuit breaker: consecutive failures before skipping, and cool-down (s)
-CB_THRESHOLD = int(os.getenv("CB_FAILURE_THRESHOLD", "4"))
-CB_COOLDOWN = float(os.getenv("CB_COOLDOWN_SEC", "120"))
-
-# ──────────────────────────────────────────────
-# Runtime state (process-local, intentional)
-# ──────────────────────────────────────────────
-_PROVIDER_HEALTH: Dict[str, Dict[str, Any]] = {}
-_REQUEST_COUNTERS: Dict[str, int] = {}
-_CACHE: Dict[str, Tuple[float, Any]] = {}  # key → (expiry_ts, payload)
-_CB_STATE: Dict[str, Dict[str, Any]] = {}  # provider → {failures, tripped_at}
-
-# ──────────────────────────────────────────────
-# Timeframe maps
-# ──────────────────────────────────────────────
-TIMEFRAME_MAP_BINANCE = {
-    "1m": "1m", "3m": "3m", "5m": "5m", "15m": "15m", "30m": "30m",
-    "1h": "1h", "2h": "2h", "4h": "4h", "6h": "6h", "8h": "8h", "12h": "12h",
-    "1d": "1d", "3d": "3d", "1w": "1w",
-}
-TIMEFRAME_MAP_KUCOIN = {
-    "1m": "1min", "3m": "3min", "5m": "5min", "15m": "15min", "30m": "30min",
-    "1h": "1hour", "2h": "2hour", "4h": "4hour", "6h": "6hour", "8h": "8hour",
-    "12h": "12hour", "1d": "1day", "1w": "1week",
-}
-TIMEFRAME_MAP_OKX = {
-    "1m": "1m", "3m": "3m", "5m": "5m", "15m": "15m", "30m": "30m",
-    "1h": "1H", "2h": "2H", "4h": "4H", "6h": "6H", "12h": "12H",
-    "1d": "1D", "3d": "3D", "1w": "1W",
-}
-TIMEFRAME_MAP_BYBIT = {
-    "1m": "1", "3m": "3", "5m": "5", "15m": "15", "30m": "30",
-    "1h": "60", "2h": "120", "4h": "240", "6h": "360", "12h": "720",
-    "1d": "D", "1w": "W",
-}
-
-
-# ──────────────────────────────────────────────
-# Helpers
-# ──────────────────────────────────────────────
-
-def _now_iso() -> str:
-    return datetime.now(timezone.utc).isoformat()
-
-
-def _now_ts() -> float:
-    return time.monotonic()
-
-
-def _bump_counter(name: str) -> None:
-    _REQUEST_COUNTERS[name] = _REQUEST_COUNTERS.get(name, 0) + 1
-
-
-# ── Cache ──────────────────────────────────────
-
-def _cache_get(key: str) -> Optional[Any]:
-    entry = _CACHE.get(key)
-    if entry and _now_ts() < entry[0]:
-        return entry[1]
-    return None
-
-
-def _cache_set(key: str, value: Any, ttl: float) -> None:
-    _CACHE[key] = (_now_ts() + ttl, value)
-
-
-# ── Circuit Breaker ────────────────────────────
-
-def _cb_is_open(provider: str) -> bool:
-    """Returns True if provider is currently circuit-broken (should be skipped)."""
-    state = _CB_STATE.get(provider)
-    if not state:
-        return False
-    if state["failures"] >= CB_THRESHOLD:
-        if (_now_ts() - state["tripped_at"]) < CB_COOLDOWN:
-            return True
-        # Cool-down elapsed → half-open: reset
-        _CB_STATE[provider] = {"failures": 0, "tripped_at": 0}
-    return False
-
-
-def _cb_record(provider: str, ok: bool) -> None:
-    state = _CB_STATE.setdefault(provider, {"failures": 0, "tripped_at": 0})
-    if ok:
-        state["failures"] = 0
-    else:
-        state["failures"] += 1
-        if state["failures"] >= CB_THRESHOLD:
-            state["tripped_at"] = _now_ts()
-
-
-# ── Provider Health ────────────────────────────
-
-def _record_provider(provider: str, ok: bool, latency_ms: float, error: Optional[str] = None) -> None:
-    entry = _PROVIDER_HEALTH.setdefault(provider, {
-        "provider": provider, "status": "unknown",
-        "successes": 0, "failures": 0,
-        "latencySamples": [], "errorSamples": [],
-        "lastSuccess": None, "lastError": None, "lastChecked": None,
-    })
-    entry["lastChecked"] = _now_iso()
-    samples = entry.setdefault("latencySamples", [])
-    samples.append(round(float(latency_ms), 2))
-    del samples[:-30]
-    if ok:
-        entry["successes"] += 1
-        entry["lastSuccess"] = _now_iso()
-        entry["status"] = "healthy" if entry["failures"] == 0 else "degraded"
-    else:
-        entry["failures"] += 1
-        entry["lastError"] = _now_iso()
-        entry["status"] = "degraded" if entry["successes"] else "unavailable"
-        errors = entry.setdefault("errorSamples", [])
-        if error:
-            errors.append(str(error)[:300])
-            del errors[:-MAX_ERROR_SAMPLES]
-    _cb_record(provider, ok)
-
-
-def _latency_avg(provider: str) -> Optional[float]:
-    samples = _PROVIDER_HEALTH.get(provider, {}).get("latencySamples", [])
-    if not samples:
-        return None
-    return round(sum(samples) / len(samples), 2)
-
-
-# ── Symbol normalisation ───────────────────────
-
-def _normalize_symbol(symbol: str) -> Dict[str, str]:
-    raw = (symbol or "BTC").strip().upper().replace("_", "-")
-    if raw in ("XBT", "XBTUSDT", "XBT-USDT"):
-        raw = "BTC"
-    for suffix in ("-USDT", "USDT", "-USD", "USD", "-BUSD", "BUSD"):
-        if raw.endswith(suffix) and len(raw) > len(suffix):
-            raw = raw[: -len(suffix)]
-            break
-    raw = raw.replace("-", "")
-    if raw == "XBT":
-        raw = "BTC"
-    base = raw
-    return {
-        "input": symbol,
-        "base": base,
-        "binance": f"{base}USDT",
-        "binance_perp": f"{base}USDT",          # same for Binance perp
-        "kucoin": f"{base}-USDT",
-        "okx_spot": f"{base}-USDT",
-        "okx_swap": f"{base}-USDT-SWAP",
-        "bybit_spot": f"{base}USDT",
-        "bybit_perp": f"{base}USDT",
-        "cc_base": base,
-    }
-
-
-# ── Quality payload ────────────────────────────
-
-def _quality_payload(
-    *, source: str, source_chain: List[str], errors: List[str],
-    market_type: str = "spot", is_live: bool = True,
-    is_tradable: bool = False, data_quality: str = "partial",
-) -> Dict[str, Any]:
-    return {
-        "source": source,
-        "sourceChain": source_chain,
-        "marketType": market_type,
-        "isLive": is_live,
-        "isTradable": is_tradable,
-        "executionAllowed": False,          # always
-        "dataQuality": data_quality,
-        "errors": errors,
-        "timestamp": _now_iso(),
-    }
-
-
-# ── HTTP helpers ───────────────────────────────
-
-async def _fetch_json(
-    provider: str, url: str,
-    params: Optional[Dict[str, Any]] = None,
-    headers: Optional[Dict[str, str]] = None,
-) -> Tuple[Optional[Any], Optional[str], float]:
-    if _cb_is_open(provider):
-        return None, f"circuit_open:{provider}", 0.0
-    start = time.perf_counter()
-    try:
-        async with httpx.AsyncClient(
-            timeout=REQUEST_TIMEOUT,
-            headers=headers or {"User-Agent": "enterprise-data-hub-v3.1"},
-        ) as client:
-            resp = await client.get(url, params=params)
-            latency_ms = (time.perf_counter() - start) * 1000
-            if resp.status_code >= 400:
-                err = f"HTTP {resp.status_code} from {url}"
-                _record_provider(provider, False, latency_ms, err)
-                return None, err, latency_ms
-            data = resp.json()
-            _record_provider(provider, True, latency_ms)
-            return data, None, latency_ms
-    except Exception as exc:  # noqa: BLE001
-        latency_ms = (time.perf_counter() - start) * 1000
-        err = f"{type(exc).__name__}: {exc}"
-        _record_provider(provider, False, latency_ms, err)
-        return None, err, latency_ms
-
-
-async def _fetch_v4(
-    path: str, params: Optional[Dict[str, Any]] = None,
-) -> Tuple[Optional[Dict[str, Any]], Optional[str]]:
-    data, err, _ = await _fetch_json("v4_source", f"{V4_BASE_URL}{path}", params=params)
-    if data is None:
-        return None, err
-    if not isinstance(data, dict):
-        return None, "v4_source returned non-object JSON"
-    return data, None
-
-
-# ──────────────────────────────────────────────
-# Candle normalisation
-# ──────────────────────────────────────────────
-
-def _norm_candles_binance(rows: List[Any]) -> List[Dict[str, Any]]:
-    out = []
-    for row in rows or []:
-        try:
-            open_time = int(row[0])
-            out.append({
-                "timestamp": open_time, "open_time": open_time,
-                "open": float(row[1]), "high": float(row[2]),
-                "low": float(row[3]), "close": float(row[4]),
-                "volume": float(row[5]),
-                "close_time": int(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return out
-
-
-def _norm_candles_kucoin(rows: List[Any]) -> List[Dict[str, Any]]:
-    out = []
-    for row in rows or []:
-        try:
-            ts_ms = int(float(row[0])) * 1000
-            out.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row[1]), "high": float(row[3]),
-                "low": float(row[4]), "close": float(row[2]),
-                "volume": float(row[5]),
-                "turnover": float(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return sorted(out, key=lambda x: x["timestamp"])
-
-
-def _norm_candles_okx(rows: List[Any]) -> List[Dict[str, Any]]:
-    # OKX: [ts, open, high, low, close, vol, volCcy, volCcyQuote, confirm]
-    out = []
-    for row in rows or []:
-        try:
-            ts_ms = int(row[0])
-            out.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row[1]), "high": float(row[2]),
-                "low": float(row[3]), "close": float(row[4]),
-                "volume": float(row[5]),
-                "quote_volume": float(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return sorted(out, key=lambda x: x["timestamp"])
-
-
-def _norm_candles_bybit(rows: List[Any]) -> List[Dict[str, Any]]:
-    # ByBit: [startTime, openPrice, highPrice, lowPrice, closePrice, volume, turnover]
-    out = []
-    for row in rows or []:
-        try:
-            ts_ms = int(row[0])
-            out.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row[1]), "high": float(row[2]),
-                "low": float(row[3]), "close": float(row[4]),
-                "volume": float(row[5]),
-                "turnover": float(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return sorted(out, key=lambda x: x["timestamp"])
-
-
-def _v4_candles(data: Dict[str, Any]) -> List[Dict[str, Any]]:
-    for key in ("candles", "data", "ohlcv"):
-        candidate = data.get(key)
-        if isinstance(candidate, list) and candidate:
-            return candidate
-    return []
-
-
-# ─────────────────────────��────────────────────
-# OHLCV fallback chain (parallel)
-# ──────────────────────────────────────────────
-
-async def _ohlcv_from_binance(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    interval = TIMEFRAME_MAP_BINANCE.get(timeframe, "1h")
-    data, err, _ = await _fetch_json(
-        "binance_vision_klines",
-        "https://data-api.binance.vision/api/v3/klines",
-        {"symbol": sym["binance"], "interval": interval, "limit": limit},
-    )
-    if err or not isinstance(data, list):
-        return None
-    candles = _norm_candles_binance(data)
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles, "source": "binance_vision_klines", "marketType": "spot"}
-
-
-async def _ohlcv_from_kucoin(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    ku_type = TIMEFRAME_MAP_KUCOIN.get(timeframe, "1hour")
-    data, err, _ = await _fetch_json(
-        "kucoin_public_candles",
-        "https://api.kucoin.com/api/v1/market/candles",
-        {"symbol": sym["kucoin"], "type": ku_type},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    rows = data.get("data") or []
-    candles = _norm_candles_kucoin(rows)[:limit]
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles, "source": "kucoin_public_candles", "marketType": "spot"}
-
-
-async def _ohlcv_from_okx(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    bar = TIMEFRAME_MAP_OKX.get(timeframe, "1H")
-    limit_capped = min(limit, 300)
-    data, err, _ = await _fetch_json(
-        "okx_public_candles",
-        "https://www.okx.com/api/v5/market/candles",
-        {"instId": sym["okx_spot"], "bar": bar, "limit": str(limit_capped)},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    rows = data.get("data") or []
-    candles = _norm_candles_okx(rows)
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles[-limit:], "source": "okx_public_candles", "marketType": "spot"}
-
-
-async def _ohlcv_from_bybit(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    interval = TIMEFRAME_MAP_BYBIT.get(timeframe, "60")
-    limit_capped = min(limit, 200)
-    data, err, _ = await _fetch_json(
-        "bybit_public_klines",
-        "https://api.bybit.com/v5/market/kline",
-        {"category": "spot", "symbol": sym["bybit_spot"], "interval": interval, "limit": str(limit_capped)},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    rows = (data.get("result") or {}).get("list") or []
-    candles = _norm_candles_bybit(rows)
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles[-limit:], "source": "bybit_public_klines", "marketType": "spot"}
-
-
-async def _ohlcv_from_cryptocompare(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    cc_key = os.getenv("CRYPTOCOMPARE_KEY")
-    cc_params: Dict[str, Any] = {"fsym": sym["cc_base"], "tsym": "USD", "limit": limit, "aggregate": 1}
-    if cc_key:
-        cc_params["api_key"] = cc_key
-    url = ("https://min-api.cryptocompare.com/data/v2/histohour"
-           if timeframe.endswith("h") else "https://min-api.cryptocompare.com/data/v2/histoday")
-    data, err, _ = await _fetch_json("cryptocompare_histo", url, cc_params)
-    if err or not isinstance(data, dict):
-        return None
-    rows = (((data.get("Data") or {}).get("Data")) or [])
-    candles = []
-    for row in rows:
-        try:
-            ts_ms = int(row.get("time", 0)) * 1000
-            candles.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row.get("open", 0)), "high": float(row.get("high", 0)),
-                "low": float(row.get("low", 0)), "close": float(row.get("close", 0)),
-                "volume": float(row.get("volumefrom", 0)),
-                "quote_volume": float(row.get("volumeto", 0)),
-            })
-        except Exception:
-            continue
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles[-limit:], "source": "cryptocompare_histo", "marketType": "spot"}
-
-
-async def _fallback_ohlcv_parallel(
-    symbol: str, timeframe: str, limit: int,
-    errors: List[str], source_chain: List[str],
-) -> Optional[Dict[str, Any]]:
-    """Fetch all public fallbacks concurrently; return first success."""
-    sym = _normalize_symbol(symbol)
-    limit = max(1, min(limit, 500))
-
-    fetchers = [
-        ("binance_vision_klines", _ohlcv_from_binance(sym, timeframe, limit)),
-        ("kucoin_public_candles", _ohlcv_from_kucoin(sym, timeframe, limit)),
-        ("okx_public_candles", _ohlcv_from_okx(sym, timeframe, limit)),
-        ("bybit_public_klines", _ohlcv_from_bybit(sym, timeframe, limit)),
-        ("cryptocompare_histo", _ohlcv_from_cryptocompare(sym, timeframe, limit)),
-    ]
-    for name, _ in fetchers:
-        source_chain.append(name)
-
-    results = await asyncio.gather(*[coro for _, coro in fetchers], return_exceptions=True)
-
-    for (name, _), result in zip(fetchers, results):
-        if isinstance(result, Exception):
-            errors.append(f"{name}: {result}")
-            continue
-        if result and result.get("candles"):
-            return result
-    return None
-
-
-# ──────────────────────────────────────────────
-# Ticker helpers (single price, low-latency)
-# ──────────────────────────────────────────────
-
-async def _ticker_from_binance(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "binance_vision_price",
-        "https://data-api.binance.vision/api/v3/ticker/price",
-        {"symbol": sym["binance"]},
-    )
-    if err or not isinstance(data, dict) or "price" not in data:
-        return None
-    price = float(data["price"])
-    return {"symbol": sym["binance"], "price": price, "source": "binance_vision_price"}
-
-
-async def _ticker_from_kucoin(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "kucoin_ticker",
-        "https://api.kucoin.com/api/v1/market/orderbook/level1",
-        {"symbol": sym["kucoin"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    price_str = (data.get("data") or {}).get("price")
-    if not price_str:
-        return None
-    return {"symbol": sym["binance"], "price": float(price_str), "source": "kucoin_ticker"}
-
-
-async def _ticker_from_okx(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "okx_ticker",
-        "https://www.okx.com/api/v5/market/ticker",
-        {"instId": sym["okx_spot"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = data.get("data") or []
-    if not items:
-        return None
-    price = float(items[0].get("last", 0) or 0)
-    if not price:
-        return None
-    return {"symbol": sym["binance"], "price": price, "source": "okx_ticker"}
-
-
-async def _ticker_from_bybit(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "bybit_ticker",
-        "https://api.bybit.com/v5/market/tickers",
-        {"category": "spot", "symbol": sym["bybit_spot"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = (data.get("result") or {}).get("list") or []
-    if not items:
-        return None
-    price = float(items[0].get("lastPrice", 0) or 0)
-    if not price:
-        return None
-    return {"symbol": sym["binance"], "price": price, "source": "bybit_ticker"}
-
-
-async def _fetch_ticker_parallel(sym: Dict[str, str]) -> Tuple[Optional[Dict[str, Any]], List[str]]:
-    errors: List[str] = []
-    results = await asyncio.gather(
-        _ticker_from_binance(sym),
-        _ticker_from_kucoin(sym),
-        _ticker_from_okx(sym),
-        _ticker_from_bybit(sym),
-        return_exceptions=True,
-    )
-    for r in results:
-        if isinstance(r, Exception):
-            errors.append(str(r))
-            continue
-        if r and r.get("price"):
-            return r, errors
-    return None, errors
-
-
-# ──────────────────────────────────────────────
-# Funding rate helpers
-# ──────────────────────────────────────────────
-
-async def _funding_from_binance(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "binance_funding",
-        "https://fapi.binance.com/fapi/v1/premiumIndex",
-        {"symbol": sym["binance_perp"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    fr = data.get("lastFundingRate")
-    if fr is None:
-        return None
-    return {
-        "symbol": sym["binance"], "fundingRate": float(fr),
-        "nextFundingTime": data.get("nextFundingTime"),
-        "markPrice": float(data.get("markPrice", 0) or 0),
-        "source": "binance_futures",
-    }
-
-
-async def _funding_from_okx(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "okx_funding",
-        "https://www.okx.com/api/v5/public/funding-rate",
-        {"instId": sym["okx_swap"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = data.get("data") or []
-    if not items:
-        return None
-    fr = items[0].get("fundingRate")
-    if fr is None:
-        return None
-    return {
-        "symbol": sym["binance"], "fundingRate": float(fr),
-        "nextFundingTime": items[0].get("nextFundingTime"),
-        "source": "okx_futures",
-    }
-
-
-async def _funding_from_bybit(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "bybit_funding",
-        "https://api.bybit.com/v5/market/tickers",
-        {"category": "linear", "symbol": sym["bybit_perp"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = (data.get("result") or {}).get("list") or []
-    if not items:
-        return None
-    fr = items[0].get("fundingRate")
-    if fr is None:
-        return None
-    return {
-        "symbol": sym["binance"], "fundingRate": float(fr),
-        "nextFundingTime": items[0].get("nextFundingTime"),
-        "markPrice": float(items[0].get("markPrice", 0) or 0),
-        "source": "bybit_futures",
-    }
-
-
-# ──────────────────────────────────────────────
-# Open Interest helpers
-# ──────────────────────────────────────────────
-
-async def _oi_from_binance(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "binance_oi",
-        "https://fapi.binance.com/fapi/v1/openInterest",
-        {"symbol": sym["binance_perp"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    oi = data.get("openInterest")
-    if oi is None:
-        return None
-    return {"symbol": sym["binance"], "openInterest": float(oi), "source": "binance_futures"}
-
-
-async def _oi_from_okx(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "okx_oi",
-        "https://www.okx.com/api/v5/rubik/stat/contracts/open-interest-volume",
-        {"ccy": sym["base"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = data.get("data") or []
-    if not items:
-        return None
-    oi = items[0][1] if len(items[0]) > 1 else None
-    if oi is None:
-        return None
-    return {"symbol": sym["binance"], "openInterest": float(oi), "source": "okx_futures"}
-
-
-async def _oi_from_bybit(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "bybit_oi",
-        "https://api.bybit.com/v5/market/open-interest",
-        {"category": "linear", "symbol": sym["bybit_perp"], "intervalTime": "5min", "limit": "1"},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = (data.get("result") or {}).get("list") or []
-    if not items:
-        return None
-    oi = items[0].get("openInterest")
-    if oi is None:
-        return None
-    return {"symbol": sym["binance"], "openInterest": float(oi), "source": "bybit_futures"}
-
-
-# ──────────────────────────────────────────────
-# API Endpoints
-# ──────────────────────────────────────────────
-
-@router.get("/api/enterprise/status")
-@router.get("/api/hub/status")
-async def enterprise_status() -> Dict[str, Any]:
-    """Enterprise hub status: source contracts, counters, and runtime provider health."""
-    _bump_counter("enterprise_status")
-    online = sum(1 for v in _PROVIDER_HEALTH.values() if v.get("status") == "healthy")
-    degraded = sum(1 for v in _PROVIDER_HEALTH.values() if v.get("status") == "degraded")
-    offline = sum(1 for v in _PROVIDER_HEALTH.values() if v.get("status") == "unavailable")
-    cb_open = [p for p, s in _CB_STATE.items() if s.get("failures", 0) >= CB_THRESHOLD
-               and (_now_ts() - s.get("tripped_at", 0)) < CB_COOLDOWN]
-    return {
-        "status": "ok",
-        "hubRole": "central_single_source_of_truth",
-        "version": "enterprise-data-hub-v3.1",
-        "v4Source": V4_BASE_URL,
-        "contracts": {
-            "ohlcv": "v3.1.normalized.candles",
-            "orderbook": "v3.1.normalized.depth",
-            "volume": "v3.1.normalized.volume24h",
-            "ticker": "v3.1.normalized.price",
-            "multiTicker": "v3.1.normalized.prices[]",
-            "funding": "v3.1.normalized.fundingRate",
-            "openInterest": "v3.1.normalized.openInterest",
-            "news": "v3.1.normalized.news",
-            "sentiment": "v3.1.normalized.sentiment",
-        },
-        "providerHealthSummary": {
-            "online": online, "degraded": degraded,
-            "offline": offline, "tracked": len(_PROVIDER_HEALTH),
-        },
-        "circuitBreakers": {"tripped": cb_open, "threshold": CB_THRESHOLD, "cooldownSec": CB_COOLDOWN},
-        "cacheStats": {"keysHeld": len(_CACHE)},
-        "requestCounters": _REQUEST_COUNTERS,
-        "safety": {"executionAllowed": False, "secretsInSource": False},
-        "timestamp": _now_iso(),
-    }
-
-
-@router.get("/api/enterprise/provider-health")
-@router.get("/api/hub/provider-health")
-async def enterprise_provider_health() -> Dict[str, Any]:
-    _bump_counter("enterprise_provider_health")
-    providers = [
-        {**entry, "avgLatencyMs": _latency_avg(p), "circuitOpen": _cb_is_open(p)}
-        for p, entry in sorted(_PROVIDER_HEALTH.items())
-    ]
-    return {"status": "ok", "providers": providers, "count": len(providers), "timestamp": _now_iso()}
-
-
-@router.get("/api/enterprise/source-contracts")
-@router.get("/api/hub/source-contracts")
-async def enterprise_source_contracts() -> Dict[str, Any]:
-    _bump_counter("enterprise_source_contracts")
-    return {
-        "status": "ok",
-        "schemaVersion": "enterprise-hub-v3.1",
-        "sourcePriority": {
-            "ohlcv": ["v4_source", "binance_vision_klines", "kucoin_public_candles",
-                      "okx_public_candles", "bybit_public_klines", "cryptocompare_histo"],
-            "orderbook": ["v4_source", "binance_vision_depth", "kucoin_public_level2_20",
-                          "okx_orderbook", "bybit_orderbook"],
-            "volume": ["v4_source", "binance_vision_24hr", "kucoin_public_stats",
-                       "okx_ticker", "bybit_ticker"],
-            "ticker": ["binance_vision_price", "kucoin_ticker", "okx_ticker", "bybit_ticker"],
-            "multiTicker": ["binance_vision_price (parallel)"],
-            "funding": ["binance_futures", "okx_futures", "bybit_futures"],
-            "openInterest": ["binance_futures", "okx_futures", "bybit_futures"],
-            "news": ["v4_source", "render_crypto_dt_source", "empty_nonfatal_fallback"],
-            "sentiment": ["v4_source", "alternative_me_fear_greed", "coingecko_sentiment"],
-        },
-        "requiredQualityFields": [
-            "source", "sourceChain", "marketType", "isLive",
-            "isTradable", "executionAllowed", "dataQuality", "errors", "timestamp",
-        ],
-        "timestamp": _now_iso(),
-    }
-
-
-@router.get("/api/enterprise/sync/v4")
-@router.get("/api/hub/sync/v4")
-async def enterprise_v4_sync_probe() -> Dict[str, Any]:
-    """Probe V4 without trusting it blindly. Hub-source drift detection."""
-    _bump_counter("enterprise_v4_sync_probe")
-    probes = [
-        ("health", "/api/health", {}),
-        ("status", "/api/status", {}),
-        ("ohlcv", "/api/ohlcv", {"symbol": "BTC", "timeframe": "1h", "limit": 5}),
-        ("orderbook", "/api/trading/orderbook", {"symbol": "BTC", "depth": 5}),
-        ("volume", "/api/trading/volume", {"symbol": "BTC"}),
-        ("sentiment", "/api/social/sentiment", {"coin": "BTC", "timeframe": "24h"}),
-    ]
-    results = []
-    for name, path, params in probes:
-        start = time.perf_counter()
-        data, err = await _fetch_v4(path, params)
-        latency = round((time.perf_counter() - start) * 1000, 2)
-        results.append({
-            "capability": name, "path": path,
-            "ok": data is not None and not err,
-            "latencyMs": latency, "error": err,
-            "hasData": bool(data),
-            "schemaPreview": sorted(list(data.keys()))[:12] if isinstance(data, dict) else [],
-        })
-    ok_count = sum(1 for r in results if r["ok"])
-    return {
-        "status": "ok" if ok_count >= 4 else "degraded",
-        "v4Source": V4_BASE_URL,
-        "okCount": ok_count, "total": len(results),
-        "results": results, "timestamp": _now_iso(),
-    }
-
-
-# ── OHLCV ──────────────────────────────────────
-
-@router.get("/api/hub/ohlcv")
-@router.get("/api/enterprise/ohlcv")
-async def enterprise_ohlcv(
-    symbol: str = Query("BTC"),
-    timeframe: str = Query("1h"),
-    limit: int = Query(100),
-) -> Dict[str, Any]:
-    _bump_counter("enterprise_ohlcv")
-    cache_key = f"ohlcv:{symbol}:{timeframe}:{limit}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain: List[str] = []
-    sym = _normalize_symbol(symbol)
-    limit = max(1, min(int(limit or 100), 500))
-
-    # 1) V4 first
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/ohlcv", {"symbol": sym["base"], "timeframe": timeframe, "limit": limit})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict):
-        candles = _v4_candles(v4)
-        if candles:
-            payload = {
-                "success": True, "symbol": sym["binance"],
-                "timeframe": timeframe, "candles": candles[-limit:],
-                **_quality_payload(
-                    source="v4_source", source_chain=source_chain, errors=errors,
-                    market_type=v4.get("marketType", "spot"),
-                    is_live=bool(v4.get("isLive", True)),
-                    is_tradable=False,
-                    data_quality="live" if not errors else "partial",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_OHLCV)
-            return payload
-        errors.append("v4_source: no candles in response")
-
-    # 2) Public fallbacks — parallel
-    fallback = await _fallback_ohlcv_parallel(symbol, timeframe, limit, errors, source_chain)
-    if fallback and fallback.get("candles"):
-        payload = {
-            "success": True, "symbol": fallback["symbol"],
-            "timeframe": timeframe, "candles": fallback["candles"],
-            **_quality_payload(
-                source=fallback["source"], source_chain=source_chain, errors=errors,
-                market_type=fallback.get("marketType", "spot"),
-                is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_OHLCV)
-        return payload
-
-    return {
-        "success": False, "symbol": sym["binance"],
-        "timeframe": timeframe, "candles": [],
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Ticker (single price) ──────────────────────
-
-@router.get("/api/hub/ticker")
-@router.get("/api/enterprise/ticker")
-async def enterprise_ticker(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    """Fast price lookup. Parallel across Binance/KuCoin/OKX/ByBit; first wins."""
-    _bump_counter("enterprise_ticker")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"ticker:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain = ["binance_vision_price", "kucoin_ticker", "okx_ticker", "bybit_ticker"]
-
-    # Try V4 first (it may already have a fast price endpoint)
-    v4, err = await _fetch_v4("/api/trading/volume", {"symbol": sym["base"]})
-    if not err and isinstance(v4, dict) and v4.get("price"):
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "price": float(v4["price"]),
-            **_quality_payload(
-                source="v4_source", source_chain=["v4_source"] + source_chain,
-                errors=errors, market_type="spot", is_live=True,
-                is_tradable=False, data_quality="live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_TICKER)
-        return payload
-
-    result, ticker_errors = await _fetch_ticker_parallel(sym)
-    errors.extend(ticker_errors)
-
-    if result:
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "price": result["price"],
-            **_quality_payload(
-                source=result["source"], source_chain=source_chain, errors=errors,
-                market_type="spot", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_TICKER)
-        return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "price": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Multi-Ticker (batch) ───────────────────────
-
-@router.get("/api/hub/multi-ticker")
-@router.get("/api/enterprise/multi-ticker")
-async def enterprise_multi_ticker(symbols: str = Query("BTC,ETH,SOL")) -> Dict[str, Any]:
-    """
-    Batch price fetch. `symbols` is comma-separated, max 20.
-    Uses Binance bulk ticker endpoint first, falls back to parallel individual fetches.
-    """
-    _bump_counter("enterprise_multi_ticker")
-    raw_symbols = [s.strip().upper() for s in symbols.split(",") if s.strip()][:20]
-    if not raw_symbols:
-        return {"success": False, "prices": {}, "errors": ["no symbols provided"], "timestamp": _now_iso()}
-
-    # Try Binance bulk endpoint (most efficient)
-    sym_map = {s: _normalize_symbol(s) for s in raw_symbols}
-    binance_syms = [sym_map[s]["binance"] for s in raw_symbols]
-    bulk_data, err, _ = await _fetch_json(
-        "binance_vision_price_bulk",
-        "https://data-api.binance.vision/api/v3/ticker/price",
-        {},  # No params = all symbols
-    )
-
-    prices: Dict[str, Optional[float]] = {}
-    errors: List[str] = []
-
-    if not err and isinstance(bulk_data, list):
-        bulk_lookup = {item["symbol"]: float(item["price"]) for item in bulk_data if "symbol" in item and "price" in item}
-        for s, sym in sym_map.items():
-            p = bulk_lookup.get(sym["binance"])
-            if p:
-                prices[s] = p
-        missing = [s for s in raw_symbols if s not in prices]
-        if missing:
-            errors.append(f"binance bulk: missing {missing}")
-    else:
-        if err:
-            errors.append(f"binance_vision_price_bulk: {err}")
-        missing = list(raw_symbols)
-
-    # Individual parallel fetch for anything still missing
-    if missing:
-        individual_results = await asyncio.gather(
-            *[_fetch_ticker_parallel(_normalize_symbol(s)) for s in missing],
-            return_exceptions=True,
-        )
-        for sym_str, result in zip(missing, individual_results):
-            if isinstance(result, Exception):
-                errors.append(str(result))
-                prices[sym_str] = None
-            else:
-                ticker, ind_errors = result
-                errors.extend(ind_errors)
-                prices[sym_str] = ticker["price"] if ticker else None
-
-    return {
-        "success": True,
-        "prices": prices,
-        "count": len(prices),
-        "errors": errors,
-        "source": "binance_vision_price_bulk+individual_fallback",
-        "executionAllowed": False,
-        "timestamp": _now_iso(),
-    }
-
-
-# ── Orderbook ──────────────────────────────────
-
-@router.get("/api/hub/orderbook")
-@router.get("/api/enterprise/orderbook")
-async def enterprise_orderbook(
-    symbol: str = Query("BTC"),
-    depth: int = Query(20),
-    limit: Optional[int] = None,
-) -> Dict[str, Any]:
-    _bump_counter("enterprise_orderbook")
-    depth_value = max(1, min(int(limit or depth or 20), 100))
-    errors: List[str] = []
-    source_chain: List[str] = []
-    sym = _normalize_symbol(symbol)
-
-    cache_key = f"ob:{sym['base']}:{depth_value}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    # V4
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/trading/orderbook", {"symbol": sym["base"], "depth": depth_value})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict) and (v4.get("bids") or v4.get("asks")):
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "bids": v4.get("bids", []), "asks": v4.get("asks", []),
-            **_quality_payload(
-                source="v4_source", source_chain=source_chain, errors=errors,
-                market_type=v4.get("marketType", "spot"),
-                is_live=True, is_tradable=False,
-                data_quality="live" if not errors else "partial",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-        return payload
-
-    # Binance Vision
-    source_chain.append("binance_vision_depth")
-    data, err, _ = await _fetch_json(
-        "binance_vision_depth", "https://data-api.binance.vision/api/v3/depth",
-        {"symbol": sym["binance"], "limit": depth_value},
-    )
-    if err:
-        errors.append(f"binance_vision_depth: {err}")
-    elif isinstance(data, dict) and (data.get("bids") or data.get("asks")):
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "bids": [[float(p), float(q)] for p, q in data.get("bids", [])[:depth_value]],
-            "asks": [[float(p), float(q)] for p, q in data.get("asks", [])[:depth_value]],
-            **_quality_payload(
-                source="binance_vision_depth", source_chain=source_chain, errors=errors,
-                market_type="spot", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-        return payload
-
-    # KuCoin
-    source_chain.append("kucoin_public_level2_20")
-    data, err, _ = await _fetch_json(
-        "kucoin_public_level2_20",
-        "https://api.kucoin.com/api/v1/market/orderbook/level2_20",
-        {"symbol": sym["kucoin"]},
-    )
-    if err:
-        errors.append(f"kucoin_public_level2_20: {err}")
-    elif isinstance(data, dict):
-        book = data.get("data") or {}
-        if book.get("bids") or book.get("asks"):
-            payload = {
-                "success": True, "symbol": sym["binance"],
-                "bids": [[float(p), float(q)] for p, q in book.get("bids", [])[:depth_value]],
-                "asks": [[float(p), float(q)] for p, q in book.get("asks", [])[:depth_value]],
-                **_quality_payload(
-                    source="kucoin_public_level2_20", source_chain=source_chain, errors=errors,
-                    market_type="spot", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-            return payload
-
-    # OKX
-    source_chain.append("okx_orderbook")
-    data, err, _ = await _fetch_json(
-        "okx_orderbook",
-        "https://www.okx.com/api/v5/market/books",
-        {"instId": sym["okx_spot"], "sz": str(depth_value)},
-    )
-    if err:
-        errors.append(f"okx_orderbook: {err}")
-    elif isinstance(data, dict):
-        items = data.get("data") or []
-        if items:
-            book = items[0]
-            bids = [[float(r[0]), float(r[1])] for r in (book.get("bids") or [])[:depth_value]]
-            asks = [[float(r[0]), float(r[1])] for r in (book.get("asks") or [])[:depth_value]]
-            if bids or asks:
-                payload = {
-                    "success": True, "symbol": sym["binance"],
-                    "bids": bids, "asks": asks,
-                    **_quality_payload(
-                        source="okx_orderbook", source_chain=source_chain, errors=errors,
-                        market_type="spot", is_live=True, is_tradable=False,
-                        data_quality="partial" if errors else "live",
-                    ),
-                }
-                _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-                return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "bids": [], "asks": [],
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Volume ─────────────────────────────────────
-
-@router.get("/api/hub/volume")
-@router.get("/api/enterprise/volume")
-async def enterprise_volume(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    _bump_counter("enterprise_volume")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"vol:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain: List[str] = []
-
-    # V4
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/trading/volume", {"symbol": sym["base"]})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict) and v4.get("success") and (
-        v4.get("volume") is not None or v4.get("base_volume") is not None
-    ):
-        payload = {
-            **v4,
-            **_quality_payload(
-                source="v4_source", source_chain=source_chain, errors=errors,
-                market_type=v4.get("marketType", "spot"),
-                is_live=True, is_tradable=False,
-                data_quality="live" if not errors else "partial",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-        return payload
-
-    def _parse_24hr(data: Dict[str, Any], src: str) -> Dict[str, Any]:
-        return {
-            "success": True, "symbol": sym["binance"],
-            "price": float(data.get("lastPrice") or data.get("last") or 0),
-            "volume": float(data.get("volume") or data.get("vol") or 0),
-            "base_volume": float(data.get("volume") or data.get("vol") or 0),
-            "quote_volume": float(data.get("quoteVolume") or data.get("volValue") or 0),
-            "change_percent": float(data.get("priceChangePercent") or
-                                    (float(data.get("changeRate", 0)) * 100) or 0),
-            "high": float(data.get("highPrice") or data.get("high") or 0),
-            "low": float(data.get("lowPrice") or data.get("low") or 0),
-            **_quality_payload(
-                source=src, source_chain=source_chain, errors=errors,
-                market_type="spot", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-
-    # Binance Vision 24hr
-    source_chain.append("binance_vision_24hr")
-    data, err, _ = await _fetch_json(
-        "binance_vision_24hr", "https://data-api.binance.vision/api/v3/ticker/24hr",
-        {"symbol": sym["binance"]},
-    )
-    if err:
-        errors.append(f"binance_vision_24hr: {err}")
-    elif isinstance(data, dict) and data.get("lastPrice") is not None:
-        payload = _parse_24hr(data, "binance_vision_24hr")
-        _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-        return payload
-
-    # KuCoin
-    source_chain.append("kucoin_public_stats")
-    data, err, _ = await _fetch_json(
-        "kucoin_public_stats", "https://api.kucoin.com/api/v1/market/stats",
-        {"symbol": sym["kucoin"]},
-    )
-    if err:
-        errors.append(f"kucoin_public_stats: {err}")
-    elif isinstance(data, dict):
-        stats = data.get("data") or {}
-        if stats.get("last") is not None:
-            payload = _parse_24hr(stats, "kucoin_public_stats")
-            _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-            return payload
-
-    # OKX
-    source_chain.append("okx_ticker")
-    data, err, _ = await _fetch_json(
-        "okx_ticker", "https://www.okx.com/api/v5/market/ticker",
-        {"instId": sym["okx_spot"]},
-    )
-    if err:
-        errors.append(f"okx_ticker: {err}")
-    elif isinstance(data, dict):
-        items = data.get("data") or []
-        if items and items[0].get("last"):
-            t = items[0]
-            payload = {
-                "success": True, "symbol": sym["binance"],
-                "price": float(t.get("last", 0)), "volume": float(t.get("vol24h", 0)),
-                "base_volume": float(t.get("vol24h", 0)), "quote_volume": float(t.get("volCcy24h", 0)),
-                "change_percent": 0.0, "high": float(t.get("high24h", 0)), "low": float(t.get("low24h", 0)),
-                **_quality_payload(
-                    source="okx_ticker", source_chain=source_chain, errors=errors,
-                    market_type="spot", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-            return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "price": None, "volume": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Funding Rate ───────────────────────────────
-
-@router.get("/api/hub/funding")
-@router.get("/api/enterprise/funding")
-async def enterprise_funding(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    """
-    Perpetual contract funding rate.
-    Source chain: Binance Futures → OKX Swap → ByBit Linear.
-    """
-    _bump_counter("enterprise_funding")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"funding:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain = ["binance_futures", "okx_futures", "bybit_futures"]
-
-    results = await asyncio.gather(
-        _funding_from_binance(sym),
-        _funding_from_okx(sym),
-        _funding_from_bybit(sym),
-        return_exceptions=True,
-    )
-
-    for r in results:
-        if isinstance(r, Exception):
-            errors.append(str(r))
-            continue
-        if r and r.get("fundingRate") is not None:
-            payload = {
-                "success": True,
-                "symbol": sym["binance"],
-                "fundingRate": r["fundingRate"],
-                "fundingRatePct": round(r["fundingRate"] * 100, 6),
-                "nextFundingTime": r.get("nextFundingTime"),
-                "markPrice": r.get("markPrice"),
-                **_quality_payload(
-                    source=r["source"], source_chain=source_chain, errors=errors,
-                    market_type="perpetual", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_FUNDING)
-            return payload
-
-    return {
-        "success": False, "symbol": sym["binance"],
-        "fundingRate": None, "fundingRatePct": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="perpetual", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Open Interest ──────────────────────────────
-
-@router.get("/api/hub/open-interest")
-@router.get("/api/enterprise/open-interest")
-async def enterprise_open_interest(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    """
-    Perpetual contract open interest.
-    Source chain: Binance Futures → OKX → ByBit.
-    """
-    _bump_counter("enterprise_open_interest")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"oi:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain = ["binance_futures", "okx_futures", "bybit_futures"]
-
-    results = await asyncio.gather(
-        _oi_from_binance(sym),
-        _oi_from_okx(sym),
-        _oi_from_bybit(sym),
-        return_exceptions=True,
-    )
-
-    for r in results:
-        if isinstance(r, Exception):
-            errors.append(str(r))
-            continue
-        if r and r.get("openInterest") is not None:
-            payload = {
-                "success": True,
-                "symbol": sym["binance"],
-                "openInterest": r["openInterest"],
-                **_quality_payload(
-                    source=r["source"], source_chain=source_chain, errors=errors,
-                    market_type="perpetual", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_OI)
-            return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "openInterest": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="perpetual", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── News ───────────────────────────────────────
-
-@router.get("/api/hub/news/{coin}")
-@router.get("/api/enterprise/news/{coin}")
-async def enterprise_news(coin: str, limit: int = Query(5)) -> Dict[str, Any]:
-    _bump_counter("enterprise_news")
-    errors: List[str] = []
-    source_chain: List[str] = []
-    base = _normalize_symbol(coin)["base"].lower()
-    limit = max(1, min(int(limit or 5), 50))
-
-    cache_key = f"news:{base}:{limit}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4(f"/api/news/{base}", {"limit": limit})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict):
-        news = v4.get("news") or v4.get("data") or []
-        if news:
-            payload = {
-                "success": True, "coin": base.upper(),
-                "news": news[:limit], "data": news[:limit], "count": len(news[:limit]),
-                **_quality_payload(
-                    source="v4_source", source_chain=source_chain, errors=errors,
-                    market_type="none", is_live=True, is_tradable=False,
-                    data_quality="live" if not errors else "partial",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_NEWS)
-            return payload
-
-    source_chain.append("render_crypto_dt_source")
-    data, err, _ = await _fetch_json(
-        "render_crypto_dt_source", f"{CRYPTO_DT_SOURCE_URL}/api/v1/rss/feed",
-        {"feed_name": "coindesk", "limit": limit},
-    )
-    if err:
-        errors.append(f"render_crypto_dt_source: {err}")
-    elif isinstance(data, dict):
-        raw_items = data.get("items") or data.get("data") or data.get("news") or []
-        if isinstance(raw_items, list) and raw_items:
-            payload = {
-                "success": True, "coin": base.upper(),
-                "news": raw_items[:limit], "data": raw_items[:limit], "count": len(raw_items[:limit]),
-                **_quality_payload(
-                    source="render_crypto_dt_source", source_chain=source_chain, errors=errors,
-                    market_type="none", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_NEWS)
-            return payload
-
-    return {
-        "success": True, "coin": base.upper(), "news": [], "data": [], "count": 0,
-        **_quality_payload(
-            source="empty_nonfatal_fallback", source_chain=source_chain, errors=errors,
-            market_type="none", is_live=False, is_tradable=False, data_quality="empty",
-        ),
-    }
-
-
-# ── Sentiment ──────────────────────────────────
-
-@router.get("/api/hub/sentiment")
-@router.get("/api/enterprise/sentiment")
-async def enterprise_sentiment(
-    coin: str = Query("BTC"),
-    timeframe: str = Query("24h"),
-) -> Dict[str, Any]:
-    _bump_counter("enterprise_sentiment")
-    errors: List[str] = []
-    source_chain: List[str] = []
-    base = _normalize_symbol(coin)["base"]
-
-    cache_key = f"sentiment:{base}:{timeframe}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    # V4
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/social/sentiment", {"coin": base, "timeframe": timeframe})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict) and v4.get("success"):
-        payload = {
-            **v4,
-            **_quality_payload(
-                source="v4_source", source_chain=source_chain, errors=errors,
-                market_type="none", is_live=True, is_tradable=False,
-                data_quality="live" if not errors else "partial",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_SENTIMENT)
-        return payload
-
-    # Alternative.me Fear & Greed
-    source_chain.append("alternative_me_fear_greed")
-    data, err, _ = await _fetch_json(
-        "alternative_me_fear_greed", "https://api.alternative.me/fng/",
-        {"limit": 1, "format": "json"},
-    )
-    if err:
-        errors.append(f"alternative_me_fear_greed: {err}")
-    if isinstance(data, dict) and data.get("data"):
-        item = data["data"][0]
-        value = float(item.get("value", 50))
-        score = round((value - 50.0) / 50.0, 4)
-        label = item.get("value_classification", "Neutral")
-        payload = {
-            "success": True, "coin": base, "asset": base, "timeframe": timeframe,
-            "sentiment_score": score, "score": score,
-            "fear_greed_index": int(value), "label": label, "sentiment": label.lower(),
-            **_quality_payload(
-                source="alternative_me_fear_greed", source_chain=source_chain, errors=errors,
-                market_type="none", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_SENTIMENT)
-        return payload
-
-    # CoinGecko as final fallback (more stable, rate-limited but public)
-    source_chain.append("coingecko_sentiment")
-    cg_id_map = {"BTC": "bitcoin", "ETH": "ethereum", "SOL": "solana", "BNB": "binancecoin"}
-    cg_id = cg_id_map.get(base, base.lower())
-    data, err, _ = await _fetch_json(
-        "coingecko_sentiment",
-        f"https://api.coingecko.com/api/v3/coins/{cg_id}",
-        {"localization": "false", "tickers": "false", "market_data": "false",
-         "community_data": "true", "developer_data": "false"},
-    )
-    if err:
-        errors.append(f"coingecko_sentiment: {err}")
-    elif isinstance(data, dict):
-        sent_up = data.get("sentiment_votes_up_percentage") or 50.0
-        score = round((float(sent_up) - 50.0) / 50.0, 4)
-        label = "Bullish" if score > 0.1 else ("Bearish" if score < -0.1 else "Neutral")
-        payload = {
-            "success": True, "coin": base, "asset": base, "timeframe": timeframe,
-            "sentiment_score": score, "score": score,
-            "sentiment_votes_up_pct": float(sent_up),
-            "label": label, "sentiment": label.lower(),
-            **_quality_payload(
-                source="coingecko_sentiment", source_chain=source_chain, errors=errors,
-                market_type="none", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_SENTIMENT)
-        return payload
-
-    return {
-        "success": False, "coin": base, "asset": base, "timeframe": timeframe,
-        "sentiment_score": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="none", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }

enterprise_data_hub_v3_data_brain_v4.py

@@ -1,1990 +0,0 @@
-"""
-Enterprise Data Brain v4.0 — Autonomous V4 Supplier + Enterprise Hub
-Central, source-agnostic data mesh layer for HuggingFace crypto Spaces.
-
-Upgrade summary (v3.1 → v3.2):
-──────────────────────────────────────────────────────────────────────
- 11. Peer Bridge Integration  – Bidirectional data exchange with V4.
-                                After every successful external fetch,
-                                data is published to peer_bridge so V4
-                                can pull it, and vice versa.
-                                peer_bridge.peer_data() is checked as
-                                an additional fallback source.
- 12. /api/hub/peer-status     – Live view of peer connection health.
- 13. /api/hub/peer-push       – Manual trigger: push all cached data to V4.
-
-Upgrade summary (v3 → v3.1):
-──────────────────────────────────────────────────────────────────────
-  1. TTL In-Memory Cache      – Per-endpoint configurable TTLs.
-  2. Circuit Breaker          – Skip failing providers automatically.
-  3. Parallel Source Fetching – asyncio.gather; first success wins.
-  4. New Providers            – OKX public API, ByBit public API.
-  5. /api/hub/ticker          – Fast single-price lookup.
-  6. /api/hub/multi-ticker    – Batch price fetch (up to 20 symbols).
-  7. /api/hub/funding         – Perpetual funding rates.
-  8. /api/hub/open-interest   – Open interest.
-  9. CoinGecko sentiment fb   – Stable final fallback for sentiment.
- 10. Richer source contracts  – Lists all endpoints + providers.
-
-Design principles (unchanged):
-  - V2 is the single source of truth / hub.
-  - V4 and public providers are sources, not hard dependencies.
-  - Every response normalized with source, sourceChain, dataQuality,
-    isLive, isTradable, marketType, errors.
-  - No secrets hard-coded; optional keys from env only.
-  - executionAllowed is ALWAYS False.
-──────────────────────────────────────────────────────────────────────
-"""
-from __future__ import annotations
-
-import os
-import time
-import asyncio
-import json
-import hashlib
-from datetime import datetime, timezone
-from typing import Any, Dict, List, Optional, Tuple
-
-import httpx
-from fastapi import APIRouter, Query, Body
-
-router = APIRouter(tags=["Enterprise Data Brain v4.0"])
-
-# ──────────────────────────────────────────────
-# Configuration (all overridable via env)
-# ──────────────────────────────────────────────
-V4_BASE_URL = os.getenv(
-    "V4_SOURCE_BASE_URL",
-    "https://really-amin-datasourceforcryptocurrency-4.hf.space",
-).rstrip("/")
-V2_HUB_BASE_URL = os.getenv(
-    "V2_HUB_BASE_URL",
-    "https://really-amin-datasourceforcryptocurrency-2.hf.space",
-).rstrip("/")
-DATA_BRAIN_ROLE = os.getenv("DATA_BRAIN_ROLE", "v4_supplier").strip().lower()
-DATA_BRAIN_ENABLE_PEER_PUSH = os.getenv("DATA_BRAIN_ENABLE_PEER_PUSH", "false").lower() == "true"
-DATA_BRAIN_SCHEMA_VERSION = os.getenv("DATA_BRAIN_SCHEMA_VERSION", "enterprise-data-brain-v4.0")
-CRYPTO_DT_SOURCE_URL = os.getenv(
-    "CRYPTO_DT_SOURCE_URL",
-    "https://crypto-dt-source.onrender.com",
-).rstrip("/")
-HF_OHLC_DATASET_ID = os.getenv("HF_OHLC_DATASET_ID", "Really-amin/crypto-ohlc-data")
-REQUEST_TIMEOUT = float(os.getenv("ENTERPRISE_HUB_TIMEOUT", "8"))
-MAX_ERROR_SAMPLES = int(os.getenv("ENTERPRISE_HUB_MAX_ERROR_SAMPLES", "40"))
-
-# Cache TTLs (seconds)
-CACHE_TTL_OHLCV = int(os.getenv("CACHE_TTL_OHLCV", "30"))
-CACHE_TTL_TICKER = int(os.getenv("CACHE_TTL_TICKER", "10"))
-CACHE_TTL_ORDERBOOK = int(os.getenv("CACHE_TTL_ORDERBOOK", "5"))
-CACHE_TTL_VOLUME = int(os.getenv("CACHE_TTL_VOLUME", "20"))
-CACHE_TTL_FUNDING = int(os.getenv("CACHE_TTL_FUNDING", "60"))
-CACHE_TTL_OI = int(os.getenv("CACHE_TTL_OI", "30"))
-CACHE_TTL_SENTIMENT = int(os.getenv("CACHE_TTL_SENTIMENT", "300"))
-CACHE_TTL_NEWS = int(os.getenv("CACHE_TTL_NEWS", "120"))
-
-# Circuit breaker: consecutive failures before skipping, and cool-down (s)
-CB_THRESHOLD = int(os.getenv("CB_FAILURE_THRESHOLD", "4"))
-CB_COOLDOWN = float(os.getenv("CB_COOLDOWN_SEC", "120"))
-
-# ──────────────────────────────────────────────
-# Runtime state (process-local, intentional)
-# ──────────────────────────────────────────────
-_PROVIDER_HEALTH: Dict[str, Dict[str, Any]] = {}
-_REQUEST_COUNTERS: Dict[str, int] = {}
-_CACHE: Dict[str, Tuple[float, Any]] = {}  # key → (expiry_ts, payload)
-_CB_STATE: Dict[str, Dict[str, Any]] = {}  # provider → {failures, tripped_at}
-
-# Data Brain runtime memory. Process-local by design for HF Spaces.
-_DATA_BRAIN_STATE: Dict[str, Any] = {
-    "schemaVersion": DATA_BRAIN_SCHEMA_VERSION,
-    "role": DATA_BRAIN_ROLE,
-    "sourceScores": {},
-    "routeHistory": [],
-    "decisionHistory": [],
-    "failurePatterns": {},
-    "anomalySamples": [],
-    "peerEvents": [],
-    "lastGoodByKey": {},
-}
-_PEER_CACHE: Dict[str, Any] = {}
-_PEER_QUEUE: List[Dict[str, Any]] = []
-
-
-# ──────────────────────────────────────────────
-# Timeframe maps
-# ──────────────────────────────────────────────
-TIMEFRAME_MAP_BINANCE = {
-    "1m": "1m", "3m": "3m", "5m": "5m", "15m": "15m", "30m": "30m",
-    "1h": "1h", "2h": "2h", "4h": "4h", "6h": "6h", "8h": "8h", "12h": "12h",
-    "1d": "1d", "3d": "3d", "1w": "1w",
-}
-TIMEFRAME_MAP_KUCOIN = {
-    "1m": "1min", "3m": "3min", "5m": "5min", "15m": "15min", "30m": "30min",
-    "1h": "1hour", "2h": "2hour", "4h": "4hour", "6h": "6hour", "8h": "8hour",
-    "12h": "12hour", "1d": "1day", "1w": "1week",
-}
-TIMEFRAME_MAP_OKX = {
-    "1m": "1m", "3m": "3m", "5m": "5m", "15m": "15m", "30m": "30m",
-    "1h": "1H", "2h": "2H", "4h": "4H", "6h": "6H", "12h": "12H",
-    "1d": "1D", "3d": "3D", "1w": "1W",
-}
-TIMEFRAME_MAP_BYBIT = {
-    "1m": "1", "3m": "3", "5m": "5", "15m": "15", "30m": "30",
-    "1h": "60", "2h": "120", "4h": "240", "6h": "360", "12h": "720",
-    "1d": "D", "1w": "W",
-}
-
-
-# ──────────────────────────────────────────────
-# Helpers
-# ──────────────────────────────────────────────
-
-def _now_iso() -> str:
-    return datetime.now(timezone.utc).isoformat()
-
-
-def _now_ts() -> float:
-    return time.monotonic()
-
-
-def _bump_counter(name: str) -> None:
-    _REQUEST_COUNTERS[name] = _REQUEST_COUNTERS.get(name, 0) + 1
-
-
-# ── Cache ──────────────────────────────────────
-
-def _cache_get(key: str) -> Optional[Any]:
-    entry = _CACHE.get(key)
-    if entry and _now_ts() < entry[0]:
-        return entry[1]
-    return None
-
-
-def _cache_set(key: str, value: Any, ttl: float) -> None:
-    _CACHE[key] = (_now_ts() + ttl, value)
-    try:
-        _brain_observe_cache_write(key, value, ttl)
-    except Exception:
-        pass
-
-
-# ── Circuit Breaker ────────────────────────────
-
-def _cb_is_open(provider: str) -> bool:
-    """Returns True if provider is currently circuit-broken (should be skipped)."""
-    state = _CB_STATE.get(provider)
-    if not state:
-        return False
-    if state["failures"] >= CB_THRESHOLD:
-        if (_now_ts() - state["tripped_at"]) < CB_COOLDOWN:
-            return True
-        # Cool-down elapsed → half-open: reset
-        _CB_STATE[provider] = {"failures": 0, "tripped_at": 0}
-    return False
-
-
-def _cb_record(provider: str, ok: bool) -> None:
-    state = _CB_STATE.setdefault(provider, {"failures": 0, "tripped_at": 0})
-    if ok:
-        state["failures"] = 0
-    else:
-        state["failures"] += 1
-        if state["failures"] >= CB_THRESHOLD:
-            state["tripped_at"] = _now_ts()
-
-
-# ── Provider Health ────────────────────────────
-
-def _record_provider(provider: str, ok: bool, latency_ms: float, error: Optional[str] = None) -> None:
-    entry = _PROVIDER_HEALTH.setdefault(provider, {
-        "provider": provider, "status": "unknown",
-        "successes": 0, "failures": 0,
-        "latencySamples": [], "errorSamples": [],
-        "lastSuccess": None, "lastError": None, "lastChecked": None,
-    })
-    entry["lastChecked"] = _now_iso()
-    samples = entry.setdefault("latencySamples", [])
-    samples.append(round(float(latency_ms), 2))
-    del samples[:-30]
-    if ok:
-        entry["successes"] += 1
-        entry["lastSuccess"] = _now_iso()
-        entry["status"] = "healthy" if entry["failures"] == 0 else "degraded"
-    else:
-        entry["failures"] += 1
-        entry["lastError"] = _now_iso()
-        entry["status"] = "degraded" if entry["successes"] else "unavailable"
-        errors = entry.setdefault("errorSamples", [])
-        if error:
-            errors.append(str(error)[:300])
-            del errors[:-MAX_ERROR_SAMPLES]
-    _cb_record(provider, ok)
-    try:
-        _brain_update_provider_score(provider, ok, latency_ms, error)
-    except Exception:
-        pass
-
-
-def _latency_avg(provider: str) -> Optional[float]:
-    samples = _PROVIDER_HEALTH.get(provider, {}).get("latencySamples", [])
-    if not samples:
-        return None
-    return round(sum(samples) / len(samples), 2)
-
-
-# ── Symbol normalisation ───────────────────────
-
-def _normalize_symbol(symbol: str) -> Dict[str, str]:
-    raw = (symbol or "BTC").strip().upper().replace("_", "-")
-    if raw in ("XBT", "XBTUSDT", "XBT-USDT"):
-        raw = "BTC"
-    for suffix in ("-USDT", "USDT", "-USD", "USD", "-BUSD", "BUSD"):
-        if raw.endswith(suffix) and len(raw) > len(suffix):
-            raw = raw[: -len(suffix)]
-            break
-    raw = raw.replace("-", "")
-    if raw == "XBT":
-        raw = "BTC"
-    base = raw
-    return {
-        "input": symbol,
-        "base": base,
-        "binance": f"{base}USDT",
-        "binance_perp": f"{base}USDT",          # same for Binance perp
-        "kucoin": f"{base}-USDT",
-        "okx_spot": f"{base}-USDT",
-        "okx_swap": f"{base}-USDT-SWAP",
-        "bybit_spot": f"{base}USDT",
-        "bybit_perp": f"{base}USDT",
-        "cc_base": base,
-    }
-
-
-# ── Quality payload ────────────────────────────
-
-def _quality_payload(
-    *, source: str, source_chain: List[str], errors: List[str],
-    market_type: str = "spot", is_live: bool = True,
-    is_tradable: bool = False, data_quality: str = "partial",
-) -> Dict[str, Any]:
-    return {
-        "source": source,
-        "sourceChain": source_chain,
-        "marketType": market_type,
-        "isLive": is_live,
-        "isTradable": is_tradable,
-        "executionAllowed": False,          # always
-        "dataQuality": data_quality,
-        "errors": errors,
-        "timestamp": _now_iso(),
-    }
-
-
-
-# ── Data Brain helpers ─────────────────────────
-
-def _stable_hash(value: Any) -> str:
-    """Small deterministic hash for schema/shape diagnostics."""
-    try:
-        raw = json.dumps(value, sort_keys=True, default=str)[:12000]
-    except Exception:
-        raw = str(value)[:12000]
-    return hashlib.sha256(raw.encode("utf-8", errors="ignore")).hexdigest()[:16]
-
-
-def _brain_provider_score(provider: str) -> float:
-    item = _DATA_BRAIN_STATE["sourceScores"].get(provider) or {}
-    return float(item.get("score", 1.0))
-
-
-def _brain_update_provider_score(provider: str, success: bool, latency_ms: float = 0.0, error: Optional[str] = None) -> None:
-    """
-    Adaptive provider scoring.
-    - Rewards stable, low-latency providers.
-    - Penalizes HTTP 451/401/429/5xx and repeated provider failures.
-    """
-    scores = _DATA_BRAIN_STATE.setdefault("sourceScores", {})
-    item = scores.setdefault(provider, {
-        "score": 1.0,
-        "successes": 0,
-        "failures": 0,
-        "lastLatencyMs": None,
-        "lastError": None,
-        "lastUpdate": None,
-    })
-    item["lastLatencyMs"] = round(float(latency_ms or 0), 2)
-    item["lastUpdate"] = _now_iso()
-    if success:
-        item["successes"] += 1
-        # Low-latency wins gently; do not overfit one fast call.
-        latency_bonus = 0.03 if latency_ms and latency_ms < 700 else 0.01
-        item["score"] = min(2.5, float(item.get("score", 1.0)) + latency_bonus)
-        item["lastError"] = None
-    else:
-        item["failures"] += 1
-        item["lastError"] = str(error)[:300] if error else None
-        penalty = 0.08
-        err = str(error or "")
-        if "451" in err:
-            penalty = 0.20
-        elif "401" in err or "403" in err:
-            penalty = 0.18
-        elif "429" in err:
-            penalty = 0.14
-        elif "500" in err or "502" in err or "503" in err:
-            penalty = 0.12
-        item["score"] = max(0.05, float(item.get("score", 1.0)) - penalty)
-        failures = _DATA_BRAIN_STATE.setdefault("failurePatterns", {})
-        failures[provider] = failures.get(provider, 0) + 1
-
-
-def _brain_quality_score(payload: Any) -> float:
-    """Estimate payload usefulness without pretending it is tradable."""
-    if not isinstance(payload, dict):
-        return 0.0
-    if payload.get("success") is False:
-        return 0.05
-    score = 0.35
-    for key in ("candles", "bids", "asks", "news", "data"):
-        val = payload.get(key)
-        if isinstance(val, list) and val:
-            score += min(0.35, len(val) / 300)
-    if payload.get("price") or payload.get("volume") or payload.get("sentiment_score") is not None:
-        score += 0.20
-    if payload.get("errors"):
-        score -= min(0.25, 0.04 * len(payload.get("errors") or []))
-    if payload.get("dataQuality") == "live":
-        score += 0.15
-    elif payload.get("dataQuality") == "empty":
-        score -= 0.30
-    elif payload.get("dataQuality") == "unavailable":
-        score -= 0.50
-    return round(max(0.0, min(1.0, score)), 4)
-
-
-def _brain_observe_cache_write(key: str, payload: Any, ttl: float) -> None:
-    """Every successful hub write updates last-good memory and peer queue."""
-    confidence = _brain_quality_score(payload)
-    record = {
-        "key": key,
-        "confidence": confidence,
-        "ttl": ttl,
-        "schemaHash": _stable_hash(payload),
-        "timestamp": _now_iso(),
-        "payload": payload,
-    }
-    _DATA_BRAIN_STATE.setdefault("lastGoodByKey", {})[key] = record
-    # Keep route history bounded.
-    history = _DATA_BRAIN_STATE.setdefault("routeHistory", [])
-    history.append({k: v for k, v in record.items() if k != "payload"})
-    del history[:-300]
-    # Peer cache: V2/V4 can pull recent normalized payloads.
-    _PEER_CACHE[key] = {k: v for k, v in record.items() if k != "payload"} | {"payload": payload}
-    # Peer push is optional to avoid write loops between V2 and V4.
-    if DATA_BRAIN_ENABLE_PEER_PUSH:
-        _PEER_QUEUE.append({k: v for k, v in record.items() if k != "payload"})
-        del _PEER_QUEUE[:-200]
-
-
-def _brain_decision(route: str, candidates: List[Dict[str, Any]], errors: Optional[List[str]] = None) -> Dict[str, Any]:
-    """
-    Decide which candidate should win based on provider score + payload quality.
-    Candidate shape: {name, payload, latencyMs?}
-    """
-    ranked: List[Dict[str, Any]] = []
-    for c in candidates:
-        payload = c.get("payload")
-        if not payload:
-            continue
-        name = str(c.get("name") or payload.get("source") or "unknown")
-        provider_score = _brain_provider_score(name)
-        payload_score = _brain_quality_score(payload)
-        latency = float(c.get("latencyMs") or 0.0)
-        latency_penalty = min(0.25, latency / 10000) if latency else 0.0
-        total = round((provider_score * 0.35) + (payload_score * 0.75) - latency_penalty, 4)
-        ranked.append({"name": name, "score": total, "payloadScore": payload_score, "providerScore": provider_score})
-    ranked.sort(key=lambda x: x["score"], reverse=True)
-    decision = {
-        "route": route,
-        "winner": ranked[0]["name"] if ranked else None,
-        "ranked": ranked[:8],
-        "errors": (errors or [])[-12:],
-        "timestamp": _now_iso(),
-    }
-    decisions = _DATA_BRAIN_STATE.setdefault("decisionHistory", [])
-    decisions.append(decision)
-    del decisions[:-300]
-    return decision
-
-
-def _brain_enrich(payload: Dict[str, Any], route: str, decision: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-    """Attach Data Brain fields while preserving the original response schema."""
-    if not isinstance(payload, dict):
-        return payload
-    out = dict(payload)
-    out.setdefault("executionAllowed", False)
-    out["executionAllowed"] = False
-    out.setdefault("isTradable", False)
-    out.setdefault("brain", {})
-    out["brain"].update({
-        "version": DATA_BRAIN_SCHEMA_VERSION,
-        "role": DATA_BRAIN_ROLE,
-        "route": route,
-        "confidence": _brain_quality_score(out),
-        "decision": decision or {},
-        "schemaHash": _stable_hash(out),
-        "timestamp": _now_iso(),
-    })
-    return out
-
-
-# ── HTTP helpers ───────────────────────────────
-
-async def _fetch_json(
-    provider: str, url: str,
-    params: Optional[Dict[str, Any]] = None,
-    headers: Optional[Dict[str, str]] = None,
-) -> Tuple[Optional[Any], Optional[str], float]:
-    if _cb_is_open(provider):
-        return None, f"circuit_open:{provider}", 0.0
-    start = time.perf_counter()
-    try:
-        async with httpx.AsyncClient(
-            timeout=REQUEST_TIMEOUT,
-            headers=headers or {"User-Agent": "enterprise-data-hub-v3.1"},
-        ) as client:
-            resp = await client.get(url, params=params)
-            latency_ms = (time.perf_counter() - start) * 1000
-            if resp.status_code >= 400:
-                err = f"HTTP {resp.status_code} from {url}"
-                _record_provider(provider, False, latency_ms, err)
-                return None, err, latency_ms
-            data = resp.json()
-            _record_provider(provider, True, latency_ms)
-            return data, None, latency_ms
-    except Exception as exc:  # noqa: BLE001
-        latency_ms = (time.perf_counter() - start) * 1000
-        err = f"{type(exc).__name__}: {exc}"
-        _record_provider(provider, False, latency_ms, err)
-        return None, err, latency_ms
-
-
-async def _fetch_v4(
-    path: str, params: Optional[Dict[str, Any]] = None,
-) -> Tuple[Optional[Dict[str, Any]], Optional[str]]:
-    data, err, _ = await _fetch_json("v4_source", f"{V4_BASE_URL}{path}", params=params)
-    if data is None:
-        return None, err
-    if not isinstance(data, dict):
-        return None, "v4_source returned non-object JSON"
-    return data, None
-
-
-# ──────────────────────────────────────────────
-# Candle normalisation
-# ──────────────────────────────────────────────
-
-def _norm_candles_binance(rows: List[Any]) -> List[Dict[str, Any]]:
-    out = []
-    for row in rows or []:
-        try:
-            open_time = int(row[0])
-            out.append({
-                "timestamp": open_time, "open_time": open_time,
-                "open": float(row[1]), "high": float(row[2]),
-                "low": float(row[3]), "close": float(row[4]),
-                "volume": float(row[5]),
-                "close_time": int(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return out
-
-
-def _norm_candles_kucoin(rows: List[Any]) -> List[Dict[str, Any]]:
-    out = []
-    for row in rows or []:
-        try:
-            ts_ms = int(float(row[0])) * 1000
-            out.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row[1]), "high": float(row[3]),
-                "low": float(row[4]), "close": float(row[2]),
-                "volume": float(row[5]),
-                "turnover": float(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return sorted(out, key=lambda x: x["timestamp"])
-
-
-def _norm_candles_okx(rows: List[Any]) -> List[Dict[str, Any]]:
-    # OKX: [ts, open, high, low, close, vol, volCcy, volCcyQuote, confirm]
-    out = []
-    for row in rows or []:
-        try:
-            ts_ms = int(row[0])
-            out.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row[1]), "high": float(row[2]),
-                "low": float(row[3]), "close": float(row[4]),
-                "volume": float(row[5]),
-                "quote_volume": float(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return sorted(out, key=lambda x: x["timestamp"])
-
-
-def _norm_candles_bybit(rows: List[Any]) -> List[Dict[str, Any]]:
-    # ByBit: [startTime, openPrice, highPrice, lowPrice, closePrice, volume, turnover]
-    out = []
-    for row in rows or []:
-        try:
-            ts_ms = int(row[0])
-            out.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row[1]), "high": float(row[2]),
-                "low": float(row[3]), "close": float(row[4]),
-                "volume": float(row[5]),
-                "turnover": float(row[6]) if len(row) > 6 else None,
-            })
-        except Exception:
-            continue
-    return sorted(out, key=lambda x: x["timestamp"])
-
-
-def _v4_candles(data: Dict[str, Any]) -> List[Dict[str, Any]]:
-    for key in ("candles", "data", "ohlcv"):
-        candidate = data.get(key)
-        if isinstance(candidate, list) and candidate:
-            return candidate
-    return []
-
-
-# ──────────────────────────────────────────────
-# OHLCV fallback chain (parallel)
-# ──────────────────────────────────────────────
-
-async def _ohlcv_from_binance(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    interval = TIMEFRAME_MAP_BINANCE.get(timeframe, "1h")
-    data, err, _ = await _fetch_json(
-        "binance_vision_klines",
-        "https://data-api.binance.vision/api/v3/klines",
-        {"symbol": sym["binance"], "interval": interval, "limit": limit},
-    )
-    if err or not isinstance(data, list):
-        return None
-    candles = _norm_candles_binance(data)
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles, "source": "binance_vision_klines", "marketType": "spot"}
-
-
-async def _ohlcv_from_kucoin(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    ku_type = TIMEFRAME_MAP_KUCOIN.get(timeframe, "1hour")
-    data, err, _ = await _fetch_json(
-        "kucoin_public_candles",
-        "https://api.kucoin.com/api/v1/market/candles",
-        {"symbol": sym["kucoin"], "type": ku_type},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    rows = data.get("data") or []
-    candles = _norm_candles_kucoin(rows)[:limit]
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles, "source": "kucoin_public_candles", "marketType": "spot"}
-
-
-async def _ohlcv_from_okx(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    bar = TIMEFRAME_MAP_OKX.get(timeframe, "1H")
-    limit_capped = min(limit, 300)
-    data, err, _ = await _fetch_json(
-        "okx_public_candles",
-        "https://www.okx.com/api/v5/market/candles",
-        {"instId": sym["okx_spot"], "bar": bar, "limit": str(limit_capped)},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    rows = data.get("data") or []
-    candles = _norm_candles_okx(rows)
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles[-limit:], "source": "okx_public_candles", "marketType": "spot"}
-
-
-async def _ohlcv_from_bybit(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    interval = TIMEFRAME_MAP_BYBIT.get(timeframe, "60")
-    limit_capped = min(limit, 200)
-    data, err, _ = await _fetch_json(
-        "bybit_public_klines",
-        "https://api.bybit.com/v5/market/kline",
-        {"category": "spot", "symbol": sym["bybit_spot"], "interval": interval, "limit": str(limit_capped)},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    rows = (data.get("result") or {}).get("list") or []
-    candles = _norm_candles_bybit(rows)
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles[-limit:], "source": "bybit_public_klines", "marketType": "spot"}
-
-
-async def _ohlcv_from_cryptocompare(sym: Dict[str, str], timeframe: str, limit: int) -> Optional[Dict[str, Any]]:
-    cc_key = os.getenv("CRYPTOCOMPARE_KEY")
-    cc_params: Dict[str, Any] = {"fsym": sym["cc_base"], "tsym": "USD", "limit": limit, "aggregate": 1}
-    if cc_key:
-        cc_params["api_key"] = cc_key
-    url = ("https://min-api.cryptocompare.com/data/v2/histohour"
-           if timeframe.endswith("h") else "https://min-api.cryptocompare.com/data/v2/histoday")
-    data, err, _ = await _fetch_json("cryptocompare_histo", url, cc_params)
-    if err or not isinstance(data, dict):
-        return None
-    rows = (((data.get("Data") or {}).get("Data")) or [])
-    candles = []
-    for row in rows:
-        try:
-            ts_ms = int(row.get("time", 0)) * 1000
-            candles.append({
-                "timestamp": ts_ms, "open_time": ts_ms,
-                "open": float(row.get("open", 0)), "high": float(row.get("high", 0)),
-                "low": float(row.get("low", 0)), "close": float(row.get("close", 0)),
-                "volume": float(row.get("volumefrom", 0)),
-                "quote_volume": float(row.get("volumeto", 0)),
-            })
-        except Exception:
-            continue
-    if not candles:
-        return None
-    return {"symbol": sym["binance"], "timeframe": timeframe,
-            "candles": candles[-limit:], "source": "cryptocompare_histo", "marketType": "spot"}
-
-
-async def _fallback_ohlcv_parallel(
-    symbol: str, timeframe: str, limit: int,
-    errors: List[str], source_chain: List[str],
-) -> Optional[Dict[str, Any]]:
-    """Fetch all public fallbacks concurrently; return first success."""
-    sym = _normalize_symbol(symbol)
-    limit = max(1, min(limit, 500))
-
-    fetchers = [
-        ("binance_vision_klines", _ohlcv_from_binance(sym, timeframe, limit)),
-        ("kucoin_public_candles", _ohlcv_from_kucoin(sym, timeframe, limit)),
-        ("okx_public_candles", _ohlcv_from_okx(sym, timeframe, limit)),
-        ("bybit_public_klines", _ohlcv_from_bybit(sym, timeframe, limit)),
-        ("cryptocompare_histo", _ohlcv_from_cryptocompare(sym, timeframe, limit)),
-    ]
-    for name, _ in fetchers:
-        source_chain.append(name)
-
-    results = await asyncio.gather(*[coro for _, coro in fetchers], return_exceptions=True)
-
-    for (name, _), result in zip(fetchers, results):
-        if isinstance(result, Exception):
-            errors.append(f"{name}: {result}")
-            continue
-        if result and result.get("candles"):
-            return result
-    return None
-
-
-# ──────────────────────────────────────────────
-# Ticker helpers (single price, low-latency)
-# ──────────────────────────────────────────────
-
-async def _ticker_from_binance(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "binance_vision_price",
-        "https://data-api.binance.vision/api/v3/ticker/price",
-        {"symbol": sym["binance"]},
-    )
-    if err or not isinstance(data, dict) or "price" not in data:
-        return None
-    price = float(data["price"])
-    return {"symbol": sym["binance"], "price": price, "source": "binance_vision_price"}
-
-
-async def _ticker_from_kucoin(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "kucoin_ticker",
-        "https://api.kucoin.com/api/v1/market/orderbook/level1",
-        {"symbol": sym["kucoin"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    price_str = (data.get("data") or {}).get("price")
-    if not price_str:
-        return None
-    return {"symbol": sym["binance"], "price": float(price_str), "source": "kucoin_ticker"}
-
-
-async def _ticker_from_okx(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "okx_ticker",
-        "https://www.okx.com/api/v5/market/ticker",
-        {"instId": sym["okx_spot"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = data.get("data") or []
-    if not items:
-        return None
-    price = float(items[0].get("last", 0) or 0)
-    if not price:
-        return None
-    return {"symbol": sym["binance"], "price": price, "source": "okx_ticker"}
-
-
-async def _ticker_from_bybit(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "bybit_ticker",
-        "https://api.bybit.com/v5/market/tickers",
-        {"category": "spot", "symbol": sym["bybit_spot"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = (data.get("result") or {}).get("list") or []
-    if not items:
-        return None
-    price = float(items[0].get("lastPrice", 0) or 0)
-    if not price:
-        return None
-    return {"symbol": sym["binance"], "price": price, "source": "bybit_ticker"}
-
-
-async def _fetch_ticker_parallel(sym: Dict[str, str]) -> Tuple[Optional[Dict[str, Any]], List[str]]:
-    errors: List[str] = []
-    results = await asyncio.gather(
-        _ticker_from_binance(sym),
-        _ticker_from_kucoin(sym),
-        _ticker_from_okx(sym),
-        _ticker_from_bybit(sym),
-        return_exceptions=True,
-    )
-    for r in results:
-        if isinstance(r, Exception):
-            errors.append(str(r))
-            continue
-        if r and r.get("price"):
-            return r, errors
-    return None, errors
-
-
-# ──────────────────────────────────────────────
-# Funding rate helpers
-# ──────────────────────────────────────────────
-
-async def _funding_from_binance(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "binance_funding",
-        "https://fapi.binance.com/fapi/v1/premiumIndex",
-        {"symbol": sym["binance_perp"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    fr = data.get("lastFundingRate")
-    if fr is None:
-        return None
-    return {
-        "symbol": sym["binance"], "fundingRate": float(fr),
-        "nextFundingTime": data.get("nextFundingTime"),
-        "markPrice": float(data.get("markPrice", 0) or 0),
-        "source": "binance_futures",
-    }
-
-
-async def _funding_from_okx(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "okx_funding",
-        "https://www.okx.com/api/v5/public/funding-rate",
-        {"instId": sym["okx_swap"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = data.get("data") or []
-    if not items:
-        return None
-    fr = items[0].get("fundingRate")
-    if fr is None:
-        return None
-    return {
-        "symbol": sym["binance"], "fundingRate": float(fr),
-        "nextFundingTime": items[0].get("nextFundingTime"),
-        "source": "okx_futures",
-    }
-
-
-async def _funding_from_bybit(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "bybit_funding",
-        "https://api.bybit.com/v5/market/tickers",
-        {"category": "linear", "symbol": sym["bybit_perp"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = (data.get("result") or {}).get("list") or []
-    if not items:
-        return None
-    fr = items[0].get("fundingRate")
-    if fr is None:
-        return None
-    return {
-        "symbol": sym["binance"], "fundingRate": float(fr),
-        "nextFundingTime": items[0].get("nextFundingTime"),
-        "markPrice": float(items[0].get("markPrice", 0) or 0),
-        "source": "bybit_futures",
-    }
-
-
-# ──────────────────────────────────────────────
-# Open Interest helpers
-# ──────────────────────────────────────────────
-
-async def _oi_from_binance(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "binance_oi",
-        "https://fapi.binance.com/fapi/v1/openInterest",
-        {"symbol": sym["binance_perp"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    oi = data.get("openInterest")
-    if oi is None:
-        return None
-    return {"symbol": sym["binance"], "openInterest": float(oi), "source": "binance_futures"}
-
-
-async def _oi_from_okx(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "okx_oi",
-        "https://www.okx.com/api/v5/rubik/stat/contracts/open-interest-volume",
-        {"ccy": sym["base"]},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = data.get("data") or []
-    if not items:
-        return None
-    oi = items[0][1] if len(items[0]) > 1 else None
-    if oi is None:
-        return None
-    return {"symbol": sym["binance"], "openInterest": float(oi), "source": "okx_futures"}
-
-
-async def _oi_from_bybit(sym: Dict[str, str]) -> Optional[Dict[str, Any]]:
-    data, err, _ = await _fetch_json(
-        "bybit_oi",
-        "https://api.bybit.com/v5/market/open-interest",
-        {"category": "linear", "symbol": sym["bybit_perp"], "intervalTime": "5min", "limit": "1"},
-    )
-    if err or not isinstance(data, dict):
-        return None
-    items = (data.get("result") or {}).get("list") or []
-    if not items:
-        return None
-    oi = items[0].get("openInterest")
-    if oi is None:
-        return None
-    return {"symbol": sym["binance"], "openInterest": float(oi), "source": "bybit_futures"}
-
-
-# ──────────────────────────────────────────────
-# API Endpoints
-# ──────────────────────────────────────────────
-
-@router.get("/api/enterprise/status")
-@router.get("/api/hub/status")
-async def enterprise_status() -> Dict[str, Any]:
-    """Enterprise hub status: source contracts, counters, and runtime provider health."""
-    _bump_counter("enterprise_status")
-    online = sum(1 for v in _PROVIDER_HEALTH.values() if v.get("status") == "healthy")
-    degraded = sum(1 for v in _PROVIDER_HEALTH.values() if v.get("status") == "degraded")
-    offline = sum(1 for v in _PROVIDER_HEALTH.values() if v.get("status") == "unavailable")
-    cb_open = [p for p, s in _CB_STATE.items() if s.get("failures", 0) >= CB_THRESHOLD
-               and (_now_ts() - s.get("tripped_at", 0)) < CB_COOLDOWN]
-    return {
-        "status": "ok",
-        "hubRole": "central_single_source_of_truth",
-        "version": "enterprise-data-hub-v3.1",
-        "v4Source": V4_BASE_URL,
-        "contracts": {
-            "ohlcv": "v3.1.normalized.candles",
-            "orderbook": "v3.1.normalized.depth",
-            "volume": "v3.1.normalized.volume24h",
-            "ticker": "v3.1.normalized.price",
-            "multiTicker": "v3.1.normalized.prices[]",
-            "funding": "v3.1.normalized.fundingRate",
-            "openInterest": "v3.1.normalized.openInterest",
-            "news": "v3.1.normalized.news",
-            "sentiment": "v3.1.normalized.sentiment",
-        },
-        "providerHealthSummary": {
-            "online": online, "degraded": degraded,
-            "offline": offline, "tracked": len(_PROVIDER_HEALTH),
-        },
-        "circuitBreakers": {"tripped": cb_open, "threshold": CB_THRESHOLD, "cooldownSec": CB_COOLDOWN},
-        "cacheStats": {"keysHeld": len(_CACHE)},
-        "requestCounters": _REQUEST_COUNTERS,
-        "safety": {"executionAllowed": False, "secretsInSource": False},
-        "timestamp": _now_iso(),
-    }
-
-
-@router.get("/api/enterprise/provider-health")
-@router.get("/api/hub/provider-health")
-async def enterprise_provider_health() -> Dict[str, Any]:
-    _bump_counter("enterprise_provider_health")
-    providers = [
-        {**entry, "avgLatencyMs": _latency_avg(p), "circuitOpen": _cb_is_open(p)}
-        for p, entry in sorted(_PROVIDER_HEALTH.items())
-    ]
-    return {"status": "ok", "providers": providers, "count": len(providers), "timestamp": _now_iso()}
-
-
-@router.get("/api/enterprise/source-contracts")
-@router.get("/api/hub/source-contracts")
-async def enterprise_source_contracts() -> Dict[str, Any]:
-    _bump_counter("enterprise_source_contracts")
-    return {
-        "status": "ok",
-        "schemaVersion": "enterprise-hub-v3.1",
-        "sourcePriority": {
-            "ohlcv": ["v4_source", "binance_vision_klines", "kucoin_public_candles",
-                      "okx_public_candles", "bybit_public_klines", "cryptocompare_histo"],
-            "orderbook": ["v4_source", "binance_vision_depth", "kucoin_public_level2_20",
-                          "okx_orderbook", "bybit_orderbook"],
-            "volume": ["v4_source", "binance_vision_24hr", "kucoin_public_stats",
-                       "okx_ticker", "bybit_ticker"],
-            "ticker": ["binance_vision_price", "kucoin_ticker", "okx_ticker", "bybit_ticker"],
-            "multiTicker": ["binance_vision_price (parallel)"],
-            "funding": ["binance_futures", "okx_futures", "bybit_futures"],
-            "openInterest": ["binance_futures", "okx_futures", "bybit_futures"],
-            "news": ["v4_source", "render_crypto_dt_source", "empty_nonfatal_fallback"],
-            "sentiment": ["v4_source", "alternative_me_fear_greed", "coingecko_sentiment"],
-        },
-        "requiredQualityFields": [
-            "source", "sourceChain", "marketType", "isLive",
-            "isTradable", "executionAllowed", "dataQuality", "errors", "timestamp",
-        ],
-        "timestamp": _now_iso(),
-    }
-
-
-@router.get("/api/enterprise/sync/v4")
-@router.get("/api/hub/sync/v4")
-async def enterprise_v4_sync_probe() -> Dict[str, Any]:
-    """Probe V4 without trusting it blindly. Hub-source drift detection."""
-    _bump_counter("enterprise_v4_sync_probe")
-    probes = [
-        ("health", "/api/health", {}),
-        ("status", "/api/status", {}),
-        ("ohlcv", "/api/ohlcv", {"symbol": "BTC", "timeframe": "1h", "limit": 5}),
-        ("orderbook", "/api/trading/orderbook", {"symbol": "BTC", "depth": 5}),
-        ("volume", "/api/trading/volume", {"symbol": "BTC"}),
-        ("sentiment", "/api/social/sentiment", {"coin": "BTC", "timeframe": "24h"}),
-    ]
-    results = []
-    for name, path, params in probes:
-        start = time.perf_counter()
-        data, err = await _fetch_v4(path, params)
-        latency = round((time.perf_counter() - start) * 1000, 2)
-        results.append({
-            "capability": name, "path": path,
-            "ok": data is not None and not err,
-            "latencyMs": latency, "error": err,
-            "hasData": bool(data),
-            "schemaPreview": sorted(list(data.keys()))[:12] if isinstance(data, dict) else [],
-        })
-    ok_count = sum(1 for r in results if r["ok"])
-    return {
-        "status": "ok" if ok_count >= 4 else "degraded",
-        "v4Source": V4_BASE_URL,
-        "okCount": ok_count, "total": len(results),
-        "results": results, "timestamp": _now_iso(),
-    }
-
-
-# ── OHLCV ──────────────────────────────────────
-
-@router.get("/api/hub/ohlcv")
-@router.get("/api/enterprise/ohlcv")
-async def enterprise_ohlcv(
-    symbol: str = Query("BTC"),
-    timeframe: str = Query("1h"),
-    limit: int = Query(100),
-) -> Dict[str, Any]:
-    _bump_counter("enterprise_ohlcv")
-    cache_key = f"ohlcv:{symbol}:{timeframe}:{limit}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain: List[str] = []
-    sym = _normalize_symbol(symbol)
-    limit = max(1, min(int(limit or 100), 500))
-
-    # 1) V4 first
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/ohlcv", {"symbol": sym["base"], "timeframe": timeframe, "limit": limit})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict):
-        candles = _v4_candles(v4)
-        if candles:
-            payload = {
-                "success": True, "symbol": sym["binance"],
-                "timeframe": timeframe, "candles": candles[-limit:],
-                **_quality_payload(
-                    source="v4_source", source_chain=source_chain, errors=errors,
-                    market_type=v4.get("marketType", "spot"),
-                    is_live=bool(v4.get("isLive", True)),
-                    is_tradable=False,
-                    data_quality="live" if not errors else "partial",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_OHLCV)
-            return payload
-        errors.append("v4_source: no candles in response")
-
-    # 2) Public fallbacks — parallel
-    fallback = await _fallback_ohlcv_parallel(symbol, timeframe, limit, errors, source_chain)
-    if fallback and fallback.get("candles"):
-        payload = {
-            "success": True, "symbol": fallback["symbol"],
-            "timeframe": timeframe, "candles": fallback["candles"],
-            **_quality_payload(
-                source=fallback["source"], source_chain=source_chain, errors=errors,
-                market_type=fallback.get("marketType", "spot"),
-                is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_OHLCV)
-        return payload
-
-    return {
-        "success": False, "symbol": sym["binance"],
-        "timeframe": timeframe, "candles": [],
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Ticker (single price) ──────────────────────
-
-@router.get("/api/hub/ticker")
-@router.get("/api/enterprise/ticker")
-async def enterprise_ticker(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    """Fast price lookup. Parallel across Binance/KuCoin/OKX/ByBit; first wins."""
-    _bump_counter("enterprise_ticker")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"ticker:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain = ["binance_vision_price", "kucoin_ticker", "okx_ticker", "bybit_ticker"]
-
-    # Try V4 first (it may already have a fast price endpoint)
-    v4, err = await _fetch_v4("/api/trading/volume", {"symbol": sym["base"]})
-    if not err and isinstance(v4, dict) and v4.get("price"):
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "price": float(v4["price"]),
-            **_quality_payload(
-                source="v4_source", source_chain=["v4_source"] + source_chain,
-                errors=errors, market_type="spot", is_live=True,
-                is_tradable=False, data_quality="live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_TICKER)
-        return payload
-
-    result, ticker_errors = await _fetch_ticker_parallel(sym)
-    errors.extend(ticker_errors)
-
-    if result:
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "price": result["price"],
-            **_quality_payload(
-                source=result["source"], source_chain=source_chain, errors=errors,
-                market_type="spot", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_TICKER)
-        return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "price": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Multi-Ticker (batch) ───────────────────────
-
-@router.get("/api/hub/multi-ticker")
-@router.get("/api/enterprise/multi-ticker")
-async def enterprise_multi_ticker(symbols: str = Query("BTC,ETH,SOL")) -> Dict[str, Any]:
-    """
-    Batch price fetch. `symbols` is comma-separated, max 20.
-    Uses Binance bulk ticker endpoint first, falls back to parallel individual fetches.
-    """
-    _bump_counter("enterprise_multi_ticker")
-    raw_symbols = [s.strip().upper() for s in symbols.split(",") if s.strip()][:20]
-    if not raw_symbols:
-        return {"success": False, "prices": {}, "errors": ["no symbols provided"], "timestamp": _now_iso()}
-
-    # Try Binance bulk endpoint (most efficient)
-    sym_map = {s: _normalize_symbol(s) for s in raw_symbols}
-    binance_syms = [sym_map[s]["binance"] for s in raw_symbols]
-    bulk_data, err, _ = await _fetch_json(
-        "binance_vision_price_bulk",
-        "https://data-api.binance.vision/api/v3/ticker/price",
-        {},  # No params = all symbols
-    )
-
-    prices: Dict[str, Optional[float]] = {}
-    errors: List[str] = []
-
-    if not err and isinstance(bulk_data, list):
-        bulk_lookup = {item["symbol"]: float(item["price"]) for item in bulk_data if "symbol" in item and "price" in item}
-        for s, sym in sym_map.items():
-            p = bulk_lookup.get(sym["binance"])
-            if p:
-                prices[s] = p
-        missing = [s for s in raw_symbols if s not in prices]
-        if missing:
-            errors.append(f"binance bulk: missing {missing}")
-    else:
-        if err:
-            errors.append(f"binance_vision_price_bulk: {err}")
-        missing = list(raw_symbols)
-
-    # Individual parallel fetch for anything still missing
-    if missing:
-        individual_results = await asyncio.gather(
-            *[_fetch_ticker_parallel(_normalize_symbol(s)) for s in missing],
-            return_exceptions=True,
-        )
-        for sym_str, result in zip(missing, individual_results):
-            if isinstance(result, Exception):
-                errors.append(str(result))
-                prices[sym_str] = None
-            else:
-                ticker, ind_errors = result
-                errors.extend(ind_errors)
-                prices[sym_str] = ticker["price"] if ticker else None
-
-    return {
-        "success": True,
-        "prices": prices,
-        "count": len(prices),
-        "errors": errors,
-        "source": "binance_vision_price_bulk+individual_fallback",
-        "executionAllowed": False,
-        "timestamp": _now_iso(),
-    }
-
-
-# ── Orderbook ──────────────────────────────────
-
-@router.get("/api/hub/orderbook")
-@router.get("/api/enterprise/orderbook")
-async def enterprise_orderbook(
-    symbol: str = Query("BTC"),
-    depth: int = Query(20),
-    limit: Optional[int] = None,
-) -> Dict[str, Any]:
-    _bump_counter("enterprise_orderbook")
-    depth_value = max(1, min(int(limit or depth or 20), 100))
-    errors: List[str] = []
-    source_chain: List[str] = []
-    sym = _normalize_symbol(symbol)
-
-    cache_key = f"ob:{sym['base']}:{depth_value}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    # V4
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/trading/orderbook", {"symbol": sym["base"], "depth": depth_value})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict) and (v4.get("bids") or v4.get("asks")):
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "bids": v4.get("bids", []), "asks": v4.get("asks", []),
-            **_quality_payload(
-                source="v4_source", source_chain=source_chain, errors=errors,
-                market_type=v4.get("marketType", "spot"),
-                is_live=True, is_tradable=False,
-                data_quality="live" if not errors else "partial",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-        return payload
-
-    # Binance Vision
-    source_chain.append("binance_vision_depth")
-    data, err, _ = await _fetch_json(
-        "binance_vision_depth", "https://data-api.binance.vision/api/v3/depth",
-        {"symbol": sym["binance"], "limit": depth_value},
-    )
-    if err:
-        errors.append(f"binance_vision_depth: {err}")
-    elif isinstance(data, dict) and (data.get("bids") or data.get("asks")):
-        payload = {
-            "success": True, "symbol": sym["binance"],
-            "bids": [[float(p), float(q)] for p, q in data.get("bids", [])[:depth_value]],
-            "asks": [[float(p), float(q)] for p, q in data.get("asks", [])[:depth_value]],
-            **_quality_payload(
-                source="binance_vision_depth", source_chain=source_chain, errors=errors,
-                market_type="spot", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-        return payload
-
-    # KuCoin
-    source_chain.append("kucoin_public_level2_20")
-    data, err, _ = await _fetch_json(
-        "kucoin_public_level2_20",
-        "https://api.kucoin.com/api/v1/market/orderbook/level2_20",
-        {"symbol": sym["kucoin"]},
-    )
-    if err:
-        errors.append(f"kucoin_public_level2_20: {err}")
-    elif isinstance(data, dict):
-        book = data.get("data") or {}
-        if book.get("bids") or book.get("asks"):
-            payload = {
-                "success": True, "symbol": sym["binance"],
-                "bids": [[float(p), float(q)] for p, q in book.get("bids", [])[:depth_value]],
-                "asks": [[float(p), float(q)] for p, q in book.get("asks", [])[:depth_value]],
-                **_quality_payload(
-                    source="kucoin_public_level2_20", source_chain=source_chain, errors=errors,
-                    market_type="spot", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-            return payload
-
-    # OKX
-    source_chain.append("okx_orderbook")
-    data, err, _ = await _fetch_json(
-        "okx_orderbook",
-        "https://www.okx.com/api/v5/market/books",
-        {"instId": sym["okx_spot"], "sz": str(depth_value)},
-    )
-    if err:
-        errors.append(f"okx_orderbook: {err}")
-    elif isinstance(data, dict):
-        items = data.get("data") or []
-        if items:
-            book = items[0]
-            bids = [[float(r[0]), float(r[1])] for r in (book.get("bids") or [])[:depth_value]]
-            asks = [[float(r[0]), float(r[1])] for r in (book.get("asks") or [])[:depth_value]]
-            if bids or asks:
-                payload = {
-                    "success": True, "symbol": sym["binance"],
-                    "bids": bids, "asks": asks,
-                    **_quality_payload(
-                        source="okx_orderbook", source_chain=source_chain, errors=errors,
-                        market_type="spot", is_live=True, is_tradable=False,
-                        data_quality="partial" if errors else "live",
-                    ),
-                }
-                _cache_set(cache_key, payload, CACHE_TTL_ORDERBOOK)
-                return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "bids": [], "asks": [],
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Volume ─────────────────────────────────────
-
-@router.get("/api/hub/volume")
-@router.get("/api/enterprise/volume")
-async def enterprise_volume(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    _bump_counter("enterprise_volume")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"vol:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain: List[str] = []
-
-    # V4
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/trading/volume", {"symbol": sym["base"]})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict) and v4.get("success") and (
-        v4.get("volume") is not None or v4.get("base_volume") is not None
-    ):
-        payload = {
-            **v4,
-            **_quality_payload(
-                source="v4_source", source_chain=source_chain, errors=errors,
-                market_type=v4.get("marketType", "spot"),
-                is_live=True, is_tradable=False,
-                data_quality="live" if not errors else "partial",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-        return payload
-
-    def _parse_24hr(data: Dict[str, Any], src: str) -> Dict[str, Any]:
-        return {
-            "success": True, "symbol": sym["binance"],
-            "price": float(data.get("lastPrice") or data.get("last") or 0),
-            "volume": float(data.get("volume") or data.get("vol") or 0),
-            "base_volume": float(data.get("volume") or data.get("vol") or 0),
-            "quote_volume": float(data.get("quoteVolume") or data.get("volValue") or 0),
-            "change_percent": float(data.get("priceChangePercent") or
-                                    (float(data.get("changeRate", 0)) * 100) or 0),
-            "high": float(data.get("highPrice") or data.get("high") or 0),
-            "low": float(data.get("lowPrice") or data.get("low") or 0),
-            **_quality_payload(
-                source=src, source_chain=source_chain, errors=errors,
-                market_type="spot", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-
-    # Binance Vision 24hr
-    source_chain.append("binance_vision_24hr")
-    data, err, _ = await _fetch_json(
-        "binance_vision_24hr", "https://data-api.binance.vision/api/v3/ticker/24hr",
-        {"symbol": sym["binance"]},
-    )
-    if err:
-        errors.append(f"binance_vision_24hr: {err}")
-    elif isinstance(data, dict) and data.get("lastPrice") is not None:
-        payload = _parse_24hr(data, "binance_vision_24hr")
-        _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-        return payload
-
-    # KuCoin
-    source_chain.append("kucoin_public_stats")
-    data, err, _ = await _fetch_json(
-        "kucoin_public_stats", "https://api.kucoin.com/api/v1/market/stats",
-        {"symbol": sym["kucoin"]},
-    )
-    if err:
-        errors.append(f"kucoin_public_stats: {err}")
-    elif isinstance(data, dict):
-        stats = data.get("data") or {}
-        if stats.get("last") is not None:
-            payload = _parse_24hr(stats, "kucoin_public_stats")
-            _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-            return payload
-
-    # OKX
-    source_chain.append("okx_ticker")
-    data, err, _ = await _fetch_json(
-        "okx_ticker", "https://www.okx.com/api/v5/market/ticker",
-        {"instId": sym["okx_spot"]},
-    )
-    if err:
-        errors.append(f"okx_ticker: {err}")
-    elif isinstance(data, dict):
-        items = data.get("data") or []
-        if items and items[0].get("last"):
-            t = items[0]
-            payload = {
-                "success": True, "symbol": sym["binance"],
-                "price": float(t.get("last", 0)), "volume": float(t.get("vol24h", 0)),
-                "base_volume": float(t.get("vol24h", 0)), "quote_volume": float(t.get("volCcy24h", 0)),
-                "change_percent": 0.0, "high": float(t.get("high24h", 0)), "low": float(t.get("low24h", 0)),
-                **_quality_payload(
-                    source="okx_ticker", source_chain=source_chain, errors=errors,
-                    market_type="spot", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_VOLUME)
-            return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "price": None, "volume": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="unknown", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Funding Rate ───────────────────────────────
-
-@router.get("/api/hub/funding")
-@router.get("/api/enterprise/funding")
-async def enterprise_funding(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    """
-    Perpetual contract funding rate.
-    Source chain: Binance Futures → OKX Swap → ByBit Linear.
-    """
-    _bump_counter("enterprise_funding")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"funding:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain = ["binance_futures", "okx_futures", "bybit_futures"]
-
-    results = await asyncio.gather(
-        _funding_from_binance(sym),
-        _funding_from_okx(sym),
-        _funding_from_bybit(sym),
-        return_exceptions=True,
-    )
-
-    for r in results:
-        if isinstance(r, Exception):
-            errors.append(str(r))
-            continue
-        if r and r.get("fundingRate") is not None:
-            payload = {
-                "success": True,
-                "symbol": sym["binance"],
-                "fundingRate": r["fundingRate"],
-                "fundingRatePct": round(r["fundingRate"] * 100, 6),
-                "nextFundingTime": r.get("nextFundingTime"),
-                "markPrice": r.get("markPrice"),
-                **_quality_payload(
-                    source=r["source"], source_chain=source_chain, errors=errors,
-                    market_type="perpetual", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_FUNDING)
-            return payload
-
-    return {
-        "success": False, "symbol": sym["binance"],
-        "fundingRate": None, "fundingRatePct": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="perpetual", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── Open Interest ──────────────────────────────
-
-@router.get("/api/hub/open-interest")
-@router.get("/api/enterprise/open-interest")
-async def enterprise_open_interest(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    """
-    Perpetual contract open interest.
-    Source chain: Binance Futures → OKX → ByBit.
-    """
-    _bump_counter("enterprise_open_interest")
-    sym = _normalize_symbol(symbol)
-    cache_key = f"oi:{sym['base']}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    errors: List[str] = []
-    source_chain = ["binance_futures", "okx_futures", "bybit_futures"]
-
-    results = await asyncio.gather(
-        _oi_from_binance(sym),
-        _oi_from_okx(sym),
-        _oi_from_bybit(sym),
-        return_exceptions=True,
-    )
-
-    for r in results:
-        if isinstance(r, Exception):
-            errors.append(str(r))
-            continue
-        if r and r.get("openInterest") is not None:
-            payload = {
-                "success": True,
-                "symbol": sym["binance"],
-                "openInterest": r["openInterest"],
-                **_quality_payload(
-                    source=r["source"], source_chain=source_chain, errors=errors,
-                    market_type="perpetual", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_OI)
-            return payload
-
-    return {
-        "success": False, "symbol": sym["binance"], "openInterest": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="perpetual", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ── News ───────────────────────────────────────
-
-@router.get("/api/hub/news/{coin}")
-@router.get("/api/enterprise/news/{coin}")
-async def enterprise_news(coin: str, limit: int = Query(5)) -> Dict[str, Any]:
-    _bump_counter("enterprise_news")
-    errors: List[str] = []
-    source_chain: List[str] = []
-    base = _normalize_symbol(coin)["base"].lower()
-    limit = max(1, min(int(limit or 5), 50))
-
-    cache_key = f"news:{base}:{limit}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4(f"/api/news/{base}", {"limit": limit})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict):
-        news = v4.get("news") or v4.get("data") or []
-        if news:
-            payload = {
-                "success": True, "coin": base.upper(),
-                "news": news[:limit], "data": news[:limit], "count": len(news[:limit]),
-                **_quality_payload(
-                    source="v4_source", source_chain=source_chain, errors=errors,
-                    market_type="none", is_live=True, is_tradable=False,
-                    data_quality="live" if not errors else "partial",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_NEWS)
-            return payload
-
-    source_chain.append("render_crypto_dt_source")
-    data, err, _ = await _fetch_json(
-        "render_crypto_dt_source", f"{CRYPTO_DT_SOURCE_URL}/api/v1/rss/feed",
-        {"feed_name": "coindesk", "limit": limit},
-    )
-    if err:
-        errors.append(f"render_crypto_dt_source: {err}")
-    elif isinstance(data, dict):
-        raw_items = data.get("items") or data.get("data") or data.get("news") or []
-        if isinstance(raw_items, list) and raw_items:
-            payload = {
-                "success": True, "coin": base.upper(),
-                "news": raw_items[:limit], "data": raw_items[:limit], "count": len(raw_items[:limit]),
-                **_quality_payload(
-                    source="render_crypto_dt_source", source_chain=source_chain, errors=errors,
-                    market_type="none", is_live=True, is_tradable=False,
-                    data_quality="partial" if errors else "live",
-                ),
-            }
-            _cache_set(cache_key, payload, CACHE_TTL_NEWS)
-            return payload
-
-    return {
-        "success": True, "coin": base.upper(), "news": [], "data": [], "count": 0,
-        **_quality_payload(
-            source="empty_nonfatal_fallback", source_chain=source_chain, errors=errors,
-            market_type="none", is_live=False, is_tradable=False, data_quality="empty",
-        ),
-    }
-
-
-# ── Sentiment ──────────────────────────────────
-
-@router.get("/api/hub/sentiment")
-@router.get("/api/enterprise/sentiment")
-async def enterprise_sentiment(
-    coin: str = Query("BTC"),
-    timeframe: str = Query("24h"),
-) -> Dict[str, Any]:
-    _bump_counter("enterprise_sentiment")
-    errors: List[str] = []
-    source_chain: List[str] = []
-    base = _normalize_symbol(coin)["base"]
-
-    cache_key = f"sentiment:{base}:{timeframe}"
-    cached = _cache_get(cache_key)
-    if cached is not None:
-        return {**cached, "cached": True}
-
-    # V4
-    source_chain.append("v4_source")
-    v4, err = await _fetch_v4("/api/social/sentiment", {"coin": base, "timeframe": timeframe})
-    if err:
-        errors.append(f"v4_source: {err}")
-    elif isinstance(v4, dict) and v4.get("success"):
-        payload = {
-            **v4,
-            **_quality_payload(
-                source="v4_source", source_chain=source_chain, errors=errors,
-                market_type="none", is_live=True, is_tradable=False,
-                data_quality="live" if not errors else "partial",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_SENTIMENT)
-        return payload
-
-    # Alternative.me Fear & Greed
-    source_chain.append("alternative_me_fear_greed")
-    data, err, _ = await _fetch_json(
-        "alternative_me_fear_greed", "https://api.alternative.me/fng/",
-        {"limit": 1, "format": "json"},
-    )
-    if err:
-        errors.append(f"alternative_me_fear_greed: {err}")
-    if isinstance(data, dict) and data.get("data"):
-        item = data["data"][0]
-        value = float(item.get("value", 50))
-        score = round((value - 50.0) / 50.0, 4)
-        label = item.get("value_classification", "Neutral")
-        payload = {
-            "success": True, "coin": base, "asset": base, "timeframe": timeframe,
-            "sentiment_score": score, "score": score,
-            "fear_greed_index": int(value), "label": label, "sentiment": label.lower(),
-            **_quality_payload(
-                source="alternative_me_fear_greed", source_chain=source_chain, errors=errors,
-                market_type="none", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_SENTIMENT)
-        return payload
-
-    # CoinGecko as final fallback (more stable, rate-limited but public)
-    source_chain.append("coingecko_sentiment")
-    cg_id_map = {"BTC": "bitcoin", "ETH": "ethereum", "SOL": "solana", "BNB": "binancecoin"}
-    cg_id = cg_id_map.get(base, base.lower())
-    data, err, _ = await _fetch_json(
-        "coingecko_sentiment",
-        f"https://api.coingecko.com/api/v3/coins/{cg_id}",
-        {"localization": "false", "tickers": "false", "market_data": "false",
-         "community_data": "true", "developer_data": "false"},
-    )
-    if err:
-        errors.append(f"coingecko_sentiment: {err}")
-    elif isinstance(data, dict):
-        sent_up = data.get("sentiment_votes_up_percentage") or 50.0
-        score = round((float(sent_up) - 50.0) / 50.0, 4)
-        label = "Bullish" if score > 0.1 else ("Bearish" if score < -0.1 else "Neutral")
-        payload = {
-            "success": True, "coin": base, "asset": base, "timeframe": timeframe,
-            "sentiment_score": score, "score": score,
-            "sentiment_votes_up_pct": float(sent_up),
-            "label": label, "sentiment": label.lower(),
-            **_quality_payload(
-                source="coingecko_sentiment", source_chain=source_chain, errors=errors,
-                market_type="none", is_live=True, is_tradable=False,
-                data_quality="partial" if errors else "live",
-            ),
-        }
-        _cache_set(cache_key, payload, CACHE_TTL_SENTIMENT)
-        return payload
-
-    return {
-        "success": False, "coin": base, "asset": base, "timeframe": timeframe,
-        "sentiment_score": None,
-        **_quality_payload(
-            source="unavailable", source_chain=source_chain, errors=errors,
-            market_type="none", is_live=False, is_tradable=False, data_quality="unavailable",
-        ),
-    }
-
-
-# ──────────────────────────────────────────────
-# Data Brain v4 direct aliases + peer bridge
-# These routes make the file usable directly inside V4 as a supplier.
-# They intentionally preserve executionAllowed=False.
-# ──────────────���───────────────────────────────
-
-@router.get("/api/data-brain/status")
-async def data_brain_status() -> Dict[str, Any]:
-    _bump_counter("data_brain_status")
-    return {
-        "status": "ok",
-        "version": DATA_BRAIN_SCHEMA_VERSION,
-        "role": DATA_BRAIN_ROLE,
-        "v4Source": V4_BASE_URL,
-        "v2Peer": V2_HUB_BASE_URL,
-        "providersTracked": len(_PROVIDER_HEALTH),
-        "sourceScores": _DATA_BRAIN_STATE.get("sourceScores", {}),
-        "failurePatterns": _DATA_BRAIN_STATE.get("failurePatterns", {}),
-        "recentDecisions": _DATA_BRAIN_STATE.get("decisionHistory", [])[-20:],
-        "lastGoodKeys": list((_DATA_BRAIN_STATE.get("lastGoodByKey") or {}).keys())[-80:],
-        "peer": {"cacheSize": len(_PEER_CACHE), "queueSize": len(_PEER_QUEUE)},
-        "safety": {"executionAllowed": False, "isTradable": False},
-        "timestamp": _now_iso(),
-    }
-
-
-@router.get("/api/hub/peer-status")
-@router.get("/api/enterprise/peer-status")
-@router.get("/api/data-brain/peer-status")
-async def data_brain_peer_status() -> Dict[str, Any]:
-    _bump_counter("data_brain_peer_status")
-    return {
-        "status": "ok",
-        "peerCacheSize": len(_PEER_CACHE),
-        "peerQueueSize": len(_PEER_QUEUE),
-        "recentPeerKeys": list(_PEER_CACHE.keys())[-50:],
-        "recentPeerEvents": _DATA_BRAIN_STATE.get("peerEvents", [])[-50:],
-        "timestamp": _now_iso(),
-    }
-
-
-@router.post("/api/hub/peer-push")
-@router.post("/api/enterprise/peer-push")
-@router.post("/api/data-brain/peer-push")
-async def data_brain_peer_push(payload: Dict[str, Any] = Body(...)) -> Dict[str, Any]:
-    """Manual peer push. V2 or V4 can post normalized payloads here."""
-    _bump_counter("data_brain_peer_push")
-    key = str(payload.get("key") or payload.get("route") or payload.get("symbol") or f"peer:{len(_PEER_CACHE)+1}")
-    record = {
-        "key": key,
-        "payload": payload,
-        "confidence": _brain_quality_score(payload),
-        "schemaHash": _stable_hash(payload),
-        "origin": payload.get("origin", "peer"),
-        "timestamp": _now_iso(),
-    }
-    _PEER_CACHE[key] = record
-    events = _DATA_BRAIN_STATE.setdefault("peerEvents", [])
-    events.append({k: v for k, v in record.items() if k != "payload"})
-    del events[:-200]
-    return {"success": True, "stored": True, "key": key, "confidence": record["confidence"], "timestamp": _now_iso()}
-
-
-@router.get("/api/hub/peer-data")
-@router.get("/api/enterprise/peer-data")
-@router.get("/api/data-brain/peer-data")
-async def data_brain_peer_data(key: Optional[str] = Query(None)) -> Dict[str, Any]:
-    _bump_counter("data_brain_peer_data")
-    if key:
-        item = _PEER_CACHE.get(key)
-        return {"success": bool(item), "key": key, "item": item, "timestamp": _now_iso()}
-    return {"success": True, "items": list(_PEER_CACHE.values())[-100:], "count": len(_PEER_CACHE), "timestamp": _now_iso()}
-
-
-# Direct compatibility aliases for V4 consumers. If V4 already has these routes,
-# use install_data_brain(app, replace_existing=True) in the main app to give this
-# Data Brain router priority.
-
-@router.get("/api/ohlcv")
-async def data_brain_direct_ohlcv(
-    symbol: str = Query("BTC"),
-    timeframe: str = Query("1h"),
-    limit: int = Query(100),
-) -> Dict[str, Any]:
-    payload = await enterprise_ohlcv(symbol=symbol, timeframe=timeframe, limit=limit)
-    decision = _brain_decision("/api/ohlcv", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/ohlcv", decision)
-
-
-@router.get("/api/klines")
-@router.get("/api/history")
-async def data_brain_direct_klines(
-    symbol: str = Query("BTC"),
-    timeframe: str = Query("1h"),
-    interval: Optional[str] = Query(None),
-    limit: int = Query(100),
-) -> Dict[str, Any]:
-    tf = interval or timeframe
-    payload = await enterprise_ohlcv(symbol=symbol, timeframe=tf, limit=limit)
-    decision = _brain_decision("/api/klines", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/klines", decision)
-
-
-@router.get("/api/orderbook")
-@router.get("/api/trading/orderbook")
-async def data_brain_direct_orderbook(
-    symbol: str = Query("BTC"),
-    depth: int = Query(20),
-    limit: Optional[int] = None,
-) -> Dict[str, Any]:
-    payload = await enterprise_orderbook(symbol=symbol, depth=depth, limit=limit)
-    decision = _brain_decision("/api/trading/orderbook", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/trading/orderbook", decision)
-
-
-@router.get("/api/volume")
-@router.get("/api/trading/volume")
-async def data_brain_direct_volume(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    payload = await enterprise_volume(symbol=symbol)
-    decision = _brain_decision("/api/trading/volume", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/trading/volume", decision)
-
-
-@router.get("/api/news/{coin}")
-async def data_brain_direct_news(coin: str, limit: int = Query(5)) -> Dict[str, Any]:
-    payload = await enterprise_news(coin=coin, limit=limit)
-    decision = _brain_decision(f"/api/news/{coin}", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, f"/api/news/{coin}", decision)
-
-
-@router.get("/api/social/sentiment")
-@router.get("/api/sentiment")
-async def data_brain_direct_sentiment(
-    coin: str = Query("BTC"),
-    timeframe: str = Query("24h"),
-) -> Dict[str, Any]:
-    payload = await enterprise_sentiment(coin=coin, timeframe=timeframe)
-    decision = _brain_decision("/api/social/sentiment", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/social/sentiment", decision)
-
-
-@router.get("/api/funding")
-@router.get("/api/trading/funding")
-async def data_brain_direct_funding(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    payload = await enterprise_funding(symbol=symbol)
-    decision = _brain_decision("/api/trading/funding", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/trading/funding", decision)
-
-
-@router.get("/api/open-interest")
-@router.get("/api/trading/open-interest")
-async def data_brain_direct_open_interest(symbol: str = Query("BTC")) -> Dict[str, Any]:
-    payload = await enterprise_open_interest(symbol=symbol)
-    decision = _brain_decision("/api/trading/open-interest", [{"name": payload.get("source", "unknown"), "payload": payload}], payload.get("errors", []))
-    return _brain_enrich(payload, "/api/trading/open-interest", decision)
-
-
-def _existing_route_keys(app: Any) -> set:
-    """Return {(METHOD, PATH)} for currently registered FastAPI routes."""
-    keys = set()
-    for route in getattr(app, "routes", []) or []:
-        path = getattr(route, "path", "")
-        methods = getattr(route, "methods", set()) or set()
-        for method in methods:
-            if method not in {"HEAD", "OPTIONS"}:
-                keys.add((method.upper(), path))
-    return keys
-
-
-def _add_router_routes_safely(app: Any, source_router: Any) -> Dict[str, Any]:
-    """
-    Mount only missing routes from this module's router.
-    Existing project routes are preserved to avoid feature loss and duplicate signatures.
-    """
-    existing = _existing_route_keys(app)
-    added: List[str] = []
-    skipped: List[str] = []
-
-    for route in getattr(source_router, "routes", []) or []:
-        path = getattr(route, "path", "")
-        endpoint = getattr(route, "endpoint", None)
-        methods = sorted((getattr(route, "methods", set()) or set()) - {"HEAD", "OPTIONS"})
-        if not path or endpoint is None or not methods:
-            continue
-
-        # If every method/path already exists, skip to preserve native V4 behavior.
-        if all((method.upper(), path) in existing for method in methods):
-            skipped.append(f"{','.join(methods)} {path}")
-            continue
-
-        missing_methods = [m for m in methods if (m.upper(), path) not in existing]
-        if not missing_methods:
-            skipped.append(f"{','.join(methods)} {path}")
-            continue
-
-        app.add_api_route(
-            path,
-            endpoint,
-            methods=missing_methods,
-            name=getattr(route, "name", None),
-            tags=getattr(route, "tags", None),
-            summary=getattr(route, "summary", None),
-            description=getattr(route, "description", None),
-            response_model=getattr(route, "response_model", None),
-            status_code=getattr(route, "status_code", None),
-            dependencies=getattr(route, "dependencies", None),
-        )
-        for method in missing_methods:
-            existing.add((method.upper(), path))
-            added.append(f"{method.upper()} {path}")
-
-    return {"added": added, "skippedExisting": skipped}
-
-
-def install_unified_crypto_platform_v5(app: Any, preserve_existing: bool = True) -> Dict[str, Any]:
-    """
-    Zero-conflict, non-destructive installer for V4.
-
-    Purpose:
-      - preserve all existing V4 features/routes/UI/backends
-      - add missing Data Brain endpoints
-      - add missing Hub endpoints
-      - add missing legacy aliases only if they do not already exist
-      - never remove or override existing routes
-
-    Required routes supported by this module when missing:
-      /api/data-brain/status
-      /api/data-brain/peer-status
-      /api/data-brain/peer-push
-      /api/data-brain/peer-data
-      /api/ohlcv, /api/klines, /api/history
-      /api/orderbook, /api/trading/orderbook
-      /api/volume, /api/trading/volume
-      /api/news/{coin}
-      /api/social/sentiment, /api/sentiment
-      /api/trading/funding, /api/trading/open-interest
-      /api/hub/ohlcv, /api/hub/orderbook, /api/hub/volume
-      /api/hub/news/{coin}, /api/hub/sentiment
-      /api/hub/funding, /api/hub/open-interest
-      /api/hub/provider-health, /api/hub/source-contracts
-    """
-    before = len(getattr(app, "routes", []) or [])
-    result = _add_router_routes_safely(app, router)
-    after = len(getattr(app, "routes", []) or [])
-    report = {
-        "status": "ok",
-        "installer": "UNIFIED_CRYPTO_DATA_PLATFORM_v5_ZERO_CONFLICT",
-        "preserveExisting": preserve_existing,
-        "routesBefore": before,
-        "routesAfter": after,
-        "routesAdded": result["added"],
-        "routesSkippedExisting": result["skippedExisting"],
-        "executionAllowed": False,
-        "timestamp": _now_iso(),
-    }
-    try:
-        print(f"[OK] Unified Crypto Data Platform v5 installed: added={len(result['added'])}, skipped_existing={len(result['skippedExisting'])}")
-    except Exception:
-        pass
-    return report
-
-
-def install_data_brain(app: Any, replace_existing: bool = False) -> Dict[str, Any]:
-    """
-    Backward-compatible installer.
-
-    IMPORTANT: default is now non-destructive. Existing V4 routes are preserved.
-    replace_existing is intentionally ignored for safety unless the caller manually
-    edits this function; this prevents accidental feature loss.
-    """
-    return install_unified_crypto_platform_v5(app, preserve_existing=True)

enterprise_router_v5.py

@@ -1,756 +0,0 @@
-"""
-enterprise_router_v5.py — Zero-Conflict Unified Router (REAL DATA)
-
-Three layers, mounted once on the main FastAPI app:
-  LAYER 1  /api/data-brain/*   -> internal status/sync info (no external calls)
-  LAYER 2  /api/hub/*          -> canonical real-data endpoints (Binance public API)
-  LAYER 3  /api/*              -> legacy paths, kept for backward compatibility,
-                                   simply forward to the hub layer.
-
-Usage (inside api_server_extended.py, AFTER `app = FastAPI(...)`):
-
-    from enterprise_router_v5 import install_zero_conf_router
-    install_zero_conf_router(app)
-
-No extra dependencies are required beyond `httpx` and `fastapi`,
-both of which are already used by api_server_extended.py.
-"""
-
-from __future__ import annotations
-
-import time
-import logging
-from typing import Any, Dict, List, Optional
-
-import httpx
-from fastapi import APIRouter, FastAPI, HTTPException, Query
-
-logger = logging.getLogger(__name__)
-
-# =========================
-# CONFIG
-# =========================
-
-BINANCE_BASE = "https://api.binance.com"
-BINANCE_FAPI = "https://fapi.binance.com"       # USDT-M futures (funding / open interest)
-CRYPTOCOMPARE_BASE = "https://min-api.cryptocompare.com"
-FEAR_GREED_URL = "https://api.alternative.me/fng/"
-
-HTTP_TIMEOUT = 10.0
-
-_START_TIME = time.time()
-
-# ---- Optional API keys (set as HF Space secrets or env vars; .env.extra_providers
-# has working defaults supplied by the project owner) ----
-import os
-
-def _load_env_file(path: str = ".env.extra_providers"):
-    try:
-        with open(path, "r", encoding="utf-8") as f:
-            for line in f:
-                line = line.strip()
-                if not line or line.startswith("#") or "=" not in line:
-                    continue
-                k, v = line.split("=", 1)
-                os.environ.setdefault(k.strip(), v.strip())
-    except FileNotFoundError:
-        pass
-
-_load_env_file()
-
-CMC_API_KEY = os.getenv("COINMARKETCAP_API_KEY", "")
-CMC_API_KEY_2 = os.getenv("COINMARKETCAP_API_KEY_2", "")
-CRYPTOCOMPARE_API_KEY = os.getenv("CRYPTOCOMPARE_API_KEY", "")
-ETHERSCAN_API_KEY = os.getenv("ETHERSCAN_API_KEY", "")
-BSCSCAN_API_KEY = os.getenv("BSCSCAN_API_KEY", "")
-TRONSCAN_API_KEY = os.getenv("TRONSCAN_API_KEY", "")
-NEWSAPI_KEY = os.getenv("NEWSAPI_KEY", "")
-
-# Tiny in-memory cache so a refresh storm on the frontend doesn't turn into
-# a refresh storm on upstream exchanges. {key: (timestamp, data)}
-_CACHE: Dict[str, Any] = {}
-_CACHE_TTL = 5.0  # seconds
-
-
-async def _cached_get(client: httpx.AsyncClient, url: str, params: Optional[dict] = None,
-                       ttl: float = _CACHE_TTL) -> Any:
-    key = f"{url}?{params}"
-    now = time.time()
-    entry = _CACHE.get(key)
-    if entry and (now - entry[0]) < ttl:
-        return entry[1]
-
-    resp = await client.get(url, params=params, timeout=HTTP_TIMEOUT)
-    resp.raise_for_status()
-    data = resp.json()
-    _CACHE[key] = (now, data)
-    return data
-
-
-def _norm_symbol(symbol: str) -> str:
-    """Accepts BTC, BTC-USDT, BTC/USDT, btcusdt -> returns BTCUSDT (Binance style)."""
-    s = symbol.upper().replace("-", "").replace("/", "").replace("_", "")
-    if not s.endswith("USDT") and not s.endswith("USD") and not s.endswith("BTC") and not s.endswith("ETH"):
-        s = s + "USDT"
-    return s
-
-
-# =========================
-# GLOBAL ROUTE REGISTRY (kept for compatibility with v5 spec)
-# =========================
-ROUTE_REGISTRY: Dict[str, Any] = {}
-
-
-def register(route: str):
-    def decorator(fn):
-        if route in ROUTE_REGISTRY:
-            return ROUTE_REGISTRY[route]
-        ROUTE_REGISTRY[route] = fn
-        return fn
-    return decorator
-
-
-# =========================
-# ROUTER LAYERS
-# =========================
-
-data_brain_router = APIRouter(prefix="/api/data-brain", tags=["data-brain"])
-hub_router = APIRouter(prefix="/api/hub", tags=["hub"])
-legacy_router = APIRouter(prefix="/api", tags=["legacy"])
-
-
-# =========================
-# LAYER 1: DATA BRAIN (internal status)
-# =========================
-
-@data_brain_router.get("/status")
-async def brain_status():
-    return {
-        "status": "ok",
-        "layer": "data-brain",
-        "conflict_mode": "zero-conflict",
-        "uptime_seconds": round(time.time() - _START_TIME, 1),
-        "registered_routes": len(ROUTE_REGISTRY),
-    }
-
-
-@data_brain_router.get("/peer-status")
-async def peer_status():
-    # Single-node deployment: no peers configured.
-    return {"peers": 0, "sync": "stable"}
-
-
-@data_brain_router.post("/peer-push")
-async def peer_push(payload: dict):
-    logger.info("peer-push received (no-op, single-node): %s", list(payload.keys()))
-    return {"pushed": True, "note": "single-node deployment, push accepted but not propagated"}
-
-
-@data_brain_router.get("/peer-data")
-async def peer_data():
-    return {"data": []}
-
-
-# =========================
-# LAYER 2: HUB (canonical, real data via Binance public API)
-# =========================
-
-@hub_router.get("/ohlcv")
-async def hub_ohlcv(symbol: str, timeframe: str = "1h", limit: int = 100):
-    """Real OHLCV candles from Binance public REST API."""
-    pair = _norm_symbol(symbol)
-    interval = timeframe
-    limit = max(1, min(limit, 1000))
-
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                f"{BINANCE_BASE}/api/v3/klines",
-                params={"symbol": pair, "interval": interval, "limit": limit},
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Binance klines error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    candles = [
-        {
-            "open_time": row[0],
-            "open": float(row[1]),
-            "high": float(row[2]),
-            "low": float(row[3]),
-            "close": float(row[4]),
-            "volume": float(row[5]),
-            "close_time": row[6],
-        }
-        for row in raw
-    ]
-
-    return {
-        "source": "binance",
-        "symbol": pair,
-        "timeframe": interval,
-        "count": len(candles),
-        "candles": candles,
-    }
-
-
-@hub_router.get("/orderbook")
-async def hub_orderbook(symbol: str, limit: int = 50):
-    pair = _norm_symbol(symbol)
-    limit = max(5, min(limit, 500))
-
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                f"{BINANCE_BASE}/api/v3/depth",
-                params={"symbol": pair, "limit": limit},
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Binance depth error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    return {
-        "source": "binance",
-        "symbol": pair,
-        "bids": [[float(p), float(q)] for p, q in raw.get("bids", [])],
-        "asks": [[float(p), float(q)] for p, q in raw.get("asks", [])],
-        "last_update_id": raw.get("lastUpdateId"),
-    }
-
-
-@hub_router.get("/volume")
-async def hub_volume(symbol: str):
-    pair = _norm_symbol(symbol)
-
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                f"{BINANCE_BASE}/api/v3/ticker/24hr",
-                params={"symbol": pair},
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Binance ticker error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    return {
-        "source": "binance",
-        "symbol": pair,
-        "volume_base": float(raw.get("volume", 0)),
-        "volume_quote": float(raw.get("quoteVolume", 0)),
-        "price_change_percent_24h": float(raw.get("priceChangePercent", 0)),
-        "last_price": float(raw.get("lastPrice", 0)),
-        "high_24h": float(raw.get("highPrice", 0)),
-        "low_24h": float(raw.get("lowPrice", 0)),
-    }
-
-
-@hub_router.get("/news/{coin}")
-async def hub_news(coin: str, limit: int = 20):
-    """Recent news for a coin via CryptoCompare's free news API."""
-    limit = max(1, min(limit, 50))
-
-    params = {"categories": coin.upper(), "excludeCategories": "Sponsored", "lang": "EN"}
-    if CRYPTOCOMPARE_API_KEY:
-        params["api_key"] = CRYPTOCOMPARE_API_KEY
-
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                f"{CRYPTOCOMPARE_BASE}/data/v2/news/",
-                params=params,
-                ttl=60.0,
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"CryptoCompare news error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    items = (raw or {}).get("Data", [])[:limit]
-    news = [
-        {
-            "title": item.get("title"),
-            "url": item.get("url"),
-            "source": item.get("source_info", {}).get("name") or item.get("source"),
-            "published_on": item.get("published_on"),
-            "body": (item.get("body") or "")[:300],
-        }
-        for item in items
-    ]
-
-    return {"source": "cryptocompare", "coin": coin.upper(), "count": len(news), "news": news}
-
-
-@hub_router.get("/social/sentiment")
-@hub_router.get("/sentiment")
-async def hub_sentiment():
-    """Real market sentiment via the Fear & Greed Index (alternative.me)."""
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(client, FEAR_GREED_URL, params={"limit": 1}, ttl=300.0)
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Fear&Greed error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    entry = (raw.get("data") or [{}])[0]
-    value = int(entry.get("value", 50))
-    classification = entry.get("value_classification", "Neutral")
-
-    sentiment = "neutral"
-    if value <= 25:
-        sentiment = "extreme_fear"
-    elif value <= 45:
-        sentiment = "fear"
-    elif value <= 55:
-        sentiment = "neutral"
-    elif value <= 75:
-        sentiment = "greed"
-    else:
-        sentiment = "extreme_greed"
-
-    return {
-        "source": "alternative.me",
-        "sentiment": sentiment,
-        "fear_greed_value": value,
-        "fear_greed_label": classification,
-        "timestamp": entry.get("timestamp"),
-    }
-
-
-@hub_router.get("/trading/funding")
-async def hub_funding(symbol: str = "BTCUSDT"):
-    pair = _norm_symbol(symbol)
-
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                f"{BINANCE_FAPI}/fapi/v1/premiumIndex",
-                params={"symbol": pair},
-                ttl=30.0,
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Binance futures error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    return {
-        "source": "binance_futures",
-        "symbol": pair,
-        "funding_rate": float(raw.get("lastFundingRate", 0)),
-        "next_funding_time": raw.get("nextFundingTime"),
-        "mark_price": float(raw.get("markPrice", 0)),
-    }
-
-
-@hub_router.get("/trading/open-interest")
-async def hub_open_interest(symbol: str = "BTCUSDT"):
-    pair = _norm_symbol(symbol)
-
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                f"{BINANCE_FAPI}/fapi/v1/openInterest",
-                params={"symbol": pair},
-                ttl=30.0,
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Binance futures error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    return {
-        "source": "binance_futures",
-        "symbol": pair,
-        "open_interest": float(raw.get("openInterest", 0)),
-        "time": raw.get("time"),
-    }
-
-
-@hub_router.get("/provider-health")
-async def provider_health():
-    """Lightweight live check of the upstream providers this router depends on."""
-    checks = {
-        "binance_spot": f"{BINANCE_BASE}/api/v3/ping",
-        "binance_futures": f"{BINANCE_FAPI}/fapi/v1/ping",
-        "cryptocompare": f"{CRYPTOCOMPARE_BASE}/data/v2/news/?categories=BTC&lang=EN",
-        "fear_greed": FEAR_GREED_URL,
-    }
-    results: Dict[str, Any] = {}
-    async with httpx.AsyncClient() as client:
-        for name, url in checks.items():
-            t0 = time.time()
-            try:
-                resp = await client.get(url, timeout=5.0)
-                results[name] = {
-                    "status": "online" if resp.status_code < 400 else "degraded",
-                    "status_code": resp.status_code,
-                    "response_time_ms": round((time.time() - t0) * 1000, 1),
-                }
-            except Exception as e:
-                results[name] = {"status": "offline", "error": str(e)}
-
-    overall = "ok" if all(v.get("status") == "online" for v in results.values()) else "degraded"
-    return {"status": overall, "providers": results}
-
-
-@hub_router.get("/market/cmc")
-async def hub_market_cmc(symbol: str = "BTC"):
-    """Live quote from CoinMarketCap (uses configured API key, falls back to key #2)."""
-    if not (CMC_API_KEY or CMC_API_KEY_2):
-        raise HTTPException(status_code=503, detail="CoinMarketCap API key not configured")
-
-    url = "https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest"
-    params = {"symbol": symbol.upper(), "convert": "USD"}
-
-    async with httpx.AsyncClient() as client:
-        last_err = None
-        for key in (CMC_API_KEY, CMC_API_KEY_2):
-            if not key:
-                continue
-            try:
-                resp = await client.get(url, params=params, headers={"X-CMC_PRO_API_KEY": key}, timeout=HTTP_TIMEOUT)
-                if resp.status_code == 200:
-                    raw = resp.json()
-                    coin = (raw.get("data") or {}).get(symbol.upper(), {})
-                    quote = (coin.get("quote") or {}).get("USD", {})
-                    return {
-                        "source": "coinmarketcap",
-                        "symbol": symbol.upper(),
-                        "price_usd": quote.get("price"),
-                        "market_cap_usd": quote.get("market_cap"),
-                        "volume_24h_usd": quote.get("volume_24h"),
-                        "percent_change_24h": quote.get("percent_change_24h"),
-                    }
-                last_err = f"HTTP {resp.status_code}"
-            except httpx.RequestError as e:
-                last_err = str(e)
-
-    raise HTTPException(status_code=502, detail=f"CoinMarketCap error: {last_err}")
-
-
-@hub_router.get("/news/headlines")
-async def hub_news_headlines(query: str = "cryptocurrency", limit: int = 20):
-    """Top headlines via NewsAPI.org (requires NEWSAPI_KEY)."""
-    if not NEWSAPI_KEY:
-        raise HTTPException(status_code=503, detail="NEWSAPI_KEY not configured")
-
-    limit = max(1, min(limit, 50))
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(
-                client,
-                "https://newsapi.org/v2/everything",
-                params={"q": query, "sortBy": "publishedAt", "pageSize": limit, "apiKey": NEWSAPI_KEY},
-                ttl=60.0,
-            )
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"NewsAPI error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    articles = [
-        {"title": a.get("title"), "source": (a.get("source") or {}).get("name"),
-         "url": a.get("url"), "published_at": a.get("publishedAt")}
-        for a in (raw.get("articles") or [])[:limit]
-    ]
-    return {"source": "newsapi", "query": query, "count": len(articles), "articles": articles}
-
-
-@hub_router.get("/chain/balance")
-async def hub_chain_balance(chain: str, address: str):
-    """Native-coin balance for an address on eth / bsc / tron (uses configured explorer keys)."""
-    chain = chain.lower()
-
-    async with httpx.AsyncClient() as client:
-        if chain == "eth":
-            if not ETHERSCAN_API_KEY:
-                raise HTTPException(status_code=503, detail="ETHERSCAN_API_KEY not configured")
-            try:
-                raw = await _cached_get(
-                    client, "https://api.etherscan.io/api",
-                    params={"module": "account", "action": "balance", "address": address,
-                            "tag": "latest", "apikey": ETHERSCAN_API_KEY}, ttl=15.0,
-                )
-            except httpx.RequestError as e:
-                raise HTTPException(status_code=502, detail=str(e))
-            wei = int(raw.get("result", "0") or "0")
-            return {"source": "etherscan", "chain": "eth", "address": address, "balance": wei / 1e18, "unit": "ETH"}
-
-        if chain == "bsc":
-            if not BSCSCAN_API_KEY:
-                raise HTTPException(status_code=503, detail="BSCSCAN_API_KEY not configured")
-            try:
-                raw = await _cached_get(
-                    client, "https://api.bscscan.com/api",
-                    params={"module": "account", "action": "balance", "address": address,
-                            "tag": "latest", "apikey": BSCSCAN_API_KEY}, ttl=15.0,
-                )
-            except httpx.RequestError as e:
-                raise HTTPException(status_code=502, detail=str(e))
-            wei = int(raw.get("result", "0") or "0")
-            return {"source": "bscscan", "chain": "bsc", "address": address, "balance": wei / 1e18, "unit": "BNB"}
-
-        if chain == "tron":
-            try:
-                raw = await _cached_get(
-                    client, "https://apilist.tronscanapi.com/api/accountv2",
-                    params={"address": address}, ttl=15.0,
-                )
-            except httpx.RequestError as e:
-                raise HTTPException(status_code=502, detail=str(e))
-            sun = raw.get("balance", 0)
-            return {"source": "tronscan", "chain": "tron", "address": address, "balance": sun / 1e6, "unit": "TRX"}
-
-        raise HTTPException(status_code=400, detail="chain must be one of: eth, bsc, tron")
-
-
-@hub_router.get("/source-contracts")
-async def source_contracts():
-    return {
-        "contracts": "valid",
-        "providers": {
-            "ohlcv": "binance:/api/v3/klines",
-            "orderbook": "binance:/api/v3/depth",
-            "volume": "binance:/api/v3/ticker/24hr",
-            "news": "cryptocompare:/data/v2/news/",
-            "sentiment": "alternative.me:/fng/",
-            "funding": "binance_futures:/fapi/v1/premiumIndex",
-            "open_interest": "binance_futures:/fapi/v1/openInterest",
-            "defi_price": "defillama:/coins/prices/current/{ids}",
-            "social_reddit": "reddit:/r/cryptocurrency/top.json",
-            "news_rss": "coindesk|cointelegraph rss feeds",
-            "whales": "clankapp:/api",
-            "market_alt": "coinpaprika:/v1/tickers/{id}",
-        },
-    }
-
-
-# =========================
-# EXTRA FREE NO-AUTH RESOURCES (from crypto_resources_unified_2025-11-11.json)
-# =========================
-
-DEFILLAMA_BASE = "https://coins.llama.fi"
-REDDIT_TOP_URL = "https://www.reddit.com/r/cryptocurrency/top.json"
-COINPAPRIKA_BASE = "https://api.coinpaprika.com/v1"
-CLANKAPP_URL = "https://clankapp.com/api/v2/whales"
-
-RSS_FEEDS = {
-    "coindesk": "https://feeds.feedburner.com/CoinDesk",
-    "cointelegraph": "https://cointelegraph.com/rss",
-}
-
-
-@hub_router.get("/defi/price")
-async def hub_defi_price(token: str = Query(..., description="e.g. coingecko:bitcoin or ethereum:0x...")):
-    """Token price via DefiLlama (free, no auth)."""
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(client, f"{DEFILLAMA_BASE}/prices/current/{token}", ttl=30.0)
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"DefiLlama error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    return {"source": "defillama", "token": token, "data": raw.get("coins", {})}
-
-
-@hub_router.get("/social/reddit")
-async def hub_social_reddit(limit: int = 10):
-    """Top posts from r/cryptocurrency (free, no auth)."""
-    limit = max(1, min(limit, 50))
-    async with httpx.AsyncClient(headers={"User-Agent": "crypto-hub/1.0"}) as client:
-        try:
-            raw = await _cached_get(client, REDDIT_TOP_URL, params={"limit": limit, "t": "day"}, ttl=120.0)
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Reddit error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    posts = []
-    for child in (raw.get("data", {}).get("children", []))[:limit]:
-        d = child.get("data", {})
-        posts.append({
-            "title": d.get("title"),
-            "score": d.get("score"),
-            "num_comments": d.get("num_comments"),
-            "url": f"https://reddit.com{d.get('permalink', '')}",
-            "created_utc": d.get("created_utc"),
-        })
-
-    return {"source": "reddit", "subreddit": "cryptocurrency", "count": len(posts), "posts": posts}
-
-
-@hub_router.get("/news/rss")
-async def hub_news_rss(source: str = "coindesk"):
-    """Raw RSS news feed (CoinDesk / CoinTelegraph), free no-auth."""
-    if source not in RSS_FEEDS:
-        raise HTTPException(status_code=400, detail=f"Unknown source. Choose from: {list(RSS_FEEDS)}")
-
-    async with httpx.AsyncClient(follow_redirects=True) as client:
-        try:
-            now = time.time()
-            cache_key = f"rss:{source}"
-            entry = _CACHE.get(cache_key)
-            if entry and (now - entry[0]) < 120.0:
-                xml_text = entry[1]
-            else:
-                resp = await client.get(RSS_FEEDS[source], timeout=HTTP_TIMEOUT)
-                resp.raise_for_status()
-                xml_text = resp.text
-                _CACHE[cache_key] = (now, xml_text)
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"{source} RSS error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    # Minimal RSS parse (avoid extra deps): pull <title> and <link> from <item> blocks
-    import re
-    items = []
-    for block in re.findall(r"<item>(.*?)</item>", xml_text, re.S)[:20]:
-        title_m = re.search(r"<title>(.*?)</title>", block, re.S)
-        link_m = re.search(r"<link>(.*?)</link>", block, re.S)
-        items.append({
-            "title": (title_m.group(1).strip() if title_m else "").replace("<![CDATA[", "").replace("]]>", ""),
-            "link": (link_m.group(1).strip() if link_m else ""),
-        })
-
-    return {"source": source, "count": len(items), "items": items}
-
-
-@hub_router.get("/whales")
-async def hub_whales(limit: int = 20):
-    """Recent large transactions via ClankApp (free, no auth)."""
-    limit = max(1, min(limit, 100))
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(client, CLANKAPP_URL, params={"size": limit}, ttl=30.0)
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"ClankApp error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    return {"source": "clankapp", "count": len(raw) if isinstance(raw, list) else None, "data": raw}
-
-
-@hub_router.get("/market/alt")
-async def hub_market_alt(symbol: str = "btc-bitcoin"):
-    """Fallback market data via Coinpaprika (free, no auth, no Binance dependency).
-
-    `symbol` is a Coinpaprika coin id, e.g. btc-bitcoin, eth-ethereum.
-    """
-    async with httpx.AsyncClient() as client:
-        try:
-            raw = await _cached_get(client, f"{COINPAPRIKA_BASE}/tickers/{symbol}", ttl=15.0)
-        except httpx.HTTPStatusError as e:
-            raise HTTPException(status_code=502, detail=f"Coinpaprika error: {e.response.status_code}")
-        except httpx.RequestError as e:
-            raise HTTPException(status_code=502, detail=f"Upstream request failed: {e}")
-
-    quote = (raw.get("quotes") or {}).get("USD", {})
-    return {
-        "source": "coinpaprika",
-        "id": raw.get("id"),
-        "symbol": raw.get("symbol"),
-        "name": raw.get("name"),
-        "price_usd": quote.get("price"),
-        "volume_24h_usd": quote.get("volume_24h"),
-        "market_cap_usd": quote.get("market_cap"),
-        "percent_change_24h": quote.get("percent_change_24h"),
-    }
-
-
-# =========================
-# LAYER 3: LEGACY (no-break compatibility, forwards to hub layer)
-# =========================
-
-def bind_legacy(app: FastAPI):
-
-    @app.get("/api/ohlcv")
-    async def legacy_ohlcv(symbol: str, timeframe: str = "1h", limit: int = 100):
-        return await hub_ohlcv(symbol, timeframe, limit)
-
-    @app.get("/api/klines")
-    async def legacy_klines(symbol: str, interval: str = "1h", limit: int = 100):
-        result = await hub_ohlcv(symbol, interval, limit)
-        return {"symbol": result["symbol"], "klines": result["candles"]}
-
-    @app.get("/api/history")
-    async def legacy_history(symbol: str, interval: str = "1d", limit: int = 30):
-        result = await hub_ohlcv(symbol, interval, limit)
-        return {"symbol": result["symbol"], "history": result["candles"]}
-
-    @app.get("/api/orderbook")
-    async def legacy_orderbook(symbol: str, limit: int = 50):
-        return await hub_orderbook(symbol, limit)
-
-    @app.get("/api/trading/orderbook")
-    async def legacy_trade_ob(symbol: str, limit: int = 50):
-        return await hub_orderbook(symbol, limit)
-
-    @app.get("/api/volume")
-    async def legacy_volume(symbol: str):
-        return await hub_volume(symbol)
-
-    @app.get("/api/trading/volume")
-    async def legacy_trade_vol(symbol: str):
-        return await hub_volume(symbol)
-
-    @app.get("/api/news/{coin}")
-    async def legacy_news(coin: str, limit: int = 20):
-        return await hub_news(coin, limit)
-
-    @app.get("/api/social/sentiment")
-    async def legacy_sentiment():
-        return await hub_sentiment()
-
-    @app.get("/api/trading/funding")
-    async def legacy_funding(symbol: str = "BTCUSDT"):
-        return await hub_funding(symbol)
-
-    @app.get("/api/trading/open-interest")
-    async def legacy_oi(symbol: str = "BTCUSDT"):
-        return await hub_open_interest(symbol)
-
-
-# =========================
-# INSTALLER (SAFE MOUNT)
-# =========================
-
-def install_zero_conf_router(app: FastAPI):
-    """Mounts data-brain + hub routers and binds legacy compatibility routes.
-
-    Skips any route path that already exists on `app` so this never
-    overrides an existing, more specific implementation
-    (e.g. /api/sentiment already implemented in api_server_extended.py).
-    """
-    existing_paths = {getattr(r, "path", None) for r in app.router.routes}
-
-    for router in (data_brain_router, hub_router):
-        for route in router.routes:
-            full_path = router.prefix + route.path
-            if full_path in existing_paths:
-                logger.info("Skipping already-registered route: %s", full_path)
-                continue
-        app.include_router(router)
-
-    # Legacy routes: only bind ones not already present on the app.
-    legacy_paths_to_check = [
-        "/api/ohlcv", "/api/klines", "/api/history", "/api/orderbook",
-        "/api/trading/orderbook", "/api/volume", "/api/trading/volume",
-        "/api/news/{coin}", "/api/social/sentiment",
-        "/api/trading/funding", "/api/trading/open-interest",
-    ]
-    missing = [p for p in legacy_paths_to_check if p not in existing_paths]
-    if missing:
-        bind_legacy(app)
-
-    print(f"[OK] Zero-Conflict Router v5 installed (real data via Binance/CryptoCompare/Fear&Greed)")

help.html

@@ -1,14 +1,15 @@
 <!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Space 4 · Real Data Guide</title><style>
 :root{color-scheme:dark;--bg:#070b14;--card:#10192abb;--line:#ffffff12;--text:#eff5ff;--muted:#90a2bd;--good:#42e5c6;--warn:#ffbd5b;--bad:#ff6b7d}*{box-sizing:border-box}body{margin:0;background:radial-gradient(circle at 15% 0,#16334b,transparent 28%),var(--bg);color:var(--text);font:15px/1.65 Inter,system-ui}header,main{width:min(1120px,calc(100% - 32px));margin:auto}header{display:flex;justify-content:space-between;align-items:center;padding:24px 0}a{color:#79ddff;text-decoration:none}nav a{margin-left:18px;color:var(--text)}.hero{padding:48px 0 30px}.kicker{color:var(--good);font-size:12px;letter-spacing:.12em;text-transform:uppercase}h1{font-size:clamp(34px,7vw,66px);line-height:1;margin:18px 0}h2{margin-top:50px}p{color:var(--muted)}.matrix{display:grid;grid-template-columns:repeat(3,1fr);gap:12px}.cell,.endpoint,.warning{background:var(--card);border:1px solid var(--line);border-radius:18px;padding:18px}.cell b{display:block}.tag{font-size:11px;padding:5px 8px;border-radius:999px;background:#42e5c61b;color:var(--good)}.tag.warn{color:var(--warn);background:#ffbd5b1b}.tag.bad{color:var(--bad);background:#ff6b7d1b}.warning{border-color:#ffbd5b55}.endpoint{margin:14px 0}.method{font:700 12px ui-monospace;color:var(--good)}code,pre{font-family:ui-monospace,monospace}pre{overflow:auto;background:#050a12;border:1px solid var(--line);padding:15px;border-radius:13px;color:#cce6ff}summary{cursor:pointer}.route-list{display:grid;grid-template-columns:repeat(2,1fr);gap:8px}.route{background:#0c1422;border:1px solid var(--line);border-radius:11px;padding:10px;font:12px ui-monospace}.muted{color:var(--muted)}@media(max-width:760px){.matrix,.route-list{grid-template-columns:1fr}nav{display:none}}
-</style></head><body><header><strong>Datasource 4 · Truthful API Guide</strong><nav><a href="/">Dashboard</a><a href="/data-lab">Data Lab</a><a href="/docs">OpenAPI</a></nav></header><main><section class="hero"><div class="kicker">Canonical compat router · updated 2026-08-25</div><h1>Market history and LIVE snapshots, clearly separated.</h1><p>The compatibility router is the canonical historical path. The Enterprise Data Hub's duplicate aliases remain unregistered. Short Hunter stays a LIVE-only contract.</p></section><div class="warning"><b>Consumer trap</b><p>HTTP 200 is not proof of data. Check <code>success</code>, <code>dataState</code>, <code>coverage.mode</code>, <code>count</code> and array length.</p></div><h2>Coverage matrix</h2><div class="matrix"><div class="cell"><b>OHLCV</b><span class="tag">REAL HISTORICAL</span><p>Binance Vision → Binance → KuCoin → CryptoCompare, with temporal pagination.</p></div><div class="cell"><b>Funding</b><span class="tag">REAL HISTORICAL</span><p>Gate.io provides real funding with about 180 days of retention in the current HF runtime; Binance/Bybit are geo-blocked there.</p></div><div class="cell"><b>Open interest</b><span class="tag warn">180-DAY + FORWARD</span><p>Gate.io supplies the real ~180-day production window plus a daily SQLite cache; Binance/Bybit are geo-blocked from the current HF runtime.</p></div><div class="cell"><b>Fear & Greed</b><span class="tag">REAL HISTORICAL</span><p>Full Alternative.me series.</p></div><div class="cell"><b>News</b><span class="tag warn">FORWARD ONLY</span><p>Authenticated NewsData latest feed; no pre-deployment history.</p></div><div class="cell"><b>Whale flow</b><span class="tag warn">FORWARD ONLY</span><p>Real large native ETH/BNB transfers from public RPC blocks; no owner labels.</p></div></div><h2>Endpoints and verified behavior</h2>
+</style></head><body><header><strong>Datasource 4 · Truthful API Guide</strong><nav><a href="/">Dashboard</a><a href="/data-lab">Data Lab</a><a href="/docs">OpenAPI</a></nav></header><main><section class="hero"><div class="kicker">Live contract guide · updated 2026-08-25</div><h1>Market history and LIVE snapshots, clearly separated.</h1><p>The compatibility router is the canonical historical path. Duplicate Enterprise Data Hub implementations are not part of the production router and have been removed in this cleanup. Short Hunter stays a LIVE-only contract.</p></section><div class="warning"><b>Consumer trap</b><p>HTTP 200 is not proof of data. Check <code>success</code>, <code>dataState</code>, <code>coverage.mode</code>, <code>count</code> and array length.</p></div><h2>Coverage matrix</h2><div class="matrix"><div class="cell"><b>OHLCV</b><span class="tag">REAL HISTORICAL</span><p>Binance Vision → Binance → KuCoin → CryptoCompare, with temporal pagination.</p></div><div class="cell"><b>Funding</b><span class="tag">REAL HISTORICAL</span><p>Gate.io provides real funding with about 180 days of retention in the current HF runtime; Binance/Bybit are geo-blocked there.</p></div><div class="cell"><b>Open interest</b><span class="tag warn">180-DAY + FORWARD</span><p>Gate.io supplies the real ~180-day production window plus a daily SQLite cache; Binance/Bybit are geo-blocked from the current HF runtime.</p></div><div class="cell"><b>Fear & Greed</b><span class="tag">REAL HISTORICAL</span><p>Full Alternative.me series.</p></div><div class="cell"><b>News</b><span class="tag warn">FORWARD ONLY</span><p>Authenticated NewsData latest feed; no pre-deployment history.</p></div><div class="cell"><b>Whale flow</b><span class="tag warn">FORWARD ONLY</span><p>Real large native ETH/BNB transfers from public RPC blocks; no owner labels.</p></div></div><h2>Endpoints and verified behavior</h2>
 <article class="endpoint"><div class="method">GET</div><h3>/api/ohlcv · /api/klines · /api/history</h3><p>Intentional aliases of one implementation. Supports <code>since/start/startTime</code> and <code>end/endTime</code> in milliseconds.</p><pre>curl "$BASE/api/history?symbol=BTCUSDT&amp;interval=4h&amp;start=1640995200000&amp;end=1735689599999&amp;limit=10000"</pre><pre>const body = await fetch(`${base}/api/history?symbol=BTCUSDT&amp;interval=4h&amp;start=${start}&amp;end=${end}&amp;limit=10000`).then(r=&gt;r.json());
 if (!body.success || !body.data.length) throw new Error('history unavailable');</pre><details><summary>Captured response summary</summary><pre>{"success":true,"source":"binance_public","dataState":"REAL","count":6576,"coverage":{"mode":"REAL_HISTORICAL","earliestTimestamp":1640995200000,"latestTimestamp":1735675200000}}</pre></details></article>
-<article class="endpoint"><div class="method">GET / POST</div><h3>/api/apex/funding/{symbol} · /api/apex/open-interest/{symbol} · /api/apex/open-interest-archive/{symbol}</h3><p>Funding is multi-year. OI's live source is limited to 30 days, but startup + daily collection upserts the complete rolling window for <code>APEX_TRACKED_SYMBOLS</code>, deduped by symbol + timestamp. Production history begins at <code>archiveStartedAt</code>; earlier OI cannot be backfilled. <code>/api/apex/coverage</code> distinguishes a mounted <code>/data</code> persistent volume from ephemeral container storage.</p><pre>curl "$BASE/api/apex/funding/BTCUSDT?start=1640995200000&amp;end=1735689599999&amp;limit=20000"
+<article class="endpoint"><div class="method">GET / POST</div><h3>/api/apex/funding/{symbol} · /api/apex/open-interest/{symbol} · /api/apex/open-interest-archive/{symbol}</h3><p>In the current Hugging Face runtime, Binance Futures returns 451 and all tested Bybit domains return 403. Gate.io is the working real-data fallback for Funding and OI, with approximately 180 days of upstream retention. Startup + daily collection upserts the available OI window for <code>APEX_TRACKED_SYMBOLS</code>, deduped by symbol + timestamp. The local archive begins at <code>archiveStartedAt</code>; requests beyond upstream retention cannot be recovered. <code>/api/apex/coverage</code> reports row counts, collector health, and whether storage is persistent or ephemeral.</p><pre>curl "$BASE/api/apex/funding/BTCUSDT?limit=1000"
 curl "$BASE/api/apex/open-interest/BTCUSDT?period=1h&amp;limit=500"
 curl "$BASE/api/apex/open-interest-archive/BTCUSDT?limit=10000"
-curl -X POST "$BASE/api/apex/open-interest/archive/collect?period=1h"</pre><pre>const archivedOI = await fetch(`${base}/api/apex/open-interest-archive/BTCUSDT?limit=10000`).then(r=&gt;r.json());</pre><details><summary>Captured response summaries</summary><pre>funding: {"count":3288,"earliestTimestamp":1640995200006,"latestTimestamp":1735660800000}
-openInterest: {"trackedSymbols":5,"rowsPerSymbol":500,"dedupeKey":["symbol","timestamp"],"secondRunDuplicateRows":0}</pre></details></article>
-<article class="endpoint"><div class="method">GET</div><h3>/api/apex/sentiment/fear-greed?limit=0</h3><p>Full dated Alternative.me history.</p><pre>curl "$BASE/api/apex/sentiment/fear-greed?limit=0"</pre><pre>const sentiment = await fetch(`${base}/api/apex/sentiment/fear-greed?limit=0`).then(r=&gt;r.json());</pre><details><summary>Captured response summary</summary><pre>{"count":3123,"source":"alternative.me","coverage":{"mode":"REAL_HISTORICAL","earliestTimestamp":"1517443200","latestTimestamp":"1787529600"}}</pre></details></article>
+curl -X POST "$BASE/api/apex/open-interest/archive/collect?period=1h"</pre><pre>const archivedOI = await fetch(`${base}/api/apex/open-interest-archive/BTCUSDT?limit=10000`).then(r=&gt;r.json());</pre><details><summary>Current production behavior</summary><pre>funding: source=gateio_futures · retention=about_180_days
+openInterest: source=gateio_futures · archive is CACHED/REAL when rows exist
+storage: EPHEMERAL_LOCAL_DISK (forward archives are not rebuild-safe)</pre></details></article>
+<article class="endpoint"><div class="method">GET</div><h3>/api/apex/sentiment/fear-greed?limit=0</h3><p>Full dated Alternative.me history. Treat the live <code>count</code> and coverage timestamps as authoritative because the series grows daily.</p><pre>curl "$BASE/api/apex/sentiment/fear-greed?limit=0"</pre><pre>const sentiment = await fetch(`${base}/api/apex/sentiment/fear-greed?limit=0`).then(r=&gt;r.json());</pre></article>
 <article class="endpoint"><div class="method">GET</div><h3>/api/short-hunter/snapshot/{symbol}</h3><p>LIVE-only multi-capability snapshot. It is not a replay endpoint and accepts no historical timestamp.</p><pre>curl "$BASE/api/short-hunter/snapshot/BTCUSDT?interval=1h&amp;limit=120"</pre><pre>const snap = await fetch(`${base}/api/short-hunter/snapshot/BTCUSDT`).then(r=&gt;r.json());
 if (snap.sourceMode !== 'LIVE' || snap.dataState !== 'REAL') disableTrading();</pre><details><summary>Contract states</summary><pre>LIVE/REAL = every required component succeeded
 DEGRADED/PARTIAL = some components missing
@@ -22,4 +23,4 @@ BitQuery old/new without token: HTTP 401 · ClankApp: HTTP 403
 DIY live test: 12 ETH blocks, 2,556 transactions, 2 matches ≥50 ETH; 12 BSC blocks, 744 transactions, 0 matches ≥500 BNB
 BitQuery signup: https://ide.bitquery.io (time-limited free trial; paid production plans thereafter)
 Whale source: public_evm_rpc_large_native_transfers; forward-only</pre></details></article>
-<h2>All live routes</h2><p>Generated from the deployed OpenAPI contract.</p><div id="routes" class="route-list"><div class="muted">Loading OpenAPI…</div></div><script>fetch('/openapi.json').then(r=>r.json()).then(j=>{routes.innerHTML=Object.entries(j.paths).flatMap(([p,ops])=>Object.entries(ops).filter(([m])=>['get','post','put','delete','patch'].includes(m)).map(([m,o])=>`<div class="route"><b>${m.toUpperCase()}</b> ${p}<br><span class="muted">${o.summary||o.description?.split('\n')[0]||'Registered endpoint'}</span></div>`)).join('')}).catch(e=>routes.textContent='OpenAPI unavailable: '+e.message)</script></main></body></html>
+<h2>All registered routes</h2><p>Loaded from the current OpenAPI contract and grouped by its real tags.</p><div id="route-sections"><div class="muted">Loading OpenAPI…</div></div><script>const routeRoot=document.getElementById('route-sections');fetch('/openapi.json').then(r=>r.json()).then(j=>{const groups={};Object.entries(j.paths).forEach(([p,ops])=>Object.entries(ops).filter(([m])=>['get','post','put','delete','patch'].includes(m)).forEach(([m,o])=>{const tag=(o.tags||['Other'])[0];(groups[tag]??=[]).push([m,p,o])}));routeRoot.innerHTML=Object.entries(groups).map(([tag,items])=>`<section><h3>${tag} <span class="muted">(${items.length})</span></h3><div class="route-list">${items.map(([m,p,o])=>`<div class="route"><b>${m.toUpperCase()}</b> ${p}<br><span class="muted">${o.summary||o.description?.split('\n')[0]||'Registered endpoint'}</span></div>`).join('')}</div></section>`).join('')}).catch(e=>routeRoot.textContent='OpenAPI unavailable: '+e.message)</script></main></body></html>

index.html

@@ -1,922 +1,21 @@
-<!DOCTYPE html>
-<html lang="en" dir="ltr">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0, user-scalable=yes">
-    <meta http-equiv="Permissions-Policy" content="interest-cohort=()">
-    <title>Crypto Intelligence Hub - AI-Powered Data Center</title>
-    
-    <!-- Fonts -->
-    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800;900&display=swap" rel="stylesheet">
-    <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
-    
-    <!-- Charts -->
-    <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>
-    
-    <!-- Styles -->
-    <link rel="stylesheet" href="/static/css/main.css?v=10">
-    <link rel="stylesheet" href="/static/css/toast.css?v=10">
-    <script src="/static/js/api-resource-loader.js?v=10" defer></script>
-    <script src="/static/js/trading-pairs-loader.js?v=10" defer></script>
-    <script src="/static/js/toast.js?v=10" defer></script>
-    <script src="/static/js/app.js?v=10" defer></script>
-    
-    <!-- Favicon -->
-    <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>🚀</text></svg>">
-</head>
-<body>
-    <!-- Toast Container -->
-    <div class="toast-container" id="toast-container"></div>
-    
-    <div class="app-layout">
-        <!-- Sidebar Navigation -->
-        <aside class="sidebar" id="sidebar">
-            <div class="sidebar-header">
-                <div class="sidebar-logo" onclick="switchTab('dashboard')" style="cursor: pointer;">
-                    <div class="logo-icon">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
-                            <path d="M2 17l10 5 10-5"></path>
-                            <path d="M2 12l10 5 10-5"></path>
-                        </svg>
-                    </div>
-                    <div class="logo-text">
-                        <h1>Crypto Hub</h1>
-                        <p>AI-Powered</p>
-                    </div>
-                </div>
-                <button class="sidebar-toggle-btn" id="sidebar-close" onclick="toggleSidebar()">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <line x1="18" y1="6" x2="6" y2="18"></line>
-                        <line x1="6" y1="6" x2="18" y2="18"></line>
-                    </svg>
-                </button>
-            </div>
-            
-            <nav class="sidebar-nav">
-                <button class="nav-item active" data-tab="dashboard" onclick="switchTab('dashboard')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <line x1="18" y1="20" x2="18" y2="10"></line>
-                        <line x1="12" y1="20" x2="12" y2="4"></line>
-                        <line x1="6" y1="20" x2="6" y2="14"></line>
-                    </svg>
-                    <span>Dashboard</span>
-                </button>
-                <button class="nav-item" data-tab="market" onclick="switchTab('market')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <circle cx="12" cy="12" r="10"></circle>
-                        <path d="M12 6v6l4 2"></path>
-                    </svg>
-                    <span>Market</span>
-                </button>
-                <button class="nav-item" data-tab="models" onclick="switchTab('models')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>
-                        <rect x="7" y="7" width="3" height="3"></rect>
-                        <rect x="14" y="7" width="3" height="3"></rect>
-                        <rect x="7" y="14" width="3" height="3"></rect>
-                        <rect x="14" y="14" width="3" height="3"></rect>
-                    </svg>
-                    <span>AI Models</span>
-                </button>
-                <button class="nav-item" data-tab="sentiment" onclick="switchTab('sentiment')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <path d="M9 11a3 3 0 1 0 6 0 3 3 0 0 0-6 0z"></path>
-                        <path d="M17.5 11a2.5 2.5 0 1 0 5 0 2.5 2.5 0 0 0-5 0z"></path>
-                        <path d="M6.5 11a2.5 2.5 0 1 0 5 0 2.5 2.5 0 0 0-5 0z"></path>
-                    </svg>
-                    <span>Sentiment</span>
-                </button>
-                <button class="nav-item" data-tab="trading-assistant" onclick="switchTab('trading-assistant')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <line x1="12" y1="1" x2="12" y2="23"></line>
-                        <path d="M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6"></path>
-                    </svg>
-                    <span>Trading Signals</span>
-                </button>
-                <button class="nav-item" data-tab="news" onclick="switchTab('news')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"></path>
-                        <path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"></path>
-                        <line x1="9" y1="8" x2="15" y2="8"></line>
-                        <line x1="9" y1="12" x2="15" y2="12"></line>
-                    </svg>
-                    <span>News</span>
-                </button>
-                <button class="nav-item" data-tab="ai-tools" onclick="switchTab('ai-tools')">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
-                        <path d="M2 17l10 5 10-5"></path>
-                        <path d="M2 12l10 5 10-5"></path>
-                        <circle cx="12" cy="12" r="1"></circle>
-                    </svg>
-                    <span>AI Design Tools</span>
-                </button>
-                <div class="nav-section">
-                    <div class="nav-section-header">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"></path>
-                            <path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"></path>
-                            <path d="M9 8h6"></path>
-                            <path d="M9 12h6"></path>
-                        </svg>
-                        <span>Reference</span>
-                    </div>
-                    <div class="nav-section-items">
-                        <button class="nav-item nav-subitem" data-tab="help" onclick="switchTab('help')">
-                            <span>Help / API Reference</span>
-                        </button>
-                    </div>
-                </div>
-                <div class="nav-section">
-                    <div class="nav-section-header">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <circle cx="12" cy="12" r="3"></circle>
-                            <path d="M12 1v6m0 6v6m9-9h-6m-6 0H3m15.364 6.364l-4.243-4.243m-4.242 0L5.636 17.364m12.728 0l-4.243-4.243m-4.242 0L5.636 6.636"></path>
-                        </svg>
-                        <span>Settings</span>
-                    </div>
-                    <div class="nav-section-items">
-                        <button class="nav-item nav-subitem" data-tab="settings" onclick="switchTab('settings')">
-                            <span>⚙️ System Status</span>
-                        </button>
-                        <button class="nav-item nav-subitem" data-tab="diagnostics" onclick="switchTab('diagnostics')">
-                            <span>🔍 Test & Diagnostics</span>
-                        </button>
-                    </div>
-                </div>
-            </nav>
-            
-            <div class="sidebar-footer">
-                <div class="status-indicator">
-                    <span class="status-dot"></span>
-                    <span id="sidebar-status">Gateway initializing...</span>
-                </div>
-                <div class="sidebar-stats">
-                    <div class="stat-mini">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <ellipse cx="12" cy="5" rx="9" ry="3"></ellipse>
-                            <path d="M21 12c0 1.66-4 3-9 3s-9-1.34-9-3"></path>
-                            <path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"></path>
-                        </svg>
-                        <span id="sidebar-resources">-</span>
-                        <small>Resources</small>
-                    </div>
-                    <div class="stat-mini">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <path d="M16 3h5v5"></path>
-                            <path d="M4 20h5"></path>
-                            <path d="M21 3 12 12"></path>
-                            <path d="M15 12a3 3 0 0 0-3 3v2a3 3 0 0 1-3 3"></path>
-                        </svg>
-                        <span id="sidebar-apis">-</span>
-                        <small>APIs</small>
-                    </div>
-                    <div class="stat-mini">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>
-                            <rect x="7" y="7" width="3" height="3"></rect>
-                            <rect x="14" y="7" width="3" height="3"></rect>
-                            <rect x="7" y="14" width="3" height="3"></rect>
-                            <rect x="14" y="14" width="3" height="3"></rect>
-                        </svg>
-                        <span id="sidebar-sources">-</span>
-                        <small>Sources</small>
-                    </div>
-                </div>
-            </div>
-        </aside>
-
-        <!-- Mobile Overlay -->
-        <div class="sidebar-overlay" id="sidebar-overlay" onclick="toggleSidebar()"></div>
-
-        <!-- Main Content Area -->
-        <div class="main-wrapper">
-            <!-- Top Header -->
-            <header class="top-header">
-                <button class="hamburger-btn" id="hamburger-btn" onclick="toggleSidebar()">
-                    <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                        <line x1="3" y1="12" x2="21" y2="12"></line>
-                        <line x1="3" y1="6" x2="21" y2="6"></line>
-                        <line x1="3" y1="18" x2="21" y2="18"></line>
-                    </svg>
-                </button>
-                <div class="header-title">
-                    <h2 id="page-title">Dashboard</h2>
-                    <p id="page-subtitle">System Overview</p>
-                </div>
-                <div class="header-actions">
-                    <button class="icon-btn" onclick="toggleTheme()" title="Toggle Theme">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path>
-                        </svg>
-                    </button>
-                    <button class="icon-btn" onclick="refreshCurrentTab()" title="Refresh">
-                        <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                            <polyline points="23 4 23 10 17 10"></polyline>
-                            <polyline points="1 20 1 14 7 14"></polyline>
-                            <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                        </svg>
-                    </button>
-                </div>
-            </header>
-
-            <!-- Content Area -->
-            <main class="content-area">
-                <!-- Dashboard Tab -->
-                <section id="tab-dashboard" class="tab-panel active">
-                    <div class="stats-grid" id="dashboard-stats">
-                        <div class="stat-card gradient-purple">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <ellipse cx="12" cy="5" rx="9" ry="3"></ellipse>
-                                    <path d="M21 12c0 1.66-4 3-9 3s-9-1.34-9-3"></path>
-                                    <path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"></path>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-value" id="stat-total-resources">-</div>
-                                <div class="stat-label">Total Resources</div>
-                                <div class="stat-trend">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <polyline points="23 6 13.5 15.5 8.5 10.5 1 18"></polyline>
-                                        <polyline points="17 6 23 6 23 12"></polyline>
-                                    </svg>
-                                    Active
-                                </div>
-                            </div>
-                        </div>
-                        <div class="stat-card gradient-green">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"></path>
-                                    <polyline points="22 4 12 14.01 9 11.01"></polyline>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-value" id="stat-free-resources">-</div>
-                                <div class="stat-label">Free Resources</div>
-                                <div class="stat-trend">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"></path>
-                                        <polyline points="22 4 12 14.01 9 11.01"></polyline>
-                                    </svg>
-                                    Available
-                                </div>
-                            </div>
-                        </div>
-                        <div class="stat-card gradient-blue">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>
-                                    <rect x="7" y="7" width="3" height="3"></rect>
-                                    <rect x="14" y="7" width="3" height="3"></rect>
-                                    <rect x="7" y="14" width="3" height="3"></rect>
-                                    <rect x="14" y="14" width="3" height="3"></rect>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-value" id="stat-models">-</div>
-                                <div class="stat-label">AI Models</div>
-                                <div class="stat-trend">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <path d="M9 11a3 3 0 1 0 6 0 3 3 0 0 0-6 0z"></path>
-                                        <path d="M17.5 11a2.5 2.5 0 1 0 5 0 2.5 2.5 0 0 0-5 0z"></path>
-                                        <path d="M6.5 11a2.5 2.5 0 1 0 5 0 2.5 2.5 0 0 0-5 0z"></path>
-                                    </svg>
-                                    Ready
-                                </div>
-                            </div>
-                        </div>
-                        <div class="stat-card gradient-orange">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <rect x="2" y="3" width="20" height="14" rx="2" ry="2"></rect>
-                                    <line x1="8" y1="21" x2="16" y2="21"></line>
-                                    <line x1="12" y1="17" x2="12" y2="21"></line>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-value" id="stat-providers">-</div>
-                                <div class="stat-label">Providers</div>
-                                <div class="stat-trend">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <path d="M2 12h20M12 2v20"></path>
-                                    </svg>
-                                    Online
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-
-                    <div class="grid-2">
-                        <div class="glass-card">
-                            <h3>System Status</h3>
-                            <div id="system-status"></div>
-                        </div>
-                        <div class="glass-card">
-                            <h3>Category Statistics</h3>
-                            <canvas id="categories-chart"></canvas>
-                        </div>
-                    </div>
-                </section>
-
-                <!-- Market Tab -->
-                <section id="tab-market" class="tab-panel">
-                    <div class="glass-card">
-                        <h3>Top Cryptocurrencies</h3>
-                        <div id="market-data"></div>
-                    </div>
-                    
-                    <div class="glass-card">
-                        <h3>Trending Coins</h3>
-                        <div id="trending-coins"></div>
-                    </div>
-                    
-                    <!-- Enhanced Sentiment Analysis Section -->
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <div>
-                                <h3>📊 Market Sentiment Analysis</h3>
-                                <p class="text-secondary">Real-time market sentiment indicators and Fear & Greed Index</p>
-                            </div>
-                            <button class="btn-refresh" onclick="loadMarketData()" title="Refresh Sentiment Data">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <polyline points="23 4 23 10 17 10"></polyline>
-                                    <polyline points="1 20 1 14 7 14"></polyline>
-                                    <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                </svg>
-                            </button>
-                        </div>
-                        <div id="fear-greed"></div>
-                    </div>
-                </section>
-
-                <!-- Models Tab -->
-                <section id="tab-models" class="tab-panel">
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <h3>Hugging Face Models</h3>
-                            <button class="btn-primary" onclick="initializeModels()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon>
-                                </svg>
-                                Load Models
-                            </button>
-                        </div>
-                        <div id="models-status"></div>
-                    </div>
-                    
-                    <div class="glass-card">
-                        <h3>Models List</h3>
-                        <div id="models-list"></div>
-                    </div>
-                </section>
-
-                <!-- Sentiment Analysis Tab -->
-                <section id="tab-sentiment" class="tab-panel">
-                    <!-- Global Market Sentiment -->
-                    <div class="glass-card">
-                        <h3>Global Market Sentiment</h3>
-                        <p class="text-secondary">Analyze overall crypto market sentiment using AI models</p>
-                        <button class="btn-primary" onclick="analyzeGlobalSentiment()">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <line x1="18" y1="20" x2="18" y2="10"></line>
-                                <line x1="12" y1="20" x2="12" y2="4"></line>
-                                <line x1="6" y1="20" x2="6" y2="14"></line>
-                            </svg>
-                            Analyze Market Sentiment
-                        </button>
-                        <div id="global-sentiment-result" style="margin-top: 20px;"></div>
-                    </div>
-                    
-                    <!-- Per-Asset Sentiment -->
-                    <div class="glass-card">
-                        <h3>Per-Asset Sentiment Analysis</h3>
-                        <div class="form-group">
-                            <label>Trading Pair:</label>
-                            <div id="asset-symbol-container">
-                                <input type="text" id="asset-symbol" placeholder="Loading pairs..." readonly>
-                            </div>
-                        </div>
-                        <div class="form-group">
-                            <label>Related Text or News (Optional):</label>
-                            <textarea id="asset-sentiment-text" rows="3" placeholder="Example: Bitcoin breaks resistance at $50,000"></textarea>
-                        </div>
-                        <button class="btn-primary" onclick="analyzeAssetSentiment()">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <circle cx="11" cy="11" r="8"></circle>
-                                <path d="M21 21l-4.35-4.35"></path>
-                            </svg>
-                            Analyze Asset Sentiment
-                        </button>
-                        <div id="asset-sentiment-result" style="margin-top: 20px;"></div>
-                    </div>
-                    
-                    <!-- Text Analysis -->
-                    <div class="glass-card">
-                        <h3>Text Analysis</h3>
-                        <div class="form-group">
-                            <label>Text to Analyze:</label>
-                            <textarea id="sentiment-text" rows="5" placeholder="Example: Bitcoin price is rising rapidly!"></textarea>
-                        </div>
-                        <div class="form-group">
-                            <label>Analysis Type:</label>
-                            <select id="sentiment-mode">
-                                <option value="auto">Auto (Crypto)</option>
-                                <option value="crypto">Crypto</option>
-                                <option value="financial">Financial</option>
-                                <option value="social">Social</option>
-                            </select>
-                        </div>
-                        <button class="btn-primary" onclick="analyzeSentiment()">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <circle cx="11" cy="11" r="8"></circle>
-                                <path d="M21 21l-4.35-4.35"></path>
-                            </svg>
-                            Analyze
-                        </button>
-                        <div id="sentiment-result"></div>
-                    </div>
-                </section>
-
-                <!-- Trading Assistant Tab -->
-                <section id="tab-trading-assistant" class="tab-panel">
-                    <div class="glass-card">
-                        <h3>Trading Signal Assistant</h3>
-                        <p class="text-secondary">Get AI-powered trading signals (BUY/SELL/HOLD) based on market analysis.</p>
-                        
-                        <div class="form-group">
-                            <label>Trading Symbol:</label>
-                            <div id="trading-symbol-container">
-                                <input type="text" id="trading-symbol" placeholder="Loading pairs..." readonly>
-                            </div>
-                        </div>
-                        
-                        <div class="form-group">
-                            <label>Market Context (Optional):</label>
-                            <textarea id="trading-context" rows="4" placeholder="Example: Recent breakout above resistance, high volume, positive news flow..."></textarea>
-                        </div>
-                        
-                        <button class="btn-primary" onclick="runTradingAssistant()">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <circle cx="12" cy="12" r="10"></circle>
-                                <polygon points="12 6 16 14 8 14"></polygon>
-                            </svg>
-                            Get Trading Signal
-                        </button>
-                        
-                        <div id="trading-assistant-result" style="margin-top: 20px;"></div>
-                    </div>
-                    
-                    <div class="glass-card">
-                        <h3>⚠️ Disclaimer</h3>
-                        <div class="alert alert-warning">
-                            <strong>Important:</strong> This trading assistant provides AI-generated signals for informational purposes only. 
-                            It should NOT be used as the sole basis for trading decisions. Always conduct your own research.
-                        </div>
-                    </div>
-                </section>
-
-                <!-- News Tab -->
-                <section id="tab-news" class="tab-panel">
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <h3>Crypto News</h3>
-                            <div style="display: flex; gap: 10px;">
-                                <button class="btn-primary" onclick="fetchNewsFromAPI()">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                        <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path>
-                                        <polyline points="7 10 12 15 17 10"></polyline>
-                                        <line x1="12" y1="15" x2="12" y2="3"></line>
-                                    </svg>
-                                    Fetch Latest News
-                                </button>
-                                <button class="btn-refresh" onclick="loadNews()">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                        <polyline points="23 4 23 10 17 10"></polyline>
-                                        <polyline points="1 20 1 14 7 14"></polyline>
-                                        <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                    </svg>
-                                    Refresh
-                                </button>
-                            </div>
-                        </div>
-                        <div id="news-list"></div>
-                    </div>
-                </section>
-
-                <!-- Settings Tab -->
-                <section id="tab-settings" class="tab-panel">
-                    <div class="glass-card">
-                        <h3>System Settings</h3>
-                        <div class="form-group">
-                            <label>Theme:</label>
-                            <select id="theme-select" onchange="changeTheme(this.value)">
-                                <option value="dark">Dark Mode</option>
-                                <option value="light">Light Mode</option>
-                            </select>
-                        </div>
-                        <div class="form-group">
-                            <label>Auto Refresh Interval (seconds):</label>
-                            <input type="number" id="refresh-interval" value="30" min="10" max="300">
-                        </div>
-                        <button class="btn-primary" onclick="saveSettings()">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <path d="M19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11l5 5v11a2 2 0 0 1-2 2z"></path>
-                                <polyline points="17 21 17 13 7 13 7 21"></polyline>
-                                <polyline points="7 3 7 8 15 8"></polyline>
-                            </svg>
-                            Save Settings
-                        </button>
-                    </div>
-                    
-                    <div class="glass-card">
-                        <h3>API Information</h3>
-                        <div id="api-info"></div>
-                    </div>
-                </section>
-
-                <!-- Providers Placeholder Tab -->
-                <section id="tab-providers" class="tab-panel">
-                    <div class="placeholder-page">
-                        <div class="placeholder-icon">🧩</div>
-                        <h2>Providers</h2>
-                        <p>This feature is under development.</p>
-                        <p class="text-secondary">Provider management and configuration will be available here.</p>
-                        <button class="btn-primary" onclick="switchTab('diagnostics')">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
-                                <path d="M2 17l10 5 10-5"></path>
-                                <path d="M2 12l10 5 10-5"></path>
-                            </svg>
-                            Run Diagnostics
-                        </button>
-                    </div>
-                </section>
-
-                <!-- Resources Placeholder Tab -->
-                <section id="tab-resources" class="tab-panel">
-                    <div class="placeholder-page">
-                        <div class="placeholder-icon">📚</div>
-                        <h2>Resources</h2>
-                        <p>This feature is under development.</p>
-                        <p class="text-secondary">Resource management and monitoring will be available here.</p>
-                        <button class="btn-primary" onclick="switchTab('diagnostics')">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
-                                <path d="M2 17l10 5 10-5"></path>
-                                <path d="M2 12l10 5 10-5"></path>
-                            </svg>
-                            Run Diagnostics
-                        </button>
-                    </div>
-                </section>
-
-                <!-- DeFi Analytics Placeholder Tab -->
-                <section id="tab-defi" class="tab-panel">
-                    <div class="placeholder-page">
-                        <div class="placeholder-icon">💎</div>
-                        <h2>DeFi Analytics</h2>
-                        <p>This feature is under development.</p>
-                        <p class="text-secondary">DeFi protocol analytics and insights will be available here.</p>
-                        <button class="btn-primary" onclick="switchTab('diagnostics')">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
-                                <path d="M2 17l10 5 10-5"></path>
-                                <path d="M2 12l10 5 10-5"></path>
-                            </svg>
-                            Run Diagnostics
-                        </button>
-                    </div>
-                </section>
-
-                <!-- System Status Placeholder Tab -->
-                <section id="tab-system-status" class="tab-panel">
-                    <div class="placeholder-page">
-                        <div class="placeholder-icon">⚙️</div>
-                        <h2>System Status</h2>
-                        <p>This feature is under development.</p>
-                        <p class="text-secondary">System health monitoring and status dashboard will be available here.</p>
-                        <button class="btn-primary" onclick="switchTab('diagnostics')">
-                            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                <path d="M12 2L2 7l10 5 10-5-10-5z"></path>
-                                <path d="M2 17l10 5 10-5"></path>
-                                <path d="M2 12l10 5 10-5"></path>
-                            </svg>
-                            Run Diagnostics
-                        </button>
-                    </div>
-                </section>
-
-                <!-- Test & Diagnostics Tab -->
-                <section id="tab-diagnostics" class="tab-panel">
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <div>
-                                <h3>🔧 Advanced Diagnostics & Monitoring</h3>
-                                <p class="text-secondary">Comprehensive system health monitoring, testing, and debugging tools</p>
-                            </div>
-                            <div style="display: flex; gap: 8px;">
-                                <button class="btn-refresh" onclick="toggleAutoRefresh()" id="auto-refresh-btn">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 4px;">
-                                        <polyline points="23 4 23 10 17 10"></polyline>
-                                        <polyline points="1 20 1 14 7 14"></polyline>
-                                        <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                    </svg>
-                                    Auto: OFF
-                                </button>
-                            </div>
-                        </div>
-                    </div>
-
-                    <!-- Quick Status Cards -->
-                    <div class="stats-grid">
-                        <div class="stat-card gradient-blue" id="transformers-status">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"></path>
-                                    <path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"></path>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-label">ML Library Status</div>
-                                <div class="stat-value" id="transformers-status-value">Checking...</div>
-                            </div>
-                        </div>
-
-                        <div class="stat-card gradient-green" id="hf-status">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <circle cx="12" cy="12" r="10"></circle>
-                                    <path d="M8 12h8"></path>
-                                    <path d="M12 8v8"></path>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-label">HF Hub Connection</div>
-                                <div class="stat-value" id="hf-status-value">Checking...</div>
-                            </div>
-                        </div>
-
-                        <div class="stat-card gradient-purple" id="models-status">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect>
-                                    <rect x="7" y="7" width="3" height="3"></rect>
-                                    <rect x="14" y="7" width="3" height="3"></rect>
-                                    <rect x="7" y="14" width="3" height="3"></rect>
-                                    <rect x="14" y="14" width="3" height="3"></rect>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-label">AI Models Ready</div>
-                                <div class="stat-value" id="models-status-value">0</div>
-                            </div>
-                        </div>
-
-                        <div class="stat-card gradient-orange" id="last-test-status">
-                            <div class="stat-icon">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <circle cx="12" cy="12" r="10"></circle>
-                                    <polyline points="12 6 12 12 16 14"></polyline>
-                                </svg>
-                            </div>
-                            <div class="stat-content">
-                                <div class="stat-label">Last Diagnostic</div>
-                                <div class="stat-value" id="last-test-value" style="font-size: 13px;">Never</div>
-                            </div>
-                        </div>
-                    </div>
-
-                    <!-- System Health Overview -->
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <h3>📊 System Health Overview</h3>
-                            <button class="btn-refresh" onclick="loadSystemHealth()" title="Refresh Health Status">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                    <polyline points="23 4 23 10 17 10"></polyline>
-                                    <polyline points="1 20 1 14 7 14"></polyline>
-                                    <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                </svg>
-                            </button>
-                        </div>
-                        <div id="system-health-overview" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 16px;">
-                            <!-- Will be populated by JavaScript -->
-                        </div>
-                    </div>
-
-                    <!-- Provider & Model Status Table -->
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <h3>🔍 Provider & Model Status</h3>
-                            <div style="display: flex; gap: 8px;">
-                                <button class="btn-refresh" onclick="loadProviderHealth()" title="Refresh Provider Status">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <polyline points="23 4 23 10 17 10"></polyline>
-                                        <polyline points="1 20 1 14 7 14"></polyline>
-                                        <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                    </svg>
-                                </button>
-                                <button class="btn-refresh" onclick="triggerSelfHeal()" title="Trigger Self-Healing">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <path d="M21.5 2v6h-6M2.5 22v-6h6M2 11.5a10 10 0 0 1 18.8-4.3M22 12.5a10 10 0 0 1-18.8 4.2"></path>
-                                    </svg>
-                                    Self-Heal
-                                </button>
-                            </div>
-                        </div>
-                        <div style="overflow-x: auto;">
-                            <table style="width: 100%; border-collapse: collapse;">
-                                <thead>
-                                    <tr style="border-bottom: 1px solid var(--border);">
-                                        <th style="padding: 12px; text-align: left; color: var(--text-secondary); font-weight: 600;">Name</th>
-                                        <th style="padding: 12px; text-align: left; color: var(--text-secondary); font-weight: 600;">Type</th>
-                                        <th style="padding: 12px; text-align: left; color: var(--text-secondary); font-weight: 600;">Status</th>
-                                        <th style="padding: 12px; text-align: left; color: var(--text-secondary); font-weight: 600;">Last Check</th>
-                                        <th style="padding: 12px; text-align: left; color: var(--text-secondary); font-weight: 600;">Actions</th>
-                                    </tr>
-                                </thead>
-                                <tbody id="provider-health-table">
-                                    <tr><td colspan="5" style="padding: 20px; text-align: center; color: var(--text-secondary);">Loading...</td></tr>
-                                </tbody>
-                            </table>
-                        </div>
-                    </div>
-
-                    <!-- Quick Diagnostic Actions -->
-                    <div class="glass-card">
-                        <div class="card-header">
-                            <h3>⚡ Quick Diagnostic Actions</h3>
-                        </div>
-                        <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px;">
-                            <button class="btn-primary" id="run-diagnostics-btn" onclick="runDiagnostic()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"></polygon>
-                                </svg>
-                                Run Full Diagnostic
-                            </button>
-                            <button class="btn-refresh" onclick="testAPIEndpoints()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <path d="M18 20V10"></path>
-                                    <path d="M12 20V4"></path>
-                                    <path d="M6 20v-6"></path>
-                                </svg>
-                                Test API Endpoints
-                            </button>
-                            <button class="btn-refresh" onclick="checkDatabaseHealth()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <ellipse cx="12" cy="5" rx="9" ry="3"></ellipse>
-                                    <path d="M21 12c0 1.66-4 3-9 3s-9-1.34-9-3"></path>
-                                    <path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"></path>
-                                </svg>
-                                Check Database
-                            </button>
-                            <button class="btn-refresh" onclick="testNetworkConnectivity()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <circle cx="12" cy="12" r="10"></circle>
-                                    <path d="M2 12h20"></path>
-                                    <path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"></path>
-                                </svg>
-                                Network Test
-                            </button>
-                            <button class="btn-refresh" onclick="refreshDiagnosticStatus()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <polyline points="23 4 23 10 17 10"></polyline>
-                                    <polyline points="1 20 1 14 7 14"></polyline>
-                                    <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                </svg>
-                                Refresh All
-                            </button>
-                            <button class="btn-refresh" onclick="downloadDiagnosticLog()">
-                                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="display: inline-block; vertical-align: middle; margin-right: 6px;">
-                                    <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path>
-                                    <polyline points="7 10 12 15 17 10"></polyline>
-                                    <line x1="12" y1="15" x2="12" y2="3"></line>
-                                </svg>
-                                Download Log
-                            </button>
-                        </div>
-                    </div>
-
-                    <!-- Tabs for different diagnostic views -->
-                    <div class="glass-card">
-                        <div style="display: flex; gap: 8px; border-bottom: 1px solid var(--border); margin-bottom: 20px;">
-                            <button class="diagnostic-tab-btn active" data-tab="output" onclick="switchDiagnosticTab('output')">Test Output</button>
-                            <button class="diagnostic-tab-btn" data-tab="health" onclick="switchDiagnosticTab('health')">Health Details</button>
-                            <button class="diagnostic-tab-btn" data-tab="api-test" onclick="switchDiagnosticTab('api-test')">API Tests</button>
-                            <button class="diagnostic-tab-btn" data-tab="logs" onclick="switchDiagnosticTab('logs')">Recent Logs</button>
-                        </div>
-
-                        <!-- Test Output Tab -->
-                        <div id="diagnostic-tab-output" class="diagnostic-tab-content active">
-                            <div class="card-header">
-                                <h3>Test Output</h3>
-                                <div id="test-progress" style="display: none;">
-                                    <div class="spinner"></div>
-                                    <span>Running diagnostic tests...</span>
-                                </div>
-                            </div>
-                            <div style="background: rgba(0, 0, 0, 0.3); border-radius: 8px; padding: 15px; max-height: 500px; overflow-y: auto; font-family: 'JetBrains Mono', monospace; font-size: 13px; line-height: 1.6;">
-                                <pre id="diagnostic-output" style="margin: 0; color: var(--text-primary); white-space: pre-wrap; word-wrap: break-word;"></pre>
-                            </div>
-                        </div>
-
-                        <!-- Health Details Tab -->
-                        <div id="diagnostic-tab-health" class="diagnostic-tab-content" style="display: none;">
-                            <h3>Detailed Health Information</h3>
-                            <div id="health-details-content" style="margin-top: 16px;">
-                                <p class="text-secondary">Click "Refresh All" to load detailed health information</p>
-                            </div>
-                        </div>
-
-                        <!-- API Tests Tab -->
-                        <div id="diagnostic-tab-api-test" class="diagnostic-tab-content" style="display: none;">
-                            <h3>API Endpoint Testing</h3>
-                            <div id="api-test-results" style="margin-top: 16px;">
-                                <p class="text-secondary">Click "Test API Endpoints" to run tests</p>
-                            </div>
-                        </div>
-
-                        <!-- Logs Tab -->
-                        <div id="diagnostic-tab-logs" class="diagnostic-tab-content" style="display: none;">
-                            <div class="card-header">
-                                <h3>Recent System Logs</h3>
-                                <button class="btn-refresh" onclick="loadRecentLogs()">
-                                    <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                                        <polyline points="23 4 23 10 17 10"></polyline>
-                                        <polyline points="1 20 1 14 7 14"></polyline>
-                                        <path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"></path>
-                                    </svg>
-                                </button>
-                            </div>
-                            <div id="recent-logs-content" style="margin-top: 16px; max-height: 500px; overflow-y: auto;">
-                                <p class="text-secondary">Loading logs...</p>
-                            </div>
-                        </div>
-                    </div>
-
-                    <!-- Test Results Summary -->
-                    <div class="glass-card" id="diagnostic-summary" style="display: none;">
-                        <h3>Test Results Summary</h3>
-                        <div class="grid-2">
-                            <div>
-                                <div style="display: flex; justify-content: space-between; padding: 12px; border-bottom: 1px solid var(--border);">
-                                    <span class="text-secondary">Duration:</span>
-                                    <strong id="summary-duration">-</strong>
-                                </div>
-                                <div style="display: flex; justify-content: space-between; padding: 12px; border-bottom: 1px solid var(--border);">
-                                    <span class="text-secondary">Tests Passed:</span>
-                                    <strong style="color: var(--success);" id="summary-passed">-</strong>
-                                </div>
-                            </div>
-                            <div>
-                                <div style="display: flex; justify-content: space-between; padding: 12px; border-bottom: 1px solid var(--border);">
-                                    <span class="text-secondary">Tests Failed:</span>
-                                    <strong style="color: var(--danger);" id="summary-failed">-</strong>
-                                </div>
-                                <div style="display: flex; justify-content: space-between; padding: 12px; border-bottom: 1px solid var(--border);">
-                                    <span class="text-secondary">Critical Issues:</span>
-                                    <strong style="color: var(--warning);" id="summary-critical">-</strong>
-                                </div>
-                            </div>
-                        </div>
-                        <div id="suggested-fixes" style="margin-top: 20px;"></div>
-                    </div>
-                </section>
-
-                <!-- AI Design Tools Tab -->
-                <section id="tab-ai-tools" class="tab-panel">
-                    <div id="ai-tools-content" style="width: 100%; height: calc(100vh - 180px); min-height: 600px; position: relative;">
-                        <iframe 
-                            id="ai-tools-iframe" 
-                            src="/ai-tools" 
-                            style="width: 100%; height: 100%; border: none; border-radius: 12px; background: transparent; display: none;"
-                            title="AI Design Tools"
-                            onload="handleAIToolsIframeLoad()"
-                        ></iframe>
-                        <div id="ai-tools-loading" style="text-align: center; padding: 60px 20px;">
-                            <div class="spinner" style="margin: 0 auto 20px;"></div>
-                            <p class="text-secondary">Loading AI Design Tools...</p>
-                        </div>
-                    </div>
-                </section>
-
-                <!-- Help / API Reference Tab -->
-                <section id="tab-help" class="tab-panel">
-                    <div class="glass-card">
-                        <div class="help-loading-state">
-                            <div class="spinner"></div>
-                            <p class="text-secondary">Loading live API reference...</p>
-                        </div>
-                    </div>
-                </section>
-            </main>
-        </div>
-    </div>
-    <nav aria-label="Historical data tools" style="position:fixed;right:18px;bottom:18px;z-index:9999;display:flex;gap:8px;padding:8px;border:1px solid #ffffff18;border-radius:16px;background:#08111ddd;backdrop-filter:blur(16px);box-shadow:0 16px 50px #0008">
-        <a href="/data-lab" style="padding:10px 13px;border-radius:10px;background:linear-gradient(135deg,#45e5d2,#6a8dff);color:#06121a;text-decoration:none;font:700 13px system-ui">Historical Data Lab</a>
-        <a href="/help" style="padding:10px 13px;color:#dce9ff;text-decoration:none;font:600 13px system-ui">Data guide</a>
-    </nav>
-</body>
-</html>
+<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="dark"><title>Space 4 · Crypto Data Operations</title>
+<style>
+:root{--bg:#070b14;--panel:#101827cc;--line:#ffffff14;--text:#f3f7ff;--muted:#8fa0bb;--cyan:#55dff7;--violet:#8b7cff;--live:#32d6a0;--degraded:#ffbd59;--cached:#65a8ff;--unavailable:#ff667d;--shadow:0 24px 80px #0008}*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:radial-gradient(circle at 78% -10%,#27205c66,transparent 36%),radial-gradient(circle at 22% 12%,#0b617144,transparent 30%),var(--bg);color:var(--text);font:14px/1.5 Inter,ui-sans-serif,system-ui,-apple-system,"Segoe UI",sans-serif}a{color:inherit;text-decoration:none}button{font:inherit}.shell{min-height:100vh;display:grid;grid-template-columns:248px minmax(0,1fr)}.sidebar{position:sticky;top:0;height:100vh;padding:22px 16px;border-right:1px solid var(--line);background:#090f1bee;backdrop-filter:blur(20px);z-index:20}.brand{display:flex;gap:12px;align-items:center;padding:4px 8px 24px}.brand-mark{width:40px;height:40px;display:grid;place-items:center;border-radius:13px;background:linear-gradient(135deg,var(--violet),var(--cyan));box-shadow:0 10px 30px #6d74ff55;font-weight:900}.brand strong{display:block;font-size:15px}.brand small{color:var(--muted)}.nav-group{margin:18px 0}.nav-label{padding:0 10px 7px;color:#657590;font-size:10px;font-weight:800;letter-spacing:.14em;text-transform:uppercase}.nav-link{display:flex;gap:11px;align-items:center;padding:10px 12px;border-radius:11px;color:#b6c1d4;margin:3px 0}.nav-link:hover,.nav-link.active{color:white;background:#ffffff0c}.nav-link.active{box-shadow:inset 3px 0 var(--cyan);background:linear-gradient(90deg,#55dff719,transparent)}.nav-icon{width:18px;text-align:center}.side-status{position:absolute;left:16px;right:16px;bottom:18px;padding:13px;border:1px solid var(--line);border-radius:14px;background:#0d1625}.side-status-row{display:flex;justify-content:space-between;gap:10px;align-items:center}.side-status small{display:block;color:var(--muted);margin-top:6px}.main{min-width:0;padding:24px 30px 70px}.topbar{display:flex;align-items:center;justify-content:space-between;gap:18px;margin-bottom:22px}.eyebrow{color:var(--cyan);font-size:11px;font-weight:800;letter-spacing:.14em;text-transform:uppercase}.topbar h1{font-size:clamp(25px,3vw,36px);margin:4px 0 0;letter-spacing:-.04em}.top-actions{display:flex;gap:10px;align-items:center}.button{border:1px solid var(--line);border-radius:11px;background:#ffffff08;color:var(--text);padding:9px 12px;cursor:pointer}.button:hover{background:#ffffff10}.menu-button{display:none}.status-strip{display:grid;grid-template-columns:1.2fr 1fr 1fr;gap:12px;margin-bottom:14px}.status-card,.panel,.market-card,.coverage-card{border:1px solid var(--line);background:linear-gradient(145deg,#121b2bd9,#0b1321d9);box-shadow:var(--shadow);backdrop-filter:blur(18px)}.status-card{border-radius:15px;padding:14px 16px;display:flex;justify-content:space-between;align-items:center;gap:14px}.status-card span:first-child{color:var(--muted);font-size:12px}.status-card strong{display:block;margin-top:2px}.badge{display:inline-flex;gap:6px;align-items:center;padding:5px 9px;border:1px solid currentColor;border-radius:999px;font-size:10px;font-weight:900;letter-spacing:.08em}.badge:before{content:"";width:6px;height:6px;border-radius:50%;background:currentColor;box-shadow:0 0 12px currentColor}.live{color:var(--live);background:#32d6a012}.degraded{color:var(--degraded);background:#ffbd5912}.cached{color:var(--cached);background:#65a8ff12}.unavailable{color:var(--unavailable);background:#ff667d12}.section-head{display:flex;align-items:end;justify-content:space-between;margin:27px 0 12px}.section-head h2{font-size:18px;margin:0}.section-head p{margin:3px 0 0;color:var(--muted)}.market-grid{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:12px}.market-card{border-radius:18px;padding:17px;min-height:153px}.market-top{display:flex;justify-content:space-between;align-items:center}.coin{display:flex;align-items:center;gap:9px}.coin-icon{width:34px;height:34px;border-radius:12px;display:grid;place-items:center;background:#ffffff0b;color:var(--cyan);font-weight:900}.coin b,.coin small{display:block}.coin small,.meta{color:var(--muted)}.price{font-size:25px;font-weight:800;letter-spacing:-.04em;margin:22px 0 4px}.meta{font-size:11px;display:flex;justify-content:space-between;gap:8px}.coverage-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px}.coverage-card{border-radius:17px;padding:16px}.coverage-top{display:flex;justify-content:space-between;gap:8px;align-items:center}.coverage-card h3{margin:0;font-size:14px}.coverage-card p{color:var(--muted);font-size:12px;min-height:38px;margin:12px 0}.coverage-meta{display:flex;justify-content:space-between;gap:12px;padding-top:10px;border-top:1px solid var(--line);font-size:11px;color:#b9c5d8}.ops-grid{display:grid;grid-template-columns:1.1fr .9fr;gap:12px}.panel{border-radius:18px;padding:18px}.panel h3{margin:0 0 14px}.row{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:10px 0;border-bottom:1px solid var(--line)}.row:last-child{border:0}.row span{color:var(--muted)}.provider-list{display:grid;grid-template-columns:repeat(2,1fr);gap:8px}.provider{padding:11px;border:1px solid var(--line);border-radius:12px;background:#ffffff05}.provider strong,.provider small{display:block}.provider small{color:var(--muted);margin-top:3px}.notice{margin-top:12px;border:1px solid #ffbd5940;background:#ffbd590d;border-radius:13px;padding:12px;color:#e7c987;font-size:12px}.footer{color:#697b96;margin-top:28px;font-size:11px}.skeleton{color:#5c6b82}.mobile-overlay{display:none}@media(max-width:1080px){.market-grid{grid-template-columns:repeat(2,1fr)}.coverage-grid{grid-template-columns:repeat(2,1fr)}}@media(max-width:780px){.shell{grid-template-columns:1fr}.sidebar{position:fixed;left:0;transform:translateX(-105%);width:260px;transition:.2s}.sidebar.open{transform:none}.mobile-overlay{position:fixed;inset:0;background:#0009;z-index:10}.mobile-overlay.open{display:block}.main{padding:18px 16px 55px}.menu-button{display:inline-flex}.topbar{align-items:flex-start}.top-actions .button:not(.menu-button){display:none}.status-strip,.market-grid,.coverage-grid,.ops-grid{grid-template-columns:1fr}.market-card{min-height:138px}.provider-list{grid-template-columns:1fr}}
+</style></head><body><div class="shell">
+<aside class="sidebar" id="sidebar"><div class="brand"><div class="brand-mark">S4</div><div><strong>Crypto Data Hub</strong><small>Space 4 · Operations</small></div></div><nav>
+<div class="nav-group"><div class="nav-label">Overview</div><a class="nav-link active" href="/"><span class="nav-icon">◫</span>Command center</a><a class="nav-link" href="#market"><span class="nav-icon">↗</span>Live markets</a><a class="nav-link" href="#coverage"><span class="nav-icon">◉</span>Data coverage</a></div>
+<div class="nav-group"><div class="nav-label">Data & signals</div><a class="nav-link" href="/data-lab"><span class="nav-icon">⌁</span>Historical Data Lab</a><a class="nav-link" href="/docs"><span class="nav-icon">⌁</span>Short Hunter Gateway</a><a class="nav-link" href="/ai-tools"><span class="nav-icon">✦</span>AI tools</a></div>
+<div class="nav-group"><div class="nav-label">Operations</div><a class="nav-link" href="/api/providers"><span class="nav-icon">⬡</span>Provider catalog</a><a class="nav-link" href="/api/apex/coverage"><span class="nav-icon">▤</span>Coverage JSON</a><a class="nav-link" href="/docs"><span class="nav-icon">{ }</span>OpenAPI explorer</a><a class="nav-link" href="/help"><span class="nav-icon">?</span>Help & examples</a></div></nav><div class="side-status"><div class="side-status-row"><strong>Gateway</strong><span id="side-badge" class="badge unavailable">CHECKING</span></div><small id="side-detail">Waiting for live health…</small></div></aside><div class="mobile-overlay" id="overlay"></div>
+<main class="main"><header class="topbar"><div><div class="eyebrow">Live system intelligence</div><h1>Data operations command center</h1></div><div class="top-actions"><button class="button menu-button" id="menu">Menu</button><a class="button" href="/help">Read the guide</a><button class="button" id="refresh">Refresh data</button></div></header>
+<section class="status-strip"><div class="status-card"><div><span>Runtime</span><strong id="runtime-text">Checking production…</strong></div><span id="runtime-badge" class="badge unavailable">CHECKING</span></div><div class="status-card"><div><span>Archive storage</span><strong id="storage-text">Inspecting database path…</strong></div><span id="storage-badge" class="badge unavailable">CHECKING</span></div><div class="status-card"><div><span>Data refreshed</span><strong id="refreshed">—</strong></div><span id="freshness-badge" class="badge unavailable">UNKNOWN</span></div></section>
+<section id="market"><div class="section-head"><div><h2>Live futures market</h2><p>Each price carries its own provider state and freshness.</p></div><a class="button" href="/data-lab">Open Data Lab</a></div><div class="market-grid" id="market-grid"></div></section>
+<section id="coverage"><div class="section-head"><div><h2>Data coverage at a glance</h2><p>Historical upstream data and forward-only archives are explicitly separated.</p></div><a class="button" href="/help">Examples & caveats</a></div><div class="coverage-grid" id="coverage-grid"></div></section>
+<section id="operations"><div class="section-head"><div><h2>Operations</h2><p>Provider capability and archive health without optimistic placeholders.</p></div></div><div class="ops-grid"><article class="panel"><h3>Archive health</h3><div id="archive-health"><div class="row"><span>Status</span><strong class="skeleton">Loading…</strong></div></div><div class="notice" id="storage-warning">Forward archives require persistent storage to survive a rebuild or restart.</div></article><article class="panel"><h3>Active upstreams</h3><div class="provider-list"><div class="provider"><strong>KuCoin Futures</strong><small>Primary LIVE Short Hunter market</small></div><div class="provider"><strong>Binance Vision</strong><small>Historical OHLCV</small></div><div class="provider"><strong>Gate.io</strong><small>Funding + OI fallback (~180 days)</small></div><div class="provider"><strong>Alternative.me</strong><small>Historical Fear & Greed</small></div><div class="provider"><strong>NewsData</strong><small>Forward news archive</small></div><div class="provider"><strong>Public EVM RPC</strong><small>Forward whale-transfer archive</small></div></div></article></div></section><div class="footer">Space 4 reports missing or stale data as unavailable. No values are synthesized.</div></main></div>
+<script>
+const symbols=['BTCUSDT','ETHUSDT','SOLUSDT','BNBUSDT'],money=new Intl.NumberFormat('en-US',{style:'currency',currency:'USD',maximumFractionDigits:2});const stateClass=s=>{s=String(s||'UNAVAILABLE').toUpperCase();return s==='LIVE'||s==='REAL'?'live':s==='CACHED'?'cached':s==='DEGRADED'||s==='PARTIAL'?'degraded':'unavailable'},badge=(s,l=s)=>`<span class="badge ${stateClass(s)}">${String(l||'UNAVAILABLE').toUpperCase()}</span>`,fmtTime=v=>{if(!v)return'Never';const n=Number(v),d=new Date(n<1e12?n*1000:n);return Number.isNaN(d.valueOf())?'Unknown':d.toLocaleString()};async function json(path){const c=new AbortController(),t=setTimeout(()=>c.abort(),20000);try{const r=await fetch(path,{signal:c.signal});if(!r.ok)throw Error(`HTTP ${r.status}`);return await r.json()}finally{clearTimeout(t)}}
+function renderMarket(items){document.querySelector('#market-grid').innerHTML=items.map((r,i)=>{const x=r.status==='fulfilled'?r.value:null,t=x?.data?.ticker||{},state=x?.sourceMode||'UNAVAILABLE',price=t.price??x?.data?.lastPrice;return`<article class="market-card"><div class="market-top"><div class="coin"><div class="coin-icon">${symbols[i][0]}</div><div><b>${symbols[i].replace('USDT','')}</b><small>USDT perpetual</small></div></div>${badge(state)}</div><div class="price">${price!=null?money.format(price):'UNAVAILABLE'}</div><div class="meta"><span>${x?.providerUsed||'No provider'}</span><span>${x?.latencyMs!=null?x.latencyMs+' ms':'No freshness'}</span></div></article>`}).join('')}
+function renderCoverage(c){const comps=c?.components||{},health=c?.archiveHealth?.components||{},cards=[['OHLCV','LIVE',comps.ohlcv?.mode||'REAL_HISTORICAL_ON_DEMAND','Vision-first historical retrieval'],['Funding','LIVE',comps.funding?.mode||'REAL_180_DAY_UPSTREAM','Gate.io production fallback'],['Open interest','CACHED',comps.openInterest?.mode||'FORWARD_ARCHIVE','Upstream window + daily archive'],['Fear & Greed','LIVE',comps.sentiment?.mode||'REAL_HISTORICAL','Full Alternative.me series'],['News','CACHED',comps.news?.mode||'FORWARD_COLLECTING_ONLY','NewsData; forward from deployment'],['Whale flow','CACHED',comps.whaleFlow?.mode||'FORWARD_COLLECTING_ONLY','Real large native transfers']];document.querySelector('#coverage-grid').innerHTML=cards.map(([name,state,mode,desc])=>{const key=name==='Open interest'?'openInterest':name==='News'?'news':name==='Whale flow'?'whaleFlow':null,rows=key?health[key]?.storedRows:null;return`<article class="coverage-card"><div class="coverage-top"><h3>${name}</h3>${badge(state)}</div><p>${desc}</p><div class="coverage-meta"><span>${mode.replaceAll('_',' ')}</span><strong>${rows!=null?rows.toLocaleString()+' rows':'On demand'}</strong></div></article>`}).join('');const entries=Object.entries(health);document.querySelector('#archive-health').innerHTML=entries.length?entries.map(([k,v])=>`<div class="row"><span>${k}</span><strong>${(v.storedRows||0).toLocaleString()} rows · ${fmtTime(v.lastObservedAt)}</strong></div>`).join(''):'<div class="row"><span>Archive telemetry</span><strong>Available after this UI build</strong></div>'}
+async function refresh(){document.querySelector('#refresh').textContent='Refreshing…';const [health,coverage,...markets]=await Promise.allSettled([json('/api/health'),json('/api/apex/coverage'),...symbols.map(s=>json('/api/short-hunter/market/'+s))]),h=health.status==='fulfilled'?health.value:null,c=coverage.status==='fulfilled'?coverage.value:null,ok=!!h?.success,mode=ok?'LIVE':'UNAVAILABLE';for(const id of['runtime-badge','side-badge']){const el=document.getElementById(id);el.className='badge '+stateClass(mode);el.textContent=mode}document.querySelector('#runtime-text').textContent=ok?`${h.service} · ${h.version}`:'Health endpoint unavailable';document.querySelector('#side-detail').textContent=ok?'Public-data gateway responding':'Gateway could not be verified';const storage=c?.archiveStorage?.mode||'UNAVAILABLE',sb=document.querySelector('#storage-badge');sb.className='badge '+(storage==='PERSISTENT_VOLUME'?'live':storage==='EPHEMERAL_LOCAL_DISK'?'degraded':'unavailable');sb.textContent=storage==='PERSISTENT_VOLUME'?'PERSISTENT':storage==='EPHEMERAL_LOCAL_DISK'?'EPHEMERAL':'UNAVAILABLE';document.querySelector('#storage-text').textContent=c?.archiveStorage?.path||'Storage state unavailable';document.querySelector('#storage-warning').textContent=c?.archiveStorage?.warning||'Persistent volume is mounted and used by the archive.';renderMarket(markets);renderCoverage(c);document.querySelector('#refreshed').textContent=new Date().toLocaleTimeString();const fb=document.querySelector('#freshness-badge');fb.className='badge live';fb.textContent='CURRENT';document.querySelector('#refresh').textContent='Refresh data'}
+document.querySelector('#refresh').addEventListener('click',refresh);const side=document.querySelector('#sidebar'),overlay=document.querySelector('#overlay');document.querySelector('#menu').addEventListener('click',()=>{side.classList.add('open');overlay.classList.add('open')});overlay.addEventListener('click',()=>{side.classList.remove('open');overlay.classList.remove('open')});document.querySelector('#market-grid').innerHTML=symbols.map(s=>`<article class="market-card skeleton">Loading ${s}…</article>`).join('');refresh();setInterval(refresh,60000);
+</script></body></html>

providers/registry.py

@@ -40,7 +40,7 @@ SUPPORTED_PROVIDERS: List[ProviderSpec] = [
     ProviderSpec("kucoin_futures", "KuCoin Futures", ["universe", "contractValidation", "ticker", "ohlcv", "orderbook", "funding", "openInterest", "markIndex"], category="exchange_public", priority=10),
     ProviderSpec("binance_futures", "Binance Futures", ["universe", "contractValidation", "ticker", "ohlcv", "orderbook", "funding", "openInterest", "markIndex"], category="exchange_public", priority=20),
     ProviderSpec("coingecko", "CoinGecko", ["universe", "ticker", "ohlcv"], category="market_data", priority=30),
-    ProviderSpec("cryptocompare", "CryptoCompare", ["ticker", "ohlcv"], requires_api_key=False, key_env="CRYPTOCOMPARE_KEY", category="market_data", priority=40),
+    ProviderSpec("cryptocompare", "CryptoCompare", ["ticker", "ohlcv"], requires_api_key=True, key_env="CRYPTOCOMPARE_KEY", category="market_data", priority=40),
     ProviderSpec("alternative_me", "Alternative.me", ["sentiment"], category="sentiment", priority=10),
     ProviderSpec("cryptopanic", "CryptoPanic", ["sentiment", "news"], requires_api_key=True, key_env="CRYPTOPANIC_KEY", category="news", priority=20),
 ]
@@ -193,4 +193,3 @@ def runtime_summary() -> Dict[str, Any]:
         "capabilities": capability_summary()["capabilities"],
         "validation": catalog_validation(),
     }
-

tests/test_space4_audit_fixes.py

@@ -0,0 +1,69 @@
+import pytest
+from fastapi.testclient import TestClient
+
+import api_compat_routes as compat
+import api_server_extended as server
+
+
+def test_provider_fixed_routes_are_not_shadowed():
+    client = TestClient(server.app)
+    for path in (
+        "/api/providers/catalog",
+        "/api/providers/status",
+        "/api/providers/auto-discovery-report",
+        "/api/providers/health-summary",
+    ):
+        assert client.get(path).status_code == 200
+
+
+def test_openapi_has_user_facing_groups_and_no_dead_static_alias():
+    schema = server.app.openapi()
+    tags = {
+        tag
+        for item in schema["paths"].values()
+        for operation in item.values()
+        if isinstance(operation, dict)
+        for tag in operation.get("tags", [])
+    }
+    assert "Core App & UI" in tags
+    assert "AI & Models" in tags
+    assert "Legacy Compatibility" in tags
+    assert "Short Hunter Gateway" in tags
+    assert "APEX Historical & Archives" in tags
+    assert "/static/api-resources/api-config-complete__1_.txt" not in schema["paths"]
+
+
+@pytest.mark.asyncio
+async def test_24h_stats_falls_back_to_kucoin(monkeypatch):
+    async def no_binance(_symbol):
+        return None, ["Binance HTTP 451"]
+
+    async def kucoin(_url, **_kwargs):
+        return {"data": {"last": "78900", "vol": "12", "volValue": "900000", "changeRate": "0.01", "high": "80000", "low": "77000"}}, None, 200
+
+    monkeypatch.setattr(compat, "_fetch_binance_ticker", no_binance)
+    monkeypatch.setattr(compat, "_get_json", kucoin)
+    result = await compat.trading_stats_24h("BTCUSDT")
+    assert result["success"] is True
+    assert result["source"] == "kucoin_public"
+    assert result["fallbackUsed"] is True
+
+
+@pytest.mark.asyncio
+async def test_compat_news_does_not_disguise_401_as_success(monkeypatch):
+    async def unauthorized(*_args, **_kwargs):
+        return None, "HTTP 401", 401
+
+    monkeypatch.setattr(compat, "_get_json", unauthorized)
+    result = await compat.coin_news("bitcoin", 5)
+    assert result["success"] is False
+    assert result["dataState"] == "UNAVAILABLE"
+    assert result["count"] == 0
+
+
+def test_homepage_has_glanceable_states_and_primary_navigation():
+    html = (server.WORKSPACE_ROOT / "index.html").read_text()
+    for label in ("Live futures market", "Data coverage at a glance", "Archive storage", "Help & examples", "OpenAPI explorer"):
+        assert label in html
+    for state in ("LIVE", "DEGRADED", "CACHED", "UNAVAILABLE"):
+        assert state in html