WeatherBot

Início 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

Variáveis de ambiente

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 da API

Opções de configuração

Parsing de mercado

O módulo MarketDiscovery analisa perguntas da Polymarket como "What will be the highest temperature in New York on March 15?" e as converte em dados estruturados: cidade (lat/lon de um mapa de 67 cidades), data (4 padrões regex: "on Month Day", "on Day Month", "Month Day", "Day Month Year"), unidade de temperatura (°F para cidades dos EUA, °C internacionalmente) e tipo de mercado (max_temp, min_temp, precipitation, snow, severe).

Resultados como "52-53°F", "54°F or higher", "50°F or lower" são parseados em intervalos com valores low/high e flags isOrHigher, isOrLower e isRange — permitindo ao EdgeCalculator executar o cálculo de CDF correto para cada tipo de resultado.

Arquitetura multiusuário

O módulo Store (store.js) fornece armazenamento persistente de arquivos JSON em /data/users.json. Cada usuário recebe: credenciais (senha com hash pbkdf2, token de autenticação), configuração de carteira (PK criptografada, endereço proxy), configuração de trading (bankroll, maxPerTrade, minEdge), estatísticas (scans, trades, edgesDetected), análises de IA, histórico de operações e logs. O módulo BotManager executa um ciclo separado de StreamEngine + Trader + IA por usuário, enquanto compartilha os dados de mercado entre todos os usuários.

Como funciona o rastreamento de traders

O /api/traders endpoint busca 4 fontes de dados por carteira em paralelo: a API de leaderboard da Polymarket (PnL + volume oficiais), a API de perfil da Gamma (nome de usuário, avatar), a API de posições (todas as posições resolvidas + ativas com cashPnL) e a API de atividade (últimas 30 operações). Os resultados são ordenados por PnL total decrescente.

Carteiras rastreadas

O WeatherBot monitora 10 carteiras top de trading meteorológico definidas em cities.js. Estes são os participantes mais lucrativos dos mercados meteorológicos na Polymarket, identificados pelo PnL acumulado e taxa de acerto nos mercados de previsão meteorológica.

Pontos de dados por trader

• Perfil — nome de usuário, foto de perfil (do leaderboard ou da Gamma)
• PnL — lucro/prejuízo total da API de leaderboard (fonte oficial)
• Volume — volume total de operações em USD
• Taxa de acerto — calculado a partir das posições: (posições vencedoras / total de posições) × 100
• Posições ativas — posições abertas atuais com tamanho > 0
• Histórico de PnL — gráfico cumulativo construído a partir das posições resolvidas ordenadas com endDate
• Operações recentes — últimas 5 operações com título do mercado, lado, tamanho, preço, timestamp

Copy trading com IA

Quando o bot roda em modo de execução automática, Claude e Gemini analisam os mesmos mercados em que esses traders de elite estão ativos. A IA recebe dados completos de previsão, análise de edge e histórico recente de operações — incluindo informação sobre se o bot já mantém uma posição (para evitar entrada dupla). Isso cria um sistema de copy trading aumentado por IA em que suas operações são informadas tanto pela atividade dos melhores traders quanto pela análise meteorológica independente de Claude e Gemini.

Proteção anti-churn

O prompt de IA inclui o histórico recente de operações do bot para cada mercado. Claude e Gemini são instruídos a SKIP se o bot acabou de vender com lucro e o preço não se moveu, a ter cautela ao reentrar após uma perda a menos que as condições tenham mudado, e a evitar comprar/vender o mesmo resultado repetidamente (o que desperdiça dinheiro no spread).

1. Algoritmo de temperatura de consenso

A função EdgeCalculator.calculateConsensus() calcula uma temperatura prevista ponderada por qualidade a partir de até 4 modelos. Pesos base: ECMWF 0,35 (melhor modelo global), GFS 0,25, UKMO 0,20, NWS 0,20. Penalização de outliers: se a previsão de um modelo se desviar mais de 1,5× o desvio padrão da média bruta, seu peso é reduzido pela metade. O consenso final é a média ponderada dos pesos ajustados, normalizada para somar 1,0.

