Herramienta
Candlestick Patterns
market.candlestick_patterns
Entradas
Sin entradas tipadas.
Salidas
Un flujo de eventos por barra de patrones de velas detectados, cada uno con el nombre del patrón (envolvente, martillo, doji, nube oscura, estrella de la mañana, …) y su sesgo alcista o bajista. Pásalo a interpretor.candlestick_pattern para convertir una formación con nombre en una señal operable.
Escanea las últimas velas y te avisa cuando se imprime una figura de reversión clásica: envolventes, martillos, dojis, nubes oscuras, estrellas de la mañana o del atardecer y más. Cada patrón detectado se reporta con su nombre y dirección para que puedas operar en contra o a favor del giro que sugiere.
Cómo funciona
Lee la apertura, máximo, mínimo y cierre de cada barra y mide el tamaño del cuerpo, la longitud de la mecha y los huecos respecto a un cuerpo promedio móvil, luego compara esas proporciones con una biblioteca de formaciones de velas con nombre. Un patrón solo califica si la geometría de la vela pasa sus pruebas de ratio y la tendencia previa (evaluada sobre trend_lookback barras con el trend_method) apunta en la dirección correcta para una reversión.
Modos
Evalúa la tendencia previa por el cambio neto de precio (momentum) sobre trend_lookback barras: si el precio sube en la ventana el contexto es alcista, así que solo califican patrones de reversión bajistas, y viceversa.
Cuándo usarlo: El chequeo de contexto más rápido y reactivo; útil cuando quieres la dirección reciente del swing en lugar de un promedio suavizado para filtrar los patrones.
Evalúa la tendencia previa comparando el precio con una media móvil simple sobre trend_lookback barras: precio por encima de la media ascendente indica contexto alcista, precio por debajo de una media descendente indica contexto bajista.
Cuándo usarlo: El chequeo de contexto más suave y estable; prefiérelo cuando quieras menos sacudidas en el filtro de tendencia, de modo que los patrones solo se acepten dentro de un movimiento limpiamente establecido.
Configuración
Ratio máximo de cuerpo a rango para que una vela cuente como doji (un cuerpo casi nulo, con apertura y cierre casi iguales). Valores menores exigen un doji más plano y de manual; 0.1 significa que el cuerpo puede ser como máximo el 10% del rango total.
El ratio de cuerpo a cuerpo promedio por debajo del cual una vela se trata como de cuerpo «corto», usado por la lógica de estrellas y harami. Valores más bajos exigen un cuerpo más pequeño para calificar como corto.
El ratio de cuerpo a cuerpo promedio por encima del cual una vela se trata como de cuerpo «largo», usado para confirmar la vela fuerte en patrones envolventes, marubozu y de estrella. Valores más altos exigen un cuerpo más dominante.
Ratio mínimo de la mecha inferior larga respecto al cuerpo para un martillo (o de la mecha superior para una estrella fugaz). Valores mayores exigen una mecha de rechazo más pronunciada antes de que el patrón califique.
Mecha superior máxima permitida para un martillo, expresada en relación con el cuerpo, de modo que un martillo verdadero tiene poca o ninguna mecha arriba. Valores menores imponen un martillo más limpio, con el cierre cerca del máximo.
Cuánto más grande debe ser el cuerpo de la vela envolvente que el cuerpo que engulle, como ratio. 1.0 significa que solo debe cubrir el cuerpo previo; valores por encima de 1.0 exigen que sea visiblemente mayor.
Para una nube oscura (y su espejo alcista, la línea penetrante), la fracción mínima en que la segunda vela debe cerrar dentro del cuerpo de la primera. 0.5 es el requisito clásico de «pasar el punto medio».
Para los patrones de estrella de la mañana y del atardecer, cuánto debe cerrar la tercera vela dentro del cuerpo de la primera para confirmar la reversión. Valores más altos exigen una recuperación o rechazo más decisivo.
Tolerancia, como fracción del precio, para tratar dos niveles como iguales; se usa para detectar aperturas, cierres o mechas coincidentes en patrones de pinzas y harami. Valores mayores aceptan como «iguales» niveles ligeramente desfasados.
Hueco de precio mínimo entre velas que exigen los patrones que dependen de huecos, como las estrellas y las formaciones de bebé abandonado. Valores mayores insisten en un hueco más claro antes de que esos patrones califiquen.
Cuántas barras atrás mira la herramienta para decidir la tendencia previa que un patrón de reversión debe revertir. Ventanas más largas evalúan el swing mayor; ventanas más cortas reaccionan al tramo más reciente.
Cómo se mide la tendencia previa antes de aceptar un patrón de reversión: 'momentum' usa el cambio neto de precio sobre el lookback, 'sma' compara el precio con una media móvil simple. La tendencia debe oponerse al patrón (p. ej. una tendencia alcista para una envolvente bajista) para que dispare.
El tipo de media móvil usado para calcular el cuerpo promedio móvil contra el que se miden las pruebas de cuerpo «corto» y «largo» (por ejemplo, simple o exponencial). Define con qué rapidez el cuerpo promedio se adapta a las velas recientes.
Se conecta con
Ejemplos
- Disparador de reversión: en un contexto alcista (trend_method 'sma'), dispara un corto cuando se imprime una envolvente bajista con engulfing_min_ratio en 1.1.
- Filtro de confirmación: limita las entradas largas solo a las barras donde se detecta un martillo alcista o una línea penetrante cerca del soporte.
Errores comunes
- Aflojar doji_body_ratio y los ratios de cuerpo tanto que casi cada vela coincida con algún patrón: el detector dispara ruido constante en lugar de giros raros y significativos.
- Olvidar el filtro de tendencia: una envolvente bajista dentro de una tendencia bajista es solo continuación, no reversión, así que un trend_method / trend_lookback mal ajustado suprime los patrones que esperabas.