WeatherBot

Avvio rapido

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

Variabili d'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)

Endpoint API

Opzioni di configurazione

Parsing dei mercati

Il modulo MarketDiscovery analizza domande di Polymarket come "What will be the highest temperature in New York on March 15?" trasformandole in dati strutturati: città (lat/lon da una mappa di 67 città), data (4 pattern regex: "on Month Day", "on Day Month", "Month Day", "Day Month Year"), unità di temperatura (°F per città USA, °C per il resto del mondo) e tipo di mercato (max_temp, min_temp, precipitation, snow, severe).

Esiti come "52-53°F", "54°F or higher", "50°F or lower" vengono analizzati in intervalli con valori low/high e flag isOrHigher, isOrLower e isRange — consentendo all'EdgeCalculator di eseguire il calcolo CDF corretto per ciascun tipo di esito.

Architettura multi-utente

Il modulo Store (store.js) fornisce archiviazione persistente di file JSON in /data/users.json. Ogni utente riceve: credenziali (password hashata pbkdf2, token di autenticazione), configurazione wallet (PK cifrata, indirizzo proxy), configurazione trading (bankroll, maxPerTrade, minEdge), statistiche (scans, trades, edgesDetected), analisi IA, cronologia delle operazioni e log. Il modulo BotManager esegue un ciclo separato StreamEngine + Trader + IA per ciascun utente, condividendo i dati di mercato tra tutti gli utenti.

Come funziona il tracking dei trader

L' /api/traders endpoint recupera 4 fonti di dati per wallet in parallelo: l'API della classifica di Polymarket (PnL + volume autorevoli), l'API del profilo Gamma (username, avatar), l'API delle posizioni (tutte le posizioni risolte + attive con cashPnL) e l'API dell'attività (ultime 30 operazioni). I risultati sono ordinati per PnL totale decrescente.

Wallet monitorati

WeatherBot monitora 10 wallet di trading meteo di alto livello definiti in cities.js. Questi sono i partecipanti più redditizi dei mercati meteo su Polymarket, identificati per PnL cumulativo e tasso di vincita nei mercati di previsione meteo.

Punti dati per trader

• Profilo — username, immagine del profilo (dalla classifica o da Gamma)
• PnL — profitto/perdita totale dall'API della classifica (fonte autorevole)
• Volume — volume di trading totale in USD
• Tasso di vittoria — calcolato dalle posizioni: (posizioni vincenti / posizioni totali) × 100
• Posizioni attive — posizioni aperte correnti con dimensione > 0
• Cronologia PnL — grafico cumulativo costruito dalle posizioni risolte ordinate con endDate
• Operazioni recenti — ultime 5 operazioni con titolo del mercato, lato, dimensione, prezzo, timestamp

Copy trading con IA

Quando il bot opera in modalità di esecuzione automatica, Claude e Gemini analizzano gli stessi mercati in cui questi top trader sono attivi. L'IA riceve dati di previsione completi, analisi del vantaggio e cronologia recente delle operazioni — incluse informazioni sul fatto che il bot detenga già una posizione (per evitare doppie entrate). Questo crea un sistema di copy trading potenziato dall'IA in cui le tue operazioni sono guidate sia dall'attività dei top trader sia dall'analisi meteorologica indipendente di Claude e Gemini.

Protezione anti-churn

Il prompt dell'IA include la cronologia recente delle operazioni del bot per ogni mercato. Claude e Gemini sono istruiti a fare SKIP se il bot ha appena venduto in profitto e il prezzo non si è mosso, a essere cauti nel rientrare dopo una perdita a meno che le condizioni non siano cambiate, e a evitare di acquistare/vendere ripetutamente lo stesso esito (il che spreca denaro nello spread).

1. Algoritmo della temperatura di consenso

La funzione EdgeCalculator.calculateConsensus() calcola una temperatura di previsione pesata per qualità a partire da un massimo di 4 modelli. Pesi base: ECMWF 0,35 (miglior modello globale), GFS 0,25, UKMO 0,20, NWS 0,20. Penalizzazione degli outlier: se la previsione di un modello si discosta di oltre 1,5× la deviazione standard dalla media grezza, il suo peso viene dimezzato. Il consenso finale è la media pesata dei pesi corretti normalizzati per sommare a 1,0.

L'accordo tra i modelli è valutato in 5 livelli in base alla deviazione standard tra i modelli: VERY_HIGH (<0,5°), HIGH (<1,0°), MODERATE (<2,0°), LOW (<3,5°), VERY_LOW (≥3,5°). Questo punteggio di accordo influisce direttamente sui livelli di confidenza e può declassare una confidenza VERY_HIGH a HIGH quando i modelli non concordano.