A concordância entre modelos é pontuada em 5 níveis com base no desvio padrão entre modelos: VERY_HIGH (<0,5°), HIGH (<1,0°), MODERATE (<2,0°), LOW (<3,5°), VERY_LOW (≥3,5°). Essa pontuação de concordância afeta diretamente os níveis de confiança e pode rebaixar a confiança VERY_HIGH para HIGH quando os modelos discordam.

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

A incerteza σ da previsão é o parâmetro mais crítico. calculateSigma() recebe três entradas: horas até a resolução, array de temperaturas dos modelos e número de modelos. σ base por 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° (além). Penalidade por número de modelos: 1,0× (≥4 modelos), 1,1× (3), 1,25× (2), 1,5× (1). Penalidade de dispersão: 1,0 + (stdDev / 5,0). σ final limitado a [0,5; 8,0].

3. Mistura bayesiana histórica

Quando há dados históricos do NOAA NCEI disponíveis, a previsão é combinada bayesiana com a distribuição histórica de 10 anos para a mesma data do calendário. Combinada por ponderação de precisão: combined_precision = forecast_precision + historical_precision, onde precision = 1/σ². Se previsão e histórico divergirem em mais de 1,5 × historical_σ, o σ combinado é alargado em 30% para considerar condições atípicas.

4. Cálculo de probabilidade

Para cada resultado de mercado, a CDF normal (aproximação Abramowitz-Stegun) calcula a probabilidade de a temperatura real cair dentro do intervalo do resultado:

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

Edge = forecastProb − marketPrice. Os trades são sinalizados quando |edge| ultrapassa o limite dinâmico: max(0,03, min(0,08, σ × 0,02)).

5. Sizing por critério de Kelly

Para BUY_YES: kellyFraction = edge / ((1/marketPrice) − 1). Para BUY_NO: kellyFraction = |edge| / ((1/noPrice) − 1). Aplica-se Quarter-Kelly (×0,25) limitado a [0, 0,15]. Isso significa que o bot nunca arrisca mais de 15% do bankroll em uma única operação, e as posições típicas são de 1-5% do bankroll.

6. Execução de trades

A classe Trader se conecta ao CLOB da Polymarket via @polymarket/clob-client com tipo de assinatura 2 (POLY_GNOSIS_SAFE). Execução primária: ordem de mercado FOK (Fill-Or-Kill) para fills imediatos. Fallback: ordem limit GTC no melhor ask/bid + 2% de slippage, arredondada para o tick size. Orderbooks mortos (404/not found) são cacheados e ignorados. A execução concorrente no mesmo tokenId é impedida por um lock do tipo Set.

7. Engenharia de Prompt de Claude e Gemini

Cada mercado é analisado por Claude e Gemini com um prompt estruturado contendo: pergunta do mercado, preços YES/NO (probabilidades implícitas), todas as 4 previsões de modelos, temperatura de consenso, nível de concordância entre modelos, horas até a resolução, médias históricas, análise de edge por resultado e histórico recente de operações do bot para aquele mercado. Dois conjuntos de regras: modo BALANCED (edge mínimo de 5%, prefere BUY_YES entre 5–40¢) e modo AGGRESSIVE (edge mínimo de 3%, BUY_NO permitido acima de 11¢). A saída é forçada como JSON com rótulos de resultado exatos.

Gerenciamento de wallet e chaves

O WeatherBot gerencia todas as operações de carteira no lado do cliente. Sua chave privada é usada localmente para derivar o endereço da carteira e as credenciais da API Polymarket (key, secret, passphrase) via ClobClient. O tipo de assinatura 2 (POLY_GNOSIS_SAFE) é usado com o proxy como funder. As chaves privadas nunca saem do seu dispositivo e não são armazenadas em nenhum servidor.

Contratos aprovados automaticamente

Monitoramento de saldo

Ao conectar a carteira, o bot verifica o saldo de POL (para gas) e o saldo de USDC (no endereço proxy, para trading) via Polygon RPC (polygon-bor-rpc.publicnode.com). Avisos são exibidos se POL < 0,01 ou USDC < US$ 1. Antes de cada trade, o bot verifica que o valor não excede o saldo de USDC disponível e rastreia o saldo localmente após cada fill.

Stack de gestão de risco

