---
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