README.md

---
title: RapidLiveClient
emoji: 📈
colorFrom: red
colorTo: green
sdk: docker
app_port: 3000
pinned: false
---

# 📈 RapidLiveClient - Trading API

API de trading en vivo con Flask. Conectado a Binance (testnet).

## ⚠️ Aviso

Este es un proyecto de trading algorítmico. 
- Usar solo en **testnet** inicialmente
- No invertir más de lo que puedas perder
- Los resultados pasados no garantizan resultados futuros

## 📡 Endpoints

| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/` | Estado del servicio |
| GET | `/health` | Health check |
| GET | `/api/balance` | Balance de cuenta |
| GET | `/api/positions` | Posiciones abiertas |
| GET | `/api/orders` | Historial de órdenes |
| POST | `/api/orders` | Crear orden |
| POST | `/api/positions/close` | Cerrar posición |
| POST | `/api/analyze` | Análisis de mercado |

## 📥 Uso

### Obtener Balance
```bash
curl https://tu-usuario-RapidLiveClient.huggingface.space/api/balance
```

### Crear Orden
```bash
curl -X POST https://tu-usuario-RapidLiveClient.huggingface.space/api/orders \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTCUSDT", "side": "BUY", "quantity": 0.01}'
```

### Analizar Mercado
```bash
curl -X POST https://tu-usuario-RapidLiveClient.huggingface.space/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTCUSDT"}'
```

## 🔍 Verificar Conexión (Terminal)

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

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

# Ver balance
curl https://tu-usuario-RapidLiveClient.huggingface.space/api/balance
```

## 📊 Estrategia

El agente usa:
- **RSI** para sobrecompra/sobreventa
- **Medias móviles** para tendencia
- **Stop loss** configurable (5%)
- **Take profit** automático (10%)

## 🔗 Consumido por

- **RapidQuant** - Frontend principal