• Sizing Quarter-Kelly — nunca arrisca mais de 25% do tamanho de aposta matematicamente ótimo
• Fração máxima 15% — limite rígido sobre qualquer posição individual em relação ao bankroll
• limite maxPerTrade — limite em dólares configurável por operação (padrão US$ 50)
• Detecção de orderbooks mortos — ignora tokens que retornam 404/não encontrado do CLOB
• Lock de execução concorrente — evita ordens duplicadas no mesmo tokenId via Set
• Filtro de faixa de preço — ignora mercados em que o preço de YES está abaixo de 2¢ ou acima de 98¢
• Filtro de tempo — ignora mercados que se resolvem dentro de 2 horas (tarde demais para operações significativas)
• Anti-churn da IA — Claude e Gemini recebem o histórico recente de operações e são instruídos a evitar entradas repetidas
• Sistema de saída em 5 camadas — meta de lucro, convergência de edge, trailing stop, stop loss, decaimento temporal

Autenticação de usuário

A autenticação é tratada no lado do cliente usando sua carteira conectada. O gerenciamento de sessão ocorre localmente no seu navegador — nenhuma credencial ou token é armazenado em qualquer servidor remoto.

Aviso legal

WeatherBot é um software de trading experimental. Operar na Polymarket envolve risco significativo — você pode perder parte ou todo o seu investimento. As previsões meteorológicas são probabilísticas e não garantidas. A análise da IA não constitui aconselhamento financeiro. Todas as operações de carteira ocorrem no lado do cliente — suas chaves privadas nunca são armazenadas em nenhum servidor. Você é responsável por cumprir as regulamentações locais relativas ao trading em mercados de previsão. Resultados passados não garantem resultados futuros.

Independência e Ausência de Vínculo com a Polymarket

O WeatherBot é uma ferramenta de software independente, de terceiros. O WeatherBot não é afiliado, endossado, patrocinado, operado, nem de qualquer forma oficialmente conectado à Polymarket, suas empresas controladoras ou quaisquer de suas subsidiárias ou afiliadas.

"Polymarket" e quaisquer nomes, marcas, logotipos e imagens relacionados são marcas registradas e propriedade de seus respectivos donos e são usados neste site apenas para fins descritivos e de interoperabilidade — exclusivamente para identificar a plataforma de terceiros com a qual a automação de código aberto do WeatherBot interage em nome do usuário. Seu uso não implica qualquer parceria, agência, patrocínio ou endosso.

O WeatherBot não custodia fundos de usuários, não opera um mercado de previsão, exchange ou livro de ordens, e não casa, compensa ou liquida operações. É um software de automação que se conecta às APIs publicamente disponíveis da Polymarket usando credenciais fornecidas e controladas inteiramente pelo usuário. Todas as operações são executadas na própria infraestrutura da Polymarket, on-chain via a rede Polygon, pela própria carteira do usuário. O WeatherBot não é um corretor, dealer, consultor financeiro, exchange ou empresa de serviços monetários.

Quaisquer dúvidas, disputas, problemas de conta ou consultas jurídicas relacionadas à própria plataforma Polymarket — incluindo resolução de mercados, depósitos, saques, elegibilidade ou termos de uso — devem ser direcionadas diretamente à Polymarket. O WeatherBot não pode e não age em nome da Polymarket e não tem autoridade para resolver tais questões.

O WeatherBot é fornecido "como está", sem garantia de qualquer tipo. Os usuários são os únicos responsáveis por garantir que seu uso do WeatherBot e da Polymarket cumpra todas as leis e regulamentos aplicáveis a eles em sua jurisdição. A negociação em mercados de previsão pode ser restrita ou proibida em algumas jurisdições; é responsabilidade do usuário verificar sua elegibilidade antes do uso.

1. Informações que coletamos

O WeatherBot opera inteiramente no lado do cliente. Não armazenamos suas chaves privadas, credenciais de carteira ou dados pessoais em nenhum servidor. Os seguintes dados são gerenciados localmente no seu navegador ou na sua própria infraestrutura:

