Herramienta
Chart Patterns
market.chart_patterns
Entradas
Un flujo opcional de pivotes de swing precalculados (máximos y mínimos) a partir de los cuales el detector construye los patrones. Conecta tu propio zigzag o fuente de swings para controlar exactamente qué puntos de giro cuentan; déjalo sin conectar y la herramienta deriva los pivotes internamente a partir de zigzag_depth y pivot_sensitivity.
Salidas
Un paquete de patrones gráficos detectados. Cada coincidencia lleva su familia, las barras que abarca, sus límites clave (línea de cuello, carriles, soporte/resistencia), si rompió y dónde, y un objetivo de precio proyectado dimensionado por measure_factor_mode. Toca el paquete para filtrar entradas según un patrón concreto o para dirigir objetivos y stops.
Chart Patterns rastrea el precio en busca de las formaciones geométricas clásicas que vigilan los traders técnicos: dobles techos, hombro-cabeza-hombro, triángulos, canales, cuñas, banderas, la taza con asa y más. Para cada patrón que encuentra, te indica la forma, dónde se sitúa la línea de ruptura y un objetivo de precio proyectado.
Cómo funciona
Reduce el precio a un zigzag de pivotes de swing (usando zigzag_depth y pivot_sensitivity, o los pivotes que tú aportes), y luego pone a prueba la secuencia reciente de pivotes contra la geometría de cada familia que actives: máximos/mínimos iguales, líneas de tendencia convergentes o paralelas, simetría y duración. Una coincidencia se confirma cuando el precio supera el límite del patrón por breakout_threshold (en percent o ATR), opcionalmente con un repunte de volumen, y el objetivo se proyecta a partir de la altura del patrón según measure_factor_mode.
Modos
Opciones de Families
Dos picos a una altura aproximadamente igual con un valle entre ellos: un giro bajista que se confirma cuando el precio rompe la línea de cuello trazada bajo el valle central.
Cuándo usarlo: Detectar un mercado que está techando: dos empujes fallidos al mismo techo y luego una ruptura del mínimo de swing entre ambos.
Dos valles a una profundidad aproximadamente igual con un pico entre ellos: un giro alcista que se confirma cuando el precio rompe la línea de cuello trazada sobre el pico central.
Cuándo usarlo: Detectar un mercado que está formando suelo: dos empujes fallidos al mismo soporte y luego una ruptura del máximo de swing entre ambos.
El precio oscila entre un soporte plano y una resistencia plana, construyendo un rango horizontal que se resuelve con una ruptura de cualquiera de los bordes.
Cuándo usarlo: Operativa de rango / consolidación, o esperar a que el rango se rompa para tomar el movimiento que sigue.
Un hombro izquierdo, una cabeza más alta y luego un hombro derecho más bajo, todos apoyados en una línea de cuello: el giro bajista clásico, confirmado al romperse la línea de cuello.
Cuándo usarlo: Anticipar el final de una tendencia alcista; el fallo del hombro derecho más la ruptura de la línea de cuello es la entrada.
Un hombro-cabeza-hombro invertido: hombro izquierdo, cabeza más profunda, hombro derecho más alto bajo una línea de cuello, un giro alcista confirmado cuando el precio rompe al alza la línea de cuello.
Cuándo usarlo: Anticipar el final de una tendencia bajista; el mínimo más alto del hombro derecho más la ruptura de la línea de cuello es la entrada.
Tres picos a una altura aproximadamente igual separados por dos valles: un giro bajista más fuerte que un doble techo, confirmado al romperse a la baja el soporte compartido.
Cuándo usarlo: Cuando el precio ha fallado tres veces en el mismo techo y buscas la ruptura a la baja.
Tres valles a una profundidad aproximadamente igual separados por dos picos: un giro alcista más fuerte que un doble suelo, confirmado al romperse al alza la resistencia compartida.
Cuándo usarlo: Cuando el precio ha aguantado tres veces en el mismo soporte y buscas la ruptura al alza.
Un rally pronunciado, casi vertical, que hace techo en un solo pico y se gira igual de rápido: un giro bajista veloz, sin redondeo ni retesteo.
Cuándo usarlo: Atrapar un techo de clímax: un empuje parabólico que rebota con fuerza en la misma vela o en la siguiente.
Una caída pronunciada, casi vertical, que hace suelo en un solo pico y se gira igual de rápido: un giro alcista veloz, sin redondeo ni retesteo.
Cuándo usarlo: Atrapar un mínimo de capitulación: una purga de pánico que rebota al alza en la misma vela o en la siguiente.
Una tendencia de entrada suave (la línea de entrada) es seguida de un «bump» pronunciado y sobreextendido, y luego el precio rompe de nuevo por debajo de la línea de tendencia de entrada y corre en sentido contrario.
Cuándo usarlo: Detectar una aceleración insostenible que devuelve el exceso una vez que se rompe la línea de entrada.
Una resistencia plana con una línea de soporte ascendente de mínimos crecientes: normalmente una continuación alcista que se resuelve con una ruptura por encima del techo.
Cuándo usarlo: Largos de continuación: mínimos crecientes presionando contra un techo fijo que acaba cediendo.
Un soporte plano con una línea de resistencia descendente de máximos decrecientes: normalmente una continuación bajista que se resuelve con una ruptura por debajo del soporte.
Cuándo usarlo: Cortos de continuación: máximos decrecientes presionando contra un soporte fijo que acaba rompiéndose.
Máximos decrecientes y mínimos crecientes convergen hacia un vértice: un patrón neutro de compresión que rompe en la dirección de la fuga final, a menudo la tendencia previa.
Cuándo usarlo: Continuación por compresión de volatilidad: opera la ruptura de la línea convergente que ceda primero.
El precio sube entre dos líneas paralelas inclinadas al alza: un canal ascendente; continuación de tendencia mientras aguanta, advertencia de giro si se rompe el carril inferior.
Cuándo usarlo: Operar una tendencia alcista limpia: comprar en el carril inferior y vigilar su ruptura como señal de cambio de tendencia.
El precio cae entre dos líneas paralelas inclinadas a la baja: un canal descendente; continuación de tendencia mientras aguanta, advertencia de giro si se rompe el carril superior.
Cuándo usarlo: Operar una tendencia bajista limpia: vender en el carril superior y vigilar su ruptura como señal de cambio de tendencia.
El precio se mueve de lado entre dos carriles planos y paralelos: un canal horizontal que opera como un rectángulo hasta que un carril se rompe.
Cuándo usarlo: Mercados laterales: operar en contra de los carriles o esperar la ruptura del carril que inicia la siguiente tendencia.
Ambos carriles se inclinan al alza pero convergen, con el carril inferior más pronunciado: un rally que se agota y que suele resolverse bajista al romperse la línea inferior.
Cuándo usarlo: Detectar una tendencia alcista que se agota: una cuña que se estrecha hacia arriba y tiende a romper a la baja.
Ambos carriles se inclinan a la baja pero convergen, con el carril superior más pronunciado: una caída que se agota y que suele resolverse alcista al romperse la línea superior.
Cuándo usarlo: Detectar una tendencia bajista que se agota: una cuña que se estrecha hacia abajo y tiende a romper al alza.
Un megáfono de máximos crecientes y mínimos decrecientes que se ensancha con el tiempo, formado cerca de un máximo: volatilidad e inestabilidad crecientes que a menudo se resuelven bajistas.
Cuándo usarlo: Leer un techo agitado y expansivo donde los swings se vuelven más amplios en lugar de más estrechos.
Un megáfono de máximos crecientes y mínimos decrecientes que se ensancha con el tiempo, formado cerca de un mínimo: volatilidad en expansión que a menudo se resuelve alcista saliendo de la base.
Cuándo usarlo: Leer un suelo agitado y expansivo donde los swings se vuelven más amplios antes de una resolución al alza.
Un rally pronunciado (el mástil) seguido de un pequeño canal de consolidación inclinado a la baja: una continuación alcista que rompe al alza saliendo de la bandera.
Cuándo usarlo: Largos de continuación tras un impulso fuerte: comprar la ruptura del canal de retroceso.
Una caída pronunciada (el mástil) seguida de un pequeño canal de consolidación inclinado al alza: una continuación bajista que rompe a la baja saliendo de la bandera.
Cuándo usarlo: Cortos de continuación tras un impulso bajista fuerte: vender la ruptura del canal de rebote.
Un movimiento brusco seguido de una pequeña pausa en triángulo simétrico que converge a un punto: una continuación breve que rompe en la dirección del impulso previo.
Cuándo usarlo: Continuación tras un movimiento rápido: operar la ruptura de la pequeña compresión en la dirección de la tendencia.
El precio se arquea en una cúpula lenta y suave: un giro bajista gradual donde la tendencia alcista se voltea hacia una tendencia bajista sin un pivote brusco.
Cuándo usarlo: Leer un techo de distribución lento donde el momentum se desvanece en silencio y gira a la baja.
El precio describe un platillo lento y suave: un giro alcista gradual donde la tendencia bajista se redondea hacia una tendencia alcista sin un pivote brusco.
Cuándo usarlo: Leer una base de acumulación lenta donde la venta se agota en silencio y gira al alza.
Un platillo redondeado (la taza) seguido de una pequeña deriva a la baja (el asa) justo bajo el borde: una continuación alcista que rompe por encima del borde.
Cuándo usarlo: Largos de continuación desde una base larga: comprar la ruptura sobre el borde después de que el asa retroceda.
Una cúpula redondeada (la taza invertida) seguida de una pequeña deriva al alza (el asa) justo sobre el borde: una continuación bajista que rompe por debajo del borde.
Cuándo usarlo: Cortos de continuación desde una cúpula de techo: vender la ruptura bajo el borde después de que el asa rebote.
Los swings primero se ensanchan y luego se contraen, trazando un diamante cerca de un máximo: un giro bajista que se confirma al romperse la línea convergente inferior.
Cuándo usarlo: Leer un techo que se abre en megáfono y luego se comprime de nuevo antes de voltearse a la baja.
Los swings primero se ensanchan y luego se contraen, trazando un diamante cerca de un mínimo: un giro alcista que se confirma al romperse la línea convergente superior.
Cuándo usarlo: Leer una base que se abre en megáfono y luego se comprime de nuevo antes de girar al alza.
Dos tramos alcistas aproximadamente iguales unidos por un retroceso correctivo: el primer tramo proyecta el tamaño del segundo, de modo que el movimiento «mide» su propio objetivo.
Cuándo usarlo: Proyectar un objetivo al alza: el tramo AB al alza, un retroceso BC y luego un tramo CD que refleja el AB.
Dos tramos bajistas aproximadamente iguales unidos por un rebote correctivo: el primer tramo proyecta el tamaño del segundo, de modo que el movimiento «mide» su propio objetivo a la baja.
Cuándo usarlo: Proyectar un objetivo a la baja: el tramo AB a la baja, un rebote BC y luego un tramo CD que refleja el AB.
Opciones de Breakout mode
Una ruptura solo cuenta cuando el precio supera el límite del patrón por breakout_threshold expresado como un porcentaje del precio: un filtro independiente de la escala que se comporta igual en una acción de $1 y en un índice de $2.000.
Cuándo usarlo: El valor por defecto portable: cuando quieres que el mismo colchón de ruptura signifique lo mismo en símbolos de precios muy distintos.
Una ruptura solo cuenta cuando el precio supera el límite del patrón por breakout_threshold múltiplos de ATR: el colchón se ensancha automáticamente en condiciones volátiles y se estrecha en las tranquilas.
Cuándo usarlo: Cuando quieres que el filtro de ruptura se adapte a la volatilidad actual en lugar de a un porcentaje fijo, de modo que los mercados ruidosos necesiten un empuje mayor para confirmar.
Opciones de Measure factor mode
El objetivo proyectado usa la fracción estadísticamente medida por Bulkowski de la altura del patrón, normalmente menor que la altura completa, porque históricamente la mayoría de los patrones se quedan cortos respecto a la proyección 1:1 de manual.
Cuándo usarlo: El valor por defecto realista: cuando quieres objetivos de precio dimensionados según hasta dónde tienden realmente a llegar estos patrones, no según la medida completa ideal.
El objetivo proyectado usa la altura completa del patrón medida 1:1 desde el punto de ruptura: el objetivo clásico de manual, más ambicioso que el parcial de Bulkowski.
Cuándo usarlo: Cuando quieres el objetivo tradicional de altura completa, aceptando que el precio lo alcanza con menos frecuencia que la medida parcial.
Configuración
Qué familias de patrones gráficos busca el detector. Activa cada patrón que te interese: hay 31 disponibles, desde giros (doble techo/suelo, hombro-cabeza-hombro, triple techo/suelo) hasta triángulos, canales, cuñas, banderas y la taza con asa. Cada familia activada aporta sus propias coincidencias al paquete de salida.
La profundidad mínima de swing (en barras) que el zigzag subyacente debe recorrer antes de plantar un nuevo pivote. Valores mayores conservan solo los swings grandes, de modo que los patrones se construyen a partir de giros importantes y se ignoran las pequeñas oscilaciones; valores menores captan estructura más fina pero admiten más ruido.
Con qué facilidad se acepta un máximo o mínimo local como pivote de patrón. Una sensibilidad mayor registra más puntos de giro (más patrones candidatos, más falsos positivos); una sensibilidad menor exige swings más limpios y pronunciados antes de contar un pivote.
Qué tan cercanos en precio deben estar dos picos (o dos valles), como porcentaje, para contar como «iguales»: la prueba que permite que un doble techo, triple techo o rectángulo califiquen. Una tolerancia mayor acepta coincidencias más toscas; una tolerancia más ajustada exige máximos o mínimos casi idénticos.
El número mínimo de pivotes que una línea de tendencia debe tocar antes de tratarse como un límite de patrón válido (un carril de triángulo, canal o cuña). Más toques significan una línea mejor confirmada pero menos patrones; el suelo habitual es de 2-3 toques por línea.
Cuánto se permite que se desvíe la pendiente de una línea y aun así cuente como «plana» o «paralela»: esto decide si un techo casi plano es un rectángulo o un triángulo ascendente, o si dos carriles son lo bastante paralelos como para ser un canal. Una tolerancia mayor perdona más la geometría imperfecta.
Qué tan equilibradas deben estar las dos mitades de un patrón simétrico: la altura del hombro izquierdo frente al derecho en hombro-cabeza-hombro, o los dos lados convergentes de un triángulo simétrico o diamante. Una tolerancia mayor acepta formas desiguales; una tolerancia más ajustada exige una simetría limpia.
El mínimo de barras que un patrón puede abarcar y aun así calificar. Subirlo filtra las formaciones diminutas y rápidas que son en su mayoría ruido; bajarlo deja pasar patrones cortos. Fija el suelo de la ventana de tamaño junto con max_duration_bars.
El máximo de barras que un patrón puede abarcar y aun así calificar. Limita cuán estirada puede estar una formación antes de que el detector deje de tratarla como un solo patrón; debería ser cómodamente mayor que min_duration_bars.
En qué unidades se mide breakout_threshold: «percent» usa un porcentaje del precio (independiente de la escala entre símbolos), «atr» usa múltiplos de ATR (se adapta a la volatilidad actual).
Cuánto debe superar el precio el límite del patrón antes de confirmar la ruptura. Sus unidades dependen de breakout_mode: un porcentaje del precio en modo «percent», o un múltiplo de ATR en modo «atr». Valores mayores exigen una ruptura más decisiva y reducen las falsas rupturas; valores menores confirman antes.
Cuánto más pesado debe ser el volumen de ruptura respecto al promedio del patrón para que la ruptura cuente como confirmada por volumen; p. ej. 1.5 significa un 50% por encima del promedio. Ponlo para exigir un repunte de volumen en la ruptura; bájalo (o a 1.0) para ignorar el volumen.
Cuántas barras después de una ruptura el detector sigue vigilando un retesteo del límite roto (el límite que pasa de resistencia a soporte, o viceversa). Una ventana más amplia capta retesteos más lentos; 0 desactiva el seguimiento de retesteos.
Cómo se dimensiona el objetivo de precio proyectado a partir de la altura del patrón: «bulkowski_p» usa la fracción parcial estadísticamente medida por Bulkowski (realista), «full_height» proyecta la altura completa 1:1 (el objetivo de manual).
Se conecta con
Ejemplos
- Señal de giro: activa head_shoulders_top y limita las entradas en corto a las barras donde se imprime una ruptura confirmada de la línea de cuello.
- Filtro de continuación: activa flag_bull y triangle_ascending y solo toma largos cuando uno de ellos rompe con volume_confirmation_ratio cumplido.
- Generador de objetivos: lee el objetivo proyectado de un double_bottom detectado (dimensionado por measure_factor_mode) para colocar tu toma de beneficios.
Errores comunes
- Activar las 31 familias a la vez en un timeframe rápido: te ahogas en coincidencias superpuestas y de baja calidad; elige los pocos patrones que tu estrategia realmente opera.
- Poner breakout_threshold demasiado pequeño, de modo que cada pequeño asomo a través de un límite cuente como ruptura y te lleve de un lado a otro con falsas rupturas.
- Esperar que el objetivo de altura completa se alcance de forma fiable: la mayoría de los patrones se quedan cortos, que es precisamente la razón de existir de la medida parcial de Bulkowski.