WeatherBot

Inicio rápido

git clone <repo>
cd weatherbot
npm install          # installs: express, ethers, @polymarket/clob-client, viem, ws, @anthropic-ai/sdk
npm start            # starts Express server on port 3777
# Open http://localhost:3777 in your browser

Variables de entorno

ANTHROPIC_API_KEY=sk-ant-...    # Claude API key for AI analysis
NOAA_CDO_TOKEN=XRHLdkB...      # NOAA CDO token for historical data
PORT=3777                        # Server port (default 3777)

Endpoints de API

Opciones de configuración

Análisis de mercado

El módulo MarketDiscovery analiza preguntas de Polymarket como "What will be the highest temperature in New York on March 15?" y las transforma en datos estructurados: ciudad (lat/lon de un mapa de 67 ciudades), fecha (4 patrones regex: "on Month Day", "on Day Month", "Month Day", "Day Month Year"), unidad de temperatura (°F para ciudades de EE. UU., °C internacional) y tipo de mercado (max_temp, min_temp, precipitation, snow, severe).

Los resultados como "52-53°F", "54°F or higher", "50°F or lower" se parsean en rangos con valores low/high y las banderas isOrHigher, isOrLower y isRange — permitiendo al EdgeCalculator ejecutar el cálculo de CDF correcto para cada tipo de resultado.

Arquitectura multi-usuario

El módulo Store (store.js) proporciona almacenamiento persistente de ficheros JSON en /data/users.json. Cada usuario obtiene: credenciales (contraseña hasheada con pbkdf2, token de autenticación), configuración del wallet (PK cifrada, dirección proxy), configuración de trading (bankroll, maxPerTrade, minEdge), estadísticas (scans, trades, edgesDetected), análisis de IA, historial de operaciones y logs. El módulo BotManager ejecuta un ciclo separado de StreamEngine + Trader + IA por usuario, mientras comparte los datos de mercado entre todos los usuarios.

Cómo funciona el seguimiento de traders

El /api/traders endpoint obtiene 4 fuentes de datos por billetera en paralelo: la API de la tabla de líderes de Polymarket (PnL + volumen autoritativos), la API de perfil de Gamma (nombre de usuario, avatar), la API de posiciones (todas las posiciones resueltas + activas con cashPnL) y la API de actividad (últimas 30 operaciones). Los resultados se ordenan por PnL total en orden descendente.

Wallets rastreados

WeatherBot monitoriza 10 wallets top de trading meteorológico definidos en cities.js. Estos son los participantes más rentables en los mercados meteorológicos de Polymarket, identificados por su PnL acumulado y su tasa de acierto en los mercados de predicción meteorológica.

Puntos de datos por trader

• Perfil — nombre de usuario, foto de perfil (de la tabla de líderes o de Gamma)
• PnL — ganancia/pérdida total de la API de la tabla de líderes (fuente autoritativa)
• Volumen — volumen total de operaciones en USD
• Tasa de aciertos — calculado a partir de las posiciones: (posiciones ganadoras / posiciones totales) × 100
• Posiciones activas — posiciones abiertas actuales con tamaño > 0
• Historial de PnL — gráfico acumulado construido a partir de posiciones resueltas ordenadas con endDate
• Operaciones recientes — últimas 5 operaciones con título del mercado, lado, tamaño, precio, marca de tiempo

Copy trading con IA

Cuando el bot funciona en modo de ejecución automática, Claude y Gemini analizan los mismos mercados en los que estos traders destacados están activos. La IA recibe datos completos de pronóstico, análisis de ventaja e historial reciente de operaciones —incluida información sobre si el bot ya tiene una posición (para evitar entrar dos veces). Esto crea un sistema de copy trading aumentado por IA en el que tus operaciones se basan tanto en la actividad de los traders destacados como en el análisis meteorológico independiente de Claude y Gemini.

Protección anti-churn

El prompt de la IA incluye el historial reciente de operaciones del bot para cada mercado. Claude y Gemini reciben la instrucción de hacer SKIP si el bot acaba de vender con ganancia y el precio no se ha movido, ser cautelosos al reentrar tras una pérdida a menos que las condiciones hayan cambiado, y evitar comprar/vender el mismo resultado repetidamente (lo que desperdicia dinero en el diferencial).

1. Algoritmo de temperatura de consenso

La función EdgeCalculator.calculateConsensus() calcula una temperatura de pronóstico ponderada por calidad a partir de hasta 4 modelos. Pesos base: ECMWF 0,35 (mejor modelo global), GFS 0,25, UKMO 0,20, NWS 0,20. Penalización por outliers: si el pronóstico de un modelo se desvía más de 1,5× la desviación estándar de la media bruta, su peso se reduce a la mitad. El consenso final es la media ponderada de los pesos ajustados, normalizados para sumar 1,0.

