Manual de Uso PolyMeteo Trader (Básico + Avanzado)

Cambios visibles para el usuario

• Web local/funcional (Paridad MMA premium dinámica, engine Android en backend web): la MMA web pasa a calcular pesos por ciudad + horizonte (H0/H1/H2) con un motor premium dinámico en backend que replica las fórmulas del engine Android (ranking por error, multiplicadores, blending entre horizontes, no-data multiplier y pesos base). Usa datos históricos de Open‑Meteo Historical Forecast / Previous Runs / Archive y mantiene caché persistente por ciudad+horizonte para evitar recomputar en cada carga.
• Web local/funcional (Paridad Wunderground, fallback fiable por ciudad): se añade una regla de fiabilidad para la Temp estación control (S) cuando Wunderground devuelve muchos payloads embebidos mezclados. Si el candidato embebido de observación tiene score bajo y no está bien anclado al ICAO de la ciudad, la web prioriza el fallback de observación weather.com (geocode/icaoCode de la ciudad) antes de usar ese embedded dudoso. Esto reduce desalineaciones como Buenos Aires (web mostrando una máxima demasiado baja) y mejora la paridad con la app móvil.
• Web local/funcional (Paridad fina Wunderground, scoring de embedded): se alinea al 100% con la app móvil el scoring de candidatos embebidos de observación (Wunderground / weather.com) usados para calcular la Temp estación control (S) cuando no hay Summary utilizable. Esto corrige casos de selección de candidato incorrecto en ciudades con payloads mezclados (por ejemplo Buenos Aires), donde la web podía escoger máximas de otra localización embebida en la misma página.
• Web local/funcional (Paridad fina Wunderground, unidades en embedded): se alinea el parser de unidad de candidatos embebidos con la app móvil para usar solo pistas units=e/m del contexto inmediato (y no temperatureUnit, que puede venir mezclado de payloads vecinos). Esto corrige desalineaciones de Temp estación control (S) en algunas ciudades (por ejemplo Buenos Aires) donde la web podía interpretar mal la unidad y seleccionar un máximo diario incorrecto.
• Web local/funcional (Paridad Wunderground estación control Miami/NY): se sustituye el parser simplificado de Wunderground en web por un flujo equivalente al de la app móvil para la Temp estación control (S): Summary (High Temp Actual) + candidatos embebidos con scoring por contexto/icaoCode + fallback a api.weather.com. Además, se elimina el parser de texto pws-current (demasiado frágil), que podía producir valores absurdos como 117°F en Miami o 77°F en Nueva York. Con esto se reduce de forma importante la discrepancia de S entre web y app móvil.
• Web local/funcional (Paridad visual grid + Wunderground control): el grid/lista web vuelve a mostrar métricas rápidas como la app móvil (M / Δ / S / P, donde P = MM) en lugar de usar MMA en la tarjeta de ciudad. Además, la Temp estación control web prioriza de forma más estricta la máxima diaria del Summary (High Temp Actual) de la URL de control, evitando que un PWS current más alto o un embedded fallback sobreescriban la referencia oficial de control cuando sí existe Summary.
• Web local/funcional (Paridad motor de decisión con app móvil): el backend web alinea la evaluación de mercados con la app móvil al portar la calibración por ciudad/horizonte/franja (TraderCalibration) y las fórmulas de probabilidad calibrada, fill, costes, edge ejecutable, señal (GREEN/YELLOW/RED) y control de ejecución (liquidez, volumen 24h, spread, fill, edge mínimo, precio de entrada y reglas de tarde). Esto reduce discrepancias de BET/PASS, OVER/UNDER y edge entre web y móvil cuando el mercado real y los datos meteo son los mismos.
• Web local/funcional (Paridad MM/MMA y criterios live): se aproxima la lógica web a la app móvil en datos críticos de decisión: MM web deja de ser media simple y pasa a usar un cálculo tipo PolyTempCalculator (pesos base, descarte de outliers y mezcla con modelo dominante), MMA web aplica la misma lógica de mezcla sobre pesos backend, se amplía Open-Meteo a ECMWF IFS + IFS 0.25 + AIFS + GFS, y se igualan criterios de invalidación diaria (epsilon) y live floor para hoy. Esto reduce discrepancias fuertes entre móvil y web en MM/MMA y en la evaluación de oportunidades cuando ya existe una máxima observada.
• Web local/funcional (Fix Wunderground estación control, prioridad de fuentes): se ajusta la prioridad del scraping de estación de control para usar primero Summary (High Temp Actual) y PWS actual, dejando el valor embedded solo como fallback. Esto evita que payloads embebidos de otras ubicaciones en la página de Wunderground contaminen la máxima diaria mostrada.
• Web local/funcional (Fix Wunderground estación control): se corrige un bug de parseo en la lectura embebida de Wunderground que podía interpretar valores imperiales (°F) como °C en la Temp estación control de algunas ciudades (ejemplo: Seúl aparecía como 39°C en lugar de ~4°C). El parser embedded ahora prioriza unidad imperial por defecto cuando la unidad no viene explícita.
• Infra web (Fase B1.19, publicación funcional en Render preparada): se añade preparación de despliegue para la web funcional (backend + frontend) en un segundo servicio Render, manteniendo la landing pública estática separada. Incluye blueprint de referencia (render.functional.yaml), guía operativa paso a paso y soporte de ruta persistente configurable para estado Web Push (POLYMETEO_WEBPUSH_STATE_FILE).
• Web local (Fase B1.18, Cuenta Polymarket web): se añade un panel Cuenta Polymarket web (lectura) por wallet, con valor de cartera, recuento de posiciones abiertas/cerradas, PnL abierto/cerrado, y listas de posiciones/trades recientes. La wallet puede venir de input manual o detectarse por defecto desde POLYMARKET_WALLET_ADDRESS (entorno / local.properties) a través del backend.
• Web local (Fase B1.17, Dashboard operativo unificado): se añade un panel superior Dashboard operativo con lectura rápida de estado backend, operativa actual (modo/estrategia/ciudad/horizonte), Paper Trading local, CopyTrade SSE (foreground), Web Push server-side (suscripciones/monitores/auditoría) e Intel usuario, para diagnóstico y control sin cambiar de sección.
• Web local (Fase B1.16, fix persistencia Web Push): se corrige un fallo de persistencia que podía dejar el archivo de estado Web Push en JSON inválido al reiniciar (cierre durante escritura). Ahora el backend usa escritura atómica (.tmp + rename) y flush real en shutdown para proteger suscripciones y auditoría.
• Web local (Fase B1.15, Admin Web Push en UI): el panel Realtime CopyTrade incorpora un bloque Backend Web Push (admin) con refresh manual para visualizar suscripciones activas, estado de monitores y auditoría reciente (eventos de subscribe/push/error/recovery) sin usar curl.
• Web local (Fase B1.14, Web Push persistente/auditable): el backend añade persistencia en disco de suscripciones Web Push + configuración de CopyTrade, recuperación automática de monitores al reiniciar y endpoints de auditoría para inspeccionar suscripciones activas e historial de eventos (/api/v1/webpush/subscriptions y /api/v1/webpush/audit).
• Web local (Fase B1.13, Web Push beta): el panel Realtime CopyTrade (SSE) añade controles de Web Push (Service Worker) para activar/sincronizar/desactivar una suscripción push real y enviar test push. El backend expone endpoints de registro (/api/v1/webpush/*) y puede monitorizar CopyTrade server-side si dispone de VAPID configurado.
• Web local (Fase B1.12, CopyTrade notificaciones navegador): el panel Realtime CopyTrade (SSE) añade opción de notificaciones del navegador (Notification API) con solicitud de permiso, estado de permiso visible y disparo automático por alerta nueva. En localhost funciona como entorno seguro de prueba; en producción requiere HTTPS (ya previsto para polymeteo.caplatemp.xyz).
• Web local (Fase B1.11, CopyTrade realtime): el panel Intel usuario Polymarket en web añade Realtime CopyTrade (SSE) con monitor en vivo de actividad pública (BUY/SELL/otros), filtros por importe mínimo y tipo de mercado, reconexión automática y feed de alertas en página sin recargar.
• Web local (Fase B1.10, Paper): se añade un panel Paper Trading web (local) con persistencia en navegador (localStorage), apertura de operaciones desde los mercados del DETALLE (Simular BUY YES/NO), marcado a mercado y cierre manual con PnL abierto/cerrado visible.
• Web local (Fase B1.10, Intel): se añade un panel Intel usuario Polymarket en web con endpoint backend propio (/api/v1/user-intel) para consultar actividad/trades públicos, perfil (proxy wallet) e insights de estilo operativos (foco meteo, BUY/SELL, top ciudades/eventos) sin exponer CORS ni lógica al navegador.
• Web local (Fase B1.9): el selector de estrategia (Conservadora/Agresiva) en web deja de ser visual y pasa a filtrar de verdad ticker, grid, etiquetas de horizonte y mercados visibles en DETALLE usando banderas calculadas por el backend (strategyEligible) sobre el mismo motor real.
• Web local (Fase B1.9, Rookie): el panel izquierdo cambia a una lista única de oportunidades en modo Rookie (ordenadas por ventaja real y respetando la estrategia seleccionada), con texto corto y métricas mínimas (M, S, MM, MMA) para lectura rápida.
• Web local (Fase B1.8): el grid CIUDADES y el ticker/FLASH pasan a usar el mismo motor web real que el DETALLE (topSummary derivado de mercados reales Polymarket + MM/MMA híbridos), en lugar del top mock. Se añade una caché corta por ciudad en backend para mejorar consistencia entre CIUDADES y DETALLE y reducir diferencias de refresco.
• Web local (Fase B1.7): el DETALLE web deja de depender de mercados mock para la recomendación y pasa a calcular Exec / Fill / Coste / BET-PASS / trazabilidad sobre los buckets reales de Polymarket (Gamma API), usando MM/MMA del provider híbrido web. El bloque “Mercado real (lectura)” se mantiene como auditoría visual.
• Web local (Fase B1.6): el provider híbrido web calcula ya una MMA backend (Media Modelos Ajustada) para el día actual usando pesos por ciudad sobre los modelos reales de Open-Meteo (ECMWF IFS + GFS). El campo MMA y el bloque de modelo dominante/peso del DETALLE web pasan a reflejar este cálculo (con fallback al mock si falta algún dato).
• Web local (Fase B1.5): el DETALLE web incorpora un bloque “Mercado real (lectura)” con buckets, precios y liquidez reales de Polymarket (Gamma API) por horizonte (Hoy/Mañana/Pasado). Además, cuando un bucket mock coincide con un bucket real, se hace overlay parcial de precios/liquidez/volumen en la tarjeta del mercado sin alterar todavía la lógica final de recomendación.
• Web local (Fase B1.4): el provider híbrido añade overlay live de MM parcial para el día actual usando Open-Meteo (ECMWF IFS + GFS, media simple). Esto actualiza el campo MM en la web local sin tocar todavía MMA ni la lógica final de mercados, que permanecen mock en esta fase.
• Web local (Fase B1.3): el provider híbrido web añade overlay live de Temp estación control (Wunderground), priorizando la máxima diaria detectada (Summary/embedded) y combinándola con METAR live. Con ello, el grid web ya muestra M, Δ, S reales en gran parte de ciudades, mientras MM/MMA/mercados siguen mock temporalmente.
• Web local (Fase B1.2): el backend web incorpora un provider híbrido con overlay live de METAR + hora local por ciudad (aviationweather.gov), manteniendo fallback automático a mock si falla red/API. Los campos no migrados todavía (MM/MMA/mercados/trazabilidad) permanecen mock temporalmente.
• Web local (Fase B1.1): el scaffold web añade carga incremental por ciudad (stream/SSE) para que el grid aparezca primero y se rellene progresivamente con placeholders, imitando el comportamiento rápido de la app Android mientras se conectan datos reales.
• Web funcional local (Fase B1 scaffold): se añade estructura inicial frontend web + backend API dentro del repo para ver CIUDADES y DETALLE en navegador con datos MOCK, preservando la semántica (MM/MMA, horizontes, trazabilidad, Rookie/Experto) mientras se prepara la integración real.
• Web MVP estático (polyMeteo): se añade una landing web para publicar documentación/capturas del proyecto y validar despliegue en dominio propio (Render + DNS + SSL) antes de construir la web funcional con datos en tiempo real.
• Modo Rookie global: la app simplifica la comunicación en DETALLE, MMA, Paper Trading y Cuenta (mismos cálculos, menos tecnicismos visibles).
• Rookie (métricas aclaradas): la tarjeta muestra liquidez libro (depth) y volumen bucket (similar al Vol. de Polymarket) por separado.
• Nueva pantalla interna “Intel usuario Polymarket”: permite introducir un @usuario, resolver su proxy wallet pública y consultar actividad/trades/posiciones públicos con insights operativos (solo informativo, sin alterar cálculos de la app).
• CopyTrade (monitor de actividad pública): en la pantalla Intel se puede activar un monitor en tiempo real práctico (polling rápido) con filtros por compra/venta, importe mínimo y tipo de mercado. Genera alertas foreground dentro de la app y registro de alertas recientes.
• CopyTrade (latencia): la velocidad depende de indexado de la API de Polymarket + intervalo de polling configurado. La app intenta minimizar el delay con sondeo corto configurable (2s-15s).
• CopyTrade (notificaciones Android): se añade notificación local de sistema por cada alerta nueva (si el permiso POST_NOTIFICATIONS está concedido).
• CopyTrade (background): se añade Foreground Service para mantener el monitor activo cuando la app queda en segundo plano (mientras Android mantenga el servicio en ejecución).
• Permisos: la app solicita POST_NOTIFICATIONS (Android 13+) para poder mostrar alertas del sistema de CopyTrade.
• DETALLE (Rookie): se resumen pronósticos, motivos de descarte y mercados con lenguaje directo (ventaja real, dificultad de ejecución, coste, apuesta posible/esperar).
• MMA (Rookie): se muestra resumen de aprendizaje y ranking de modelos en formato corto (modelo dominante, peso, error y cobertura) sin tabla extensa.
• Paper Trading (Rookie): resumen compacto para entender rápidamente si la simulación va bien o mal (resultado, fill, ejecución real vs esperada).
• Cuenta (Rookie): listas recortadas y texto más directo para no saturar con detalles.
• CIUDADES: el bloque fijo de Top Ejecutables ahora es un ticker horizontal dinámico (estilo cotizaciones) con información útil en tiempo real.
• CIUDADES: cada ciudad puede mostrar una etiqueta de horizonte [M], [P], [MP], [HM], [HP] o [HMP] junto al nombre para indicar en qué días hay oportunidades (Hoy/Mañana/Pasado).
• Ticker/FLASH: cuando la oportunidad destacada es de Mañana o Pasado, ahora se etiqueta explícitamente tras el nombre de la ciudad (ej. New York (Mañana)).
• Alerta FLASH: si aparece una oportunidad fuerte y ejecutable, se muestra FLASH en rojo parpadeante durante 1 minuto para priorizar revisión inmediata.
• DETALLE: Media Modelos Ajustada (MMA) muestra valor numérico (no solo enlace) y abre su dashboard al pulsar en etiqueta o valor.
• DETALLE: la referencia superior de Trader Mode ahora indica el horizonte correcto (Hoy/Mañana/Pasado) para evitar confusiones cuando no hay oportunidades en Hoy.
• DETALLE: se mantiene la mejora de lectura de METAR actual con fecha/hora y METAR anterior con (Hace X horas).
• DETALLE: temperaturas clave muestran unidad principal + conversión entre paréntesis para evitar errores de interpretación.
• DETALLE: se integra bloque operacional TAF con resumen, vigencia e incidencias relevantes.
• Ayuda en directo: el término TAF es clicable y explica uso práctico para principiantes.

0.1 Una analogía cotidiana (fútbol)

Imagina que compras una apuesta tipo: “Sí, gana el Madrid” a 0.60. Ese precio significa que el mercado “cree” aproximadamente en un 60% de probabilidad.

• Si compras y aciertas, ese contrato vale 1.00 al resolver.
• Si compras y fallas, vale 0.00 al resolver.
• Tu coste de entrada es el precio pagado (0.60 en este ejemplo).

En PolyMeteo no decides “a ojo”: usas datos meteorológicos para detectar cuándo el precio de mercado puede estar mal ajustado.

Polymarket es un mercado de predicción donde se negocian probabilidades. En esta app se trabaja el mercado de temperatura máxima diaria por ciudad.

Ruta básica (día 1)Ruta avanzada (día 7+)

Ruta básica (3 pasos)

1. CIUDADES: usar ticker + tarjetas para detectar 1-2 candidatos con mejor perfil.
2. DETALLE: confirmar datos METAR/estación/Media Modelos (MM)/Media Modelos Ajustada (MMA) y revisar Trader Mode.
3. Paper Trading: verificar si expected se convierte en realized.

Ruta avanzada (iteración semanal)

1. Analizar gap de ejecución por ciudad/estrategia.
2. Descartar patrones con fill pobre o liquidez débil.
3. Mantener disciplina con guardrails y kill-switch.

Qué ver en 10 segundos

Bloque METAR / Estación / Media Modelos (MM) / TAF

Por qué un mercado puede estar ACTIVO en Polymarket pero NO aparecer en la app

Esto es normal y está hecho a propósito. Polymarket muestra mercados activos, pero la app solo muestra mercados que pasan filtros de calidad y ejecución. Es decir: la app no pregunta “¿está abierto?” sino “¿tiene sentido entrar ahora?”.

Límites actuales de decisión (importante)

Hay dos capas de límites: (1) filtros duros del motor y (2) filtros de estrategia (Conservadora/Agresiva, sobre todo en modo Rookie). Primero deben pasar los filtros duros. Después, la estrategia puede endurecer aún más la selección.

Esta pantalla se abre desde Media Modelos Ajustada (MMA) en DETALLE. Es el dashboard de aprendizaje continuo por ciudad: compara cada modelo contra el observado real y ajusta pesos.

Qué responde esta pantalla

¿La ventaja esperada se convierte en resultado real cuando incluyes fricciones de mercado?

Escenario A: día soleado (tendencia OVER)

• METAR sube de forma sostenida.
• Estación de control ya está alta al mediodía.
• Media Modelos (MM) por encima de los buckets centrales.
• Resultado típico: mercados “temperatura alta” con mejor probabilidad.

Escenario B: día nublado/frío (tendencia UNDER)

• METAR plano o bajando.
• Estación de control no rompe máximos esperados.
• Media Modelos (MM) revisa a la baja.
• Resultado típico: mercados de umbral alto se vuelven débiles para YES.

DEMO MODE existe para probar rápido el sistema de riesgo. No es para estimar rentabilidad real final.

Activar/desactivar

1. En local.properties, pon DEMO_MODE=true.
2. Recompila y abre app: en Paper Trading verás Modo: DEMO.
3. Para volver a normal: DEMO_MODE=false y recompilar.

Errores psicológicos frecuentes

• Sesgo de confirmación: buscar solo datos que te dan la razón.
• Revenge trading: subir riesgo tras perder para “recuperar rápido”.
• Sobreconfianza: creer que 3 aciertos seguidos garantizan el cuarto.

Reglas de higiene mental

• Si kill-switch se activa: parar y revisar, no discutir con el sistema.
• Registrar errores semanales y corregir 1 hábito por semana.
• No operar con fatiga, enfado o prisa.

Ejercicio 1 (principiante): lectura básica Londres

1. Abre Londres en DETALLE.
2. Anota: METAR actual, METAR anterior, estación control, Media Modelos (MM).
3. Predice manualmente: ¿OVER o UNDER?
4. Compara con Trader Mode y explica por qué coincides o no.

Ejercicio 2 (ejecución): expected vs realized

1. En Paper Trading, anota Expected PnL y Realized PnL.
2. Anota Gap ejecución.
3. Si gap es negativo 3 días seguidos, reduce mercados con fill bajo.

Ejercicio 3 (identificación local): Madrid / LEMD

1. Usa Madrid como práctica conceptual (aunque no esté en lista fija actual).
2. Piensa el flujo igual: aeropuerto de referencia (LEMD), METAR, estación, consenso.
3. El objetivo es entrenar el método, no adivinar por intuición.