Herramienta
Market Structure Interpretor (SMC)
interpretor.market_structure
Entradas
Un paquete market structure + liquidity de market.smc_structure. Esta herramienta lee su grupo STRUCTURE — los swings etiquetados (HH/HL/LH/LL) y las rupturas entre ellos.
Salidas
Un booleano que es verdadero en cada barra en que se cumple la condición de estructura elegida (una ruptura fresca para los modos de ruptura, o el estado vigente para bias_is / level_is).
Lee el lado de estructura de mercado de un paquete Market Structure + Liquidity y lo convierte en una puerta sí/no sobre cambios de tendencia. Un Break-of-Structure (BOS) confirma que la tendencia continúa; un Change-of-Character (CHoCH) es la primera señal de que puede estar girando. Úsalo para alinear las entradas con la estructura.
Cómo funciona
Lee el grupo STRUCTURE de un paquete market.smc_structure, y el modo elige qué condición de estructura probar: is_bos, is_choch e is_break se activan en la barra donde el nivel se rompe, bull_break y bear_break añaden una dirección, level_is informa del grado del nivel roto y bias_is informa del sesgo de tendencia vigente. La perilla required_level (internal o swing) te permite exigir estructura mayor de grado swing e ignorar las rupturas menores; required_bias fija la tendencia a coincidir en modo bias_is.
Modos
Opciones de Mode
Se activa en la barra en que un nivel de swing se rompe en la dirección de la tendencia existente — confirmación de que la tendencia continúa.
Cuándo usarlo: Confirma la continuación de la tendencia antes de sumar a una posición.
Se activa en la barra en que el precio rompe la estructura en contra de la tendencia previa — el primer aviso de que la tendencia puede estar girando.
Cuándo usarlo: Capta el primer indicio de un giro en un swing mayor.
Se activa en la barra en que se rompe cualquier nivel de estructura, sea un BOS o un CHoCH y en cualquier dirección.
Cuándo usarlo: Filtra por «acaba de pasar algo estructural» sin importar de qué tipo.
Se activa solo cuando la ruptura de estructura es al alza — el precio cierra por encima del nivel roto.
Cuándo usarlo: Filtra las entradas en largo solo a rupturas de estructura al alza.
Se activa solo cuando la ruptura de estructura es a la baja — el precio cierra por debajo del nivel roto.
Cuándo usarlo: Filtra las entradas en corto solo a rupturas de estructura a la baja.
Un estado vigente: verdadero mientras el sesgo de tendencia general de la estructura sea igual a required_bias (bullish, bearish, neutral o ranging).
Cuándo usarlo: Mantén una estrategia activa solo mientras la estructura concuerde con tu dirección prevista.
Un estado vigente: verdadero cuando el grado del nivel roto coincide con required_level (estructura menor internal o estructura mayor swing).
Cuándo usarlo: Exige un grado de estructura concreto antes de reaccionar a una ruptura.
Opciones de Required bias
Exige que el sesgo de tendencia vigente sea alcista (máximos más altos y mínimos más altos).
Cuándo usarlo: Opera solo en largo mientras la estructura tiende al alza.
Exige que el sesgo de tendencia vigente sea bajista (máximos más bajos y mínimos más bajos).
Cuándo usarlo: Opera solo en corto mientras la estructura tiende a la baja.
Exige un sesgo neutral — sin tendencia clara al alza o a la baja, la estructura está equilibrada.
Cuándo usarlo: Hazte a un lado u opera en reversión a la media cuando ninguna tendencia tiene el control.
Exige un sesgo en rango — el precio oscilando entre un suelo y un techo sin estructura direccional.
Cuándo usarlo: Activa tácticas de rango (operar contra los bordes) solo mientras la estructura esté en rango.
Opciones de Required level
Exige un grado de estructura internal (menor) — pequeñas rupturas entre los swings mayores.
Cuándo usarlo: Reacciona a rupturas tempranas y más finas dentro de un tramo.
Exige un grado de estructura swing (mayor) — solo los pivotes significativos que definen la tendencia mayor.
Cuándo usarlo: Ignora el ruido menor y actúa solo en rupturas de swing mayores.
Configuración
Qué condición de estructura probar: is_bos / is_choch / is_break (y las direccionales bull_break / bear_break) se activan solo en la barra de ruptura, level_is informa del grado del nivel roto y bias_is informa del sesgo de tendencia vigente.
El sesgo de tendencia a coincidir en modo bias_is: bullish, bearish, neutral o ranging.
El grado de estructura a exigir para los modos de ruptura y level_is — internal (estructura menor) o swing (estructura mayor).
Se conecta con
Ejemplos
- Filtro: toma largos solo cuando el modo es is_choch con required_level = swing (un cambio de carácter mayor al alza).
- Filtra las entradas de continuación con el modo bull_break para confirmar que la estructura rompió al alza antes de sumar a un largo.
Errores comunes
- Tratar un CHoCH como un giro garantizado — es un aviso temprano, no una confirmación, y puede fallar en rangos entrecortados.
- Dejar required_level en internal y verte inundado de rupturas menores cuando en realidad querías solo estructura de grado swing.