La concordancia entre modelos se puntúa en 5 niveles según la desviación estándar entre modelos: VERY_HIGH (<0.5°), HIGH (<1.0°), MODERATE (<2.0°), LOW (<3.5°), VERY_LOW (≥3.5°). Esta puntuación de concordancia afecta directamente los niveles de confianza y puede degradar la confianza VERY_HIGH a HIGH cuando los modelos no coinciden.

2. Cálculo dinámico de sigma (σ)

La incertidumbre del pronóstico σ es el parámetro más crítico. calculateSigma() toma tres entradas: horas hasta la resolución, array de temperaturas de los modelos y número de modelos. σ base según horizonte: 0,8° (≤6h), 1,0° (≤12h), 1,3° (≤24h), 1,8° (≤48h), 2,2° (≤72h), 3,0° (≤120h), 3,8° (≤168h), 4,5° (≤240h), 5,5° (más allá). Penalización por número de modelos: 1,0× (≥4 modelos), 1,1× (3), 1,25× (2), 1,5× (1). Penalización por dispersión: 1,0 + (stdDev / 5,0). σ final acotada a [0,5; 8,0].

3. Mezcla bayesiana histórica

Cuando hay datos históricos del NOAA NCEI disponibles, el pronóstico se combina por Bayes con la distribución histórica de 10 años para la misma fecha del calendario. Combinado mediante ponderación por precisión: combined_precision = forecast_precision + historical_precision, donde precision = 1/σ². Si el pronóstico y el histórico difieren en más de 1,5 × historical_σ, la σ combinada se amplía en un 30% para tener en cuenta condiciones inusuales.

4. Cálculo de probabilidad

Para cada resultado del mercado, la CDF normal (aproximación de Abramowitz-Stegun) calcula la probabilidad de que la temperatura real caiga dentro del rango del resultado:

• Valor exacto (p. ej., "52°F"): P = CDF(52,5) − CDF(51,5) usando bin de ±0,5°
• Rango (p. ej., "52-53°F"): P = CDF(53,5) − CDF(51,5)
• "or higher" (p. ej., "54°F+"): P = 1 − CDF(54)
• "or lower" (p. ej., "50°F−"): P = CDF(50)

Edge = forecastProb − marketPrice. Las operaciones se señalan cuando |edge| supera el umbral dinámico: max(0.03, min(0.08, σ × 0.02)).

5. Dimensionamiento por criterio de Kelly

Para BUY_YES: kellyFraction = edge / ((1/marketPrice) − 1). Para BUY_NO: kellyFraction = |edge| / ((1/noPrice) − 1). Se aplica Quarter-Kelly (×0,25) y se acota a [0, 0,15]. Esto significa que el bot nunca arriesga más del 15% del bankroll en una sola operación, y las posiciones típicas son del 1-5% del bankroll.

6. Ejecución de operaciones

La clase Trader se conecta al CLOB de Polymarket usando @polymarket/clob-client con tipo de firma 2 (POLY_GNOSIS_SAFE). Ejecución principal: orden de mercado FOK (Fill-Or-Kill) para ejecución inmediata. Respaldo: orden límite GTC al mejor ask/bid + 2% de deslizamiento, redondeado al tamaño del tick. Los libros de órdenes muertos (404/not found) se cachean y omiten. La ejecución concurrente en el mismo tokenId se evita mediante un Set como lock.

7. Ingeniería de prompts de Claude y Gemini

Cada mercado es analizado por Claude y Gemini con un prompt estructurado que contiene: pregunta del mercado, precios de YES/NO (probabilidades implícitas), los 4 pronósticos de los modelos, temperatura de consenso, nivel de concordancia entre modelos, horas hasta la resolución, promedios históricos, análisis de ventaja por resultado e historial reciente de operaciones del bot para ese mercado. Dos conjuntos de reglas: modo BALANCED (ventaja mínima del 5%, prefiere BUY_YES a 5-40¢) y modo AGGRESSIVE (ventaja mínima del 3%, BUY_NO permitido por encima de 11¢). La salida se impone como JSON con etiquetas de resultado exactas.

Gestión de wallet y claves

WeatherBot gestiona todas las operaciones del wallet en el lado del cliente. Tu clave privada se usa localmente para derivar la dirección del wallet y las credenciales de la API de Polymarket (key, secret, passphrase) mediante el ClobClient. El tipo de firma 2 (POLY_GNOSIS_SAFE) se utiliza con el proxy como funder. Las claves privadas nunca salen de tu dispositivo y no se almacenan en ningún servidor.