2. Calcolo dinamico di sigma (σ)

L'incertezza σ della previsione è il parametro più critico. calculateSigma() prende tre input: ore alla risoluzione, array di temperature dei modelli e numero di modelli. σ di base per orizzonte: 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° (oltre). Penalità per numero di modelli: 1,0× (≥4 modelli), 1,1× (3), 1,25× (2), 1,5× (1). Penalità di dispersione: 1,0 + (stdDev / 5,0). σ finale limitato a [0,5; 8,0].

3. Miscela bayesiana storica

Quando sono disponibili dati storici NOAA NCEI, la previsione viene combinata in modo bayesiano con la distribuzione storica decennale per la stessa data del calendario. Combinata tramite pesatura per precisione: combined_precision = forecast_precision + historical_precision, dove precision = 1/σ². Se previsione e storico differiscono di oltre 1,5 × historical_σ, la σ combinata viene allargata del 30% per tenere conto di condizioni inusuali.

4. Calcolo della probabilità

Per ogni esito di mercato, la CDF normale (approssimazione Abramowitz-Stegun) calcola la probabilità che la temperatura effettiva ricada nell'intervallo dell'esito:

• Valore esatto (es., "52°F"): P = CDF(52,5) − CDF(51,5) con bin ±0,5°
• Intervallo (es., "52-53°F"): P = CDF(53,5) − CDF(51,5)
• "or higher" (es., "54°F+"): P = 1 − CDF(54)
• "or lower" (es., "50°F−"): P = CDF(50)

Edge = forecastProb − marketPrice. I trade vengono segnalati quando |edge| supera la soglia dinamica: max(0,03, min(0,08, σ × 0,02)).

5. Sizing con criterio di Kelly

Per BUY_YES: kellyFraction = edge / ((1/marketPrice) − 1). Per BUY_NO: kellyFraction = |edge| / ((1/noPrice) − 1). Si applica Quarter-Kelly (×0,25) limitato a [0, 0,15]. Significa che il bot non rischia mai più del 15% del bankroll su una singola operazione, e le posizioni tipiche sono 1-5% del bankroll.

6. Esecuzione dei trade

La classe Trader si connette al CLOB di Polymarket tramite @polymarket/clob-client con tipo di firma 2 (POLY_GNOSIS_SAFE). Esecuzione primaria: ordine di mercato FOK (Fill-Or-Kill) per fill immediati. Fallback: ordine limit GTC al miglior ask/bid + 2% di slippage, arrotondato alla tick size. Gli orderbook morti (404/not found) vengono memorizzati in cache e saltati. L'esecuzione concorrente sullo stesso tokenId è impedita da un lock Set.

7. Ingegneria dei prompt di Claude e Gemini

Ogni mercato è analizzato da Claude e Gemini con un prompt strutturato che contiene: domanda del mercato, prezzi YES/NO (probabilità implicite), tutte le 4 previsioni dei modelli, temperatura di consenso, livello di accordo tra i modelli, ore mancanti alla risoluzione, medie storiche, analisi del vantaggio per esito e cronologia recente delle operazioni del bot per quel mercato. Due insiemi di regole: modalità BALANCED (vantaggio minimo del 5%, preferisce BUY_YES a 5-40¢) e modalità AGGRESSIVE (vantaggio minimo del 3%, BUY_NO consentito sopra gli 11¢). L'output è imposto come JSON con etichette di esito esatte.

Gestione wallet e chiavi

WeatherBot gestisce tutte le operazioni del wallet lato client. La tua chiave privata viene usata localmente per derivare l'indirizzo del wallet e le credenziali API di Polymarket (key, secret, passphrase) tramite il ClobClient. Il tipo di firma 2 (POLY_GNOSIS_SAFE) è usato con il proxy come funder. Le chiavi private non lasciano mai il tuo dispositivo e non vengono memorizzate su nessun server.

Contratti approvati automaticamente

Monitoraggio saldo

