Resumen
La función Detección de Picos monitorea más de 600 símbolos de criptomonedas para detectar movimientos de precio extremos y repentinos. Genera dos tipos de señales:
- SPIKE_PUMP: Pico rápido al alza (≥ umbral %)
- SPIKE_CRASH: Caída rápida al baja (≥ umbral %)
Propósito Principal
Detección de Crisis y Captura de Oportunidades
- 🚨 Deslistados en exchanges (caídas repentinas)
- 📰 Desastres de proyectos (hackeos, rug pulls, exploits)
- ⚖️ Acciones regulatorias (demandas de la SEC, prohibiciones en países)
- 💥 Exploits mayores (fallos en contratos inteligentes, hackeos de puentes)
- 📈 Pumps impulsados por noticias (asociaciones, listados, avances)
Comportamiento Predeterminado
Modo Solo Difusión:
- ✅ Detecta todos los picos en más de 600 símbolos
- ✅ Difunde señales vía Telegram, WhatsApp, Discord
- ❌ NO coloca órdenes (seguro por defecto)
Para Habilitar Trading:
Agregue "SPIKE_PUMP" y/o "SPIKE_CRASH" a la lista supported_volatility_action
Cómo Funciona
Lógica de Detección
El sistema monitorea el movimiento de precio de cada símbolo:
- Comparar vela actual con cierre de vela anterior
- Calcular cambio porcentual
- Verificar si el cambio supera el umbral
- Confirmar color de la vela (verde para pump, roja para crash)
- Generar señal si se cumplen todas las condiciones
Flujo de Señales
┌─────────────────────────────────────────────────────────┐
│ Detección de Picos (Todos los 600+ Símbolos) │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ Calcular % de cambio desde cierre de vela anterior │
└─────────────────────────────────────────────────────────┘
↓
┌───────────┴───────────┐
│ │
Pump ≥ umbral Crash ≥ umbral
Vela verde Vela roja
│ │
↓ ↓
SPIKE_PUMP SPIKE_CRASH
│ │
└───────────┬───────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ ¿La señal está en supported_volatility_action_broadcast?│
└─────────────────────────────────────────────────────────┘
↓
┌───────────┴───────────┐
NO SÍ
│ │
↓ ↓
Señal Ignorada Enviar Alerta
(Telegram + WhatsApp + Discord)
↓
┌─────────────────────────────────────────────────────────┐
│ ¿La señal está en supported_volatility_action? │
└─────────────────────────────────────────────────────────┘
↓
┌───────────┴───────────┐
NO SÍ
│ │
↓ ↓
Solo Difusión Colocar Orden + Difusión
(Modo Seguro) (Modo Trading)
Parámetros de Configuración
Ajustes de Detección de Picos
signal_settings:
# Habilitar/deshabilitar detección de picos globalmente
enable_spike_detection: false
# Umbral de detección de pump (pico al alza)
spike_pump_threshold: 6.0 # Predeterminado: 6% aumento mínimo
# Umbral de detección de crash (pico a la baja)
spike_crash_threshold: 5.0 # Predeterminado: 5% disminución mínima
Ajustes de Control de Difusión
trading_settings:
# Señales que serán DIFUNDIDAS (Telegram/WhatsApp/Discord)
# Estas señales enviarán alertas cuando se detecten
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
- "SPIKE_CRASH" # ✅ Difundirá alertas de crash
- "SPIKE_PUMP" # ✅ Difundirá alertas de pump
# Señales que COLOCARÁN ÓRDENES (además de difundir)
# Solo las señales en AMBAS listas operarán
supported_volatility_action:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
# Señales SPIKE NO aquí = solo difusión, sin trading
# - "SPIKE_CRASH" # ⚠️ Descomente para habilitar órdenes SHORT
# - "SPIKE_PUMP" # ⚠️ Descomente para habilitar órdenes LONG
Referencia de Parámetros
| Parámetro | Tipo | Predeterminado | Rango | Descripción |
|---|---|---|---|---|
enable_spike_detection |
boolean | false |
- | Interruptor maestro para monitoreo de picos |
spike_pump_threshold |
float | 6.0 |
1.0-20.0 | % mínimo de aumento para activar SPIKE_PUMP |
spike_crash_threshold |
float | 5.0 |
1.0-20.0 | % mínimo de disminución para activar SPIKE_CRASH |
supported_volatility_action_broadcast |
array | Ver arriba | - | Señales que envían alertas (difusión) |
supported_volatility_action |
array | Ver arriba | - | Señales que colocan órdenes (trading) |
Entendiendo las Dos Listas
Concepto Clave:
supported_volatility_action_broadcast= Qué se ALERTAsupported_volatility_action= Qué se OPERA
La señal debe estar en la lista de DIFUSIÓN para enviar alertas
La señal debe estar en AMBAS listas para colocar órdenes
Modos de Configuración
Modo 1: Solo Difusión (Predeterminado - Seguro)
enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0
# Difunde alertas de picos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # ✅ Difunde alertas de crash
- "SPIKE_PUMP" # ✅ Difunde alertas de pump
# NO opera picos
supported_volatility_action:
- "BUY"
- "SELL"
# Señales SPIKE NO en lista = sin trading
Resultado:
- ✅ Monitorea todos los 600+ símbolos
- ✅ Difunde alertas SPIKE_PUMP y SPIKE_CRASH
- ❌ Sin órdenes en señales de pico
- 🎯 Perfecto para monitoreo de crisis
Modo 2: Trading de Pumps Habilitado
enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0
# Difunde ambos tipos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # ✅ Difunde alertas de crash
- "SPIKE_PUMP" # ✅ Difunde alertas de pump
# Solo opera pumps
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # ✅ Coloca órdenes LONG en pumps
# SPIKE_CRASH sigue siendo solo difusión
Resultado:
- ✅ Difunde todas las alertas de picos (pumps y crashes)
- ✅ Coloca órdenes LONG en señales SPIKE_PUMP
- ❌ Sin órdenes en SPIKE_CRASH (solo difusión)
- 🎯 Bueno para trading de momentum/breakouts
Modo 3: Trading de Crashes Habilitado
enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0
# Difunde ambos tipos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # ✅ Difunde alertas de crash
- "SPIKE_PUMP" # ✅ Difunde alertas de pump
# Solo opera crashes
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # ✅ Coloca órdenes SHORT en crashes
# SPIKE_PUMP sigue siendo solo difusión
Resultado:
- ✅ Difunde todas las alertas de picos (pumps y crashes)
- ✅ Coloca órdenes SHORT en señales SPIKE_CRASH
- ❌ Sin órdenes en SPIKE_PUMP (solo difusión)
- 🎯 Bueno para trading de crashes/deslistados
Modo 4: Trading Completo Habilitado (Ambos)
enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 5.0
# Difunde ambos tipos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # ✅ Difunde alertas de crash
- "SPIKE_PUMP" # ✅ Difunde alertas de pump
# Opera ambos tipos
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # ✅ Coloca órdenes LONG en pumps
- "SPIKE_CRASH" # ✅ Coloca órdenes SHORT en crashes
Resultado:
- ✅ Difunde todas las alertas de picos
- ✅ Coloca órdenes LONG en pumps
- ✅ Coloca órdenes SHORT en crashes
- ⚠️ Modo de mayor riesgo
- 🎯 Solo para traders experimentados
Modo 5: Sin Difusión, Sin Trading (Deshabilitado)
enable_spike_detection: false
# O
enable_spike_detection: true
# No difundir picos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
# Señales SPIKE NO en lista = sin alertas
# No operar picos
supported_volatility_action:
- "BUY"
- "SELL"
# Señales SPIKE NO en lista = sin trading
Resultado:
- ❌ Sin alertas de picos enviadas
- ❌ Sin trading de picos
- 🎯 Úsese cuando no se necesita detección de picos
Tipos de Señales
SPIKE_PUMP (Señal de Pump)
Se activa cuando:
- El precio aumenta en ≥
spike_pump_threshold(p.ej., 6%) - La vela reciente es verde (cierre > apertura)
- Movimiento desde cierre de vela anterior a cierre de vela actual
Ejemplo de Detección:
Cierre de vela anterior: $100.00 Vela actual: Apertura: $101.00 Cierre: $106.50 (vela VERDE) Cálculo: Cambio: ($106.50 - $100.00) / $100.00 × 100 = +6.5% Umbral: 6.0% Resultado: ✅ SPIKE_PUMP detectado (+6.5% ≥ 6.0%)
Lo que típicamente indica:
- 📰 Anuncio importante de noticias (asociación, listado)
- 🚀 Ruptura de consolidación
- 💰 Gran orden de compra / acumulación de ballenas
- 📈 Ola de compras FOMO
- 🎯 Ruptura técnica confirmada
Alerta de Difusión:
🚀 SPIKE_PUMP DETECTADO Símbolo: TOKEN/USDT Cambio: +6.5% Precio: $100.00 → $106.50 Confianza: 88% Hora: 2024-11-02 14:35:00 UTC
Acción de Trading (si habilitado):
- Coloca orden LONG (compra)
- Entrada: Orden de mercado al precio actual
- Salida: Gestionada por su sistema inteligente SL/TP
- Tamaño de posición: Según configuración de trading
SPIKE_CRASH (Señal de Crash)
Se activa cuando:
- El precio disminuye en ≥
spike_crash_threshold(p.ej., 5%) - La vela reciente es roja (cierre < apertura)
- Movimiento desde cierre de vela anterior a cierre de vela actual
Ejemplo de Detección:
Cierre de vela anterior: $100.00 Vela actual: Apertura: $99.00 Cierre: $94.50 (vela ROJA) Cálculo: Cambio: ($94.50 - $100.00) / $100.00 × 100 = -5.5% Umbral: -5.0% Resultado: ✅ SPIKE_CRASH detectado (-5.5% ≤ -5.0%)
Lo que típicamente indica:
- 🚨 Anuncio de deslistado en exchange
- 💥 Hackeo o exploit del proyecto
- ⚖️ Acción regulatoria (demanda de la SEC)
- 😱 FUD mayor / noticias negativas
- 🏃 Dumping de ballenas / estafa de salida
- ⚠️ Flash crash / cascada de liquidaciones
Alerta de Difusión:
🚨 SPIKE_CRASH DETECTADO Símbolo: TOKEN/USDT Cambio: -5.5% Precio: $100.00 → $94.50 Confianza: 83% Hora: 2024-11-02 14:35:00 UTC ⚠️ VERIFICAR ANUNCIOS DEL EXCHANGE
Acción de Trading (si habilitado):
- Coloca orden SHORT (venta/corto)
- Entrada: Orden de mercado al precio actual
- Salida: Gestionada por su sistema inteligente SL/TP
- Tamaño de posición: Según configuración de trading
Ajustes Recomendados por Marco Temporal
Tabla de Referencia Rápida
| Marco Temporal | Umbral Pump | Umbral Crash | Señales Esperadas/Día | Riesgo | Caso de Uso |
|---|---|---|---|---|---|
| 1m | 2.5-3.5% | 2.5-3.5% | 40-80 | Muy Alto | Scalping (alto ruido) |
| 3m | 3.0-4.0% | 3.0-4.0% | 25-50 | Alto | Scalping rápido |
| 5m | 3.5-5.0% | 3.5-5.0% | 15-35 | Medio-Alto | ⭐ Scalping (recomendado) |
| 15m | 4.5-6.0% | 4.5-6.0% | 8-20 | Medio | Trading intradía |
| 30m | 5.0-7.0% | 5.0-7.0% | 5-12 | Medio | Swing trading |
| 1h | 6.0-8.0% | 6.0-8.0% | 3-8 | Bajo-Medio | ⭐ Monitoreo (recomendado) |
| 4h | 8.0-12.0% | 8.0-12.0% | 1-4 | Bajo | Trading de posición |
| 1d | 10.0-15.0% | 10.0-15.0% | 0-2 | Muy Bajo | Solo eventos mayores |
Ajustes Optimizados por Caso de Uso
Caso de Uso 1: Monitoreo de Crisis (600+ Símbolos)
Objetivo: Detectar deslistados, hackeos, caídas mayores
enable_spike_detection: true
spike_pump_threshold: 8.0 # Más alto para reducir ruido
spike_crash_threshold: 7.0 # Enfocarse en caídas mayores
# Difundir alertas de picos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH"
- "SPIKE_PUMP"
# No operar picos - solo difusión
supported_volatility_action:
- "BUY"
- "SELL"
# Señales SPIKE NO en lista
# Marco temporal recomendado: 5m o 15m
Esperado:
- 8-15 alertas por día en 600 símbolos
- Señales de crisis de alta calidad
- Baja tasa de falsos positivos (~20%)
- Tiempo para investigar y responder
Caso de Uso 2: Scalping (Alta Frecuencia)
Objetivo: Capturar movimientos rápidos de momentum para ganancias
enable_spike_detection: true
spike_pump_threshold: 3.5 # Más bajo para más señales
spike_crash_threshold: 3.5
# Difundir ambos
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
# Operar en ambas direcciones
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # Operar pumps
- "SPIKE_CRASH" # Operar crashes
# Marco temporal recomendado: 5m
Esperado:
- 20-40 alertas por día
- 10-20 operaciones por día
- Mayor tasa de falsos positivos (~30-40%)
- Requiere monitoreo activo
- Bueno solo para símbolos de alta liquidez
Caso de Uso 3: Swing Trading (Selectivo)
Objetivo: Capturar movimientos mayores, mantener por horas/días
enable_spike_detection: true
spike_pump_threshold: 6.0 # Umbral moderado
spike_crash_threshold: 5.5
# Difundir ambos
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
# Operar solo pumps (aprovechar momentum)
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # Operar pumps
# Sin SPIKE_CRASH (no shortear)
# Marco temporal recomendado: 15m o 1h
Esperado:
- 8-15 alertas por día
- 3-8 operaciones por día
- Enfoque en momentum alcista
- Dejar que SL/TP inteligente maneje salidas
- Buena tasa de aciertos (~60-70%)
Caso de Uso 4: Trading de Noticias (Breakouts)
Objetivo: Capturar breakouts impulsados por noticias rápidamente
enable_spike_detection: true
spike_pump_threshold: 5.0 # Capturar breakouts tempranos
spike_crash_threshold: 8.0 # Ignorar crashes (enfocarse en pumps)
# Solo difundir pumps
supported_volatility_action_broadcast:
- "SPIKE_PUMP" # Solo alertar en pumps
# Solo operar pumps
supported_volatility_action:
- "SPIKE_PUMP" # Solo operar pumps
# Marco temporal recomendado: 3m o 5m
Esperado:
- Enfoque solo en picos alcistas
- Entrada rápida en breakouts
- Ignorar crashes (reducir riesgo)
- 5-15 operaciones por día
Ajuste Específico por Activo
Activos de Alta Volatilidad (La mayoría de Altcoins)
# Más conservador (reducir ruido)
spike_pump_threshold: 7.0
spike_crash_threshold: 6.0
Activos: La mayoría de altcoins, meme coins, tokens de baja capitalización
Activos de Volatilidad Media (Altcoins Mayores)
# Enfoque equilibrado
spike_pump_threshold: 5.0
spike_crash_threshold: 5.0
Activos: ETH, BNB, SOL, ADA, XRP, MATIC, etc.
Activos de Baja Volatilidad (BTC, Stablecoins)
# Más sensible (capturar movimientos menores)
spike_pump_threshold: 3.0
spike_crash_threshold: 3.0
Activos: BTC, tokens de gran capitalización
Escenarios de Crisis del Mundo Real
Escenario 1: Deslistado en Exchange
Evento: Binance anuncia deslistado de TOKEN_X efectivo en 7 días
Cronología:
14:00:00 - Anuncio de Binance publicado 14:00:30 - La noticia se difunde en Twitter/Telegram 14:01:00 - Comienza venta de pánico 14:02:00 - Precio cae de $1.50 a $1.28 (-14.7%) 14:02:05 - 🚨 SPIKE_CRASH detectado 14:02:06 - Alerta difundida: Telegram + WhatsApp + Discord 14:02:30 - Verifica anuncio en Binance 14:03:00 - Salida manual (si tiene posición) 14:10:00 - Precio continúa a $0.95 (-36.7%)
Resultado: Detección temprana permitió salida en -15% vs mantener hasta -37%
Respuesta Solo Difusión:
🚨 SPIKE_CRASH: TOKEN_X/USDT Cambio: -14.7% Precio: $1.50 → $1.28 Acción: Revisión manual requerida 1. Verificar anuncios de Binance 2. Confirmar deslistado 3. Salir de posición si se confirma
Respuesta con Trading Habilitado (si SPIKE_CRASH en ambas listas):
🚨 SPIKE_CRASH: TOKEN_X/USDT Cambio: -14.7% Precio: $1.50 → $1.28 ✅ Orden SHORT colocada en $1.28 Sistema SL/TP inteligente activo Objetivo: Movimiento adicional de -10% a -20%
Escenario 2: Exploit/Hackeo del Proyecto
Evento: Puente de protocolo DeFi hackeado por $100M
Cronología:
02:30:00 - Exploit ejecutado en cadena 02:31:00 - Hacker vuelca token del proyecto en DEX 02:32:00 - Precio cae de $5.00 a $3.25 (-35%) 02:32:05 - 🚨 SPIKE_CRASH detectado 02:32:06 - Alerta te despierta (2:32 AM) 02:33:00 - Verifica Twitter - "Puente hackeado" en tendencia 02:34:00 - Salida de emergencia (si tiene posición) 02:40:00 - Precio continúa a $1.20 (-76%)
Resultado: Actuado en 2 minutos, salida en -35% vs -76%
Aprendizaje Clave:
- Caídas extremas (>20%) casi siempre son crisis reales
- Horas inusuales (2 AM) = probablemente exploit
- Actuar rápido, investigar después
- Detección SPIKE_CRASH fue salvavidas
Escenario 3: Pump por Noticias Mayores
Evento: Anuncio de asociación mayor
Cronología:
10:00:00 - Empresa tuitea asociación con Fortune 500 10:00:30 - Noticia se vuelve viral 10:01:00 - Ola de compras FOMO comienza 10:02:00 - Precio sube de $0.50 a $0.58 (+16%) 10:02:05 - 🚀 SPIKE_PUMP detectado 10:02:06 - Alerta difundida 10:02:30 - Verificar noticia (anuncio oficial) 10:03:00 - Entrar en posición (si trading habilitado) 10:15:00 - Precio alcanza pico en $0.72 (+44%) 10:30:00 - SL/TP inteligente sigue y sale en $0.68 (+36%)
Resultado: Capturó momentum temprano, salida inteligente preservó ganancias
Respuesta Solo Difusión:
🚀 SPIKE_PUMP: TOKEN_Y/USDT Cambio: +16% Precio: $0.50 → $0.58 Acción: Verificar noticia - Verificar canales oficiales - Considerar entrada si noticia confirmada - Establecer stop loss por debajo de entrada
Respuesta con Trading Habilitado:
🚀 SPIKE_PUMP: TOKEN_Y/USDT Cambio: +16% Precio: $0.50 → $0.58 ✅ Orden LONG colocada en $0.58 SL/TP inteligente activo Stop trailing activado Monitoreando condiciones de salida
Escenario 4: Falsa Alarma - Recuperación de Flash Crash
Evento: Evento de liquidez causa pico temporal, recuperación inmediata
Cronología:
10:30:00 - Gran orden de venta golpea libro de órdenes delgado 10:31:00 - Precio cae de $10.00 a $8.80 (-12%) 10:31:05 - 🚨 SPIKE_CRASH detectado 10:31:06 - Alerta difundida 10:32:00 - Verificar noticias: Nada encontrado 10:33:00 - Precio recuperando: $8.80 → $9.40 10:35:00 - Completamente recuperado: $9.40 → $10.20 (+2%)
Resultado: Alerta recibida, investigación mostró falsa alarma, no se tomó acción
Cómo Identificar Falsas Alarmas:
- ✅ Sin noticias - Twitter, Telegram, anuncios de exchange en silencio
- ✅ Recuperación rápida - Precio rebota en 3-5 minutos
- ✅ Evento aislado - Solo un exchange afectado
- ✅ Patrón de volumen - Una sola orden grande, no venta sostenida
Protocolo de Respuesta:
Pico detectado
↓
Verificar noticias (30 segundos)
↓
¿Noticias encontradas?
↓
SÍ → Actuar (salir/entrar)
NO → Esperar 2-3 velas
↓
¿Sigue moviéndose?
↓
SÍ → Actuar (probablemente real)
NO → Falsa alarma, ignorar
Trading vs Difusión
Entendiendo el Sistema de Dos Listas
Tu bot usa dos listas de control separadas:
Lista 1: Control de Difusión
supported_volatility_action_broadcast
- Controla qué señales envían alertas
- Debe incluir la señal para que se envíen alertas
- Puede incluir señales solo de difusión (p.ej., SPIKE_CRASH, SPIKE_PUMP)
Lista 2: Control de Trading
supported_volatility_action
- Controla qué señales colocan órdenes
- Debe incluir la señal para que ocurra trading
- Típicamente subconjunto de la lista de difusión
Flujo de Procesamiento de Señales
1. Señal Detectada (p.ej., SPIKE_CRASH)
↓
2. Verificar: ¿La señal está en supported_volatility_action_broadcast?
↓
┌───┴───┐
NO SÍ
↓ ↓
Omitir Enviar Alerta
(Telegram/WhatsApp/Discord)
↓
3. Verificar: ¿La señal está en supported_volatility_action?
↓
┌───┴───┐
NO SÍ
↓ ↓
Hecho Colocar Orden
Ejemplos de Configuración
Ejemplo 1: Monitorear Todo, Operar Nada
# Obtener alertas para todas las señales, no colocar órdenes
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
- "SPIKE_CRASH" # ✅ Alertará
- "SPIKE_PUMP" # ✅ Alertará
supported_volatility_action:
# Lista vacía o mínima = sin trading
[]
Resultado:
- ✅ Alertas para todo
- ❌ Sin órdenes colocadas
- 🎯 Modo de monitoreo puro
Ejemplo 2: Monitorear Todo, Operar Solo Señales Tradicionales
# Obtener alertas para todas las señales, pero solo operar BUY/SELL
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
- "SPIKE_CRASH" # ✅ Alertará
- "SPIKE_PUMP" # ✅ Alertará
supported_volatility_action:
- "BUY" # ✅ Alertará Y operará
- "SELL" # ✅ Alertará Y operará
# Señales SPIKE NO aquí = solo alerta
Resultado:
- ✅ Alertas para todas las señales
- ✅ Trading solo en BUY/SELL
- ❌ Sin trading en picos (solo alertas)
- 🎯 Enfoque conservador
Ejemplo 3: Monitorear y Operar Solo Crashes
# Alertar en ambos, pero solo operar crashes
supported_volatility_action_broadcast:
- "SPIKE_CRASH" # ✅ Alertará
- "SPIKE_PUMP" # ✅ Alertará
supported_volatility_action:
- "SPIKE_CRASH" # ✅ Alertará Y operará
# SPIKE_PUMP no aquí = solo alerta
Resultado:
- ✅ Alertas para pumps y crashes
- ✅ Trading solo en crashes
- ❌ Sin trading en pumps
- 🎯 Estrategia de trading de crashes
Ejemplo 4: Modo Trading Completo
# Alertar y operar en todo
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
- "SPIKE_CRASH"
- "SPIKE_PUMP"
supported_volatility_action:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
- "SPIKE_CRASH"
- "SPIKE_PUMP"
Resultado:
- ✅ Alertas para todo
- ✅ Trading en todo
- ⚠️ Mayor riesgo
- 🎯 Enfoque agresivo
¿Por Qué Este Diseño?
Separación de Responsabilidades:
- Monitoreo ≠ Trading
- Podrías querer saber sobre TODOS los picos (600 símbolos)
- Pero solo operar en condiciones SELECTAS
- Difusión te mantiene informado
- Lista de trading controla el riesgo
Ejemplo de Caso de Uso:
Monitoreando 600 símbolos: - 590 altcoins de baja capitalización, alto riesgo → Solo difusión - 10 monedas mayores de alta liquidez → Trading habilitado Configuración: supported_volatility_action_broadcast: [todas las señales incluyendo SPIKE] supported_volatility_action: [solo para 10 monedas mayores] Resultado: - Obtener alertas para todos los 600 (detección de crisis) - Solo operar 10 (gestión de riesgo)
Mejores Prácticas
1. Comenzar con Solo Difusión
# Semana 1-4: Aprender los patrones
enable_spike_detection: true
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
supported_volatility_action:
- "BUY"
- "SELL"
# Sin señales SPIKE = solo difusión
# Rastrear:
- ¿Cuántas alertas por día?
- ¿Cuántas fueron crisis reales?
- ¿Cuántas fueron falsas alarmas?
- ¿Cuáles fueron los resultados?
Beneficios:
- Cero riesgo de trading
- Aprender calidad de señales
- Entender tasa de falsos positivos
- Construir confianza
2. Habilitar Trading Gradualmente
# Mes 2: Habilitar una dirección primero
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # Comenzar con pumps (menos riesgoso)
# Mes 3+: Agregar crashes si se desea
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP"
- "SPIKE_CRASH" # Agregar después de ganar experiencia
3. Ajustar Umbrales Según Condiciones del Mercado
Período de Alta Volatilidad (p.ej., mercado alcista):
spike_pump_threshold: 8.0 # Aumentar para reducir ruido
spike_crash_threshold: 7.0
Período de Baja Volatilidad (p.ej., consolidación bajista):
spike_pump_threshold: 4.0 # Disminuir para capturar movimientos
spike_crash_threshold: 4.0
Volatilidad Extrema (p.ej., evento de noticias mayor):
spike_pump_threshold: 10.0 # Mucho más alto para evitar caos
spike_crash_threshold: 10.0
4. Monitorear Métricas de Calidad de Alertas
Rastrear semanalmente:
Total Alertas: 150 Crisis Reales: 8 Falsas Alarmas: 45 Eventos Perdidos: 2 Tasa de Falsos Positivos: 30% Tasa de Detección: 80% Si demasiadas falsas alarmas: → Aumentar umbrales en 0.5-1.0% Si se pierden eventos reales: → Disminuir umbrales en 0.5-1.0%
5. Usar Marcos Temporales Apropiados
Para Monitoreo de Crisis:
- Usar velas de 5m o 15m
- Marcos más altos = señales más limpias
- Menor tasa de falsos positivos
Para Scalping:
- Usar velas de 3m o 5m
- Detección más rápida
- Aceptar mayor tasa de falsos positivos
Para Swing Trading:
- Usar velas de 15m o 1h
- Mejor calidad de señal
- Menos pero más fuertes señales
6. Combinar con Otras Señales
No depender únicamente de señales de pico:
Ejemplo de Estrategia de Confirmación:
SPIKE_PUMP detectado
+
RSI < 70 (no sobrecomprado)
+
Volumen > 2× promedio
+
Exchange mayor (Binance)
=
ALTA CONFIANZA → Considerar entrada
SPIKE_PUMP detectado
+
RSI > 80 (sobrecomprado)
=
BAJA CONFIANZA → Solo alerta, no operar
7. Entender Requisitos de Color de Vela
Lógica Actual:
- SPIKE_PUMP requiere vela verde (cierre > apertura)
- SPIKE_CRASH requiere vela roja (cierre < apertura)
Por Qué: Confirma dirección y control de compradores/vendedores
Esto significa:
- Un movimiento +10% en vela roja no activará SPIKE_PUMP
- Un movimiento -10% en vela verde no activará SPIKE_CRASH
Beneficio: Reduce señales falsas por mechas
Escenarios Comunes
Escenario 1: Demasiadas Alertas (Fatiga de Alertas)
Problema: Más de 50 alertas por día, abrumador
Soluciones:
- Aumentar umbrales:
# Antes
spike_pump_threshold: 4.0
spike_crash_threshold: 4.0
# Después
spike_pump_threshold: 6.5
spike_crash_threshold: 6.0
- Mover a marco temporal más largo:
- 3m → 5m
- 5m → 15m
- Filtrar símbolos:
- Eliminar símbolos de bajo volumen
- Eliminar meme coins altamente volátiles
- Enfocarse en top 100-200 por capitalización de mercado
- Eliminar temporalmente de lista de difusión:
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
# Eliminar señales SPIKE temporalmente
Escenario 2: Perdiendo Eventos Importantes
Problema: Crashes reales ocurriendo pero sin alertas
Posibles Causas:
- Umbral demasiado alto
- Detección de picos deshabilitada
- Señal no en lista de difusión
- Incompatibilidad de color de vela
- Problema de feed de datos
Soluciones:
- Disminuir umbrales:
spike_pump_threshold: 8.0 → 6.0
spike_crash_threshold: 7.0 → 5.0
- Verificar habilitado:
enable_spike_detection: true # Debe ser true
- Verificar en lista de difusión:
supported_volatility_action_broadcast:
- "SPIKE_CRASH" # Debe estar en lista
- "SPIKE_PUMP" # Debe estar en lista
- Verificar logs del bot por errores
Escenario 3: Órdenes Ejecutándose en Falsas Alarmas
Problema: SPIKE_CRASH activado, orden colocada, luego precio se recuperó
Soluciones:
- Eliminar de lista de trading:
# Detener trading en picos temporalmente
supported_volatility_action:
- "BUY"
- "SELL"
# Eliminar SPIKE_CRASH y SPIKE_PUMP
# Pero mantener en lista de difusión para alertas
supported_volatility_action_broadcast:
- "SPIKE_CRASH" # Todavía obtener alertas
- "SPIKE_PUMP" # Todavía obtener alertas
- Aumentar umbrales (señales de mayor calidad):
# Más conservador = menos falsas alarmas
spike_pump_threshold: 6.0 → 8.0
spike_crash_threshold: 5.0 → 7.0
- Confiar en su SL/TP inteligente:
- Incluso en falsas alarmas, su stop-loss inteligente debería limitar daños
- Revisar configuraciones SL/TP si las pérdidas son excesivas
Escenario 4: Querer Alertas Pero No Trading
Problema: Querer saber sobre picos pero no órdenes automáticas
Solución: Caso de uso perfecto para el sistema de dos listas
# Obtener alertas para picos
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # ✅ Alertará
- "SPIKE_PUMP" # ✅ Alertará
# Pero no operarlos
supported_volatility_action:
- "BUY"
- "SELL"
# Señales SPIKE NO aquí = sin trading
Resultado:
- ✅ Obtener alertas para todos los picos
- ✅ Puede revisar manualmente y decidir
- ❌ Sin órdenes automáticas en picos
- 🎯 Enfoque seguro e informado
Escenario 5: Querer Operar Solo en Horas Específicas
Problema: No querer que operaciones de picos se ejecuten a las 3 AM
Solución:
Usar filtros de horario existentes del bot (si disponibles):
trading_hours:
enabled: true
start_hour: 8 # 8 AM
end_hour: 22 # 10 PM
timezone: "UTC"
# Señales SPIKE fuera de horario:
# - Todavía difunden alertas
# - No colocarán órdenes (filtro de tiempo bloquea)
Alternativa: Eliminar de lista de trading durante horas de sueño:
- Antes de dormir: Eliminar señales SPIKE de
supported_volatility_action - Al despertar: Agregarlas de nuevo si se desea
Solución de Problemas
Problema: No se Generan Señales
Lista de Verificación:
- [ ]
enable_spike_detection: true - [ ] Umbrales no demasiado altos (pruebe 5.0% temporalmente para test)
- [ ] Movimiento de precio suficiente en el mercado
- [ ] Al menos 2 velas de datos disponibles
- [ ] WebSocket/feed de datos conectado
Pasos de Depuración:
- Verificar logs del bot por actividad de detección de picos
- Disminuir temporalmente umbrales:
spike_pump_threshold: 2.0 # Muy sensible para pruebas
spike_crash_threshold: 2.0
- Verificar que los datos fluyen (ver actualizaciones recientes de velas en logs)
- Probar con símbolo volátil conocido
Problema: Señales Generadas Pero Sin Difusión
Posibles Causas:
- Señal no en lista
supported_volatility_action_broadcast - Canales de alerta no configurados
- Claves API faltantes
- Problemas de conectividad de red
- Cooldown de señal activo
Soluciones:
- Verificar que la señal está en lista de difusión:
supported_volatility_action_broadcast:
- "SPIKE_CRASH" # Debe estar presente
- "SPIKE_PUMP" # Debe estar presente
- Verificar configuración de alertas:
alert_settings:
enable_telegram: true
telegram_bot_token: "tu_token"
telegram_chat_id: "tu_chat_id"
enable_whatsapp: true
whatsapp_config: { ... }
enable_discord: true
discord_webhook_url: "tu_webhook"
- Verificar logs por errores de alerta
- Verificar si el símbolo está en período de cooldown (30 minutos predeterminado)
Problema: Órdenes No se Colocan A Pesar de Señal en Lista
Problema: SPIKE_PUMP en ambas listas pero sin órdenes colocadas
Lista de Verificación:
- [ ] Señal en lista
supported_volatility_action_broadcast - [ ] Señal en lista
supported_volatility_action - [ ] Trading no pausado globalmente
- [ ] Saldo suficiente en cuenta
- [ ] Permisos API de exchange (trading habilitado)
- [ ] Símbolo no filtrado por otras configuraciones
- [ ] Límites de posición no excedidos
Pasos de Depuración:
- Verificar señal en AMBAS listas:
supported_volatility_action_broadcast:
- "SPIKE_PUMP" # ✅ Debe estar aquí
supported_volatility_action:
- "SPIKE_PUMP" # ✅ Y aquí
- Verificar logs de trading por intentos de orden
- Verificar permisos API en exchange
- Verificar saldo de cuenta
- Revisar otros filtros de trading (volumen, límites de riesgo, etc.)
Problema: Obteniendo Alertas para Señales Incorrectas
Problema: Obteniendo alertas PUMP/CRASH cuando solo quiere señales SPIKE
Solución: Controlar exactamente qué se difunde
# Solo difundir señales de pico
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
# Eliminar otras señales que no quiera alertas
# Operar otras señales sin alertas
supported_volatility_action:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
# Estas operarán pero no difundirán (no en lista de difusión)
Problema: Confianza Siempre el Mismo Valor
Explicación: Esto es por diseño
La confianza se calcula según cuánto supera el pico el umbral:
Fórmula:
- Confianza base: 80%
- Bonificación: Hasta +30% basado en fuerza del pico
- Máximo: 100%
Ejemplos:
- Pico 6%, umbral 6% → 80% confianza (justo cumplió umbral)
- Pico 9%, umbral 6% → 95% confianza (50% sobre umbral)
- Pico 12%, umbral 6% → 100% confianza (100% sobre umbral)
Esto funciona correctamente. Picos más fuertes obtienen mayor confianza.
Ejemplos de Configuración Avanzada
Ejemplo 1: Ultra-Conservador (Solo Detección de Crisis)
# Objetivo: Solo detectar pumps/crashes mayores (deslistados, hackeos)
# Trading: Ninguno (solo alertas)
signal_settings:
enable_spike_detection: true
spike_pump_threshold: 12.0 # Umbral muy alto
spike_crash_threshold: 10.0 # Umbral muy alto
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
supported_volatility_action:
- "BUY"
- "SELL"
# Sin señales SPIKE
# Resultados esperados:
# - 2-8 alertas por día (solo eventos extremos)
# - Tasa de falsos positivos muy baja (~10%)
# - Puede perder algunos eventos de severidad media
# - Perfecto para protección de portafolio con ruido mínimo
Ejemplo 2: Scalping Agresivo (Alta Frecuencia)
# Objetivo: Capturar muchos movimientos rápidos para scalping
# Trading: Habilitado en ambas direcciones
signal_settings:
enable_spike_detection: true
spike_pump_threshold: 3.5 # Sensible
spike_crash_threshold: 3.5 # Sensible
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP"
- "SPIKE_CRASH"
# Resultados esperados:
# - 30-60 alertas por día
# - 15-30 operaciones por día
# - Mayor tasa de falsos positivos (~40%)
# - Requiere monitoreo activo
# - SL/TP inteligente crucial para gestión de riesgo
Ejemplo 3: Momentum Solo Long (Mercado Alcista)
# Objetivo: Aprovechar pumps de momentum, ignorar crashes
# Trading: Solo SPIKE_PUMP
signal_settings:
enable_spike_detection: true
spike_pump_threshold: 5.0 # Moderado
spike_crash_threshold: 7.0 # Todavía alertar en crashes
supported_volatility_action_broadcast:
- "SPIKE_CRASH" # Alertar en crashes
- "SPIKE_PUMP" # Alertar en pumps
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # Operar solo pumps
# Sin SPIKE_CRASH
# Resultados esperados:
# - Obtener alertas para ambos pumps y crashes
# - Solo operar pumps (posiciones long)
# - Evitar riesgo de shorting
# - 8-15 alertas por día
# - 3-8 operaciones por día (solo long)
Ejemplo 4: Trader de Crashes (Solo Short)
# Objetivo: Operar crashes/deslistados (short)
# Trading: Solo SPIKE_CRASH
signal_settings:
enable_spike_detection: true
spike_pump_threshold: 8.0 # Alto (solo alerta)
spike_crash_threshold: 5.0 # Sensible a crashes
supported_volatility_action_broadcast:
- "SPIKE_CRASH" # Alertar en crashes
- "SPIKE_PUMP" # Alertar en pumps
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_CRASH" # Operar solo crashes
# Sin SPIKE_PUMP
# Resultados esperados:
# - Obtener alertas para ambos pumps y crashes
# - Solo operar crashes (posiciones short)
# - Capturar deslistados, hackeos, malas noticias
# - 5-12 alertas por día
# - 2-5 operaciones por día (solo short)
# - Alto riesgo (shorting puede ser peligroso)
Ejemplo 5: Difusión Selectiva
# Objetivo: Solo difundir señales de pico, operar todo
signal_settings:
enable_spike_detection: true
spike_pump_threshold: 6.0
spike_crash_threshold: 6.0
# Solo difundir picos
supported_volatility_action_broadcast:
- "SPIKE_CRASH"
- "SPIKE_PUMP"
# Otras señales no aquí = sin alertas
# Operar todo
supported_volatility_action:
- "BUY"
- "SELL"
- "PUMP"
- "CRASH"
- "SPIKE_PUMP"
- "SPIKE_CRASH"
# Resultado:
# - Solo obtener alertas para señales de pico
# - Todas las señales (incluyendo BUY/SELL/PUMP/CRASH) todavía operan
# - Reduce ruido de alertas
# - Enfoque en eventos de crisis
Guía de Inicio Rápido
Paso 1: Habilitar Detección (Solo Difusión)
# config.yaml
signal_settings:
enable_spike_detection: true
spike_pump_threshold: 7.0
spike_crash_threshold: 7.0
# Difundir señales de pico
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH"
- "SPIKE_PUMP"
# No operar señales de pico aún
supported_volatility_action:
- "BUY"
- "SELL"
# Sin señales SPIKE
Iniciar bot y monitorear por 1-2 semanas:
- ¿Cuántas alertas?
- ¿Cuál es la tasa de falsos positivos?
- ¿Se capturan eventos reales?
Paso 2: Ajustar Umbrales
Basado en resultados de Semana 1-2:
¿Demasiadas alertas (>30/día)?
spike_pump_threshold: 7.0 → 9.0
spike_crash_threshold: 7.0 → 8.0
¿Pocas alertas (<5/día)?
spike_pump_threshold: 7.0 → 5.0
spike_crash_threshold: 7.0 → 5.0
Paso 3: Habilitar Trading (Opcional)
Después de estar cómodo con calidad de alertas:
supported_volatility_action_broadcast:
- "BUY"
- "SELL"
- "SPIKE_CRASH"
- "SPIKE_PUMP"
supported_volatility_action:
- "BUY"
- "SELL"
- "SPIKE_PUMP" # ← Agregar esto para habilitar trading
# Dejar SPIKE_CRASH fuera por ahora