Contratos aprobados automáticamente

Monitoreo de saldo

Al conectar el wallet, el bot comprueba el saldo de POL (para gas) y el saldo de USDC (en la dirección proxy, para trading) vía Polygon RPC (polygon-bor-rpc.publicnode.com). Se muestran advertencias si POL < 0,01 o USDC < 1 $. Antes de cada operación, el bot verifica que el monto no supere el saldo disponible de USDC y rastrea el saldo localmente tras cada fill.

Stack de gestión de riesgo

• Dimensionamiento Quarter-Kelly — nunca arriesga más del 25% del tamaño de apuesta matemáticamente óptimo
• Fracción máxima 15% — límite estricto sobre cualquier posición individual en relación con el bankroll
• límite maxPerTrade — límite configurable en dólares por operación (predeterminado $50)
• Detección de libros de órdenes muertos — omite los tokens que devuelven 404/no encontrado del CLOB
• Bloqueo de ejecución concurrente — evita ordenar dos veces el mismo tokenId mediante Set
• Filtro de rango de precio — omite los mercados donde el precio de YES está por debajo de 2¢ o por encima de 98¢
• Filtro de tiempo — omite los mercados que se resuelven dentro de 2 horas (demasiado tarde para operaciones significativas)
• Anti-churn de IA — Claude y Gemini reciben el historial reciente de operaciones y reciben la instrucción de evitar entradas repetidas
• Sistema de salida de 5 capas — objetivo de ganancia, convergencia de ventaja, trailing stop, stop loss, decaimiento temporal

Autenticación de usuario

La autenticación se gestiona en el lado del cliente usando tu wallet conectado. La gestión de sesión ocurre localmente en tu navegador — no se almacenan credenciales ni tokens en ningún servidor remoto.

Aviso legal

WeatherBot es software de trading experimental. Operar en Polymarket conlleva un riesgo significativo: puedes perder parte o la totalidad de tu inversión. Los pronósticos meteorológicos son probabilísticos y no están garantizados. El análisis de IA no es asesoramiento financiero. Todas las operaciones de wallet ocurren en el lado del cliente: tus claves privadas nunca se almacenan en ningún servidor. Eres responsable de cumplir con la normativa local sobre el trading en mercados de predicción. El rendimiento pasado no garantiza resultados futuros.

Independencia y ausencia de afiliación con Polymarket

WeatherBot es una herramienta de software independiente y de terceros. WeatherBot no está afiliado, respaldado, patrocinado, operado ni de ninguna manera conectado oficialmente con Polymarket, sus empresas matrices ni ninguna de sus subsidiarias o filiales.

"Polymarket" y cualquier nombre, marca, logotipo e imagen relacionados son marcas comerciales y propiedad de sus respectivos dueños y se utilizan en este sitio únicamente con fines descriptivos y de interoperabilidad —solo para identificar la plataforma de terceros con la que interactúa la automatización de código abierto de WeatherBot en nombre del usuario. Su uso no implica ninguna asociación, agencia, patrocinio ni respaldo.

WeatherBot no custodia los fondos de los usuarios, no opera un mercado de predicciones, exchange ni libro de órdenes, y no empareja, compensa ni liquida operaciones. Es un software de automatización que se conecta a las APIs públicas de Polymarket usando credenciales suministradas y controladas íntegramente por el usuario. Todas las operaciones se ejecutan en la propia infraestructura de Polymarket, on-chain a través de la red Polygon, mediante la propia billetera del usuario. WeatherBot no es un bróker, dealer, asesor financiero, exchange ni negocio de servicios monetarios.

Cualquier pregunta, disputa, problema de cuenta o consulta legal relacionada con la propia plataforma de Polymarket —incluida la resolución de mercados, depósitos, retiros, elegibilidad o términos de uso— debe dirigirse directamente a Polymarket. WeatherBot no puede actuar ni actúa en nombre de Polymarket y no tiene autoridad para resolver tales asuntos.

WeatherBot se proporciona "tal cual", sin garantía de ningún tipo. Los usuarios son los únicos responsables de garantizar que su uso de WeatherBot y de Polymarket cumpla con todas las leyes y regulaciones que les sean aplicables en su jurisdicción. La operación en mercados de predicciones puede estar restringida o prohibida en algunas jurisdicciones; es responsabilidad del usuario verificar su elegibilidad antes de usarlo.

1. Información que recopilamos

