> ## Documentation Index
> Fetch the complete documentation index at: https://docs.innova-trading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Swing Points (indicador standalone)

> Cómo configurar el detector de puntos de giro liviano — sin CHoCH/BOS ni rangos

## Qué es

**Swing Points** (id interno `swingpoints`) es la versión standalone y liviana del detector de puntos de giro que usa internamente el [ISS](/learn/indicators/innova-smart-structure). Dibuja únicamente los swing highs/lows detectados por análisis fractal, con su clasificación HH/HL/LH/LL y, opcionalmente, su jerarquía ST/IT/LT (Larry Williams) — **sin** CHoCH/BOS, sin rangos dinámicos y sin niveles N1/N2.

Es TradingView-equivalente a "Swing High Low / Fractal indicator".

<Info>
  Para la teoría completa (qué es un swing point, criterios de calidad, relación con liquidez), ver [Swing Points — Fundamentos](/learn/fundamentals/swing-points). Acá solo cubrimos los parámetros de este indicador puntual.
</Info>

## Cuándo usar Swing Points en vez del ISS completo

| Usá **Swing Points** si... | Usá el **ISS completo** si... |
| - | - |
| Solo necesitás ver los puntos de giro "crudos" del precio | Necesitás CHoCH/BOS, filtros de tamaño de ruptura, rangos Premium/Discount |
| Querés un panel de indicador más liviano/rápido, sin el resto del aparato del ISS | Necesitás el análisis dual N1/N2 (micro + "Ultimate") |
| Vas a usar la jerarquía ST/IT/LT como filtro visual directo (`showHierarchy`) | Vas a alimentar otro indicador (ej. FVG) con el contexto de fractal del ISS |

## Parámetros

Todos los parámetros son **planos** — este indicador no usa secciones/acordeones en su UI.

| Parámetro | Label UI | Default | Rango | Qué hace | Cuándo cambiarlo |
| - | - | - | - | - | - |
| `strength` | Fuerza (N-barras) | **2** | 1–5 (UI) / hasta 10 vía API | Barras a cada lado que deben tener un high/low menor(mayor) para confirmar el swing | Subilo a 3-5 en TFs bajos ruidosos; bajalo a 1 para máxima sensibilidad |
| `validationEnabled` | Validación por precio | **`false`** | bool | Si está activo, un swing candidato queda `ACTIVO` hasta que el precio lo confirma según `validationType` | Activalo si te interesa distinguir swings "confirmados" de candidatos aún en formación |
| `validationType` | Tipo validación | `WICK` | WICK / BODY / CLOSE | Qué parte de la vela debe confirmar el swing (solo aplica si `validationEnabled=true`) | `CLOSE` para el criterio más estricto |
| `pauseMode` | Modo pausa (outside bar) | **`strict`** | strict / flexible | Comportamiento durante la pausa posterior a un swing recién formado (ver detalle en la doc del ISS) | `flexible` si no querés perderte candidatos durante consolidaciones |
| `showHierarchy` | Mostrar jerarquía ST/IT/LT | `false` | bool | Colorea y dimensiona los marcadores según la jerarquía Larry Williams (ST/IT/LT) en vez de un esquema simple alcista/bajista | Activalo para leer bias de corto/medio/largo plazo directamente del gráfico |
| `showClassificationLabels` | Mostrar HH/LH/HL/LL | `true` | bool | Muestra la etiqueta de clasificación estructural sobre cada swing | Desactivalo si el gráfico queda muy cargado de texto |
| `showOnlyClassified` | Solo estructurales (ocultar swings base) | `false` | bool | Oculta los swings sin clasificación válida (`FIRST` o sin clasificar), mostrando solo HH/HL/LH/LL | Útil combinado con `showHierarchy` para quedarte solo con los swings LT relevantes |
| `classificationMode` | Modo clasificación | `STRUCTURAL` | STRUCTURAL / IMMEDIATE / CONFIRMED | Cómo se asigna la etiqueta HH/HL/LH/LL (ver detalle abajo) | `IMMEDIATE` para feedback instantáneo, `CONFIRMED` para exigir mayor certeza |
| `startFromBar` | Iniciar desde barra # (0=todas) | `0` | 0–1000 | Recorta el cálculo para arrancar desde una barra específica del dataset cargado | Útil para pruebas de rendimiento en datasets largos |

