Crypto API investigation (#117)

* feat: Add HuggingFace Crypto Resources API client and configs

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

* feat: Add HuggingFace Space Crypto API client and router

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

* feat: Add HuggingFace Space Crypto API client guide

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

* feat: Add comprehensive API reference documentation

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

---------

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

COMPLETE_API_REFERENCE.md

@@ -0,0 +1,888 @@
+# Complete API Reference - All Available Services
+
+## راهنمای کامل API - تمام سرویس‌های موجود
+
+**Base URL:** `http://localhost:7860`
+
+---
+
+## 📋 Table of Contents
+
+1. [Market Data & Prices](#1-market-data--prices)
+2. [OHLCV / Candlestick Data](#2-ohlcv--candlestick-data)
+3. [Technical Indicators](#3-technical-indicators)
+4. [Sentiment Analysis](#4-sentiment-analysis)
+5. [News & Headlines](#5-news--headlines)
+6. [Blockchain & On-Chain Data](#6-blockchain--on-chain-data)
+7. [Whale Tracking](#7-whale-tracking)
+8. [AI & Machine Learning](#8-ai--machine-learning)
+9. [HuggingFace Space Crypto API](#9-huggingface-space-crypto-api)
+10. [System & Monitoring](#10-system--monitoring)
+
+---
+
+## 1. Market Data & Prices
+
+### 1.1 Get Single Price
+```bash
+GET /api/market/price?symbol=BTC
+```
+**Parameters:**
+- `symbol` (required): Cryptocurrency symbol (BTC, ETH, etc.)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/market/price?symbol=BTC"
+```
+
+**Response:**
+```json
+{
+  "symbol": "BTC",
+  "price": 90241.00,
+  "source": "coingecko",
+  "timestamp": 1702406543
+}
+```
+
+---
+
+### 1.2 Get Multiple Prices (Multi-Source)
+```bash
+GET /api/multi-source/prices?symbols=BTC,ETH,BNB&limit=100
+```
+**Parameters:**
+- `symbols` (optional): Comma-separated symbols
+- `limit` (optional): Max results (1-250, default: 100)
+- `cross_check` (optional): Validate across sources (default: true)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/multi-source/prices?symbols=BTC,ETH&limit=10"
+```
+
+---
+
+### 1.3 Get Top Coins
+```bash
+GET /api/service/top?limit=100
+GET /api/hf-space/coins/top?limit=50
+```
+**Parameters:**
+- `limit` (optional): Number of coins (default: 100)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/hf-space/coins/top?limit=10"
+```
+
+---
+
+### 1.4 Get Trending Coins
+```bash
+GET /api/trending
+GET /api/hf-space/trending
+GET /coingecko/trending
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/hf-space/trending"
+```
+
+---
+
+### 1.5 Get Market Overview
+```bash
+GET /api/market
+GET /api/hf-space/market
+GET /api/service/market-status
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/hf-space/market"
+```
+
+**Response:**
+```json
+{
+  "total_market_cap": 3152683901788,
+  "total_volume": 148435101985,
+  "market_cap_percentage": {
+    "btc": 57.09,
+    "eth": 11.77
+  },
+  "active_cryptocurrencies": 19190
+}
+```
+
+---
+
+## 2. OHLCV / Candlestick Data
+
+### 2.1 Get OHLCV Data
+```bash
+GET /api/market/ohlc?symbol=BTC&timeframe=1h
+GET /api/multi-source/ohlc/{symbol}?timeframe=1h&limit=1000
+GET /api/trading/ohlcv/{symbol}?interval=1h&limit=100
+```
+
+**Parameters:**
+- `symbol` (required): Cryptocurrency symbol
+- `timeframe/interval` (optional): 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w
+- `limit` (optional): Number of candles (default: 100-1000)
+
+**Example:**
+```bash
+# Get 100 hourly candles for BTC
+curl "http://localhost:7860/api/multi-source/ohlc/BTC?timeframe=1h&limit=100"
+
+# Get 4-hour candles for ETH
+curl "http://localhost:7860/api/market/ohlc?symbol=ETH&timeframe=4h"
+```
+
+**Response:**
+```json
+{
+  "symbol": "BTC",
+  "timeframe": "1h",
+  "data": [
+    {
+      "timestamp": 1702400000000,
+      "open": 90100.00,
+      "high": 90500.00,
+      "low": 89800.00,
+      "close": 90241.00,
+      "volume": 1234567890
+    }
+  ],
+  "source": "binance"
+}
+```
+
+---
+
+### 2.2 Get Historical Data
+```bash
+GET /api/market/history?symbol=BTC&days=30
+GET /api/service/history?symbol=BTC&timeframe=1h
+```
+
+**Parameters:**
+- `symbol` (required): Cryptocurrency symbol
+- `days` (optional): Number of days (default: 30)
+- `timeframe` (optional): 1h, 4h, 1d
+
+---
+
+## 3. Technical Indicators
+
+### 3.1 RSI (Relative Strength Index)
+```bash
+GET /api/indicators/rsi?symbol=BTC&timeframe=1h&period=14
+```
+
+**Parameters:**
+- `symbol` (optional): Default "BTC"
+- `timeframe` (optional): 1m, 5m, 15m, 1h, 4h, 1d
+- `period` (optional): RSI period (default: 14)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/indicators/rsi?symbol=BTC&timeframe=1h&period=14"
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "symbol": "BTC",
+  "timeframe": "1h",
+  "indicator": "rsi",
+  "data": {
+    "value": 55.23
+  },
+  "signal": "neutral",
+  "description": "RSI at 55.23 - neutral zone"
+}
+```
+
+---
+
+### 3.2 MACD
+```bash
+GET /api/indicators/macd?symbol=BTC&timeframe=1h&fast=12&slow=26&signal_period=9
+```
+
+**Parameters:**
+- `symbol`, `timeframe`
+- `fast` (optional): Fast EMA period (default: 12)
+- `slow` (optional): Slow EMA period (default: 26)
+- `signal_period` (optional): Signal line period (default: 9)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/indicators/macd?symbol=BTC&timeframe=1h"
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "symbol": "BTC",
+  "indicator": "macd",
+  "data": {
+    "macd_line": 50.0,
+    "signal_line": 45.0,
+    "histogram": 5.0
+  },
+  "trend": "bullish",
+  "signal": "buy"
+}
+```
+
+---
+
+### 3.3 Bollinger Bands
+```bash
+GET /api/indicators/bollinger-bands?symbol=BTC&timeframe=1h&period=20&std_dev=2
+```
+
+**Parameters:**
+- `symbol`, `timeframe`
+- `period` (optional): Period (default: 20)
+- `std_dev` (optional): Standard deviation multiplier (default: 2.0)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/indicators/bollinger-bands?symbol=BTC&timeframe=1h"
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "symbol": "BTC",
+  "indicator": "bollinger_bands",
+  "data": {
+    "upper": 92500.00,
+    "middle": 90241.00,
+    "lower": 88000.00,
+    "bandwidth": 4.98,
+    "percent_b": 50.0
+  },
+  "signal": "neutral"
+}
+```
+
+---
+
+### 3.4 SMA (Simple Moving Average)
+```bash
+GET /api/indicators/sma?symbol=BTC&timeframe=1h
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "sma20": 89500.00,
+    "sma50": 87200.00,
+    "sma200": 75000.00
+  },
+  "trend": "bullish",
+  "signal": "buy"
+}
+```
+
+---
+
+### 3.5 EMA (Exponential Moving Average)
+```bash
+GET /api/indicators/ema?symbol=BTC&timeframe=1h
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "ema12": 90100.00,
+    "ema26": 89500.00,
+    "ema50": 87000.00
+  },
+  "trend": "bullish"
+}
+```
+
+---
+
+### 3.6 Stochastic RSI
+```bash
+GET /api/indicators/stoch-rsi?symbol=BTC&timeframe=1h&rsi_period=14&stoch_period=14
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "value": 65.5,
+    "k_line": 65.5,
+    "d_line": 60.2
+  },
+  "signal": "neutral"
+}
+```
+
+---
+
+### 3.7 ATR (Average True Range)
+```bash
+GET /api/indicators/atr?symbol=BTC&timeframe=1h&period=14
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "value": 1500.00,
+    "percent": 1.66
+  },
+  "volatility_level": "medium"
+}
+```
+
+---
+
+### 3.8 Comprehensive Analysis (ALL Indicators)
+```bash
+GET /api/indicators/comprehensive?symbol=BTC&timeframe=1h
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/indicators/comprehensive?symbol=BTC&timeframe=1h"
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "symbol": "BTC",
+  "current_price": 90241.00,
+  "indicators": {
+    "bollinger_bands": {"upper": 92500, "middle": 90241, "lower": 88000},
+    "stoch_rsi": {"value": 55, "k_line": 55, "d_line": 52},
+    "atr": {"value": 1500, "percent": 1.66},
+    "sma": {"sma20": 89500, "sma50": 87200, "sma200": 75000},
+    "ema": {"ema12": 90100, "ema26": 89500},
+    "macd": {"macd_line": 50, "signal_line": 45, "histogram": 5},
+    "rsi": {"value": 55}
+  },
+  "signals": {
+    "bollinger_bands": "neutral",
+    "stoch_rsi": "neutral",
+    "sma": "bullish",
+    "ema": "bullish",
+    "macd": "bullish",
+    "rsi": "neutral"
+  },
+  "overall_signal": "BUY",
+  "confidence": 70,
+  "recommendation": "Majority bullish signals - favorable conditions for entry"
+}
+```
+
+---
+
+### 3.9 List All Indicator Services
+```bash
+GET /api/indicators/services
+```
+
+---
+
+## 4. Sentiment Analysis
+
+### 4.1 Fear & Greed Index
+```bash
+GET /api/hf-space/sentiment
+GET /api/multi-source/sentiment
+GET /api/sentiment/global
+GET /alternative/fng
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/hf-space/sentiment"
+```
+
+**Response:**
+```json
+{
+  "fear_greed_index": 29,
+  "sentiment": "fear",
+  "market_mood": "bearish",
+  "confidence": 0.85,
+  "source": "alternative.me"
+}
+```
+
+---
+
+### 4.2 Analyze Text Sentiment (AI)
+```bash
+POST /api/sentiment/analyze
+POST /hf/sentiment
+```
+
+**Body:**
+```json
+{
+  "text": "Bitcoin is going to the moon! Very bullish!"
+}
+```
+
+**Example:**
+```bash
+curl -X POST "http://localhost:7860/api/sentiment/analyze" \
+  -H "Content-Type: application/json" \
+  -d '{"text": "Bitcoin is going to the moon!"}'
+```
+
+**Response:**
+```json
+{
+  "text": "Bitcoin is going to the moon!",
+  "sentiment": "bullish",
+  "score": 0.92,
+  "confidence": 0.87,
+  "model": "CryptoBERT"
+}
+```
+
+---
+
+### 4.3 Bulk Sentiment Analysis
+```bash
+POST /hf/sentiment/batch
+```
+
+**Body:**
+```json
+{
+  "texts": [
+    "BTC is going up!",
+    "ETH crash incoming",
+    "Market looks stable"
+  ]
+}
+```
+
+---
+
+### 4.4 Asset-Specific Sentiment
+```bash
+GET /api/hf-space/sentiment/{symbol}
+GET /api/resources/sentiment/coin/{symbol}
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/hf-space/sentiment/BTC"
+```
+
+---
+
+## 5. News & Headlines
+
+### 5.1 Get Latest News
+```bash
+GET /api/multi-source/news?query=cryptocurrency&limit=50
+GET /api/news/latest
+GET /api/hf-space/resources/category/news_apis
+```
+
+**Parameters:**
+- `query` (optional): Search query (default: "cryptocurrency")
+- `limit` (optional): Max articles (default: 50)
+- `aggregate` (optional): Combine from multiple sources (default: true)
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/multi-source/news?query=bitcoin&limit=20"
+```
+
+**Response:**
+```json
+{
+  "articles": [
+    {
+      "title": "Bitcoin Reaches New High",
+      "description": "...",
+      "url": "https://...",
+      "source": "CoinDesk",
+      "publishedAt": "2025-12-12T10:00:00Z"
+    }
+  ],
+  "total": 20,
+  "sources_used": ["coindesk", "cointelegraph", "cryptopanic"]
+}
+```
+
+---
+
+### 5.2 Get Headlines
+```bash
+GET /api/news/headlines
+```
+
+---
+
+### 5.3 RSS Feeds
+```bash
+GET /rss/all
+GET /rss/feed?url=https://cointelegraph.com/rss
+GET /coindesk/rss
+GET /cointelegraph/rss
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/rss/all"
+```
+
+---
+
+## 6. Blockchain & On-Chain Data
+
+### 6.1 Gas Prices
+```bash
+GET /api/blockchain/gas
+GET /api/resources/onchain/gas
+GET /api/crypto/blockchain/gas
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/blockchain/gas"
+```
+
+**Response:**
+```json
+{
+  "chain": "ethereum",
+  "gas": {
+    "slow": 20,
+    "standard": 25,
+    "fast": 35,
+    "instant": 50
+  },
+  "unit": "gwei"
+}
+```
+
+---
+
+### 6.2 Blockchain Stats
+```bash
+GET /api/blockchain/{chain}
+GET /api/blockchain/stats
+```
+
+**Parameters:**
+- `chain`: ethereum, bsc, tron
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/blockchain/ethereum"
+```
+
+---
+
+### 6.3 Transaction Data
+```bash
+GET /api/blockchain/transactions?address={address}
+GET /api/resources/onchain/transactions?address={address}&chain=ethereum
+```
+
+---
+
+### 6.4 Address Balance
+```bash
+GET /api/resources/onchain/balance?address={address}&chain=ethereum
+```
+
+---
+
+## 7. Whale Tracking
+
+### 7.1 Whale Transactions
+```bash
+GET /api/whales/transactions
+GET /api/service/whales
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/service/whales"
+```
+
+**Response:**
+```json
+{
+  "transactions": [
+    {
+      "hash": "0x...",
+      "from": "0x...",
+      "to": "0x...",
+      "value": "1000 BTC",
+      "timestamp": "2025-12-12T10:00:00Z"
+    }
+  ],
+  "total": 10
+}
+```
+
+---
+
+### 7.2 Whale Stats
+```bash
+GET /api/whales/stats
+```
+
+---
+
+## 8. AI & Machine Learning
+
+### 8.1 Available AI Models
+```bash
+GET /api/models/list
+GET /hf/models
+GET /api/models/available
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/models/list"
+```
+
+---
+
+### 8.2 Load AI Model
+```bash
+POST /hf/models/load
+```
+
+**Body:**
+```json
+{
+  "model_key": "cryptobert"
+}
+```
+
+---
+
+### 8.3 AI Price Prediction
+```bash
+GET /api/ai/predict/{symbol}
+POST /api/ai/predict
+```
+
+---
+
+### 8.4 Trading Signal
+```bash
+POST /api/trading/signal
+```
+
+**Body:**
+```json
+{
+  "symbol": "BTC",
+  "timeframe": "1h"
+}
+```
+
+---
+
+### 8.5 HuggingFace Datasets
+```bash
+GET /hf/datasets
+GET /api/resources/hf/ohlcv?symbol=BTC&timeframe=1h
+GET /api/resources/hf/symbols
+```
+
+**Example:**
+```bash
+curl "http://localhost:7860/api/resources/hf/symbols"
+```
+
+---
+
+## 9. HuggingFace Space Crypto API
+
+External API providing market data and 281 curated resources.
+
+### 9.1 Market Data
+```bash
+GET /api/hf-space/coins/top?limit=50
+GET /api/hf-space/trending
+GET /api/hf-space/market
+```
+
+### 9.2 Sentiment
+```bash
+GET /api/hf-space/sentiment
+GET /api/hf-space/sentiment/{symbol}
+```
+
+### 9.3 Resources Database (281 resources)
+```bash
+GET /api/hf-space/resources/stats
+GET /api/hf-space/resources/categories
+GET /api/hf-space/resources/category/{category}
+GET /api/hf-space/resources/all
+```
+
+**Available Categories:**
+- `rpc_nodes` (24)
+- `block_explorers` (33)
+- `market_data_apis` (33)
+- `news_apis` (17)
+- `sentiment_apis` (14)
+- `onchain_analytics_apis` (14)
+- `whale_tracking_apis` (10)
+- `hf_resources` (9)
+- `free_http_endpoints` (13)
+- `cors_proxies` (7)
+
+**Example:**
+```bash
+# Get all RPC nodes
+curl "http://localhost:7860/api/hf-space/resources/category/rpc_nodes"
+
+# Get all market data APIs
+curl "http://localhost:7860/api/hf-space/resources/category/market_data_apis"
+```
+
+### 9.4 System Status
+```bash
+GET /api/hf-space/health
+GET /api/hf-space/providers
+GET /api/hf-space/status
+```
+
+---
+
+## 10. System & Monitoring
+
+### 10.1 Health Check
+```bash
+GET /health
+GET /api/health
+GET /api/multi-source/health
+```
+
+---
+
+### 10.2 System Status
+```bash
+GET /api/status
+GET /api/monitoring/status
+```
+
+---
+
+### 10.3 Source Statistics
+```bash
+GET /api/multi-source/sources/status
+GET /api/multi-source/monitoring/stats
+GET /api/providers/stats
+```
+
+---
+
+### 10.4 Background Worker
+```bash
+GET /api/worker/status
+GET /api/worker/stats
+POST /api/worker/start
+POST /api/worker/stop
+```
+
+---
+
+## Quick Reference Table
+
+| Service | Endpoint | Method |
+|---------|----------|--------|
+| **Prices** | `/api/market/price?symbol=BTC` | GET |
+| **Multi-Source Prices** | `/api/multi-source/prices` | GET |
+| **Top Coins** | `/api/hf-space/coins/top` | GET |
+| **Trending** | `/api/hf-space/trending` | GET |
+| **Market Overview** | `/api/hf-space/market` | GET |
+| **OHLCV** | `/api/multi-source/ohlc/{symbol}` | GET |
+| **RSI** | `/api/indicators/rsi?symbol=BTC` | GET |
+| **MACD** | `/api/indicators/macd?symbol=BTC` | GET |
+| **Bollinger Bands** | `/api/indicators/bollinger-bands` | GET |
+| **SMA** | `/api/indicators/sma?symbol=BTC` | GET |
+| **EMA** | `/api/indicators/ema?symbol=BTC` | GET |
+| **All Indicators** | `/api/indicators/comprehensive` | GET |
+| **Fear & Greed** | `/api/hf-space/sentiment` | GET |
+| **Sentiment Analysis** | `/api/sentiment/analyze` | POST |
+| **News** | `/api/multi-source/news` | GET |
+| **Gas Prices** | `/api/blockchain/gas` | GET |
+| **Whales** | `/api/service/whales` | GET |
+| **AI Models** | `/api/models/list` | GET |
+| **Resources DB** | `/api/hf-space/resources/stats` | GET |
+| **Health** | `/health` | GET |
+
+---
+
+## Python Usage Examples
+
+```python
+import requests
+
+BASE_URL = "http://localhost:7860"
+
+# Get BTC price
+price = requests.get(f"{BASE_URL}/api/market/price?symbol=BTC").json()
+print(f"BTC: ${price['price']:,.2f}")
+
+# Get RSI
+rsi = requests.get(f"{BASE_URL}/api/indicators/rsi?symbol=BTC&timeframe=1h").json()
+print(f"RSI: {rsi['data']['value']}")
+
+# Get comprehensive analysis
+analysis = requests.get(f"{BASE_URL}/api/indicators/comprehensive?symbol=BTC").json()
+print(f"Signal: {analysis['overall_signal']}")
+
+# Get Fear & Greed
+sentiment = requests.get(f"{BASE_URL}/api/hf-space/sentiment").json()
+print(f"Fear & Greed: {sentiment['fear_greed_index']}")
+
+# Analyze text sentiment
+response = requests.post(
+    f"{BASE_URL}/api/sentiment/analyze",
+    json={"text": "Bitcoin is going to the moon!"}
+)
+print(f"Sentiment: {response.json()['sentiment']}")
+
+# Get OHLCV candles
+ohlcv = requests.get(f"{BASE_URL}/api/multi-source/ohlc/BTC?timeframe=1h&limit=100").json()
+print(f"Candles: {len(ohlcv.get('data', []))}")
+
+# Get news
+news = requests.get(f"{BASE_URL}/api/multi-source/news?query=bitcoin&limit=10").json()
+print(f"Articles: {len(news.get('articles', []))}")
+```
+
+---
+
+*Last updated: 2025-12-12*

HF_SPACE_CRYPTO_API_GUIDE.md

@@ -0,0 +1,666 @@
+# HuggingFace Space Crypto Resources API - Client Guide
+
+## راهنمای استفاده از API منابع کریپتو
+
+**Base URL:** `https://really-amin-crypto-api-clean.hf.space`  
+**Local Proxy:** `http://localhost:7860/api/hf-space`  
+**Documentation:** https://really-amin-crypto-api-clean.hf.space/docs
+
+---
+
+## 📋 Table of Contents
+
+1. [Overview](#overview)
+2. [Market Data Services](#1-market-data-services)
+3. [Sentiment Services](#2-sentiment-services)
+4. [Resources Database](#3-resources-database)
+5. [System Status](#4-system-status)
+6. [Python Client Usage](#5-python-client-usage)
+7. [Response Format](#6-response-format)
+
+---
+
+## Overview
+
+This API provides:
+- **Real-time market data** from CoinGecko
+- **Sentiment analysis** (Fear & Greed Index) from Alternative.me
+- **Resource database** with 281 crypto data sources across 12 categories
+- **No authentication required** - All endpoints are public
+- **Unlimited rate limit**
+
+---
+
+## 1. Market Data Services
+
+### 1.1 Top Coins by Market Cap
+
+Get the top cryptocurrencies ranked by market capitalization.
+
+**Endpoint:**
+```
+GET /api/coins/top
+GET /api/hf-space/coins/top (local proxy)
+```
+
+**Parameters:**
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `limit` | integer | 50 | Number of coins (1-250) |
+
+**Request:**
+```bash
+# Direct
+curl "https://really-amin-crypto-api-clean.hf.space/api/coins/top?limit=10"
+
+# Local Proxy
+curl "http://localhost:7860/api/hf-space/coins/top?limit=10"
+```
+
+**Response:**
+```json
+{
+  "coins": [
+    {
+      "id": "bitcoin",
+      "symbol": "btc",
+      "name": "Bitcoin",
+      "image": "https://...",
+      "current_price": 90241.00,
+      "market_cap": 1800580721557,
+      "market_cap_rank": 1,
+      "total_volume": 69997758241,
+      "high_24h": 93468,
+      "low_24h": 89600,
+      "price_change_24h": -703.87,
+      "price_change_percentage_24h": -0.77,
+      "circulating_supply": 19961237.0,
+      "ath": 126080,
+      "ath_date": "2025-10-06T18:57:42.558Z",
+      "last_updated": "2025-12-12T19:22:00.626Z"
+    }
+  ],
+  "total": 10,
+  "timestamp": "2025-12-12T19:22:43.023917Z"
+}
+```
+
+---
+
+### 1.2 Trending Coins
+
+Get currently trending cryptocurrencies.
+
+**Endpoint:**
+```
+GET /api/trending
+GET /api/hf-space/trending (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/trending"
+```
+
+**Response:**
+```json
+{
+  "coins": [
+    {
+      "id": "gala",
+      "name": "GALA",
+      "symbol": "GALA",
+      "market_cap_rank": 206,
+      "thumb": "https://...",
+      "price_btc": 7.758989661597377e-08
+    }
+  ],
+  "total": 10,
+  "timestamp": "2025-12-12T19:22:49.419456Z"
+}
+```
+
+---
+
+### 1.3 Global Market Overview
+
+Get global cryptocurrency market statistics.
+
+**Endpoint:**
+```
+GET /api/market
+GET /api/hf-space/market (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/market"
+```
+
+**Response:**
+```json
+{
+  "total_market_cap": 3152683901788.04,
+  "total_volume": 148435101985.29,
+  "market_cap_percentage": {
+    "btc": 57.09,
+    "eth": 11.77,
+    "usdt": 5.91,
+    "xrp": 3.85,
+    "bnb": 3.84
+  },
+  "market_cap_change_percentage_24h": -1.06,
+  "active_cryptocurrencies": 19190,
+  "markets": 1440,
+  "timestamp": "2025-12-12T19:22:50.922474Z"
+}
+```
+
+---
+
+## 2. Sentiment Services
+
+### 2.1 Global Sentiment (Fear & Greed Index)
+
+Get the current Fear & Greed Index.
+
+**Endpoint:**
+```
+GET /api/sentiment/global
+GET /api/hf-space/sentiment (local proxy)
+```
+
+**Parameters:**
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `timeframe` | string | "1D" | Timeframe for data |
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/sentiment/global"
+```
+
+**Response:**
+```json
+{
+  "fear_greed_index": 29,
+  "sentiment": "fear",
+  "market_mood": "bearish",
+  "confidence": 0.85,
+  "history": [
+    {
+      "timestamp": 1765497600000,
+      "sentiment": 29,
+      "classification": "Fear"
+    }
+  ],
+  "timestamp": "2025-12-12T19:22:52.215750Z",
+  "source": "alternative.me"
+}
+```
+
+**Index Classification:**
+| Range | Classification |
+|-------|----------------|
+| 0-24 | Extreme Fear |
+| 25-49 | Fear |
+| 50-74 | Greed |
+| 75-100 | Extreme Greed |
+
+---
+
+### 2.2 Asset-Specific Sentiment
+
+Get sentiment for a specific cryptocurrency.
+
+**Endpoint:**
+```
+GET /api/sentiment/asset/{symbol}
+GET /api/hf-space/sentiment/{symbol} (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/sentiment/asset/BTC"
+```
+
+**Response:**
+```json
+{
+  "symbol": "BTC",
+  "sentiment": "neutral",
+  "score": 50,
+  "confidence": 0.5,
+  "timestamp": "2025-12-12T19:22:53.614869Z"
+}
+```
+
+---
+
+## 3. Resources Database
+
+The API provides access to a curated database of **281 crypto data resources** across **12 categories**.
+
+### 3.1 Get Resources Statistics
+
+**Endpoint:**
+```
+GET /api/resources/stats
+GET /api/hf-space/resources/stats (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/resources/stats"
+```
+
+**Response:**
+```json
+{
+  "total_resources": 281,
+  "total_categories": 12,
+  "categories": {
+    "rpc_nodes": 24,
+    "block_explorers": 33,
+    "market_data_apis": 33,
+    "news_apis": 17,
+    "sentiment_apis": 14,
+    "onchain_analytics_apis": 14,
+    "whale_tracking_apis": 10,
+    "community_sentiment_apis": 1,
+    "hf_resources": 9,
+    "free_http_endpoints": 13,
+    "local_backend_routes": 106,
+    "cors_proxies": 7
+  },
+  "metadata": {
+    "version": "1.0",
+    "updated": "2025-12-08"
+  }
+}
+```
+
+---
+
+### 3.2 List All Categories
+
+**Endpoint:**
+```
+GET /api/categories
+GET /api/hf-space/resources/categories (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/categories"
+```
+
+**Response:**
+```json
+{
+  "total": 12,
+  "categories": [
+    {
+      "name": "rpc_nodes",
+      "count": 24,
+      "endpoint": "/api/resources/category/rpc_nodes"
+    },
+    {
+      "name": "market_data_apis",
+      "count": 33,
+      "endpoint": "/api/resources/category/market_data_apis"
+    }
+  ]
+}
+```
+
+---
+
+### 3.3 Get Resources by Category
+
+**Endpoint:**
+```
+GET /api/resources/category/{category}
+GET /api/hf-space/resources/category/{category} (local proxy)
+```
+
+**Available Categories:**
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| `rpc_nodes` | 24 | Ethereum, BSC, Polygon RPC endpoints |
+| `block_explorers` | 33 | Etherscan, BSCScan, Polygonscan, etc. |
+| `market_data_apis` | 33 | CoinGecko, CoinMarketCap, Binance, etc. |
+| `news_apis` | 17 | Crypto news sources |
+| `sentiment_apis` | 14 | LunarCrush, Santiment, Alternative.me |
+| `onchain_analytics_apis` | 14 | Glassnode, CryptoQuant, Nansen |
+| `whale_tracking_apis` | 10 | Whale Alert, Arkham, DeBank |
+| `hf_resources` | 9 | HuggingFace models & datasets |
+| `free_http_endpoints` | 13 | Free API endpoints |
+| `local_backend_routes` | 106 | Local backend routes |
+| `cors_proxies` | 7 | CORS proxy services |
+| `community_sentiment_apis` | 1 | Community sentiment |
+
+**Request:**
+```bash
+# Get all RPC nodes
+curl "https://really-amin-crypto-api-clean.hf.space/api/resources/category/rpc_nodes"
+
+# Get all market data APIs
+curl "https://really-amin-crypto-api-clean.hf.space/api/resources/category/market_data_apis"
+
+# Get whale tracking APIs
+curl "https://really-amin-crypto-api-clean.hf.space/api/resources/category/whale_tracking_apis"
+```
+
+**Response (example: rpc_nodes):**
+```json
+{
+  "category": "rpc_nodes",
+  "total": 24,
+  "resources": [
+    {
+      "id": "publicnode_eth_mainnet",
+      "name": "PublicNode Ethereum",
+      "chain": "ethereum",
+      "role": "rpc",
+      "base_url": "https://ethereum.publicnode.com",
+      "auth": {
+        "type": "none"
+      },
+      "docs_url": "https://www.publicnode.com",
+      "notes": "Free, no rate limit"
+    },
+    {
+      "id": "infura_eth_mainnet",
+      "name": "Infura Ethereum Mainnet",
+      "chain": "ethereum",
+      "base_url": "https://mainnet.infura.io/v3/{PROJECT_ID}",
+      "auth": {
+        "type": "apiKeyPath",
+        "param_name": "PROJECT_ID"
+      },
+      "docs_url": "https://docs.infura.io",
+      "notes": "Free tier: 100K req/day"
+    }
+  ]
+}
+```
+
+**Response (example: market_data_apis):**
+```json
+{
+  "category": "market_data_apis",
+  "total": 33,
+  "resources": [
+    {
+      "id": "coingecko",
+      "name": "CoinGecko",
+      "role": "primary_free",
+      "base_url": "https://api.coingecko.com/api/v3",
+      "auth": { "type": "none" },
+      "docs_url": "https://www.coingecko.com/en/api/documentation",
+      "endpoints": {
+        "simple_price": "/simple/price?ids={ids}&vs_currencies={fiats}",
+        "coin_data": "/coins/{id}?localization=false",
+        "market_chart": "/coins/{id}/market_chart?vs_currency=usd&days=7",
+        "global_data": "/global",
+        "trending": "/search/trending"
+      },
+      "notes": "Rate limit: 10-50 calls/min (free)"
+    }
+  ]
+}
+```
+
+---
+
+### 3.4 Get All Resources
+
+**Endpoint:**
+```
+GET /api/resources/list
+GET /api/hf-space/resources/all (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/resources/list"
+```
+
+---
+
+## 4. System Status
+
+### 4.1 Health Check
+
+**Endpoint:**
+```
+GET /health
+GET /api/hf-space/health (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/health"
+```
+
+**Response:**
+```json
+{
+  "status": "healthy",
+  "timestamp": "2025-12-12T19:22:38.977664",
+  "resources_loaded": true,
+  "total_categories": 12,
+  "websocket_connections": 0
+}
+```
+
+---
+
+### 4.2 Data Providers Status
+
+**Endpoint:**
+```
+GET /api/providers
+GET /api/hf-space/providers (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/providers"
+```
+
+**Response:**
+```json
+{
+  "providers": [
+    {
+      "name": "CoinGecko",
+      "status": "active",
+      "endpoint": "https://api.coingecko.com",
+      "latency": 148,
+      "success_rate": 97
+    },
+    {
+      "name": "Binance",
+      "status": "active",
+      "endpoint": "https://api.binance.com",
+      "latency": 72,
+      "success_rate": 96
+    }
+  ],
+  "total": 3
+}
+```
+
+---
+
+### 4.3 System Status
+
+**Endpoint:**
+```
+GET /api/status
+GET /api/hf-space/status (local proxy)
+```
+
+**Request:**
+```bash
+curl "https://really-amin-crypto-api-clean.hf.space/api/status"
+```
+
+**Response:**
+```json
+{
+  "status": "online",
+  "health": "healthy",
+  "avg_response_time": 83,
+  "cache_hit_rate": 76,
+  "active_connections": 6,
+  "uptime": "99.9%"
+}
+```
+
+---
+
+## 5. Python Client Usage
+
+### 5.1 Using the Service (Async)
+
+```python
+from backend.services.hf_space_crypto_client import get_hf_space_crypto_service
+import asyncio
+
+async def main():
+    service = get_hf_space_crypto_service()
+    
+    # Get top 10 coins
+    result = await service.get_top_coins(limit=10)
+    if result["success"]:
+        for coin in result["data"]["coins"]:
+            print(f"{coin['name']}: ${coin['current_price']:,.2f}")
+    
+    # Get Fear & Greed Index
+    fgi = await service.get_fear_greed_index()
+    print(f"Fear & Greed Index: {fgi}")
+    
+    # Get market overview
+    result = await service.get_market_overview()
+    if result["success"]:
+        print(f"Total Market Cap: ${result['data']['total_market_cap']:,.0f}")
+    
+    # Get resources by category
+    result = await service.get_resources_by_category("market_data_apis")
+    if result["success"]:
+        for resource in result["data"]["resources"][:5]:
+            print(f"- {resource['name']}: {resource['base_url']}")
+    
+    await service.close()
+
+asyncio.run(main())
+```
+
+### 5.2 Using the Standalone Client (Sync/Async)
+
+```python
+from collectors.hf_crypto_api_client import HFCryptoAPIClient
+
+# Synchronous usage
+client = HFCryptoAPIClient()
+
+# Get top coins
+coins = client.get_top_coins(limit=10)
+for coin in coins.get("coins", []):
+    print(f"{coin['name']}: ${coin['current_price']:,.2f}")
+
+# Get Fear & Greed Index
+fgi = client.get_fear_greed_index()
+print(f"Fear & Greed: {fgi}")
+
+# Get BTC price
+btc_price = client.get_btc_price()
+print(f"BTC: ${btc_price:,.2f}")
+
+# Get total market cap
+mcap = client.get_total_market_cap()
+print(f"Market Cap: ${mcap:,.0f}")
+
+# Get RPC nodes
+rpc_nodes = client.get_rpc_nodes()
+for node in rpc_nodes[:5]:
+    print(f"- {node['name']}: {node['base_url']}")
+
+# Get market data APIs
+apis = client.get_market_data_apis()
+for api in apis[:5]:
+    print(f"- {api['name']}: {api['base_url']}")
+```
+
+### 5.3 Using from Collectors Package
+
+```python
+from collectors import HFCryptoAPIClient, get_hf_crypto_client
+
+# Get singleton client
+client = get_hf_crypto_client()
+
+# Use the client
+coins = client.get_top_coins(limit=5)
+sentiment = client.get_global_sentiment()
+resources = client.get_resources_stats()
+```
+
+---
+
+## 6. Response Format
+
+All endpoints return JSON with consistent structure:
+
+### Success Response
+```json
+{
+  "data": { ... },
+  "total": 10,
+  "timestamp": "2025-12-12T19:22:43.023917Z"
+}
+```
+
+### Error Response (via local proxy)
+```json
+{
+  "detail": "HF Space API unavailable: Request timeout"
+}
+```
+
+---
+
+## Quick Reference
+
+| Service | Endpoint | Description |
+|---------|----------|-------------|
+| Top Coins | `GET /api/coins/top?limit=N` | Top N coins by market cap |
+| Trending | `GET /api/trending` | Trending coins |
+| Market | `GET /api/market` | Global market overview |
+| Sentiment | `GET /api/sentiment/global` | Fear & Greed Index |
+| Asset Sentiment | `GET /api/sentiment/asset/{symbol}` | Asset-specific sentiment |
+| Resources Stats | `GET /api/resources/stats` | Database statistics |
+| Categories | `GET /api/categories` | List all categories |
+| By Category | `GET /api/resources/category/{cat}` | Resources in category |
+| All Resources | `GET /api/resources/list` | All 281 resources |
+| Health | `GET /health` | API health check |
+| Providers | `GET /api/providers` | Data providers status |
+| Status | `GET /api/status` | System status |
+
+---
+
+## Notes
+
+- **No API key required** - All endpoints are public
+- **Rate limit** - Unlimited (but be respectful)
+- **Data freshness** - Market data updates every few seconds
+- **Resources database** - Updated periodically, contains API keys for some services
+- **WebSocket** - Available at `wss://really-amin-crypto-api-clean.hf.space/ws` for real-time updates
+
+---
+
+*Last updated: 2025-12-12*

backend/routers/hf_space_crypto_api.py

@@ -0,0 +1,451 @@
+#!/usr/bin/env python3
+"""
+HuggingFace Space Crypto Resources API Router
+روتر API برای دسترسی به منابع کریپتو در HuggingFace Space
+
+This router provides endpoints to access the external HF Space Crypto API:
+https://really-amin-crypto-api-clean.hf.space
+
+Endpoints:
+- /api/hf-space/coins/top - Top coins by market cap
+- /api/hf-space/trending - Trending coins
+- /api/hf-space/market - Market overview
+- /api/hf-space/sentiment - Fear & Greed Index
+- /api/hf-space/resources - Resource database
+"""
+
+from fastapi import APIRouter, Query, HTTPException, Path
+from typing import Optional, List
+import logging
+
+from backend.services.hf_space_crypto_client import get_hf_space_crypto_service
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(
+    prefix="/api/hf-space",
+    tags=["HuggingFace Space Crypto API"]
+)
+
+
+# ===== MARKET DATA ENDPOINTS =====
+
+@router.get("/coins/top")
+async def get_top_coins(
+    limit: int = Query(50, ge=1, le=250, description="Number of coins to return")
+):
+    """
+    Get top coins by market cap from HF Space API
+    
+    دریافت برترین ارزها بر اساس مارکت کپ
+    
+    Source: HuggingFace Space Crypto API → CoinGecko
+    
+    Returns:
+        - coins: List of top coins with price, market cap, volume, etc.
+        - total: Total number of coins returned
+        - timestamp: Data timestamp
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_top_coins(limit=limit)
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Top coins endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/trending")
+async def get_trending_coins():
+    """
+    Get trending coins from HF Space API
+    
+    دریافت ارزهای ترند
+    
+    Source: HuggingFace Space Crypto API → CoinGecko
+    
+    Returns:
+        - coins: List of trending coins
+        - total: Total number of trending coins
+        - timestamp: Data timestamp
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_trending()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Trending coins endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/market")
+async def get_market_overview():
+    """
+    Get global market overview from HF Space API
+    
+    خلاصه کلی بازار
+    
+    Source: HuggingFace Space Crypto API → CoinGecko
+    
+    Returns:
+        - total_market_cap: Total market cap in USD
+        - total_volume: 24h trading volume
+        - market_cap_percentage: Dominance by coin (BTC, ETH, etc.)
+        - active_cryptocurrencies: Number of active cryptos
+        - markets: Number of markets
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_market_overview()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Market overview endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ===== SENTIMENT ENDPOINTS =====
+
+@router.get("/sentiment")
+async def get_global_sentiment(
+    timeframe: str = Query("1D", description="Timeframe for sentiment data")
+):
+    """
+    Get Fear & Greed Index from HF Space API
+    
+    شاخص ترس و طمع
+    
+    Source: HuggingFace Space Crypto API → Alternative.me
+    
+    Returns:
+        - fear_greed_index: Current index value (0-100)
+        - sentiment: Classification (fear, greed, etc.)
+        - market_mood: Market mood (bearish, bullish, neutral)
+        - confidence: Confidence score
+        - source: Data source (alternative.me)
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_global_sentiment(timeframe=timeframe)
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Sentiment endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/sentiment/{symbol}")
+async def get_asset_sentiment(
+    symbol: str = Path(..., description="Asset symbol (e.g., BTC, ETH)")
+):
+    """
+    Get sentiment for specific asset from HF Space API
+    
+    احساسات یک ارز خاص
+    
+    Returns:
+        - symbol: Asset symbol
+        - sentiment: Sentiment classification
+        - score: Sentiment score
+        - confidence: Confidence score
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_asset_sentiment(symbol.upper())
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Asset sentiment endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ===== RESOURCES DATABASE ENDPOINTS =====
+
+@router.get("/resources/stats")
+async def get_resources_stats():
+    """
+    Get resources database statistics from HF Space API
+    
+    آمار منابع
+    
+    Returns:
+        - total_resources: Total number of resources (281)
+        - total_categories: Number of categories (12)
+        - categories: Resource count per category
+        - metadata: Database metadata
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_resources_stats()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Resources stats endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/resources/categories")
+async def get_categories():
+    """
+    Get list of resource categories from HF Space API
+    
+    لیست دسته‌بندی‌ها
+    
+    Returns:
+        - total: Number of categories
+        - categories: List of categories with name, count, and endpoint
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_categories()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Categories endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/resources/category/{category}")
+async def get_resources_by_category(
+    category: str = Path(
+        ...,
+        description="Category name (rpc_nodes, block_explorers, market_data_apis, etc.)"
+    )
+):
+    """
+    Get resources for a specific category from HF Space API
+    
+    منابع یک دسته خاص
+    
+    Available categories:
+    - rpc_nodes (24 resources)
+    - block_explorers (33 resources)
+    - market_data_apis (33 resources)
+    - news_apis (17 resources)
+    - sentiment_apis (14 resources)
+    - onchain_analytics_apis (14 resources)
+    - whale_tracking_apis (10 resources)
+    - hf_resources (9 resources)
+    - free_http_endpoints (13 resources)
+    - local_backend_routes (106 resources)
+    - cors_proxies (7 resources)
+    - community_sentiment_apis (1 resource)
+    
+    Returns:
+        - category: Category name
+        - total: Number of resources in category
+        - resources: List of resources with name, base_url, auth, endpoints
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_resources_by_category(category)
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Resources by category endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/resources/all")
+async def get_all_resources():
+    """
+    Get all resources list from HF Space API
+    
+    لیست همه منابع
+    
+    Returns:
+        - total: Total number of resources (281)
+        - resources: List of all resources
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_all_resources()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ All resources endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+# ===== SYSTEM STATUS ENDPOINTS =====
+
+@router.get("/health")
+async def health_check():
+    """
+    Check HF Space API health status
+    
+    بررسی سلامت API
+    
+    Returns:
+        - status: Health status
+        - resources_loaded: Whether resources are loaded
+        - total_categories: Number of categories
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.health_check()
+        
+        if not result["success"]:
+            return {
+                "status": "unavailable",
+                "error": result.get("error"),
+                "source": "hf_space_crypto_api"
+            }
+        
+        return {
+            **result["data"],
+            "source": "hf_space_crypto_api"
+        }
+    
+    except Exception as e:
+        return {
+            "status": "error",
+            "error": str(e),
+            "source": "hf_space_crypto_api"
+        }
+
+
+@router.get("/providers")
+async def get_providers_status():
+    """
+    Get data providers status from HF Space API
+    
+    وضعیت provider ها
+    
+    Returns:
+        - providers: List of providers with status, latency, success rate
+        - total: Number of providers
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_providers_status()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ Providers status endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/status")
+async def get_system_status():
+    """
+    Get system status from HF Space API
+    
+    وضعیت سیستم
+    
+    Returns:
+        - status: System status (online, offline)
+        - health: System health
+        - avg_response_time: Average response time
+        - cache_hit_rate: Cache hit rate
+        - uptime: System uptime
+    """
+    try:
+        service = get_hf_space_crypto_service()
+        result = await service.get_system_status()
+        
+        if not result["success"]:
+            raise HTTPException(
+                status_code=503,
+                detail=f"HF Space API unavailable: {result.get('error')}"
+            )
+        
+        return result["data"]
+    
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"❌ System status endpoint failed: {e}")
+        raise HTTPException(status_code=500, detail=str(e))

backend/services/hf_space_crypto_client.py

@@ -0,0 +1,336 @@
+#!/usr/bin/env python3
+"""
+HuggingFace Space Crypto Resources API Client Service
+سرویس کلاینت برای API منابع کریپتو در HuggingFace Space
+
+This service provides access to the external HF Space Crypto Resources API:
+https://really-amin-crypto-api-clean.hf.space
+
+Features:
+- Market data (top coins, trending)
+- Global market overview
+- Fear & Greed Index
+- Resource database (281 resources in 12 categories)
+"""
+
+import httpx
+import asyncio
+import logging
+from typing import Dict, Any, List, Optional
+from datetime import datetime, timezone
+from functools import lru_cache
+
+logger = logging.getLogger(__name__)
+
+# Base URL for the HF Space API
+HF_CRYPTO_API_BASE_URL = "https://really-amin-crypto-api-clean.hf.space"
+
+# Cache for resources (they don't change frequently)
+_resources_cache: Dict[str, Any] = {}
+_cache_timestamp: Optional[datetime] = None
+CACHE_TTL_SECONDS = 300  # 5 minutes
+
+
+class HFSpaceCryptoService:
+    """
+    Service for accessing HuggingFace Space Crypto Resources API
+    Follows project patterns with proper error handling and logging
+    """
+    
+    def __init__(self, timeout: int = 15):
+        self.base_url = HF_CRYPTO_API_BASE_URL
+        self.timeout = timeout
+        self._client: Optional[httpx.AsyncClient] = None
+    
+    async def _get_client(self) -> httpx.AsyncClient:
+        """Get or create async HTTP client"""
+        if self._client is None or self._client.is_closed:
+            self._client = httpx.AsyncClient(timeout=self.timeout)
+        return self._client
+    
+    async def close(self):
+        """Close the HTTP client"""
+        if self._client and not self._client.is_closed:
+            await self._client.aclose()
+    
+    async def _request(self, endpoint: str, params: Dict = None) -> Dict[str, Any]:
+        """
+        Make async request to HF Space API with proper error handling
+        
+        Returns standardized response format matching project patterns
+        """
+        provider = "HFSpaceCryptoAPI"
+        start_time = datetime.now(timezone.utc)
+        
+        try:
+            client = await self._get_client()
+            url = f"{self.base_url}{endpoint}"
+            
+            response = await client.get(url, params=params)
+            response.raise_for_status()
+            
+            data = response.json()
+            response_time_ms = (datetime.now(timezone.utc) - start_time).total_seconds() * 1000
+            
+            logger.info(f"✅ {provider} - {endpoint} - {response_time_ms:.0f}ms")
+            
+            return {
+                "provider": provider,
+                "endpoint": endpoint,
+                "data": data,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+                "response_time_ms": response_time_ms,
+                "success": True,
+                "error": None
+            }
+            
+        except httpx.HTTPStatusError as e:
+            logger.error(f"❌ {provider} - {endpoint} - HTTP {e.response.status_code}")
+            return {
+                "provider": provider,
+                "endpoint": endpoint,
+                "data": None,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+                "success": False,
+                "error": f"HTTP {e.response.status_code}",
+                "error_type": "http_error"
+            }
+        except httpx.TimeoutException:
+            logger.error(f"❌ {provider} - {endpoint} - Timeout")
+            return {
+                "provider": provider,
+                "endpoint": endpoint,
+                "data": None,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+                "success": False,
+                "error": "Request timeout",
+                "error_type": "timeout"
+            }
+        except Exception as e:
+            logger.error(f"❌ {provider} - {endpoint} - {str(e)}")
+            return {
+                "provider": provider,
+                "endpoint": endpoint,
+                "data": None,
+                "timestamp": datetime.now(timezone.utc).isoformat(),
+                "success": False,
+                "error": str(e),
+                "error_type": "exception"
+            }
+    
+    # ===== MARKET DATA =====
+    
+    async def get_top_coins(self, limit: int = 50) -> Dict[str, Any]:
+        """
+        Get top coins by market cap
+        دریافت برترین ارزها بر اساس مارکت کپ
+        """
+        return await self._request("/api/coins/top", params={"limit": limit})
+    
+    async def get_trending(self) -> Dict[str, Any]:
+        """
+        Get trending coins
+        دریافت ارزهای ترند
+        """
+        return await self._request("/api/trending")
+    
+    async def get_market_overview(self) -> Dict[str, Any]:
+        """
+        Get global market overview
+        خلاصه کلی بازار
+        """
+        return await self._request("/api/market")
+    
+    # ===== SENTIMENT =====
+    
+    async def get_global_sentiment(self, timeframe: str = "1D") -> Dict[str, Any]:
+        """
+        Get Fear & Greed Index
+        شاخص ترس و طمع
+        """
+        return await self._request("/api/sentiment/global", params={"timeframe": timeframe})
+    
+    async def get_asset_sentiment(self, symbol: str) -> Dict[str, Any]:
+        """
+        Get sentiment for specific asset
+        احساسات یک ارز خاص
+        """
+        return await self._request(f"/api/sentiment/asset/{symbol}")
+    
+    # ===== RESOURCES DATABASE =====
+    
+    async def get_resources_stats(self) -> Dict[str, Any]:
+        """
+        Get resources database statistics
+        آمار منابع
+        """
+        return await self._request("/api/resources/stats")
+    
+    async def get_categories(self) -> Dict[str, Any]:
+        """
+        Get list of resource categories
+        لیست دسته‌بندی‌ها
+        """
+        return await self._request("/api/categories")
+    
+    async def get_resources_by_category(self, category: str) -> Dict[str, Any]:
+        """
+        Get resources for a specific category
+        منابع یک دسته خاص
+        
+        Categories: rpc_nodes, block_explorers, market_data_apis, news_apis,
+                   sentiment_apis, onchain_analytics_apis, whale_tracking_apis,
+                   hf_resources, free_http_endpoints, cors_proxies
+        """
+        return await self._request(f"/api/resources/category/{category}")
+    
+    async def get_all_resources(self) -> Dict[str, Any]:
+        """
+        Get all resources list
+        لیست همه منابع
+        """
+        return await self._request("/api/resources/list")
+    
+    # ===== SYSTEM STATUS =====
+    
+    async def health_check(self) -> Dict[str, Any]:
+        """Check API health status"""
+        return await self._request("/health")
+    
+    async def get_providers_status(self) -> Dict[str, Any]:
+        """Get data providers status"""
+        return await self._request("/api/providers")
+    
+    async def get_system_status(self) -> Dict[str, Any]:
+        """Get system status"""
+        return await self._request("/api/status")
+    
+    # ===== CONVENIENCE METHODS =====
+    
+    async def get_fear_greed_index(self) -> int:
+        """
+        Get current Fear & Greed Index value
+        
+        Returns:
+            int: Fear & Greed Index (0-100)
+        """
+        result = await self.get_global_sentiment()
+        if result["success"] and result["data"]:
+            return result["data"].get("fear_greed_index", 50)
+        return 50  # Default neutral
+    
+    async def get_btc_price(self) -> float:
+        """
+        Get current Bitcoin price
+        
+        Returns:
+            float: BTC price in USD
+        """
+        result = await self.get_top_coins(limit=1)
+        if result["success"] and result["data"]:
+            coins = result["data"].get("coins", [])
+            if coins:
+                return coins[0].get("current_price", 0)
+        return 0
+    
+    async def get_total_market_cap(self) -> float:
+        """
+        Get total crypto market cap
+        
+        Returns:
+            float: Total market cap in USD
+        """
+        result = await self.get_market_overview()
+        if result["success"] and result["data"]:
+            return result["data"].get("total_market_cap", 0)
+        return 0
+
+
+# ===== SINGLETON INSTANCE =====
+
+_service_instance: Optional[HFSpaceCryptoService] = None
+
+
+def get_hf_space_crypto_service() -> HFSpaceCryptoService:
+    """Get singleton instance of HF Space Crypto Service"""
+    global _service_instance
+    if _service_instance is None:
+        _service_instance = HFSpaceCryptoService()
+    return _service_instance
+
+
+# ===== STANDALONE FUNCTIONS (for collectors compatibility) =====
+
+async def fetch_hf_space_top_coins(limit: int = 50) -> Dict[str, Any]:
+    """Fetch top coins from HF Space API"""
+    service = get_hf_space_crypto_service()
+    return await service.get_top_coins(limit)
+
+
+async def fetch_hf_space_trending() -> Dict[str, Any]:
+    """Fetch trending coins from HF Space API"""
+    service = get_hf_space_crypto_service()
+    return await service.get_trending()
+
+
+async def fetch_hf_space_market_overview() -> Dict[str, Any]:
+    """Fetch market overview from HF Space API"""
+    service = get_hf_space_crypto_service()
+    return await service.get_market_overview()
+
+
+async def fetch_hf_space_sentiment() -> Dict[str, Any]:
+    """Fetch global sentiment from HF Space API"""
+    service = get_hf_space_crypto_service()
+    return await service.get_global_sentiment()
+
+
+async def fetch_hf_space_resources(category: Optional[str] = None) -> Dict[str, Any]:
+    """Fetch resources from HF Space API"""
+    service = get_hf_space_crypto_service()
+    if category:
+        return await service.get_resources_by_category(category)
+    return await service.get_resources_stats()
+
+
+# ===== TEST =====
+
+if __name__ == "__main__":
+    async def main():
+        service = get_hf_space_crypto_service()
+        
+        print("=" * 60)
+        print("Testing HF Space Crypto Service")
+        print("=" * 60)
+        
+        # Health check
+        print("\n1. Health Check:")
+        result = await service.health_check()
+        print(f"   Success: {result['success']}")
+        if result['success']:
+            print(f"   Status: {result['data'].get('status')}")
+        
+        # Top coins
+        print("\n2. Top 3 Coins:")
+        result = await service.get_top_coins(limit=3)
+        if result['success']:
+            for coin in result['data'].get('coins', []):
+                print(f"   {coin['name']}: ${coin['current_price']:,.2f}")
+        
+        # Sentiment
+        print("\n3. Fear & Greed Index:")
+        fgi = await service.get_fear_greed_index()
+        print(f"   Index: {fgi}")
+        
+        # Resources
+        print("\n4. Resources Stats:")
+        result = await service.get_resources_stats()
+        if result['success']:
+            print(f"   Total: {result['data'].get('total_resources')}")
+            print(f"   Categories: {result['data'].get('total_categories')}")
+        
+        await service.close()
+        print("\n" + "=" * 60)
+        print("Tests completed!")
+    
+    asyncio.run(main())

backend/services/multi_source_config.json

@@ -1,7 +1,39 @@
 {
   "api_sources": {
+    "aggregated_sources": {
+      "primary": [
+        {
+          "name": "hf_crypto_resources_api",
+          "url": "https://really-amin-crypto-api-clean.hf.space",
+          "auth_required": false,
+          "rate_limit": "unlimited",
+          "priority": 1,
+          "timeout": 15,
+          "description": "Comprehensive crypto data API on HuggingFace Spaces",
+          "endpoints": {
+            "top_coins": "/api/coins/top",
+            "trending": "/api/trending",
+            "market_overview": "/api/market",
+            "sentiment_global": "/api/sentiment/global",
+            "resources_stats": "/api/resources/stats",
+            "categories": "/api/categories",
+            "resources_by_category": "/api/resources/category/{category}"
+          },
+          "provides": ["market_data", "sentiment", "trending", "resource_database"]
+        }
+      ]
+    },
     "market_prices": {
       "primary": [
+        {
+          "name": "hf_crypto_resources_api",
+          "url": "https://really-amin-crypto-api-clean.hf.space/api/coins/top",
+          "auth_required": false,
+          "rate_limit": "unlimited",
+          "priority": 0,
+          "timeout": 15,
+          "note": "Aggregated source - pulls from CoinGecko"
+        },
         {
           "name": "coingecko",
           "url": "https://api.coingecko.com/api/v3",
@@ -555,6 +587,15 @@
     },
     "sentiment_data": {
       "primary": [
+        {
+          "name": "hf_crypto_resources_api_sentiment",
+          "url": "https://really-amin-crypto-api-clean.hf.space/api/sentiment/global",
+          "auth_required": false,
+          "rate_limit": "unlimited",
+          "priority": 0,
+          "timeout": 15,
+          "note": "Aggregated source - pulls from Alternative.me"
+        },
         {
           "name": "alternative_me_fng",
           "url": "https://api.alternative.me/fng/",

collectors/__init__.py

@@ -41,6 +41,9 @@ __all__ = [
     "get_blockchair_data",
     "get_glassnode_metrics",
     "collect_onchain_data",
+    # HuggingFace Space Crypto API
+    "HFCryptoAPIClient",
+    "get_hf_crypto_client",
 ]
 
 _EXPORT_MAP: Dict[str, Tuple[str, str]] = {
@@ -61,6 +64,9 @@ _EXPORT_MAP: Dict[str, Tuple[str, str]] = {
     "get_blockchair_data": ("collectors.onchain", "get_blockchair_data"),
     "get_glassnode_metrics": ("collectors.onchain", "get_glassnode_metrics"),
     "collect_onchain_data": ("collectors.onchain", "collect_onchain_data"),
+    # HuggingFace Space Crypto API
+    "HFCryptoAPIClient": ("collectors.hf_crypto_api_client", "HFCryptoAPIClient"),
+    "get_hf_crypto_client": ("collectors.hf_crypto_api_client", "get_hf_crypto_client"),
 }
 
 

collectors/hf_crypto_api_client.py

@@ -0,0 +1,347 @@
+#!/usr/bin/env python3
+"""
+HuggingFace Crypto Resources API Client
+کلاینت برای API منابع کریپتو در HuggingFace Space
+
+این کلاینت برای دسترسی به API منابع کریپتو استفاده می‌شود:
+https://really-amin-crypto-api-clean.hf.space
+
+API Endpoints:
+- /api/coins/top - برترین ارزها
+- /api/trending - ارزهای ترند
+- /api/market - خلاصه بازار
+- /api/sentiment/global - شاخص ترس و طمع
+- /api/resources/stats - آمار منابع
+- /api/categories - لیست دسته‌بندی‌ها
+- /api/resources/category/{category} - منابع یک دسته
+"""
+
+import asyncio
+import aiohttp
+import requests
+from typing import Dict, Any, List, Optional
+from datetime import datetime
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class HFCryptoAPIClient:
+    """
+    Client for HuggingFace Crypto Resources API
+    کلاینت API منابع کریپتو
+    """
+    
+    BASE_URL = "https://really-amin-crypto-api-clean.hf.space"
+    
+    def __init__(self, timeout: int = 15):
+        """
+        Initialize client
+        
+        Args:
+            timeout: Request timeout in seconds
+        """
+        self.timeout = timeout
+        self._session = None
+    
+    # ===== SYNC METHODS =====
+    
+    def health_check(self) -> Dict[str, Any]:
+        """Check API health status"""
+        return self._get("/health")
+    
+    def get_top_coins(self, limit: int = 50) -> Dict[str, Any]:
+        """
+        Get top coins by market cap
+        دریافت برترین ارزها
+        
+        Args:
+            limit: Number of coins to return (default: 50)
+        """
+        return self._get("/api/coins/top", params={"limit": limit})
+    
+    def get_trending(self) -> Dict[str, Any]:
+        """
+        Get trending coins
+        دریافت ارزهای ترند
+        """
+        return self._get("/api/trending")
+    
+    def get_market_overview(self) -> Dict[str, Any]:
+        """
+        Get global market overview
+        خلاصه کلی بازار
+        """
+        return self._get("/api/market")
+    
+    def get_global_sentiment(self, timeframe: str = "1D") -> Dict[str, Any]:
+        """
+        Get Fear & Greed Index
+        شاخص ترس و طمع
+        
+        Args:
+            timeframe: Timeframe (default: "1D")
+        """
+        return self._get("/api/sentiment/global", params={"timeframe": timeframe})
+    
+    def get_asset_sentiment(self, symbol: str) -> Dict[str, Any]:
+        """
+        Get sentiment for specific asset
+        احساسات یک ارز خاص
+        
+        Args:
+            symbol: Asset symbol (e.g., "BTC", "ETH")
+        """
+        return self._get(f"/api/sentiment/asset/{symbol}")
+    
+    def get_resources_stats(self) -> Dict[str, Any]:
+        """
+        Get resources database statistics
+        آمار منابع
+        """
+        return self._get("/api/resources/stats")
+    
+    def get_categories(self) -> Dict[str, Any]:
+        """
+        Get list of resource categories
+        لیست دسته‌بندی‌ها
+        """
+        return self._get("/api/categories")
+    
+    def get_resources_by_category(self, category: str) -> Dict[str, Any]:
+        """
+        Get resources for a specific category
+        منابع یک دسته خاص
+        
+        Args:
+            category: Category name (e.g., "rpc_nodes", "market_data_apis")
+        """
+        return self._get(f"/api/resources/category/{category}")
+    
+    def get_all_resources(self) -> Dict[str, Any]:
+        """
+        Get all resources list
+        لیست همه منابع
+        """
+        return self._get("/api/resources/list")
+    
+    def get_providers(self) -> Dict[str, Any]:
+        """
+        Get data providers status
+        وضعیت provider ها
+        """
+        return self._get("/api/providers")
+    
+    def get_system_status(self) -> Dict[str, Any]:
+        """
+        Get system status
+        وضعیت سیستم
+        """
+        return self._get("/api/status")
+    
+    def get_news(self, limit: int = 50) -> Dict[str, Any]:
+        """
+        Get crypto news
+        آخرین اخبار
+        
+        Args:
+            limit: Number of articles to return
+        """
+        return self._get("/api/news", params={"limit": limit})
+    
+    def get_ohlcv(self, symbol: str = "BTC", interval: str = "1h", limit: int = 100) -> Dict[str, Any]:
+        """
+        Get OHLCV data
+        داده‌های OHLCV
+        
+        Args:
+            symbol: Asset symbol
+            interval: Time interval
+            limit: Number of candles
+        """
+        return self._get("/api/ohlcv", params={
+            "symbol": symbol,
+            "interval": interval,
+            "limit": limit
+        })
+    
+    def _get(self, endpoint: str, params: Dict = None) -> Dict[str, Any]:
+        """Make GET request"""
+        try:
+            url = f"{self.BASE_URL}{endpoint}"
+            response = requests.get(url, params=params, timeout=self.timeout)
+            response.raise_for_status()
+            return response.json()
+        except requests.RequestException as e:
+            logger.error(f"Request failed for {endpoint}: {e}")
+            return {"error": str(e), "success": False}
+    
+    # ===== ASYNC METHODS =====
+    
+    async def _get_session(self) -> aiohttp.ClientSession:
+        """Get or create aiohttp session"""
+        if self._session is None or self._session.closed:
+            self._session = aiohttp.ClientSession(
+                timeout=aiohttp.ClientTimeout(total=self.timeout)
+            )
+        return self._session
+    
+    async def close(self):
+        """Close the session"""
+        if self._session and not self._session.closed:
+            await self._session.close()
+    
+    async def _async_get(self, endpoint: str, params: Dict = None) -> Dict[str, Any]:
+        """Make async GET request"""
+        try:
+            session = await self._get_session()
+            url = f"{self.BASE_URL}{endpoint}"
+            async with session.get(url, params=params) as response:
+                response.raise_for_status()
+                return await response.json()
+        except Exception as e:
+            logger.error(f"Async request failed for {endpoint}: {e}")
+            return {"error": str(e), "success": False}
+    
+    async def async_get_top_coins(self, limit: int = 50) -> Dict[str, Any]:
+        """Async: Get top coins"""
+        return await self._async_get("/api/coins/top", params={"limit": limit})
+    
+    async def async_get_trending(self) -> Dict[str, Any]:
+        """Async: Get trending coins"""
+        return await self._async_get("/api/trending")
+    
+    async def async_get_market_overview(self) -> Dict[str, Any]:
+        """Async: Get market overview"""
+        return await self._async_get("/api/market")
+    
+    async def async_get_global_sentiment(self) -> Dict[str, Any]:
+        """Async: Get global sentiment"""
+        return await self._async_get("/api/sentiment/global")
+    
+    async def async_get_resources_by_category(self, category: str) -> Dict[str, Any]:
+        """Async: Get resources by category"""
+        return await self._async_get(f"/api/resources/category/{category}")
+    
+    # ===== UTILITY METHODS =====
+    
+    def get_rpc_nodes(self) -> List[Dict[str, Any]]:
+        """Get all RPC node resources"""
+        data = self.get_resources_by_category("rpc_nodes")
+        return data.get("resources", [])
+    
+    def get_market_data_apis(self) -> List[Dict[str, Any]]:
+        """Get all market data API resources"""
+        data = self.get_resources_by_category("market_data_apis")
+        return data.get("resources", [])
+    
+    def get_sentiment_apis(self) -> List[Dict[str, Any]]:
+        """Get all sentiment API resources"""
+        data = self.get_resources_by_category("sentiment_apis")
+        return data.get("resources", [])
+    
+    def get_block_explorers(self) -> List[Dict[str, Any]]:
+        """Get all block explorer resources"""
+        data = self.get_resources_by_category("block_explorers")
+        return data.get("resources", [])
+    
+    def get_whale_tracking_apis(self) -> List[Dict[str, Any]]:
+        """Get all whale tracking API resources"""
+        data = self.get_resources_by_category("whale_tracking_apis")
+        return data.get("resources", [])
+    
+    def get_hf_resources(self) -> List[Dict[str, Any]]:
+        """Get all HuggingFace resources (models/datasets)"""
+        data = self.get_resources_by_category("hf_resources")
+        return data.get("resources", [])
+    
+    def get_fear_greed_index(self) -> int:
+        """
+        Get current Fear & Greed Index value
+        
+        Returns:
+            int: Fear & Greed Index (0-100)
+        """
+        data = self.get_global_sentiment()
+        return data.get("fear_greed_index", 50)
+    
+    def get_btc_price(self) -> float:
+        """
+        Get current Bitcoin price
+        
+        Returns:
+            float: BTC price in USD
+        """
+        data = self.get_top_coins(limit=1)
+        coins = data.get("coins", [])
+        if coins:
+            return coins[0].get("current_price", 0)
+        return 0
+    
+    def get_total_market_cap(self) -> float:
+        """
+        Get total crypto market cap
+        
+        Returns:
+            float: Total market cap in USD
+        """
+        data = self.get_market_overview()
+        return data.get("total_market_cap", 0)
+
+
+# ===== CONVENIENCE FUNCTIONS =====
+
+def get_hf_crypto_client() -> HFCryptoAPIClient:
+    """Get a configured HF Crypto API client instance"""
+    return HFCryptoAPIClient(timeout=15)
+
+
+# ===== TEST =====
+
+if __name__ == "__main__":
+    # Test the client
+    client = HFCryptoAPIClient()
+    
+    print("=" * 60)
+    print("Testing HuggingFace Crypto Resources API Client")
+    print("=" * 60)
+    
+    # Health check
+    print("\n1. Health Check:")
+    health = client.health_check()
+    print(f"   Status: {health.get('status', 'unknown')}")
+    print(f"   Resources loaded: {health.get('resources_loaded', False)}")
+    
+    # Top coins
+    print("\n2. Top 3 Coins:")
+    coins = client.get_top_coins(limit=3)
+    for coin in coins.get("coins", []):
+        print(f"   {coin['name']}: ${coin['current_price']:,.2f}")
+    
+    # Market overview
+    print("\n3. Market Overview:")
+    market = client.get_market_overview()
+    print(f"   Total Market Cap: ${market.get('total_market_cap', 0):,.0f}")
+    print(f"   BTC Dominance: {market.get('market_cap_percentage', {}).get('btc', 0):.2f}%")
+    
+    # Sentiment
+    print("\n4. Fear & Greed Index:")
+    sentiment = client.get_global_sentiment()
+    print(f"   Index: {sentiment.get('fear_greed_index', 'N/A')}")
+    print(f"   Sentiment: {sentiment.get('sentiment', 'N/A')}")
+    
+    # Resources stats
+    print("\n5. Resources Stats:")
+    stats = client.get_resources_stats()
+    print(f"   Total Resources: {stats.get('total_resources', 0)}")
+    print(f"   Total Categories: {stats.get('total_categories', 0)}")
+    
+    # Trending
+    print("\n6. Trending Coins:")
+    trending = client.get_trending()
+    for i, coin in enumerate(trending.get("coins", [])[:5], 1):
+        print(f"   {i}. {coin['name']} ({coin['symbol']})")
+    
+    print("\n" + "=" * 60)
+    print("All tests completed!")
+    print("=" * 60)

config/api_keys.json

@@ -64,6 +64,43 @@
     }
   },
   
+  "aggregated_sources": {
+    "hf_crypto_resources_api": {
+      "name": "Crypto Resources API (HuggingFace Space)",
+      "url": "https://really-amin-crypto-api-clean.hf.space",
+      "docs_url": "https://really-amin-crypto-api-clean.hf.space/docs",
+      "auth_required": false,
+      "rate_limit": "unlimited",
+      "endpoints": {
+        "health": "/health",
+        "top_coins": "/api/coins/top",
+        "trending": "/api/trending",
+        "market_overview": "/api/market",
+        "sentiment_global": "/api/sentiment/global",
+        "sentiment_asset": "/api/sentiment/asset/{symbol}",
+        "resources_stats": "/api/resources/stats",
+        "categories": "/api/categories",
+        "resources_by_category": "/api/resources/category/{category}",
+        "providers": "/api/providers",
+        "system_status": "/api/status"
+      },
+      "categories_available": [
+        "rpc_nodes",
+        "block_explorers", 
+        "market_data_apis",
+        "news_apis",
+        "sentiment_apis",
+        "onchain_analytics_apis",
+        "whale_tracking_apis",
+        "hf_resources",
+        "free_http_endpoints",
+        "cors_proxies"
+      ],
+      "verified": true,
+      "last_verified": "2025-12-12"
+    }
+  },
+  
   "notifications": {
     "telegram": {
       "enabled": true,

config/service_registry.json

@@ -1,6 +1,72 @@
 {
   "version": "1.0.0",
-  "last_updated": "2025-11-30T00:00:00Z",
-  "services": []
+  "last_updated": "2025-12-12T00:00:00Z",
+  "services": [
+    {
+      "id": "hf_crypto_resources_api",
+      "name": "Crypto Resources API (HuggingFace Space)",
+      "type": "aggregated",
+      "description": "Comprehensive cryptocurrency data API hosted on HuggingFace Spaces. Provides market data, sentiment, trending coins, and a database of 281 crypto resources.",
+      "base_url": "https://really-amin-crypto-api-clean.hf.space",
+      "docs_url": "https://really-amin-crypto-api-clean.hf.space/docs",
+      "openapi_url": "https://really-amin-crypto-api-clean.hf.space/openapi.json",
+      "auth_required": false,
+      "rate_limit": "unlimited",
+      "priority": 1,
+      "timeout": 15,
+      "is_active": true,
+      "is_verified": true,
+      "endpoints": {
+        "health": "/health",
+        "resources_stats": "/api/resources/stats",
+        "resources_list": "/api/resources/list",
+        "categories": "/api/categories",
+        "resources_by_category": "/api/resources/category/{category}",
+        "top_coins": "/api/coins/top",
+        "trending": "/api/trending",
+        "market_overview": "/api/market",
+        "sentiment_global": "/api/sentiment/global",
+        "sentiment_asset": "/api/sentiment/asset/{symbol}",
+        "news": "/api/news",
+        "system_status": "/api/status",
+        "monitoring_status": "/api/monitoring/status",
+        "providers": "/api/providers",
+        "models_list": "/api/models/list",
+        "models_status": "/api/models/status",
+        "ohlcv": "/api/ohlcv",
+        "agents_status": "/api/agents/status"
+      },
+      "categories_available": [
+        "rpc_nodes",
+        "block_explorers",
+        "market_data_apis",
+        "news_apis",
+        "sentiment_apis",
+        "onchain_analytics_apis",
+        "whale_tracking_apis",
+        "community_sentiment_apis",
+        "hf_resources",
+        "free_http_endpoints",
+        "local_backend_routes",
+        "cors_proxies"
+      ],
+      "data_sources": {
+        "market_data": "CoinGecko (real-time)",
+        "sentiment": "Alternative.me Fear & Greed Index (real-time)",
+        "trending": "CoinGecko (real-time)"
+      },
+      "features": [
+        "market_prices",
+        "market_overview",
+        "trending_coins",
+        "fear_greed_index",
+        "resource_database",
+        "websocket_updates"
+      ],
+      "websocket": {
+        "url": "wss://really-amin-crypto-api-clean.hf.space/ws",
+        "supported": true
+      }
+    }
+  ]
 }
-

hf_unified_server.py

@@ -40,6 +40,7 @@ from backend.routers.resource_hierarchy_api import router as resource_hierarchy_
 from backend.routers.dynamic_model_api import router as dynamic_model_router
 from backend.routers.background_worker_api import router as background_worker_router
 from backend.routers.intelligent_provider_api import router as intelligent_provider_router  # NEW: Intelligent load-balanced providers
+from backend.routers.hf_space_crypto_api import router as hf_space_crypto_router  # HuggingFace Space Crypto Resources API
 
 # Real AI models registry (shared with admin/extended API)
 from ai_models import (
@@ -374,6 +375,13 @@ try:
 except Exception as e:
     logger.error(f"Failed to include indicators_router: {e}")
 
+# HuggingFace Space Crypto Resources API (External aggregated source)
+try:
+    app.include_router(hf_space_crypto_router)  # HF Space Crypto API (market, sentiment, resources database)
+    logger.info("✓ ✅ HF Space Crypto Router loaded (281 resources, 12 categories, market data, sentiment)")
+except Exception as e:
+    logger.error(f"Failed to include hf_space_crypto_router: {e}")
+
 # Add routers status endpoint
 @app.get("/api/routers")
 async def get_routers_status():