WeatherBot opera enteramente en el lado del cliente. No almacenamos tus claves privadas, credenciales del wallet ni datos personales en ningún servidor. Los siguientes datos se gestionan localmente en tu navegador o en tu propia infraestructura:

• Datos del wallet — La dirección de tu billetera de Polygon y la dirección del proxy (financiador) se usan del lado del cliente para la ejecución de operaciones on-chain mediante el CLOB de Polymarket. Las claves privadas nunca salen de tu dispositivo.
• Datos de trading — El historial de operaciones, los análisis de IA, las posiciones abiertas, las detecciones de ventaja y los ajustes de configuración (bankroll, maxPerTrade, minEdge) se gestionan localmente.
• Métricas de uso — Los recuentos de escaneos, operaciones, actualizaciones de precios y detecciones de ventaja se rastrean localmente por sesión.

2. Cómo usamos tus datos

Todos los datos recopilados se utilizan exclusivamente para operar el bot de trading meteorológico de Polymarket:

• Las credenciales del wallet se utilizan para firmar y ejecutar operaciones en Polymarket a través de la red Polygon.
• La configuración de trading determina el dimensionamiento de posiciones, los umbrales de edge y el comportamiento de automatización.
• El historial de operaciones se pasa a Claude y Gemini para evitar el sobreoperar (compra/venta repetida del mismo resultado).
• Los logs y métricas se muestran en la interfaz del dashboard para que los monitorices.

3. Almacenamiento de datos

Todos los datos se gestionan en el lado del cliente. WeatherBot no almacena datos de usuario en ningún servidor remoto ni base de datos en la nube. No hay analítica de terceros ni transmisión externa de datos más allá de las APIs necesarias para la operación del bot (listadas abajo).

4. Servicios de terceros

WeatherBot se comunica con los siguientes servicios externos como parte de su operación normal:

• Polymarket — API CLOB (clob.polymarket.com), API Gamma (gamma-api.polymarket.com), WebSocket (ws-subscriptions-clob.polymarket.com), Data API (data-api.polymarket.com) para el descubrimiento de mercados, las operaciones y la transmisión.
• Open-Meteo — API de pronóstico meteorológico (api.open-meteo.com) para los datos de los modelos GFS, ECMWF y UKMO. No requiere autenticación.
• NOAA / NWS — Pronósticos meteorológicos de EE. UU. (api.weather.gov) y datos climáticos históricos (ncei.noaa.gov). APIs públicas.
• Anthropic — API de Claude AI (api.anthropic.com) para el análisis de mercados. Se usa tu clave de API de Anthropic; se envían datos de mercado (no datos personales) para el análisis.
• RPC de Polygon — Nodo público de Polygon (polygon-bor-rpc.publicnode.com) para verificaciones de saldo y aprobaciones de tokens.

5. Retención de datos

Los logs están limitados a 200 entradas por usuario (las más antiguas se descartan). El historial de operaciones está limitado a 100 entradas. Los análisis de IA están limitados a 20. Las detecciones de edge en vivo están limitadas a 50. Estos datos persisten hasta que el directorio de datos del servidor se borra manualmente.

6. Seguridad

WeatherBot opera en el lado del cliente — tus claves privadas nunca se transmiten ni se almacenan en ningún servidor. Toda la firma y ejecución de operaciones ocurre localmente en tu dispositivo. Los usuarios deben asegurarse de que su dispositivo y entorno de navegador sean seguros.

7. Tus derechos

Puedes desconectar tu wallet en cualquier momento desde el dashboard. Como todos los datos se gestionan en el lado del cliente, desconectar tu wallet borra todos los datos asociados de tu sesión. No se requiere eliminación de datos del lado del servidor.

8. Cambios a esta política

Esta política de privacidad puede actualizarse a medida que WeatherBot evoluciona. Los cambios se reflejarán en esta página. El uso continuado del polymarket weather trading bot tras los cambios constituye la aceptación de la política actualizada.

Última actualización: junio de 2026

1. Aceptación de los términos

Al acceder o usar WeatherBot ("el Servicio"), aceptas quedar vinculado por estos Términos de Servicio. Si no estás de acuerdo con estos términos, no utilices el Servicio. WeatherBot es un polymarket weather trading bot que ejecuta operaciones en los mercados de predicción de Polymarket mediante estrategias automatizadas.

2. Descripción del servicio

WeatherBot es un software de trading experimental de código abierto que:

• Descubre mercados de predicción meteorológica en Polymarket mediante la Gamma API
• Obtiene pronósticos meteorológicos de los modelos GFS, ECMWF, UKMO y NWS
• Calcula la ventaja probabilística usando estadística bayesiana y aproximaciones CDF normales
• Analiza los mercados usando Claude y Gemini para las decisiones de operación
• Ejecuta operaciones en el CLOB de Polymarket a través de la blockchain Polygon
• Monitoriza las posiciones abiertas con condiciones de salida automatizadas

