Qué calcula. Se traza una línea horizontal sobre el histograma de volumen; las velas seguidas que quedan por encima forman un grupo, y a cada grupo se le calcula su Volume Profile desde su primera hasta su última vela. El POC de cada grupo se convierte en un nivel vivo que el indicador sigue vela a vela: registra cada vez que el precio vuelve, si lo respetó o lo rompió, y con esa historia puntúa la siguiente entrada. Lo que se DIBUJA lo calcula el navegador (assets/js/chart/cluster_detect.js y cluster_levels.js, módulos puros con tests en assets/test/), con la configuración de cada persona y sobre su buffer de velas.

Y hay una segunda copia, canónica, en el servidor (EdgeFlow.Indicators.ClusterProfile + su adaptador del Host): el MISMO algoritmo con parámetros fijos de plataforma, sobre las últimas 600 velas de 1m, para que los niveles existan con todos los gráficos cerrados y sean iguales para todos. Es la que puede alimentar al motor de señales. La paridad entre las dos se mide contra el JS real en test/edgeflow_equities/indicators/cluster_profile_paridad_test.exs (exacta; las dos diferencias conocidas están ahí y en docs/application-updates.md). Todavía no está enchufada: el motor sigue leyendo el buzón del navegador (Indicators.ClusterLevels), así que cpoc_bounce y cpoc_break_retest siguen fuera de Telegram y del bot.

No confundir con EdgeFlow.Indicators.MetaOrders (antes ClusterProfile), que agrupa trades del time & sales y sólo alimenta MarketContext.

Parámetros

Grupo	Parámetro	Qué hace
Umbral	`threshold_mode`	Cómo se traza la línea: percentil (default), múltiplo de la media o valor fijo.
Umbral	`threshold_pct`	P70 = las velas del 30 % más activo de la ventana forman grupos.
Umbral	`threshold_x` / `threshold_manual`	Para los otros dos modos.
Umbral	`window_bars`	Ventana móvil (300) sobre la que se calcula el percentil o la media — nunca la media global del buffer.
Umbral	`show_threshold`	Dibuja la línea y su tag `≥41K P70`.
Grupo	`min_bars` · `gap_bars` · `merge_gap`	Velas mínimas por encima, huecos tolerados dentro de un grupo y fusión de grupos cercanos.
Grupo	`max_range_atr`	Descarta grupos que recorren más de N × ATR(14) × √velas: son impulsos, no consolidaciones. 0 = sin filtro.
Perfil	`va_pct` · `bins` · `side_split`	Área de valor, número de bins (`auto` = rango/tick, 12-60) y de dónde sale el lado compra/venta (`bv` real del wire o posición del cierre).
Mostrar	`show` · `recent_n`	POC vivos + N recientes (default), sólo N recientes, los de la pantalla, o todos. Techo de seguridad: 16.
Mostrar	`profile_style`	Caja + mini-perfil por bin (default) · caja + POC · sólo POC y VA.
Mostrar	`detail`	Cuánta tinta lleva el perfil en reposo: tenue y fuerte al pasar el mouse (default), siempre fuerte, o sólo al pasar el mouse.
Mostrar	`show_va_lines` · `show_shape_labels`	Extender VAH/VAL y chip `P · Δ+12 %`.
Líneas de POC	`poc_extend`	Lo primero del modal, con tres opciones: sin líneas (default: el chart queda limpio, sólo los grupos), desde su grupo hacia la derecha (se ve dónde nació el nivel; termina en la vela que lo rompe) o a todo el ancho del chart (se lee como una línea horizontal dibujada a mano).
POC	`touch_ticks` · `accept_closes` · `reaction_atr` · `keep_broken_bars`	Tolerancia del toque, cierres al otro lado para dar el nivel por roto, movimiento mínimo para que un toque cuente como rechazo, y cuánto se sigue viendo un POC roto.
Señales	`signals` · `approach_ticks` · `min_respect_rate`	Emitir eventos, a qué distancia avisar de un POC vivo y qué tasa de respeto mínima exigir para alertar.

Presets. Scalping 1m (P75, 3 velas) · Intradía 5m (P70, 4 velas) · Swing 1h+ (P65, 6 velas). "Restablecer preset" vuelve a los defaults.

Ciclo de vida del POC

Estado	Cuándo	Qué significa para operar
`virgin`	nadie lo tocó desde que se formó	imán: el precio tiende a ir a buscarlo; sirve de objetivo
`tested`	el precio llegó y el cierre volvió al lado de llegada	nivel de reacción; cuanta más tasa de respeto, más confiable
`accepted`	`accept_closes` cierres consecutivos al otro lado	roto: dejó de aguantar y la línea termina en esa vela
`retest`	vuelve al nivel roto y lo respeta	break & retest clásico, con el rol invertido
`absorbed`	un grupo nuevo se formó encima	el nivel se funde en el nuevo (confluencia)

