README.md

---
title: RapidAgentClient
emoji: 🤖
colorFrom: purple
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# 🤖 RapidAgentClient - AI Analysis API

API de análisis de mercado con IA. Diseñado para ser consumido por RapidQuant.

## 📡 Endpoints

| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/` | Estado del servicio |
| GET | `/health` | Health check |
| POST | `/analyze` | Análisis de mercado |

## 📥 Uso

### Request
```bash
curl -X POST https://tu-usuario-RapidAgentClient.huggingface.space/analyze \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTC"}'
```

### Response
```json
{
  "success": true,
  "data": {
    "symbol": "BTC",
    "price_data": {
      "price": 50000,
      "change_24h": 2.5,
      "market_cap": 1000000000000
    },
    "tech_data": {
      "rsi": 65,
      "trend": "bullish"
    },
    "analysis": "..."
  }
}
```

## 🔧 Configuración

### Variables de Entorno
- `HF_TOKEN`: Token de HuggingFace (opcional, para IA avanzada)

## 🔍 Verificar Conexión (Terminal)

```bash
# Estado del servicio
curl https://tu-usuario-RapidAgentClient.huggingface.space/

# Health check
curl https://tu-usuario-RapidAgentClient.huggingface.space/health

# Análisis de prueba
curl -X POST https://tu-usuario-RapidAgentClient.huggingface.space/analyze \
  -H "Content-Type: application/json" \
  -d '{"symbol": "ETH"}'
```

## 📊 Datos que Retorna

- **price_data**: Precio, cambio 24h/7d/30d, market cap, rank
- **tech_data**: RSI, MA7, MA20, tendencia, volatilidad
- **analysis**: Señal de trading (comprar/vender/mantener)

## 🔗 Consumido por

- **RapidQuant** - Frontend principal