3. Divulgación de riesgos

Operar en Polymarket conlleva un riesgo financiero significativo. Puedes perder parte o la totalidad del capital invertido. Al usar WeatherBot, reconoces y aceptas los siguientes riesgos:

• Riesgo de mercado — Los mercados de predicción del clima son volátiles. Los precios pueden moverse en contra de tus posiciones de forma rápida e impredecible.
• Riesgo del modelo — Los pronósticos meteorológicos son probabilísticos, no garantizados. Los modelos GFS, ECMWF, UKMO y NWS pueden producir y producen pronósticos incorrectos.
• Riesgo IA — Las recomendaciones de operación de Claude y Gemini se basan en la coincidencia de patrones y el razonamiento, no en la certeza. La IA puede cometer errores de juicio.
• Riesgo de ejecución — Las operaciones pueden fallar por liquidez insuficiente, congestión de la red, libros de órdenes inactivos o errores de la API.
• Riesgo de smart contract — Interactuar con los contratos inteligentes de Polymarket en Polygon conlleva riesgos inherentes de blockchain, incluidos errores, exploits y fallos de la red.
• Riesgo de software — WeatherBot es software experimental. Errores, caídas o comportamientos inesperados pueden provocar pérdidas financieras.

4. No es asesoramiento financiero

WeatherBot no proporciona asesoramiento financiero, de inversión ni de trading. Las señales automatizadas, los análisis de IA, los cálculos de edge y las ejecuciones de operaciones son salidas algorítmicas, no recomendaciones. Eres el único responsable de tus decisiones de trading y de sus consecuencias financieras. El rendimiento pasado del bot, sus modelos o los traders monitoreados no garantiza resultados futuros.

5. Elegibilidad

Declaras y garantizas que:

• Tienes la mayoría de edad en tu jurisdicción para aceptar estos términos
• No te encuentras en una jurisdicción donde el trading en mercados de predicción esté prohibido
• Has leído y aceptas los Términos de Servicio de Polymarket
• Comprendes los riesgos del trading de criptomonedas y las interacciones con la blockchain
• Los fondos que utilizas para operar no provienen de actividades ilegales

6. Responsabilidades del usuario

Eres responsable de:

• Proteger tu dispositivo y el entorno del navegador donde corre WeatherBot
• Proteger tu clave privada y credenciales del wallet
• Monitorizar la actividad y posiciones de tu bot
• Asegurar POL suficiente para tarifas de gas y USDC para operar
• Configurar los ajustes de bankroll, maxPerTrade y minEdge apropiados a tu tolerancia al riesgo
• Cumplir con todas las leyes y normativas aplicables en tu jurisdicción

7. Limitación de responsabilidad

WeatherBot se proporciona «tal cual» y «según disponibilidad», sin garantías de ningún tipo, expresas o implícitas. En la máxima medida permitida por la ley, los desarrolladores de WeatherBot no serán responsables de daños directos, indirectos, incidentales, especiales, consecuentes o punitivos derivados de tu uso del Servicio, incluidos, entre otros, pérdidas financieras por operaciones, compromiso del wallet, fallos de contratos inteligentes o errores de software.

8. Propiedad intelectual

El código fuente de WeatherBot, sus algoritmos (incluyendo los módulos EdgeCalculator, ForecastEngine, StreamEngine, AIAnalyzer y Trader), su documentación y el diseño del sitio web son propiedad intelectual del equipo de WeatherBot. El nombre y la imagen de marca del polymarket weather trading bot son propietarios.

9. Terminación

Puedes dejar de usar WeatherBot en cualquier momento desconectando tu wallet y deteniendo el bot. Nos reservamos el derecho de modificar, suspender o discontinuar el Servicio en cualquier momento sin previo aviso.

10. Modificaciones

Estos Términos de Servicio pueden actualizarse en cualquier momento. El uso continuado del polymarket weather trading bot tras las modificaciones constituye la aceptación de los términos revisados. Los cambios importantes se indicarán en esta página con una fecha actualizada.

11. Ley aplicable

Estos términos se regirán e interpretarán de acuerdo con la legislación aplicable, sin tener en cuenta los principios de conflicto de leyes. Cualquier disputa que surja de estos términos o de tu uso de WeatherBot se resolverá mediante arbitraje vinculante.

12. Contacto

Para preguntas sobre estos Términos de Servicio, contáctanos en [email protected].

Última actualización: marzo de 2026