Un toque cuenta al entrar en la banda del nivel (no por cada vela pegada), y sólo es rechazo si el precio se aleja al menos reaction_atr × ATR en las velas siguientes; si no, queda como "toque flojo". De ahí salen touches, rejections, respect_rate, el rol (soporte/resistencia según de dónde viene el precio) y el score de rebote 0-100: volumen relativo del cluster (0-25) + historia de respeto (0-25; virgin = 15, "sin historial") + flujo del cluster (0-25) + confluencia (0-15) + forma coherente (0-10).

Eventos

cluster_formed · poc_approach · poc_rejection (score ≥ 60) · poc_acceptance · poc_retest · poc_absorbed. Los emite el chart y se casan con las reglas de alerta del usuario (push + aviso en el terminal).

Setups del motor de señales

cpoc_bounce — nivel vivo con score ≥ 60 cerca del precio. Stop al otro lado del área de valor del cluster; objetivos: el borde opuesto de esa área y los siguientes POC vivos en la dirección.
cpoc_break_retest — nivel en retest. Stop al otro lado del POC (si lo recupera, la ruptura era falsa).

Los POC vivos entran además al mapa de niveles como miembros cluster_poc, con peso volumen relativo × (0.5 + tasa de respeto).

Estadísticas propias

El chart guarda cada reacción (resultado, volumen relativo del cluster, respeto que el nivel tenía antes) por símbolo y timeframe y muestra el resumen en el modal: rechazo global, virgin vs probados, por quintil de volumen y recorrido típico en ATR. Es lo que responde si el umbral elegido sirve en ese instrumento — las cifras generales sobre "cuántos POC se llenan" que circulan por foros son anecdóticas; éstas son las del propio usuario.

Cómo se lee en el chart

La línea sobre el volumen es el umbral (P70 = el 30 % de velas más activas de la ventana). Las velas seguidas por encima forman un grupo; cada grupo tiene su perfil.
Forma: caja tiempo × área de valor del grupo, teñida del lado que dominó (compra/venta); POC como segmento dentro. Chip P · Δ+12 % = forma de la distribución y delta (con zoom).
Estilo del perfil: caja + mini-perfil por bin (default), caja + POC, o sólo POC y VA. El detalle decide la tinta en reposo: tenue y fuerte al pasar el mouse (default), siempre fuerte, o sólo al pasar el mouse.
Líneas POC (apagadas por defecto; se encienden con la primera opción del modal): cada grupo deja su POC como una horizontal discontinua, desde su grupo o a todo el ancho del chart, según elijas. Fina y corta = POC vivo; roja, más gruesa y de trazo largo = varios POC coinciden en ese precio (el nivel que el mercado ya respetó más de una vez); punteada y apagada = roto, y ahí la línea termina en la vela de la ruptura. Las marcas ▾/▴ sobre la línea son cada llegada del precio (rellenas si rechazó) y ◆ un retest.
Al eje: cPOC virgin (sin tocar), cPOC 3/4 = rechazos sobre toques, cPOC ×2 = POC coincidente.
En modo Limpio: caja + POC, sin perfil ni chips.
En hover: sobre la línea, la historia del nivel y el desglose del score; sobre la caja, las velas del grupo, volumen (× la mediana), delta y forma.
Panel "cPOC" del dock: niveles vivos por distancia al precio con respeto, rol y score; click centra el chart en su cluster.

---

Perfil por periodo (fase 4)

Esto es del Volume Profile, no del Cluster Profile, pero se documenta acá mientras el perfil de volumen no tenga ficha propia.

El perfil de volumen tiene dos modos, y son dos preguntas distintas:

Modo	Qué contesta	Se mueve
Lo que se ve	dónde se operó en lo que estoy mirando	sí, con cada scroll
Por periodo	dónde se operó en cada día / hora / sesión	no

En modo periodo hay un perfil por bloque (15 m, 1 h, 4 h, día o semana), con el histograma anclado al inicio del bloque, creciendo hasta el 90 % de su ancho — nunca invade el siguiente—, y las velas por encima: el perfil es el fondo que explica dónde se operó, no algo que tape el precio.

El vPOC se prolonga hasta la primera vela que lo toca. Un POC que el precio no volvió a tocar es un imán conocido; uno ya tocado dejó de serlo. Dibujar los dos igual sería dibujar ruido.

Al alejar, los bloques se agrupan (de a dos, hasta que entren doce en pantalla). Se agrupa en vez de recortar porque recortar dejaría media pantalla sin perfil, y el dibujo tiene que describir todo lo que se ve o no describe nada.

base elige qué se acumula: volumen, delta, bid y ask, o trades. Las tres últimas necesitan saber el lado, así que sólo dicen la verdad donde hay footprint; donde no, el reparto del OHLCV las aproxima.

Guardas: assets/test/period_profile.test.js, verificadas rompiendo el agrupado al alejar, el uso de las filas del footprint, el corte del vPOC y la elección de modo en el hook.