File size: 2,283 Bytes
e4e4574
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
---
title: Crypto Data Engine
emoji: πŸ“Š
colorFrom: blue
colorTo: green
sdk: docker
app_port: 8000
---

# πŸš€ Cryptocurrency Data Engine

A production-ready cryptocurrency data aggregator providing unified APIs for OHLCV data, real-time prices, market sentiment, and more.

## 🎯 Features

- **OHLCV Data** - Historical candlestick data from Binance, Kraken
- **Real-Time Prices** - Aggregated prices from multiple providers
- **Market Sentiment** - Fear & Greed Index and sentiment analysis
- **Market Overview** - Global crypto market statistics
- **Multi-Provider Fallback** - Automatic failover for reliability
- **Caching & Rate Limiting** - Optimized for performance

## πŸ“‘ API Endpoints

### Get OHLCV Data
```
GET /api/ohlcv?symbol=BTC&interval=1h&limit=100
```

### Get Real-Time Prices
```
GET /api/prices?symbols=BTC,ETH,SOL
```

### Get Market Sentiment
```
GET /api/sentiment
```

### Get Market Overview
```
GET /api/market/overview
```

### Health Check
```
GET /api/health
```

## πŸ“– Documentation

Interactive API documentation available at:
- Swagger UI: `/docs`
- ReDoc: `/redoc`

## πŸ”— Supported Cryptocurrencies

BTC, ETH, SOL, XRP, BNB, ADA, DOT, LINK, LTC, BCH, MATIC, AVAX, XLM, TRX

## πŸ•’ Supported Timeframes

1m, 5m, 15m, 1h, 4h, 1d, 1w

## πŸ›‘οΈ Data Sources

- **Binance** - OHLCV and price data
- **Kraken** - Backup OHLCV provider
- **CoinGecko** - Comprehensive market data
- **CoinCap** - Real-time prices
- **Alternative.me** - Fear & Greed Index

## πŸ“Š Use Cases

Perfect for:
- Trading bots and algorithms
- Market analysis applications
- Portfolio tracking systems
- Educational projects
- Research and backtesting

## πŸš€ Getting Started

Try the API right now:

```bash
# Get Bitcoin price
curl https://YOUR_SPACE_URL/api/prices?symbols=BTC

# Get hourly OHLCV data
curl https://YOUR_SPACE_URL/api/ohlcv?symbol=BTCUSDT&interval=1h&limit=10

# Check service health
curl https://YOUR_SPACE_URL/api/health
```

## πŸ“ Rate Limits

- Prices: 120 requests/minute
- OHLCV: 60 requests/minute
- Sentiment: 30 requests/minute
- Health: Unlimited

## 🀝 Integration

Designed to work seamlessly with the Dreammaker Crypto Signal & Trader application and other cryptocurrency analysis tools.

---

**Version:** 1.0.0
**License:** MIT