### Modos de clasificación

* **STRUCTURAL** (default): solo clasifica los **extremos de cada segmento fractal** — el modo recomendado para lectura ICT.
* **IMMEDIATE**: clasifica apenas se detecta el swing, sin esperar confirmación — más rápido, más propenso a "parpadear" (una etiqueta HH puede pasar a HL si aparece un swing posterior que cambia el contexto).
* **CONFIRMED**: solo clasifica swings ya `VALIDADO`, exigiendo un swing opuesto intermedio entre ellos — el más conservador.

<Warning>
  **Discrepancias reales vs el ISS / backend, verificadas en el código:**

  * **Default de `strength`:** acá es **`2`**. En el indicador ISS (`swingStrength`) el default es **`1`**. El schema Pydantic del backend (`SwingDetectionConfig.swing_strength`) también default a **`1`** — este indicador es el único de los tres que arranca en 2.
  * **Rango de `strength`:** la UI limita a 1–5; el schema del backend permite hasta 10 (`le=10`).
  * **`validationEnabled`:** acá el default real es **`false`** (a diferencia del ISS, que arranca en `true`) — confirmado explícitamente en el comentario del código fuente ("validación off by default").
  * **`pauseMode`:** el default real de la UI es `strict`. El schema del backend (`PauseMode`) default a `FLEXIBLE`. Mismo patrón que en el ISS.
</Warning>

## Colores por jerarquía

Cuando `showHierarchy=true`, los marcadores usan esta paleta fija (definida en `swing-points-config.ts`, no configurable desde el panel del indicador hoy):

| Jerarquía | High | Low | Tamaño del marcador |
| - | - | - | - |
| **ST** (Short Term) | Verde `#22c55e` | Rojo `#ef4444` | 1 (el más chico) |
| **IT** (Intermediate) | Azul `#3b82f6` | Naranja `#f97316` | 2 |
| **LT** (Long Term) | Morado `#8b5cf6` | Rosa `#ec4899` | 3 (el más grande) |
| **UNCLASSIFIED** | Gris `#9ca3af` | Gris `#9ca3af` | 1 |

Cuando `showHierarchy=false`, se usa un esquema simple de 2 colores: verde para highs, rojo para lows (mismos valores que ST). El tamaño del marcador también puede fijarse manualmente con un valor custom (clamped entre 1 y 4), que si está seteado tiene prioridad sobre el tamaño por jerarquía.

Las etiquetas de texto combinan jerarquía + clasificación cuando ambas están activas, por ejemplo `LT-H HH` (Long Term High que además es un Higher High) o `IT-L HL` (Intermediate Low que es un Higher Low).

## Presets

| Preset | Qué cambia | Perfil |
| - | - | - |
| **Estándar** | `strength=2`, `showClassificationLabels=true`, `showHierarchy=false` | Uso general — clasificación visible, sin jerarquía |
| **Fractal Básico** | `strength=2`, sin clasificación, sin jerarquía, `showOnlyClassified=false` | Solo puntos de giro puros, mínimo ruido visual |
| **Larry Williams (Jerarquía)** | `strength=2`, `showHierarchy=true`, `showClassificationLabels=true`, `classificationMode=STRUCTURAL` | Lectura de tendencia multi-plazo (ST/IT/LT) de un vistazo |
| **Sensible (1 barra)** | `strength=1`, `showClassificationLabels=true` | Detección rápida para scalping — máxima sensibilidad |

<Tip>
  Para la receta "Tendencia LT limpia" (bias de largo plazo sin ruido) descrita en la doc del ISS, partí del preset **Larry Williams (Jerarquía)** y activá además `showOnlyClassified=true` para quedarte solo con los swings HH/HL/LH/LL — así los `FIRST` (primer swing de su tipo, sin referencia previa) no ensucian el gráfico.
</Tip>

***

<Card title="Volver a la Visión General" icon="arrow-left" href="/learn/indicators/overview">
  Ver el resto de indicadores propios de la plataforma.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.