Al collegamento del wallet, il bot controlla il saldo POL (per il gas) e il saldo USDC (sull'indirizzo proxy, per il trading) tramite Polygon RPC (polygon-bor-rpc.publicnode.com). Vengono mostrati avvisi se POL < 0,01 o USDC < 1 $. Prima di ogni trade, il bot verifica che l'importo non superi il saldo USDC disponibile e traccia il saldo localmente dopo ogni fill.

Stack di gestione del rischio

• Sizing Quarter-Kelly — non rischia mai più del 25% della dimensione di scommessa matematicamente ottimale
• Frazione max 15% — limite massimo su qualsiasi singola posizione rispetto al bankroll
• limite maxPerTrade — limite in dollari configurabile per operazione (predefinito 50$)
• Rilevazione degli orderbook morti — salta i token che restituiscono 404/non trovato dal CLOB
• Lock di esecuzione concorrente — previene il doppio ordine sullo stesso tokenId tramite Set
• Filtro per range di prezzo — salta i mercati in cui il prezzo YES è inferiore a 2¢ o superiore a 98¢
• Filtro temporale — salta i mercati che si risolvono entro 2 ore (troppo tardi per operazioni significative)
• Anti-churn IA — Claude e Gemini ricevono la cronologia recente delle operazioni e sono istruiti a evitare entrate ripetute
• Sistema di uscita a 5 livelli — obiettivo di profitto, convergenza del vantaggio, trailing stop, stop loss, decadimento temporale

Autenticazione utente

L'autenticazione è gestita lato client tramite il tuo wallet connesso. La gestione della sessione avviene localmente nel tuo browser — nessuna credenziale o token viene memorizzato su nessun server remoto.

Avviso legale

WeatherBot è software di trading sperimentale. Operare su Polymarket comporta rischi significativi — puoi perdere parte o tutto il tuo investimento. Le previsioni meteo sono probabilistiche e non garantite. L'analisi IA non è consulenza finanziaria. Tutte le operazioni del wallet avvengono lato client — le tue chiavi private non vengono mai memorizzate su nessun server. Sei responsabile del rispetto delle normative locali sul trading di mercati di previsione. Le performance passate non garantiscono risultati futuri.

Indipendenza e nessuna affiliazione con Polymarket

WeatherBot è uno strumento software indipendente di terze parti. WeatherBot non è affiliato, approvato, sponsorizzato, gestito o in alcun modo ufficialmente collegato a Polymarket, alle sue società madri o a una qualsiasi delle sue controllate o affiliate.

"Polymarket" e qualsiasi nome, marchio, logo e immagine correlati sono marchi e proprietà dei rispettivi titolari e sono utilizzati su questo sito solo a scopo descrittivo e di interoperabilità — esclusivamente per identificare la piattaforma di terze parti con cui l'automazione open-source di WeatherBot interagisce per conto dell'utente. Il loro utilizzo non implica alcuna partnership, rappresentanza, sponsorizzazione o approvazione.

WeatherBot non custodisce i fondi degli utenti, non gestisce un mercato di previsione, un exchange o un order book, e non abbina, compensa o regola le operazioni. È un software di automazione che si connette alle API pubblicamente disponibili di Polymarket usando credenziali fornite e controllate interamente dall'utente. Tutte le operazioni sono eseguite sull'infrastruttura di Polymarket, on-chain tramite la rete Polygon, dal wallet dell'utente stesso. WeatherBot non è un broker, dealer, consulente finanziario, exchange o impresa di servizi monetari.

Qualsiasi domanda, controversia, problema di account o richiesta legale relativa alla piattaforma Polymarket stessa — inclusa la risoluzione dei mercati, i depositi, i prelievi, l'idoneità o i termini d'uso — deve essere indirizzata direttamente a Polymarket. WeatherBot non può e non agisce per conto di Polymarket e non ha alcuna autorità per risolvere tali questioni.

WeatherBot è fornito "così com'è", senza garanzie di alcun tipo. Gli utenti sono gli unici responsabili di garantire che il loro utilizzo di WeatherBot e di Polymarket sia conforme a tutte le leggi e i regolamenti a loro applicabili nella loro giurisdizione. Il trading sui mercati di previsione può essere limitato o vietato in alcune giurisdizioni; è responsabilità dell'utente verificare la propria idoneità prima dell'uso.

1. Informazioni che raccogliamo

WeatherBot opera interamente lato client. Non memorizziamo le tue chiavi private, le credenziali del wallet o i dati personali su nessun server. I seguenti dati sono gestiti localmente nel tuo browser o sulla tua infrastruttura:

• Dati del wallet — L'indirizzo del tuo wallet Polygon e l'indirizzo proxy (finanziatore) sono utilizzati lato client per l'esecuzione on-chain delle operazioni tramite il CLOB di Polymarket. Le chiavi private non lasciano mai il tuo dispositivo.
• Dati di trading — La cronologia delle operazioni, le analisi dell'IA, le posizioni aperte, i rilevamenti del vantaggio e le impostazioni di configurazione (bankroll, maxPerTrade, minEdge) sono gestiti localmente.
• Metriche di utilizzo — I conteggi delle scansioni, delle operazioni, degli aggiornamenti di prezzo e dei rilevamenti del vantaggio sono tracciati localmente per ogni sessione.

2. Come usiamo i tuoi dati

Tutti i dati raccolti sono usati esclusivamente per gestire il bot di trading meteo Polymarket:

• Le credenziali del wallet vengono usate per firmare ed eseguire trade su Polymarket tramite la rete Polygon.
• La configurazione di trading determina il dimensionamento delle posizioni, le soglie di edge e il comportamento dell'automazione.
• La cronologia delle operazioni è passata a Claude e Gemini per prevenire l'eccesso di trading (acquisto/vendita ripetuti sullo stesso esito).
• Log e metriche vengono mostrati nell'interfaccia della dashboard per il tuo monitoraggio.

3. Archiviazione dei dati

Tutti i dati sono gestiti lato client. WeatherBot non memorizza dati utente su alcun server remoto o database cloud. Non c'è analitica di terze parti né trasmissione esterna di dati oltre alle API necessarie per il funzionamento del bot (elencate sotto).

4. Servizi di terze parti

WeatherBot comunica con i seguenti servizi esterni come parte del normale funzionamento:

• Polymarket — API CLOB (clob.polymarket.com), API Gamma (gamma-api.polymarket.com), WebSocket (ws-subscriptions-clob.polymarket.com), Data API (data-api.polymarket.com) per la scoperta dei mercati, il trading e lo streaming.
• Open-Meteo — API di previsioni meteo (api.open-meteo.com) per i dati dei modelli GFS, ECMWF e UKMO. Nessuna autenticazione richiesta.
• NOAA / NWS — Previsioni meteo USA (api.weather.gov) e dati climatici storici (ncei.noaa.gov). API pubbliche.
• Anthropic — API di Claude AI (api.anthropic.com) per l'analisi dei mercati. Viene usata la tua chiave API Anthropic; i dati di mercato (non i dati personali) sono inviati per l'analisi.
• RPC Polygon — Nodo pubblico Polygon (polygon-bor-rpc.publicnode.com) per le verifiche del saldo e le approvazioni dei token.

5. Conservazione dei dati

I log sono limitati a 200 voci per utente (le più vecchie vengono scartate). La cronologia dei trade è limitata a 100 voci. Le analisi IA sono limitate a 20. Le rilevazioni di edge live sono limitate a 50. Questi dati persistono finché la directory dei dati del server non viene cancellata manualmente.

6. Sicurezza

WeatherBot opera lato client — le tue chiavi private non vengono mai trasmesse o memorizzate su nessun server. Tutta la firma e l'esecuzione delle operazioni avviene localmente sul tuo dispositivo. Gli utenti devono assicurarsi che il proprio dispositivo e l'ambiente del browser siano sicuri.

7. I tuoi diritti

Puoi disconnettere il tuo wallet in qualsiasi momento dalla dashboard. Poiché tutti i dati sono gestiti lato client, disconnettere il tuo wallet cancella tutti i dati associati dalla tua sessione. Nessuna eliminazione dei dati lato server è necessaria.

8. Modifiche a questa policy

Questa privacy policy può essere aggiornata man mano che WeatherBot evolve. Le modifiche saranno riflesse su questa pagina. L'uso continuato del polymarket weather trading bot dopo le modifiche costituisce accettazione della policy aggiornata.

Ultimo aggiornamento: giugno 2026

1. Accettazione dei termini

Accedendo o utilizzando WeatherBot ("il Servizio"), accetti di essere vincolato da questi Termini di Servizio. Se non accetti questi termini, non usare il Servizio. WeatherBot è un polymarket weather trading bot che esegue operazioni sui mercati di previsione di Polymarket utilizzando strategie automatizzate.

2. Descrizione del servizio

WeatherBot è un software di trading sperimentale open-source che:

• Scopre i mercati di previsione meteo su Polymarket tramite la Gamma API
• Recupera previsioni meteo dai modelli GFS, ECMWF, UKMO e NWS
• Calcola l'edge probabilistico usando statistica bayesiana e approssimazioni CDF normali
• Analizza i mercati usando Claude e Gemini per le decisioni di trading
• Esegue trade sul CLOB di Polymarket tramite la blockchain Polygon
• Monitora le posizioni aperte con condizioni di uscita automatizzate

3. Informativa sui rischi

Operare su Polymarket comporta un significativo rischio finanziario. Puoi perdere parte o tutto il capitale investito. Utilizzando WeatherBot, riconosci e accetti i seguenti rischi:

• Rischio di mercato — I mercati di previsione meteo sono volatili. I prezzi possono muoversi contro le tue posizioni in modo rapido e imprevedibile.
• Rischio del modello — Le previsioni meteo sono probabilistiche, non garantite. I modelli GFS, ECMWF, UKMO e NWS possono produrre, e producono, previsioni errate.
• Rischio IA — Le raccomandazioni di trading di Claude e Gemini si basano sul pattern matching e sul ragionamento, non sulla certezza. L'IA può commettere errori di giudizio.
• Rischio di esecuzione — Le operazioni possono fallire a causa di liquidità insufficiente, congestione della rete, order book inattivi o errori delle API.
• Rischio degli smart contract — L'interazione con gli smart contract di Polymarket su Polygon comporta rischi blockchain intrinseci, inclusi bug, exploit e guasti di rete.
• Rischio software — WeatherBot è un software sperimentale. Bug, crash o comportamenti inattesi possono provocare perdite finanziarie.

4. Nessun consiglio finanziario

WeatherBot non fornisce consulenza finanziaria, di investimento o di trading. I segnali automatizzati, le analisi IA, i calcoli di edge e le esecuzioni di trade sono output algoritmici — non raccomandazioni. Sei l'unico responsabile delle tue decisioni di trading e delle loro conseguenze finanziarie. Le performance passate del bot, dei suoi modelli o dei trader monitorati non garantiscono risultati futuri.

5. Idoneità

Dichiari e garantisci che:

• Sei maggiorenne nella tua giurisdizione per accettare questi termini
• Non ti trovi in una giurisdizione in cui il trading su mercati di previsione è vietato
• Hai letto e accetti i Termini di Servizio di Polymarket
• Comprendi i rischi del trading di criptovalute e delle interazioni blockchain
• I fondi che usi per fare trading non derivano da attività illegali

6. Responsabilità dell'utente

Sei responsabile di:

• Mettere in sicurezza il tuo dispositivo e l'ambiente del browser dove gira WeatherBot
• Proteggere la tua chiave privata e le credenziali del wallet
• Monitorare l'attività e le posizioni del tuo bot
• Garantire POL sufficiente per le gas fee e USDC per il trading
• Configurare le impostazioni bankroll, maxPerTrade e minEdge adatte alla tua tolleranza al rischio
• Rispettare tutte le leggi e i regolamenti applicabili nella tua giurisdizione

7. Limitazione di responsabilità

WeatherBot è fornito "così com'è" e "come disponibile", senza garanzie di alcun tipo, esplicite o implicite. Nella massima misura consentita dalla legge, gli sviluppatori di WeatherBot non saranno responsabili per danni diretti, indiretti, incidentali, speciali, consequenziali o punitivi derivanti dall'uso del Servizio, inclusi, a titolo esemplificativo, perdite finanziarie da operazioni, compromissione del wallet, malfunzionamenti di smart contract o bug del software.

8. Proprietà intellettuale

Il codice sorgente di WeatherBot, i suoi algoritmi (compresi i moduli EdgeCalculator, ForecastEngine, StreamEngine, AIAnalyzer e Trader), la documentazione e il design del sito sono proprietà intellettuale del team WeatherBot. Il nome e il branding del polymarket weather trading bot sono proprietari.

9. Risoluzione

Puoi smettere di usare WeatherBot in qualsiasi momento disconnettendo il tuo wallet e fermando il bot. Ci riserviamo il diritto di modificare, sospendere o interrompere il Servizio in qualsiasi momento senza preavviso.

10. Modifiche

Questi Termini di Servizio possono essere aggiornati in qualsiasi momento. L'uso continuato del polymarket weather trading bot dopo le modifiche costituisce accettazione dei termini rivisti. Le modifiche sostanziali saranno indicate in questa pagina con una data aggiornata.

11. Legge applicabile

Questi termini sono regolati e interpretati in conformità con la legge applicabile, senza riguardo ai principi sui conflitti di legge. Qualsiasi controversia derivante da questi termini o dal tuo uso di WeatherBot sarà risolta tramite arbitrato vincolante.

12. Contatto

Per domande su questi Termini di Servizio, contattaci all'indirizzo [email protected].

Ultimo aggiornamento: marzo 2026