• Dados da carteira — Seu endereço de carteira Polygon e o endereço de proxy (financiador) são usados no lado do cliente para a execução de operações on-chain via o CLOB da Polymarket. As chaves privadas nunca saem do seu dispositivo.
• Dados de trading — Histórico de operações, análises de IA, posições abertas, detecções de edge e configurações (bankroll, maxPerTrade, minEdge) são gerenciados localmente.
• Métricas de uso — Contagens de varredura, contagens de operações, contagens de atualização de preço e contagens de detecção de edge são rastreadas localmente por sessão.

2. Como usamos seus dados

Todos os dados coletados são usados exclusivamente para operar o bot de trading climático da Polymarket:

• As credenciais da carteira são usadas para assinar e executar trades na Polymarket via rede Polygon.
• A configuração de trading determina o dimensionamento de posições, os limites de edge e o comportamento da automação.
• O histórico de operações é passado a Claude e Gemini para evitar churn (compra/venda repetida no mesmo resultado).
• Logs e métricas são exibidos na interface do dashboard para seu monitoramento.

3. Armazenamento de dados

Todos os dados são gerenciados no lado do cliente. O WeatherBot não armazena dados de usuário em nenhum servidor remoto ou banco de dados em nuvem. Não há analítica de terceiros nem transmissão externa de dados além das APIs necessárias à operação do bot (listadas abaixo).

4. Serviços de terceiros

O WeatherBot se comunica com os seguintes serviços externos como parte da operação normal:

• Polymarket — CLOB API (clob.polymarket.com), Gamma API (gamma-api.polymarket.com), WebSocket (ws-subscriptions-clob.polymarket.com), Data API (data-api.polymarket.com) para descoberta de mercados, negociação e streaming.
• Open-Meteo — API de previsão do tempo (api.open-meteo.com) para os dados dos modelos GFS, ECMWF e UKMO. Nenhuma autenticação necessária.
• NOAA / NWS — Previsões do tempo dos EUA (api.weather.gov) e dados climáticos históricos (ncei.noaa.gov). APIs públicas.
• Anthropic — Claude AI API (api.anthropic.com) para análise de mercado. Sua chave de API da Anthropic é usada; dados de mercado (não dados pessoais) são enviados para análise.
• RPC Polygon — Nó público da Polygon (polygon-bor-rpc.publicnode.com) para verificações de saldo e aprovações de token.

5. Retenção de dados

Os logs são limitados a 200 entradas por usuário (as mais antigas são descartadas). O histórico de trades é limitado a 100 entradas. As análises de IA são limitadas a 20. As detecções de edge ao vivo são limitadas a 50. Esses dados persistem até que o diretório de dados do servidor seja limpo manualmente.

6. Segurança

O WeatherBot opera no lado do cliente — suas chaves privadas nunca são transmitidas nem armazenadas em nenhum servidor. Toda a assinatura e execução de trades acontece localmente no seu dispositivo. Os usuários devem garantir que seu dispositivo e ambiente de navegador sejam seguros.

7. Seus direitos

Você pode desconectar sua carteira a qualquer momento pelo dashboard. Como todos os dados são gerenciados no lado do cliente, desconectar sua carteira limpa todos os dados associados da sua sessão. Não é necessária exclusão de dados no lado do servidor.

8. Alterações a esta política

Esta política de privacidade pode ser atualizada à medida que o WeatherBot evolui. As alterações serão refletidas nesta página. O uso contínuo do polymarket weather trading bot após as alterações constitui aceitação da política atualizada.

Última atualização: junho de 2026

1. Aceitação dos termos

Ao acessar ou usar o WeatherBot ("o Serviço"), você concorda em ficar vinculado por estes Termos de Serviço. Se você não concorda com estes termos, não use o Serviço. O WeatherBot é um polymarket weather trading bot que executa operações nos mercados de previsão da Polymarket usando estratégias automatizadas.

2. Descrição do serviço

O WeatherBot é um software de trading experimental de código aberto que:

• Descobre mercados de previsão meteorológica na Polymarket via Gamma API
• Busca previsões meteorológicas dos modelos GFS, ECMWF, UKMO e NWS
• Calcula o edge probabilístico usando estatística bayesiana e aproximações CDF normais
• Analisa mercados usando Claude e Gemini para decisões de negociação
• Executa trades no CLOB da Polymarket via blockchain Polygon
• Monitora posições abertas com condições de saída automatizadas

