Hugging Face's logo

Spaces:
Really-amin
/
Datasourceforcryptocurrency
Paused

App Files Community
Datasourceforcryptocurrency
File size: 3,936 Bytes 
35ca5ec
5293cdd
 
 
 
35ca5ec
5293cdd
 
35ca5ec
 
5293cdd
35ca5ec
5293cdd
35ca5ec
5293cdd
35ca5ec
5293cdd
 
 
 
 
35ca5ec
5293cdd
35ca5ec
5293cdd
35ca5ec
5293cdd
 
 
35ca5ec
5293cdd
 
35ca5ec
5293cdd
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
 
---
title: Crypto Resources API
emoji: 🚀
colorFrom: purple
colorTo: blue
sdk: docker
pinned: false
license: mit
---

# 🚀 Crypto Resources API

یک API جامع برای دسترسی به **281+ منبع داده کریپتوکارنسی** با رابط کاربری زیبا و WebSocket support.

## ✨ ویژگی‌ها

- 📊 **281+ منبع داده**: RPC Nodes, Block Explorers, Market Data, News, Sentiment, Analytics
- 🎨 **رابط کاربری زیبا**: داشبورد تعاملی با نمایش آمار لحظه‌ای
- 🔌 **WebSocket**: بروزرسانی خودکار و real-time
- 📚 **API کامل**: RESTful API با OpenAPI/Swagger docs
- 🆓 **رایگان**: بدون نیاز به API key

## 🚀 استفاده سریع

### API Endpoints

```bash
# Health Check
GET /health

# آمار کلی منابع
GET /api/resources/stats

# لیست تمام منابع
GET /api/resources/list

# لیست دسته‌بندی‌ها
GET /api/categories

# منابع یک دسته خاص
GET /api/resources/category/{category}
```

### مثال با cURL

```bash
# دریافت آمار
curl https://YOUR_USERNAME-crypto-resources-api.hf.space/api/resources/stats

# دریافت RPC Nodes
curl https://YOUR_USERNAME-crypto-resources-api.hf.space/api/resources/category/rpc_nodes
```

### مثال با Python

```python
import requests

# دریافت آمار
response = requests.get("https://YOUR_USERNAME-crypto-resources-api.hf.space/api/resources/stats")
stats = response.json()
print(f"Total resources: {stats['total_resources']}")

# دریافت منابع یک دسته
response = requests.get("https://YOUR_USERNAME-crypto-resources-api.hf.space/api/resources/category/market_data")
resources = response.json()
print(f"Market data sources: {len(resources['resources'])}")
```

### WebSocket

```javascript
const ws = new WebSocket('wss://YOUR_USERNAME-crypto-resources-api.hf.space/ws');

ws.onopen = () => {
    console.log('Connected to WebSocket');
};

ws.onmessage = (event) => {
    const data = JSON.parse(event.data);
    console.log('Update:', data);
};
```

## 📦 دسته‌بندی منابع

- **RPC Nodes** (24): Ethereum, BSC, Polygon, Arbitrum, Optimism, ...
- **Block Explorers** (9): Etherscan, BscScan, Polygonscan, ...
- **Market Data** (15): CoinGecko, CoinMarketCap, Binance, ...
- **News** (10): CoinDesk, CoinTelegraph, Decrypt, ...
- **Sentiment** (7): LunarCrush, Santiment, ...
- **Analytics** (17): Glassnode, Nansen, Dune Analytics, ...
- **Hugging Face** (7): Datasets & Models
- و بیشتر...

## 🛠️ نصب لوکال

```bash
# Clone repository
git clone https://huggingface.co/spaces/YOUR_USERNAME/crypto-resources-api
cd crypto-resources-api

# نصب dependencies
pip install -r requirements.txt

# اجرای سرور
python -m uvicorn app:app --host 0.0.0.0 --port 7860

# یا با Docker
docker build -t crypto-api .
docker run -p 7860:7860 crypto-api
```

سرور در `http://localhost:7860` در دسترس خواهد بود.

## 📚 مستندات

- **API Docs**: `/docs` - Swagger UI
- **ReDoc**: `/redoc` - Alternative documentation
- **OpenAPI**: `/openapi.json` - OpenAPI specification

## 🔧 تنظیمات

### متغیرهای محیطی (اختیاری)

```bash
# برای آپلود داده به Hugging Face Datasets
HF_TOKEN=your_token_here

# برای استفاده از API های خارجی
COINGECKO_API_KEY=your_key_here
BINANCE_API_KEY=your_key_here
```

## 🤝 مشارکت

این پروژه open-source است و از مشارکت شما استقبال می‌کنیم!

## 📄 لایسنس

MIT License - استفاده آزاد در پروژه‌های شخصی و تجاری

## 🙏 تشکر

از تمام منابع داده و API هایی که این پروژه را ممکن کرده‌اند، تشکر می‌کنیم.

---

💜 ساخته شده با عشق برای جامعه کریپتو