# METODOLOGÍA — Analizador Chamaquín Feliz (app)

Versión 1.0 · motor en `app/js/indicadores.js` · fuentes de conocimiento: `chamaquin-feliz/dossier-dominio.md` y `chamaquin-feliz/fuentes-acceso.md`.

**Regla inapelable del proyecto:** sin cotizaciones verificables a mano → **DATOS INSUFICIENTES**; nunca se inventan precios, POCs ni resultados históricos. Esta app solo emite veredictos con velas OHLCV reales (API pública de Binance).

---

## 1. Datos de mercado
- Fuente: **API pública de Binance** (`/api/v3/ticker/24hr` para el ranking y `/api/v3/klines` para velas), sin claves API; host primario `data-api.binance.vision` con fallback.
- **Top 50**: pares contra USDT ordenados por volumen real 24 h, excluyendo tokens apalancados (UP/DOWN/BULL/BEAR) y derivados de stablecoins.
- Temporalidades evaluadas por par: **1D · 4h · 1h · 15m** (300 velas).
- Las decisiones se computan sobre **velas cerradas** (la vela en formación se usa solo para pintar el gráfico, como en TradingView).

## 2. Indicadores y su nivel de conocimiento
| Componente | Implementación | Nivel |
|---|---|---|
| EMA 10 / EMA 55 | EMA estándar (SMA seed) | ATRIBUIDA (marco del método) |
| Squeeze Momentum | BB(20,**×2.0**)/KC(20,×1.5,TrueRange) + histograma por regresión lineal (LazyBear) | DOCUMENTADA (código del autor) con **aviso**: la versión publicada en TradingView quedó con BB×1.5 por bug; este motor usa la matemática corregida |
| Valles rojos/verdes | Secuencias consecutivas del histograma (hist<0 = valle rojo; hist>0 = valle verde) con extremo y edad | ATRIBUIDA |
| Cuadrantes | impulso/fuerza alcista-bajista según signo y pendiente del hist | ATRIBUIDA (APIDEVS) |
| ADX 14 (Wilder) + DI± | RMA de DX; pendiente = ADX[i]−ADX[i−1] | DOCUMENTADA; **umbral ≈23 = ATRIBUIDA** (Ruckard, rolgui, guía Memo — NO VALIDADO) |
| Divergencias | Valles del mismo signo con extremos decrecientes contra extremos de precio crecientes (y espejo), solo con datos ya vistos (sin lookahead) | ATRIBUIDA |
| Perfil de volumen | 48 niveles sobre 100 velas; volumen de cada vela repartido en sus niveles; **POC**, área de valor (70% por expansión desde el POC, VAH/VAL) | ATRIBUIDA (VPVR ~100 velas "as Jaime once used") |
| VPoC de sesión ~3 días | 18 velas de 4h / 72 velas de 1h | ATRIBUIDA (Ruckard) |

## 3. Condición 4 y decisiones (dossier sec. 2.5 y Anexo A)
**Patrón referencial LONG (4 condiciones, ATRIBUIDA):**
1. Precio y EMA10 sobre EMA55.
2. ADX con fuerza (pendiente positiva).
3. "Valle rojo con desarrollo" (el correctivo bajista ya se desarrolló y pierde fuerza — aquí: terminó hace ≤6 velas, o recupera ≥55% hacia el cero; **INTERPRETACIÓN** estos umbrales operativos).
4. Zona de volumen importante por debajo del precio (POC debajo del precio, ≤15% de distancia y con al menos 3% del volumen del perfil; **INTERPRETACIÓN** el "15%/3%", la idea es del dossier).

**Mapa de decisión por temporalidad** (lenguaje del Anexo A, punto 8):

| Decisión | Color | Condiciones (resumen) |
|---|---|---|
| COMPRAR | verde | 4 condiciones del patrón LONG completas + no divergencia bajista activa |
| MANTENER | verde | estructura alcista, hipótesis viva sin nueva ventaja de entrada |
| PREPARAR ENTRADA | amarillo | squeeze ON dentro de tendencia alcista (compresión = materia prima de continuación) |
| ESPERAR | amarillo | valle rojo sin desarrollar, EMAs entrelazadas, o divergencia alcista sobre estructura bajista (buscar el giro, no anticipar) |
| NO COMPRAR | rojo | precio y EMA10 bajo EMA55 (estructura rota) |
| REDUCIR | rojo | divergencia bajista activa ("todas las divergencias se respetan" — ATRIBUIDA) |
| SALIR | rojo | fuerza vendedora: valle rojo desarrollándose (hist↓) + ADX ≥23 con pendiente ascendente |
| DATOS INSUFICIENTES | gris | fetch fallido / velas insuficientes / warmup incompleto |

ADVERTENCIA incorporada del dossier (Ruckard, DOCUMENTADA como resultado de terceros): **en 4H el ADX confirma cuando el movimiento ya se produjo** → el ADX acá es *contexto y marco*, no gatillo; el gatillo es el borde de transición del valle.

## 4. Semáforo del dashboard (consenso multi-TF — **INTERPRETACIÓN** de esta app)
Ponderación: 1D ×3 · 4h ×2 · 1h ×1.5 · 15m ×0.5. Puntaje por decisión: COMPRAR +2, MANTENER +1, PREPARAR +0.35, ESPERAR 0, NO COMPRAR −1, REDUCIR −1.5, SALIR −2.

- **Verde** ("para entrar"): score ≥ +1.3 **y sin REDUCIR ni SALIR en 1D/4h** (el marco mayor en agotamiento no habilita una entrada completa).
- **Rojo** ("salir"): score ≤ −0.8, o SALIR en 1D ó 4h (override).
- **Amarillo** ("esperar"): el resto; incluye el caso de score alto con REDUCIR en 1D ó 4h ("EVALUAR · MARCO MAYOR EN AGOTAMIENTO").
- **Gris**: si casi no hay temporalidades con datos, no hay veredicto.

## 5. Límites declarados (honestidad del analizador)
- Estas reglas **no están VALIDADAS estadísticamente** (ver dossier sec. 13, hipótesis H1–H10): lo que la app muestra es la lectura *atribuida/interpretada* del método, no un backtest.
- El volumen de las velas de Binance no distingue ticket del comprador/vendedor; el perfil por buckets (48 niveles) es una aproximación del VPVR de TradingView.
- La librería de gráficos es **LightweightCharts de TradingView** (Apache-2.0, CDN jsdelivr/unpkg): velas y navegación idénticas en estilo al gráfico de TV, no es el producto de TV.
- La app no gestiona órdenes ni posiciones reales; no pide claves de exchange.
- **No es asesoría financiera.**