3. Divulgação de riscos

Operar na Polymarket envolve risco financeiro significativo. Você pode perder parte ou todo o capital investido. Ao usar o WeatherBot, você reconhece e aceita os seguintes riscos:

• Risco de mercado — Os mercados de previsão de clima são voláteis. Os preços podem se mover contra suas posições de forma rápida e imprevisível.
• Risco do modelo — As previsões do tempo são probabilísticas, não garantidas. Os modelos GFS, ECMWF, UKMO e NWS podem produzir e produzem previsões incorretas.
• Risco da IA — As recomendações de negociação de Claude e Gemini são baseadas em correspondência de padrões e raciocínio, não em certeza. A IA pode cometer erros de julgamento.
• Risco de execução — As operações podem falhar devido a liquidez insuficiente, congestionamento da rede, livros de ordens mortos ou erros de API.
• Risco de smart contract — Interagir com os contratos inteligentes da Polymarket na Polygon acarreta riscos inerentes de blockchain, incluindo bugs, exploits e falhas de rede.
• Risco de software — O WeatherBot é um software experimental. Bugs, travamentos ou comportamento inesperado podem resultar em perdas financeiras.

4. Sem aconselhamento financeiro

O WeatherBot não oferece aconselhamento financeiro, de investimento ou de trading. Os sinais automatizados, análises da IA, cálculos de edge e execuções de trades são saídas algorítmicas — não recomendações. Você é o único responsável pelas suas decisões de trading e suas consequências financeiras. O desempenho passado do bot, de seus modelos ou dos traders monitorados não garante resultados futuros.

5. Elegibilidade

Você declara e garante que:

• Você tem maioridade na sua jurisdição para aceitar estes termos
• Você não está em uma jurisdição onde o trading em mercados de previsão é proibido
• Você leu e concorda com os Termos de Serviço da Polymarket
• Você compreende os riscos do trading de criptomoedas e das interações com blockchain
• Os fundos que você usa para trading não provêm de atividade ilegal

6. Responsabilidades do usuário

Você é responsável por:

• Proteger seu dispositivo e o ambiente de navegador onde o WeatherBot roda
• Proteger sua chave privada e credenciais de carteira
• Monitorar a atividade e posições do seu bot
• Garantir POL suficiente para taxas de gas e USDC para trading
• Configurar as opções de bankroll, maxPerTrade e minEdge adequadas à sua tolerância ao risco
• Cumprir todas as leis e regulamentos aplicáveis em sua jurisdição

7. Limitação de responsabilidade

O WeatherBot é fornecido "como está" e "conforme disponível", sem garantias de qualquer tipo, expressas ou implícitas. Na máxima extensão permitida por lei, os desenvolvedores do WeatherBot não serão responsáveis por quaisquer danos diretos, indiretos, incidentais, especiais, consequenciais ou punitivos decorrentes do seu uso do Serviço, incluindo, entre outros, perdas financeiras em operações, comprometimento da carteira, falhas de contratos inteligentes ou bugs de software.

8. Propriedade intelectual

O código-fonte do WeatherBot, seus algoritmos (incluindo os módulos EdgeCalculator, ForecastEngine, StreamEngine, AIAnalyzer e Trader), a documentação e o design do site são propriedade intelectual da equipe do WeatherBot. O nome e a marca do polymarket weather trading bot são proprietários.

9. Rescisão

Você pode parar de usar o WeatherBot a qualquer momento desconectando sua carteira e parando o bot. Reservamo-nos o direito de modificar, suspender ou descontinuar o Serviço a qualquer momento sem aviso.

10. Modificações

Estes Termos de Serviço podem ser atualizados a qualquer momento. O uso contínuo do polymarket weather trading bot após modificações constitui aceitação dos termos revisados. Mudanças significativas serão indicadas nesta página com uma data atualizada.

11. Lei aplicável

Estes termos serão regidos e interpretados de acordo com a legislação aplicável, sem considerar princípios de conflito de leis. Quaisquer disputas decorrentes destes termos ou do seu uso do WeatherBot serão resolvidas por arbitragem vinculante.

12. Contato

Para dúvidas sobre estes Termos de Serviço, entre em contato conosco em [email protected].

Última atualização: março de 2026