WeatherBot

Démarrage rapide

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 d'environnement

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 API

Options de configuration

Analyse de marché

Le module MarketDiscovery analyse les questions de Polymarket comme "What will be the highest temperature in New York on March 15?" et les convertit en données structurées : ville (lat/lon depuis une carte de 67 villes), date (4 motifs regex : "on Month Day", "on Day Month", "Month Day", "Day Month Year"), unité de température (°F pour les villes US, °C à l'international), et type de marché (max_temp, min_temp, precipitation, snow, severe).

Les issues comme "52-53°F", "54°F or higher", "50°F or lower" sont parsées en plages avec des valeurs low/high et les drapeaux isOrHigher, isOrLower, isRange — permettant à l'EdgeCalculator d'exécuter le bon calcul CDF pour chaque type d'issue.

Architecture multi-utilisateurs

Le module Store (store.js) fournit un stockage persistant de fichiers JSON dans /data/users.json. Chaque utilisateur reçoit : identifiants (mot de passe haché pbkdf2, jeton d'authentification), configuration wallet (clé privée chiffrée, adresse proxy), configuration de trading (bankroll, maxPerTrade, minEdge), statistiques (scans, trades, edgesDetected), analyses IA, historique des transactions et logs. Le module BotManager exécute un cycle StreamEngine + Trader + IA séparé par utilisateur, tout en partageant les données de marché entre tous les utilisateurs.

Comment fonctionne le suivi des traders

Le /api/traders endpoint récupère 4 sources de données par wallet en parallèle : l'API du classement Polymarket (PnL + volume faisant autorité), l'API de profil Gamma (nom d'utilisateur, avatar), l'API des positions (toutes les positions résolues + actives avec cashPnL) et l'API d'activité (les 30 derniers trades). Les résultats sont triés par PnL total décroissant.

Wallets suivis

WeatherBot surveille 10 wallets top du trading météo définis dans cities.js. Ce sont les participants les plus rentables des marchés météo sur Polymarket, identifiés par leur PnL cumulé et leur taux de réussite sur les marchés de prédiction météo.

Points de données par trader

• Profil — nom d'utilisateur, photo de profil (depuis le classement ou Gamma)
• PnL — profit/perte total depuis l'API du classement (source faisant autorité)
• Volume — volume de trading total en USD
• Taux de victoire — calculé à partir des positions : (positions gagnantes / total des positions) × 100
• Positions actives — positions ouvertes actuelles avec une taille > 0
• Historique PnL — graphique cumulatif construit à partir des positions résolues triées avec endDate
• Transactions récentes — les 5 derniers trades avec titre du marché, sens, taille, prix, horodatage

Copy trading par IA

Lorsque le bot fonctionne en mode auto-exécution, Claude et Gemini analysent les mêmes marchés sur lesquels ces meilleurs traders sont actifs. L'IA reçoit l'ensemble des données de prévision, l'analyse d'edge et l'historique récent des trades — y compris l'information indiquant si le bot détient déjà une position (pour éviter une double entrée). Cela crée un système de copy trading augmenté par IA où vos trades sont éclairés à la fois par l'activité des meilleurs traders et par l'analyse météorologique indépendante de Claude et Gemini.

Protection anti-churn

Le prompt de l'IA inclut l'historique récent des trades du bot pour chaque marché. Claude et Gemini ont pour consigne de SKIP si le bot vient de vendre avec profit et que le prix n'a pas bougé, d'être prudents avant de re-rentrer après une perte sauf si les conditions ont changé, et d'éviter d'acheter/vendre le même outcome à répétition (ce qui gaspille de l'argent sur le spread).

1. Algorithme de température de consensus

La fonction EdgeCalculator.calculateConsensus() calcule une température de prévision pondérée par la qualité à partir de jusqu'à 4 modèles. Poids de base : ECMWF 0,35 (meilleur modèle global), GFS 0,25, UKMO 0,20, NWS 0,20. Pénalisation des outliers : si la prévision d'un modèle s'écarte de plus de 1,5× l'écart-type de la moyenne brute, son poids est réduit de moitié. Le consensus final est la moyenne pondérée des poids ajustés normalisés pour sommer à 1,0.

La concordance des modèles est notée selon 5 niveaux basés sur l'écart-type inter-modèles : VERY_HIGH (<0.5°), HIGH (<1.0°), MODERATE (<2.0°), LOW (<3.5°), VERY_LOW (≥3.5°). Ce score de concordance influe directement sur les niveaux de confiance et peut rétrograder une confiance VERY_HIGH en HIGH lorsque les modèles divergent.

2. Calcul dynamique de sigma (σ)

L'incertitude de prévision σ est le paramètre le plus critique. calculateSigma() prend trois entrées : heures avant résolution, tableau des températures des modèles et nombre de modèles. σ de base selon l'horizon : 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° (au-delà). Pénalité selon le nombre de modèles : 1,0× (≥4 modèles), 1,1× (3), 1,25× (2), 1,5× (1). Pénalité de dispersion : 1,0 + (écart-type / 5,0). σ final borné à [0,5 ; 8,0].

3. Mélange bayésien historique

Lorsque des données historiques NOAA NCEI sont disponibles, la prévision est combinée par Bayes avec la distribution historique sur 10 ans pour la même date calendaire. Combinaison par pondération de précision : combined_precision = forecast_precision + historical_precision, où precision = 1/σ². Si la prévision et l'historique divergent de plus de 1,5 × historical_σ, le σ combiné est élargi de 30% pour tenir compte de conditions inhabituelles.

4. Calcul de probabilité

Pour chaque issue de marché, la CDF normale (approximation Abramowitz-Stegun) calcule la probabilité que la température réelle tombe dans la plage de l'issue :

• Valeur exacte (par ex., "52°F") : P = CDF(52,5) − CDF(51,5) avec un bin de ±0,5°
• Plage (par ex., "52-53°F") : P = CDF(53,5) − CDF(51,5)
• "or higher" (par ex., "54°F+") : P = 1 − CDF(54)
• "or lower" (par ex., "50°F−") : P = CDF(50)

Edge = forecastProb − marketPrice. Les transactions sont signalées lorsque |edge| dépasse le seuil dynamique : max(0,03, min(0,08, σ × 0,02)).

5. Dimensionnement par critère de Kelly

Pour BUY_YES : kellyFraction = edge / ((1/marketPrice) − 1). Pour BUY_NO : kellyFraction = |edge| / ((1/noPrice) − 1). On applique le Quarter-Kelly (×0,25) borné à [0, 0,15]. Cela signifie que le bot ne risque jamais plus de 15% de la bankroll sur une seule transaction, et les positions typiques sont de 1 à 5% de la bankroll.

6. Exécution des transactions

La classe Trader se connecte au CLOB de Polymarket via @polymarket/clob-client avec le type de signature 2 (POLY_GNOSIS_SAFE). Exécution primaire : ordre de marché FOK (Fill-Or-Kill) pour des exécutions immédiates. Fallback : ordre limite GTC au meilleur ask/bid + 2% de slippage, arrondi à la tick size. Les carnets morts (404/not found) sont mis en cache et ignorés. L'exécution concurrente sur le même tokenId est empêchée par un verrou de type Set.

7. Ingénierie de prompt Claude et Gemini

Chaque marché est analysé par Claude et Gemini avec un prompt structuré contenant : question du marché, prix YES/NO (probabilités implicites), les 4 prévisions de modèles, température de consensus, niveau de concordance des modèles, heures restantes avant résolution, moyennes historiques, analyse d'edge par outcome, et historique récent des trades du bot pour ce marché. Deux jeux de règles : mode BALANCED (edge min de 5 %, préférence pour BUY_YES à 5-40¢) et mode AGGRESSIVE (edge min de 3 %, BUY_NO autorisé au-dessus de 11¢). La sortie est imposée en JSON avec des libellés d'outcome exacts.

Gestion du wallet et des clés

WeatherBot gère toutes les opérations de wallet côté client. Votre clé privée est utilisée localement pour dériver l'adresse du wallet et les identifiants de l'API Polymarket (key, secret, passphrase) via le ClobClient. Le type de signature 2 (POLY_GNOSIS_SAFE) est utilisé avec le proxy comme funder. Les clés privées ne quittent jamais votre appareil et ne sont stockées sur aucun serveur.

Contrats auto-approuvés

Surveillance du solde

À la connexion du wallet, le bot vérifie le solde POL (pour le gas) et le solde USDC (sur l'adresse proxy, pour le trading) via le RPC Polygon (polygon-bor-rpc.publicnode.com). Des avertissements s'affichent si POL < 0,01 ou USDC < 1 $. Avant chaque transaction, le bot vérifie que le montant ne dépasse pas le solde USDC disponible et suit le solde localement après chaque fill.

Pile de gestion du risque

• Dimensionnement Quarter-Kelly — ne risque jamais plus de 25 % de la taille de mise mathématiquement optimale
• Fraction max 15% — plafond strict sur toute position unique par rapport au bankroll
• plafond maxPerTrade — limite en dollars configurable par trade (50 $ par défaut)
• Détection des carnets morts — ignore les tokens qui renvoient 404/introuvable depuis le CLOB
• Verrou d'exécution concurrente — empêche le double ordre sur le même tokenId via un Set
• Filtre de plage de prix — ignore les marchés où le prix YES est inférieur à 2¢ ou supérieur à 98¢
• Filtre temporel — ignore les marchés se résolvant sous 2 heures (trop tard pour des trades significatifs)
• Anti-churn IA — Claude et Gemini reçoivent l'historique récent des trades et ont pour consigne d'éviter les entrées répétées
• Système de sortie à 5 couches — objectif de profit, convergence de l'edge, trailing stop, stop loss, décroissance temporelle

Authentification utilisateur

L'authentification est gérée côté client à l'aide de votre wallet connecté. La gestion de session se fait localement dans votre navigateur — aucun identifiant ni jeton n'est stocké sur un serveur distant.

Avertissement

WeatherBot est un logiciel de trading expérimental. Trader sur Polymarket comporte un risque important — vous pouvez perdre tout ou partie de votre investissement. Les prévisions météo sont probabilistes et non garanties. L'analyse IA ne constitue pas un conseil financier. Toutes les opérations de wallet se déroulent côté client — vos clés privées ne sont jamais stockées sur un serveur. Il vous appartient de respecter la réglementation locale relative aux marchés de prédiction. Les performances passées ne garantissent pas les résultats futurs.

Indépendance et absence d'affiliation avec Polymarket

WeatherBot est un outil logiciel indépendant et tiers. WeatherBot n'est pas affilié à, approuvé par, sponsorisé par, exploité par, ni officiellement lié de quelque manière que ce soit à Polymarket, à ses sociétés mères, ou à l'une quelconque de ses filiales ou sociétés affiliées.

« Polymarket » ainsi que tous les noms, marques, logos et images associés sont les marques déposées et la propriété de leurs détenteurs respectifs et sont utilisés sur ce site à des fins purement descriptives et d'interopérabilité — uniquement pour identifier la plateforme tierce avec laquelle l'automatisation open-source de WeatherBot interagit pour le compte de l'utilisateur. Leur utilisation n'implique aucun partenariat, mandat, parrainage ni approbation.

WeatherBot ne détient pas les fonds des utilisateurs, n'exploite pas de marché de prédiction, d'échange ou de carnet d'ordres, et n'apparie, ne compense ni ne règle aucun trade. Il s'agit d'un logiciel d'automatisation qui se connecte aux API publiquement disponibles de Polymarket à l'aide d'identifiants fournis et contrôlés entièrement par l'utilisateur. Tous les trades sont exécutés sur l'infrastructure propre de Polymarket, on-chain via le réseau Polygon, par le wallet propre de l'utilisateur. WeatherBot n'est pas un courtier, un négociant, un conseiller financier, un échange ni un prestataire de services monétaires.

Toute question, litige, problème de compte ou demande juridique relatif à la plateforme Polymarket elle-même — y compris la résolution des marchés, les dépôts, les retraits, l'éligibilité ou les conditions d'utilisation — doit être adressé directement à Polymarket. WeatherBot ne peut pas agir, et n'agit pas, pour le compte de Polymarket et n'a aucune autorité pour résoudre de telles questions.

WeatherBot est fourni « en l'état », sans garantie d'aucune sorte. Les utilisateurs sont seuls responsables de s'assurer que leur utilisation de WeatherBot et de Polymarket respecte toutes les lois et réglementations qui leur sont applicables dans leur juridiction. Le trading sur les marchés de prédiction peut être restreint ou interdit dans certaines juridictions ; il incombe à l'utilisateur de vérifier son éligibilité avant toute utilisation.

1. Informations que nous collectons

WeatherBot fonctionne entièrement côté client. Nous ne stockons ni vos clés privées, ni vos identifiants de wallet, ni vos données personnelles sur un serveur. Les données suivantes sont gérées localement dans votre navigateur ou sur votre propre infrastructure :

• Données du wallet — Votre adresse de wallet Polygon et votre adresse de proxy (funder) sont utilisées côté client pour l'exécution des trades on-chain via le CLOB de Polymarket. Les clés privées ne quittent jamais votre appareil.
• Données de trading — L'historique des trades, les analyses IA, les positions ouvertes, les détections d'edge et les paramètres de configuration (bankroll, maxPerTrade, minEdge) sont gérés localement.
• Métriques d'utilisation — Les nombres de scans, de trades, de mises à jour de prix et de détections d'edge sont suivis localement par session.

2. Comment nous utilisons vos données

Toutes les données collectées sont utilisées exclusivement pour faire fonctionner le bot de trading météo Polymarket :

• Les identifiants du wallet sont utilisés pour signer et exécuter des transactions sur Polymarket via le réseau Polygon.
• La configuration de trading détermine le dimensionnement des positions, les seuils d'edge et le comportement d'automatisation.
• L'historique des trades est transmis à Claude et Gemini pour éviter le churning (achat/vente répété sur le même outcome).
• Les logs et métriques sont affichés dans l'interface du dashboard pour votre suivi.

3. Stockage des données

Toutes les données sont gérées côté client. WeatherBot ne stocke aucune donnée utilisateur sur un serveur distant ou une base de données cloud. Il n'y a pas d'analytique tierce ni de transmission externe de données au-delà des API nécessaires au fonctionnement du bot (listées ci-dessous).

4. Services tiers

WeatherBot communique avec les services externes suivants dans le cadre de son fonctionnement normal :

• Polymarket — API CLOB (clob.polymarket.com), API Gamma (gamma-api.polymarket.com), WebSocket (ws-subscriptions-clob.polymarket.com), API Data (data-api.polymarket.com) pour la découverte des marchés, le trading et le streaming.
• Open-Meteo — API de prévision météo (api.open-meteo.com) pour les données des modèles GFS, ECMWF et UKMO. Aucune authentification requise.
• NOAA / NWS — Prévisions météo US (api.weather.gov) et données climatiques historiques (ncei.noaa.gov). API publiques.
• Anthropic — API Claude AI (api.anthropic.com) pour l'analyse des marchés. Votre clé API Anthropic est utilisée ; les données de marché (et non des données personnelles) sont envoyées pour analyse.
• RPC Polygon — Nœud Polygon public (polygon-bor-rpc.publicnode.com) pour les vérifications de solde et les approbations de tokens.

5. Conservation des données

Les logs sont plafonnés à 200 entrées par utilisateur (les plus anciennes sont supprimées). L'historique de trading est plafonné à 100 entrées. Les analyses IA sont plafonnées à 20. Les détections d'edge en direct sont plafonnées à 50. Ces données persistent jusqu'à ce que le répertoire de données du serveur soit effacé manuellement.

6. Sécurité

WeatherBot fonctionne côté client — vos clés privées ne sont jamais transmises ni stockées sur un serveur. Toute la signature et l'exécution des transactions se passent localement sur votre appareil. Les utilisateurs doivent s'assurer que leur appareil et leur environnement de navigateur sont sécurisés.

7. Vos droits

Vous pouvez déconnecter votre wallet à tout moment via le dashboard. Comme toutes les données sont gérées côté client, déconnecter votre wallet efface toutes les données associées de votre session. Aucune suppression côté serveur n'est nécessaire.

8. Modifications de cette politique

Cette politique de confidentialité peut être mise à jour à mesure que WeatherBot évolue. Les modifications seront reflétées sur cette page. L'utilisation continue du polymarket weather trading bot après les modifications constitue l'acceptation de la politique mise à jour.

Dernière mise à jour : juin 2026

1. Acceptation des conditions

En accédant à WeatherBot ("le Service") ou en l'utilisant, vous acceptez d'être lié par ces Conditions d'Utilisation. Si vous n'acceptez pas ces conditions, n'utilisez pas le Service. WeatherBot est un polymarket weather trading bot qui exécute des transactions sur les marchés de prédiction Polymarket via des stratégies automatisées.

2. Description du service

WeatherBot est un logiciel de trading expérimental open-source qui :

• Découvre les marchés de prédiction météo sur Polymarket via la Gamma API
• Récupère les prévisions météo des modèles GFS, ECMWF, UKMO et NWS
• Calcule l'edge probabiliste à l'aide de statistiques bayésiennes et d'approximations CDF normales
• Analyse les marchés en utilisant Claude et Gemini pour les décisions de trading
• Exécute les transactions sur le CLOB de Polymarket via la blockchain Polygon
• Surveille les positions ouvertes avec des conditions de sortie automatisées

3. Divulgation des risques

Trader sur Polymarket comporte un risque financier important. Vous pouvez perdre tout ou partie du capital investi. En utilisant WeatherBot, vous reconnaissez et acceptez les risques suivants :

• Risque de marché — Les marchés de prédiction météo sont volatils. Les prix peuvent évoluer contre vos positions de manière rapide et imprévisible.
• Risque modèle — Les prévisions météo sont probabilistes, non garanties. Les modèles GFS, ECMWF, UKMO et NWS peuvent produire, et produisent, des prévisions erronées.
• Risque IA — Les recommandations de trading de Claude et Gemini reposent sur la reconnaissance de motifs et le raisonnement, non sur la certitude. L'IA peut commettre des erreurs de jugement.
• Risque d'exécution — Les trades peuvent échouer en raison d'une liquidité insuffisante, d'une congestion réseau, de carnets d'ordres morts ou d'erreurs d'API.
• Risque lié aux smart contracts — L'interaction avec les smart contracts de Polymarket sur Polygon comporte des risques inhérents à la blockchain, notamment des bugs, des exploits et des défaillances réseau.
• Risque logiciel — WeatherBot est un logiciel expérimental. Des bugs, des plantages ou des comportements inattendus peuvent entraîner des pertes financières.

4. Pas de conseil financier

WeatherBot ne fournit ni conseil financier, ni conseil en investissement, ni conseil en trading. Les signaux automatisés, les analyses IA, les calculs d'edge et les exécutions de transactions sont des sorties algorithmiques — pas des recommandations. Vous êtes seul responsable de vos décisions de trading et de leurs conséquences financières. Les performances passées du bot, de ses modèles ou des traders suivis ne garantissent pas les résultats futurs.

5. Éligibilité

Vous déclarez et garantissez que :

• Vous êtes majeur dans votre juridiction pour accepter ces conditions
• Vous n'êtes pas situé dans une juridiction où le trading sur marchés de prédiction est interdit
• Vous avez lu et acceptez les Conditions d'Utilisation de Polymarket
• Vous comprenez les risques du trading de cryptomonnaies et des interactions blockchain
• Les fonds que vous utilisez pour trader ne proviennent pas d'activités illégales

6. Responsabilités de l'utilisateur

Vous êtes responsable de :

• Sécuriser votre appareil et l'environnement de navigateur sur lequel tourne WeatherBot
• Protéger votre clé privée et les identifiants du wallet
• Surveiller l'activité et les positions de votre bot
• Garantir un POL suffisant pour les frais de gas et de l'USDC pour trader
• Configurer les paramètres bankroll, maxPerTrade et minEdge adaptés à votre tolérance au risque
• Respecter toutes les lois et réglementations applicables dans votre juridiction

7. Limitation de responsabilité

WeatherBot est fourni « tel quel » et « selon disponibilité », sans garanties d'aucune sorte, expresses ou implicites. Dans la mesure maximale permise par la loi, les développeurs de WeatherBot ne sauraient être tenus responsables de tout dommage direct, indirect, accessoire, spécial, consécutif ou punitif découlant de votre utilisation du Service, y compris, sans s'y limiter, les pertes financières liées aux transactions, la compromission de wallet, les défaillances de smart contracts ou les bugs logiciels.

8. Propriété intellectuelle

Le code source de WeatherBot, ses algorithmes (y compris les modules EdgeCalculator, ForecastEngine, StreamEngine, AIAnalyzer et Trader), sa documentation et la conception du site web sont la propriété intellectuelle de l'équipe WeatherBot. Le nom et l'image de marque du polymarket weather trading bot sont propriétaires.

9. Résiliation

Vous pouvez cesser d'utiliser WeatherBot à tout moment en déconnectant votre wallet et en arrêtant le bot. Nous nous réservons le droit de modifier, suspendre ou interrompre le Service à tout moment sans préavis.

10. Modifications

Ces Conditions d'Utilisation peuvent être mises à jour à tout moment. L'utilisation continue du polymarket weather trading bot après modification constitue l'acceptation des conditions révisées. Les changements importants seront indiqués sur cette page avec une date mise à jour.

11. Loi applicable

Ces conditions sont régies et interprétées conformément à la loi applicable, sans tenir compte des principes de conflit de lois. Tout litige découlant de ces conditions ou de votre utilisation de WeatherBot sera résolu par arbitrage contraignant.

12. Contact

Pour toute question concernant ces Conditions d'utilisation, veuillez nous contacter à [email protected].

Dernière mise à jour : mars 2026