KF Candlestick Scanner
- Indicadores
- Versión: 1.0
KF Candlestick Scanner — Confirmación de la acción del precio basada en reglas (Pinbar, Engulfing, Doji)
El escáner de velas KF es un indicador de confirmación de la acción del precio, sencillo y ligero, que se integra en el gráfico de MetaTrader 5 y detecta tres familias principales de patrones de velas: formaciones de pinbar (martillo/estrella fugaz), engulfing y doji.
Diseñado para operadores de acción del precio basados en reglas y desarrolladores de algoritmos, el indicador evalúa únicamente las barras cerradas. Las señales y las flechas del gráfico aparecen en la barra 1 inmediatamente después de que esta se complete y se abra la barra 0. La barra 0 en tiempo real nunca se evalúa, lo que garantiza que las flechas y los valores de los datos permanezcan fijos una vez mostrados. Además, el indicador cuenta con una arquitectura dedicada de 3 búferes que proporciona un acceso instantáneo y estructurado para los Asesores Expertos a través de iCustom.
CARACTERÍSTICAS PRINCIPALES
- Detección de patrones principales: Pinbar / Martillo (alcista/bajista), Engulfing (alcista/bajista) y Doji (Libélula, Lápida, Estándar).
- Evalúa únicamente las barras cerradas: todos los cálculos se realizan sobre velas confirmadas y cerradas (desplazamiento >= 1). La vela activa (barra 0) nunca se señala, lo que evita señales fantasma.
- Arquitectura dedicada de 3 búferes (preparada para EA):
* Búfer 0 (gráfico 0): precio de la flecha alcista (mínimo exacto de la vela, Wingdings 233).
* Búfer 1 (Gráfico 1): Precio de la flecha bajista (máximo exacto de la vela, Wingdings 234).
* Búfer 2 (datos ocultos): código de identificación de patrones (entero ENUM_AG_CANDLE_PATTERN) para la toma de decisiones algorítmica automatizada.
- Filtro de volatilidad ATR puro: descarta automáticamente las velas insignificantes durante las sesiones de baja liquidez basándose en un múltiplo del ATR.
- Conmutadores independientes de grupo y dirección: activa o desactiva grupos de patrones individuales (Pinbar, Engulfing, Doji) y direcciones de señal (alcista, bajista).
- Regla de integración del Doji estándar: el Doji estándar (indecisión) se registra exclusivamente en el búfer oculto 2 para su integración en el EA cuando los patrones Doji están habilitados (InpEnableDoji = true), y nunca genera flechas en el gráfico, alertas de audio o push, ni etiquetas de texto. Los Doji «Dragonfly» y «Gravestone» proporcionan señales direccionales con tendencia alcista y bajista.
- Etiquetas de texto sin colisiones: Nombres de patrones opcionales en el gráfico, posicionados con desplazamientos dinámicos de distancia ATR y anclajes superiores/inferiores para evitar que se oculten los caracteres de las flechas.
- Motor de notificaciones antispam: alertas multicanal (ventana emergente en la terminal, sonido, notificaciones push en el móvil y correo electrónico) equipadas con supresión del tiempo de referencia inicial del gráfico y deduplicación de una sola señal por barra.
- Ligero y compatible con el Strategy Tester: los objetos de la interfaz de usuario y las alertas sonoras se desactivan automáticamente durante las ejecuciones no visuales del Strategy Tester, mientras que los cálculos del búfer continúan a plena velocidad.
CÓMO UTILIZARLO
1. Añade el escáner de velas KF a tu gráfico y marco temporal preferidos.
2. Selecciona los grupos de patrones y las direcciones de las señales que desees en la configuración de entrada.
3. Configura el filtro de múltiplo del ATR (por defecto, 0,5x) para ignorar el ruido de consolidación de baja volatilidad.
4. Cuando se cierra un patrón confirmado, aparece una flecha de color en el precio extremo de la vela, acompañada de la notificación que hayas configurado.
INTEGRACIÓN CON ASESORES EXPERTOS (iCustom)
Los desarrolladores pueden integrar a la perfección el KF Candlestick Scanner en sus sistemas automatizados:
- Buffer 0: iCustom(_Symbol, _Period, "KF_CandleScanner", ..., 0, shift) -> Devuelve el precio mínimo si la señal es alcista, o EMPTY_VALUE.
- Buffer 1: iCustom(_Symbol, _Period, "KF_CandleScanner", ..., 1, shift) -> Devuelve el precio máximo si la señal es bajista, o EMPTY_VALUE.
- Buffer 2: iCustom(_Symbol, _Period, "KF_CandleScanner", ..., 2, shift) -> Devuelve un código de patrón entero:
* 1 = Pinbar alcista / Martillo
* 2 = Pinbar bajista / Estrella fugaz
* 3 = Engulfing alcista
* 4 = Engulfing bajista
* 5 = Doji estándar (neutro)
* 6 = Doji «libélula» (con tendencia alcista)
* 7 = Doji «Lápida» (con tendencia bajista)
* 0 = No se ha detectado ningún patrón
PARÁMETROS DE ENTRADA
- Activar Pinbar / Martillo: activa o desactiva los patrones de Pinbar alcistas y bajistas.
- Activar «Engulfing»: activa o desactiva los patrones «Engulfing» alcistas y bajistas.
- Activar Doji: activa o desactiva los patrones Doji (Libélula, Lápida, Estándar).
- Activar señales alcistas: Filtra las señales dirigidas al alza (búfer 0).
- Activar señales bajistas: Filtra las señales con dirección a la baja (Buffer 1).
- Rango mínimo de la vela (múltiplo de ATR): rango mínimo de la barra en unidades de ATR (0,0 = desactivado).
- Período ATR: período de cálculo para el motor ATR puro integrado.
- Número máximo de barras históricas a analizar: limita los cálculos de las barras históricas para maximizar la capacidad de respuesta del gráfico.
- Código de flecha alcista/bajista: personaliza los símbolos de flecha de Wingdings (por defecto: 233 y 234).
- Desplazamiento vertical de la flecha (píxeles): ajuste de la distancia visual mediante la función nativa PLOT_ARROW_SHIFT.
- Mostrar etiquetas de texto de patrones: activa o desactiva las etiquetas de texto en el gráfico.
- Número máximo de etiquetas en las barras recientes: Límite de etiquetas de texto en el gráfico.
- Tamaño de fuente de las etiquetas de texto: tamaño de fuente para los objetos de texto del gráfico.
- Alerta emergente en la terminal: cuadro de diálogo modal nativo ante nuevas señales.
- Reproducir alerta sonora: reproducción de audio con soporte para archivos WAV personalizados.
- Notificación push en el móvil: envía notificaciones a tu aplicación móvil de MT5.
- Notificación por correo electrónico: envía alertas de señales a través de correo electrónico SMTP.
- Mostrar productos recomendados: muestra las herramientas recomendadas oficialmente por kampusforex.id en el registro de expertos.
PRODUCTOS RECOMENDADOS
¿Buscas más utilidades esenciales para el trading? Echa un vistazo a las herramientas que hemos publicado en nuestro perfil de MQL5 Market:
- AG Session Box: Sesiones de trading con una visualización clara y detección automática de la diferencia horaria con respecto al GMT.
- KF Risk Calculator: Panel interactivo para el cálculo del tamaño de las posiciones y la gestión del riesgo.
- KF Spread Swap Monitor: Herramienta de seguimiento en tiempo real del spread y del swap nocturno.
REQUISITOS Y LIMITACIONES
- Solo evalúa las barras cerradas: la señal aparece inmediatamente al abrirse la barra siguiente.
- Las notificaciones push y por correo electrónico requieren una configuración adecuada en MT5, en Herramientas -> Opciones.
- Este producto es un indicador analítico para gráficos; no realiza ni gestiona órdenes de forma automática.
AVISO LEGAL
Los patrones de velas japonesas son herramientas de confirmación de la evolución del precio, no señales de trading independientes. No deben utilizarse de forma aislada sin tener en cuenta el contexto adecuado de la estructura del mercado, la verificación de los niveles de soporte y resistencia, y una gestión de riesgos sólida.
ADVERTENCIA DE RIESGO
Operar con divisas, materias primas, índices y criptomonedas conlleva un riesgo sustancial de pérdida y no es adecuado para todos los inversores. Nunca arriesgues más capital del que puedas permitirte perder.
