WeatherBot

Швидкий старт

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

Змінні середовища

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)

Кінцеві точки API

Параметри конфігурації

Парсинг ринку

Модуль MarketDiscovery розбирає питання Polymarket на кшталт "What will be the highest temperature in New York on March 15?" у структуровані дані: місто (lat/lon з карти на 67 міст), дату (4 regex-шаблони: "on Month Day", "on Day Month", "Month Day", "Day Month Year"), одиницю температури (°F для міст США, °C для решти) і тип ринку (max_temp, min_temp, precipitation, snow, severe).

Результати на кшталт "52-53°F", "54°F or higher", "50°F or lower" парсяться в діапазони зі значеннями low/high та прапорцями isOrHigher, isOrLower, isRange — це дозволяє EdgeCalculator виконати правильний обрахунок CDF для кожного типу результату.

Багатокористувацька архітектура

Модуль Store (store.js) забезпечує постійне зберігання JSON-файлів у /data/users.json. Кожен користувач отримує: облікові дані (pbkdf2-хешований пароль, auth-токен), конфігурацію гаманця (зашифрований PK, адресу проксі), конфігурацію торгівлі (bankroll, maxPerTrade, minEdge), статистику (scans, trades, edgesDetected), ШІ-аналіз, історію угод і логи. Модуль BotManager запускає окремий цикл StreamEngine + Trader + ШІ для кожного користувача, водночас спільно використовуючи ринкові дані для всіх користувачів.

Як працює відстеження трейдерів

Цей /api/traders ендпоінт отримує 4 джерела даних на гаманець паралельно: API таблиці лідерів Polymarket (авторитетні PnL + обсяг), Gamma profile API (ім'я користувача, аватар), positions API (усі розраховані + активні позиції з cashPnL) та activity API (останні 30 угод). Результати сортуються за загальним PnL за спаданням.

Відстежувані гаманці

WeatherBot відстежує 10 найкращих гаманців для торгівлі погодою, визначених у cities.js. Це найприбутковіші учасники погодних ринків на Polymarket, визначені за кумулятивним PnL та відсотком перемог на ринках погодних прогнозів.

Точки даних на трейдера

• Профіль — ім'я користувача, зображення профілю (з таблиці лідерів або Gamma)
• PnL — загальний прибуток/збиток з API таблиці лідерів (авторитетне джерело)
• Обсяг — загальний обсяг торгівлі в USD
• Винрейт — обчислюється з позицій: (виграшні позиції / усі позиції) × 100
• Активні позиції — поточні відкриті позиції з розміром > 0
• Історія PnL — кумулятивний графік, побудований із відсортованих розрахованих позицій з endDate
• Останні угоди — останні 5 угод із назвою ринку, стороною, розміром, ціною, часовою міткою

Копітрейдинг із ШІ

Коли бот працює в режимі автовиконання, Claude та Gemini аналізують ті самі ринки, на яких активні ці провідні трейдери. ШІ отримує повні дані прогнозу, аналіз переваги та нещодавню історію угод — включно з інформацією про те, чи бот уже тримає позицію (щоб уникнути подвійного входу). Це створює доповнену ШІ систему копітрейдингу, де ваші угоди ґрунтуються як на активності провідних трейдерів, так і на незалежному метеорологічному аналізі Claude та Gemini.

Захист від churn

Підказка ШІ містить нещодавню історію угод бота для кожного ринку. Claude та Gemini отримують вказівку зробити SKIP, якщо бот щойно продав із прибутком, а ціна не змінилася, бути обережними щодо повторного входу після збитку, якщо умови не змінилися, та уникати повторюваної купівлі/продажу одного й того ж результату (що марнує гроші на спред).

1. Алгоритм консенсус-температури

Функція EdgeCalculator.calculateConsensus() обчислює температуру прогнозу, зважену за якістю, з до 4 моделей. Базові ваги: ECMWF 0,35 (найкраща глобальна модель), GFS 0,25, UKMO 0,20, NWS 0,20. Штраф за викиди: якщо прогноз моделі відхиляється від сирого середнього більш ніж на 1,5× стандартного відхилення, її вага зменшується вдвічі. Підсумковий консенсус — це зважене середнє скоригованих ваг, нормалізованих до суми 1,0.

Узгодженість моделей оцінюється за 5 рівнями на основі стандартного відхилення між моделями: VERY_HIGH (<0.5°), HIGH (<1.0°), MODERATE (<2.0°), LOW (<3.5°), VERY_LOW (≥3.5°). Ця оцінка узгодженості безпосередньо впливає на рівні впевненості й може знизити впевненість VERY_HIGH до HIGH, коли моделі не збігаються.

2. Динамічний розрахунок сигми (σ)

Невизначеність прогнозу σ — найкритичніший параметр. calculateSigma() приймає три вхідні дані: години до розв'язання, масив температур моделей і кількість моделей. Базова σ за горизонтом прогнозу: 0,8° (≤6 год), 1,0° (≤12 год), 1,3° (≤24 год), 1,8° (≤48 год), 2,2° (≤72 год), 3,0° (≤120 год), 3,8° (≤168 год), 4,5° (≤240 год), 5,5° (далі). Штраф за кількість моделей: 1,0× (≥4 моделі), 1,1× (3), 1,25× (2), 1,5× (1). Штраф за розкид: 1,0 + (stdDev / 5,0). Підсумкова σ обмежена діапазоном [0,5; 8,0].

3. Баєсівське історичне змішування

Коли доступні історичні дані NOAA NCEI, прогноз байєсівськи комбінується з 10-річним історичним розподілом для тієї самої календарної дати. Комбінується за зважуванням точності: combined_precision = forecast_precision + historical_precision, де precision = 1/σ². Якщо прогноз і історія розходяться більш ніж на 1,5 × historical_σ, комбінована σ розширюється на 30%, щоб врахувати незвичні умови.

4. Розрахунок імовірності

Для кожного результату ринку нормальна CDF (наближення Абрамовиця-Стіган) обчислює ймовірність того, що фактична температура потрапить у діапазон результату:

• Точне значення (наприклад, "52°F"): P = CDF(52,5) − CDF(51,5) із бінами ±0,5°
• Діапазон (наприклад, "52-53°F"): P = CDF(53,5) − CDF(51,5)
• "or higher" (наприклад, "54°F+"): P = 1 − CDF(54)
• "or lower" (наприклад, "50°F−"): P = CDF(50)

Edge = forecastProb − marketPrice. Угоди сигналізуються, коли |edge| перевищує динамічний поріг: max(0,03, min(0,08, σ × 0,02)).

5. Визначення розміру за критерієм Келлі

Для BUY_YES: kellyFraction = edge / ((1/marketPrice) − 1). Для BUY_NO: kellyFraction = |edge| / ((1/noPrice) − 1). Застосовується Quarter-Kelly (×0,25) з обмеженням [0, 0,15]. Це означає, що бот ніколи не ризикує більш ніж 15% банкролу на одній угоді, а типові позиції — 1-5% банкролу.

6. Виконання угод

Клас Trader підключається до CLOB Polymarket через @polymarket/clob-client із типом підпису 2 (POLY_GNOSIS_SAFE). Основне виконання: ринковий ордер FOK (Fill-Or-Kill) для миттєвого заповнення. Резерв: лімітний GTC-ордер за найкращою ask/bid + 2% проковзування, округлений до tick size. Мертві ордербуки (404/not found) кешуються та пропускаються. Паралельне виконання на одному tokenId блокується замком типу Set.

7. Інженерія підказок Claude та Gemini

Кожен ринок аналізується Claude та Gemini за допомогою структурованої підказки, що містить: питання ринку, ціни YES/NO (неявні ймовірності), усі 4 прогнози моделей, консенсусну температуру, рівень узгодженості моделей, години до розрахунку, історичні середні, аналіз переваги для кожного результату та нещодавню історію угод бота для цього ринку. Два набори правил: режим BALANCED (мін. перевага 5%, перевага BUY_YES при 5–40¢) та режим AGGRESSIVE (мін. перевага 3%, BUY_NO дозволено вище 11¢). Вивід примусово форматується як JSON з точними мітками результатів.

Керування гаманцем і ключами

WeatherBot виконує всі операції з гаманцем на стороні клієнта. Ваш приватний ключ використовується локально для отримання адреси гаманця та облікових даних Polymarket API (key, secret, passphrase) через ClobClient. Тип підпису 2 (POLY_GNOSIS_SAFE) використовується з проксі як funder. Приватні ключі ніколи не залишають ваш пристрій і ніде на сервері не зберігаються.

Авто-затверджені контракти

Моніторинг балансу

Під час підключення гаманця бот перевіряє баланс POL (для газу) і баланс USDC (на адресі проксі, для торгівлі) через Polygon RPC (polygon-bor-rpc.publicnode.com). Виводяться попередження, якщо POL < 0,01 або USDC < $1. Перед кожною угодою бот перевіряє, що сума не перевищує доступний баланс USDC, і локально відстежує баланс після кожного fill.

Стек управління ризиками

• Розмір позиції за Quarter-Kelly — ніколи не ризикує більш ніж 25% математично оптимального розміру ставки
• Макс. частка 15% — жорстке обмеження на будь-яку окрему позицію відносно bankroll
• обмеження maxPerTrade — налаштовуване доларове обмеження на угоду (за замовчуванням $50)
• Виявлення мертвих ордербуків — пропускає токени, які повертають 404/не знайдено з CLOB
• Замок паралельного виконання — запобігає подвійному ордеру на той самий tokenId через Set
• Фільтр діапазону цін — пропускає ринки, де ціна YES нижче 2¢ або вище 98¢
• Фільтр часу — пропускає ринки, що розраховуються протягом 2 годин (надто пізно для значущих угод)
• ШІ-захист від churn — Claude та Gemini отримують нещодавню історію угод і мають вказівку уникати повторних входів
• 5-рівнева система виходу — цільовий прибуток, конвергенція переваги, трейлінг-стоп, стоп-лосс, часовий розпад

Автентифікація користувача

Автентифікація відбувається на стороні клієнта з використанням підключеного гаманця. Управління сесією здійснюється локально у вашому браузері — жодні облікові дані чи токени не зберігаються на віддаленому сервері.

Застереження

WeatherBot — це експериментальне торгове програмне забезпечення. Торгівля на Polymarket пов'язана зі значним ризиком — ви можете втратити частину або всю свою інвестицію. Прогнози погоди мають імовірнісний характер і не гарантовані. ШІ-аналіз не є фінансовою порадою. Усі операції з гаманцем відбуваються на стороні клієнта — ваші приватні ключі ніколи не зберігаються на жодному сервері. Ви відповідальні за дотримання місцевих норм щодо торгівлі на ринках прогнозів. Минулі результати не гарантують майбутніх.

Незалежність і відсутність зв'язку з Polymarket

WeatherBot — це незалежний сторонній програмний інструмент. WeatherBot не пов'язаний із Polymarket, його материнськими компаніями чи будь-якими його дочірніми компаніями чи афілійованими особами, не схвалений, не спонсорований, не керований ними та жодним чином офіційно з ними не пов'язаний.

"Polymarket" та будь-які пов'язані назви, марки, логотипи та зображення є торговими марками й власністю їхніх відповідних власників і використовуються на цьому сайті лише з описовою метою та для сумісності — виключно для ідентифікації сторонньої платформи, з якою взаємодіє опенсорсна автоматизація WeatherBot від імені користувача. Їх використання не передбачає жодного партнерства, агентських відносин, спонсорства чи схвалення.

WeatherBot не зберігає кошти користувачів, не керує ринком прогнозів, біржею чи книгою ордерів, не зіставляє, не клірингує та не розраховує угоди. Це програма автоматизації, яка підключається до публічно доступних API Polymarket, використовуючи облікові дані, надані й повністю контрольовані користувачем. Усі угоди виконуються на власній інфраструктурі Polymarket, у блокчейні через мережу Polygon, власним гаманцем користувача. WeatherBot не є брокером, дилером, фінансовим радником, біржею чи компанією з надання грошових послуг.

Будь-які питання, спори, проблеми з обліковим записом чи юридичні запити щодо самої платформи Polymarket — включно з розрахунком ринків, депозитами, виведенням коштів, правом на участь чи умовами використання — слід спрямовувати безпосередньо до Polymarket. WeatherBot не може й не діє від імені Polymarket і не має повноважень вирішувати такі питання.

WeatherBot надається "як є", без жодних гарантій. Користувачі несуть повну відповідальність за те, щоб їхнє використання WeatherBot та Polymarket відповідало всім законам і нормам, застосовним до них у їхній юрисдикції. Торгівля на ринках прогнозів може бути обмежена або заборонена в деяких юрисдикціях; користувач несе відповідальність за перевірку свого права на участь перед використанням.

1. Інформація, яку ми збираємо

WeatherBot працює виключно на стороні клієнта. Ми не зберігаємо ваші приватні ключі, облікові дані гаманця або особисті дані на жодному сервері. Наступні дані обробляються локально у вашому браузері або на вашій інфраструктурі:

• Дані гаманця — Адреса вашого гаманця Polygon та адреса проксі (фондувальника) використовуються на стороні клієнта для виконання угод у блокчейні через Polymarket CLOB. Приватні ключі ніколи не залишають ваш пристрій.
• Дані торгівлі — Історія угод, аналізи ШІ, відкриті позиції, виявлення переваги та налаштування конфігурації (bankroll, maxPerTrade, minEdge) керуються локально.
• Метрики використання — Кількість сканувань, кількість угод, кількість оновлень цін і кількість виявлень переваги відстежуються локально для кожної сесії.

2. Як ми використовуємо ваші дані

Усі зібрані дані використовуються виключно для роботи погодного бота Polymarket:

• Облікові дані гаманця використовуються для підпису та виконання угод на Polymarket через мережу Polygon.
• Конфігурація торгівлі визначає розмір позиції, пороги edge та поведінку автоматизації.
• Історія угод передається до Claude та Gemini, щоб запобігти зайвому перекручуванню (повторній купівлі/продажу того самого результату).
• Логи та метрики відображаються в інтерфейсі дашборду для вашого моніторингу.

3. Зберігання даних

Усі дані обробляються на стороні клієнта. WeatherBot не зберігає дані користувачів на жодному віддаленому сервері чи хмарній базі даних. Немає сторонньої аналітики й немає зовнішньої передачі даних, окрім API, необхідних для роботи бота (наведені нижче).

4. Сторонні сервіси

WeatherBot взаємодіє з наступними зовнішніми сервісами як частина звичайної роботи:

• Polymarket — CLOB API (clob.polymarket.com), Gamma API (gamma-api.polymarket.com), WebSocket (ws-subscriptions-clob.polymarket.com), Data API (data-api.polymarket.com) для виявлення ринків, торгівлі та потокової передачі.
• Open-Meteo — API погодних прогнозів (api.open-meteo.com) для даних моделей GFS, ECMWF та UKMO. Автентифікація не потрібна.
• NOAA / NWS — Погодні прогнози для США (api.weather.gov) та історичні кліматичні дані (ncei.noaa.gov). Публічні API.
• Anthropic — Claude AI API (api.anthropic.com) для аналізу ринку. Використовується ваш ключ Anthropic API; для аналізу надсилаються ринкові дані (не персональні).
• Polygon RPC — Публічний вузол Polygon (polygon-bor-rpc.publicnode.com) для перевірки балансу та схвалення токенів.

5. Зберігання даних

Логи обмежені 200 записами на користувача (найстаріші відкидаються). Історія угод обмежена 100 записами. ШІ-аналізи обмежені 20. Виявлення edge у реальному часі обмежені 50. Ці дані зберігаються, доки каталог даних сервера не очистять вручну.

6. Безпека

WeatherBot працює на стороні клієнта — ваші приватні ключі ніколи не передаються та не зберігаються на жодному сервері. Усе підписання та виконання угод відбуваються локально на вашому пристрої. Користувачі мають забезпечити безпеку свого пристрою та середовища браузера.

7. Ваші права

Ви можете відключити гаманець у будь-який момент через dashboard. Оскільки всі дані обробляються на стороні клієнта, відключення гаманця очищає всі пов'язані дані з вашої сесії. Видалення даних на стороні сервера не потрібне.

8. Зміни до цієї політики

Ця політика конфіденційності може оновлюватися в міру розвитку WeatherBot. Зміни буде відображено на цій сторінці. Подальше використання polymarket weather trading bot після змін означає згоду з оновленою політикою.

Останнє оновлення: червень 2026

1. Прийняття умов

Отримуючи доступ до WeatherBot ("Сервісу") або користуючись ним, ви погоджуєтесь дотримуватись цих Умов обслуговування. Якщо ви не погоджуєтесь із цими умовами, не використовуйте Сервіс. WeatherBot — це polymarket weather trading bot, що виконує угоди на ринках прогнозів Polymarket за допомогою автоматизованих стратегій.

2. Опис сервісу

WeatherBot — це експериментальне торгове програмне забезпечення з відкритим кодом, яке:

• Виявляє ринки погодних прогнозів на Polymarket через Gamma API
• Отримує прогнози погоди від моделей GFS, ECMWF, UKMO та NWS
• Розраховує імовірнісну перевагу з використанням баєсівської статистики та нормальних CDF-апроксимацій
• Аналізує ринки за допомогою Claude та Gemini для ухвалення торгових рішень
• Виконує угоди на CLOB Polymarket через блокчейн Polygon
• Моніторить відкриті позиції з автоматизованими умовами виходу

3. Розкриття ризиків

Торгівля на Polymarket пов'язана зі значним фінансовим ризиком. Ви можете втратити частину або весь інвестований капітал. Користуючись WeatherBot, ви визнаєте та приймаєте наступні ризики:

• Ринковий ризик — Ринки прогнозу погоди волатильні. Ціни можуть швидко й непередбачувано рухатися проти ваших позицій.
• Ризик моделей — Погодні прогнози є ймовірнісними, а не гарантованими. Моделі GFS, ECMWF, UKMO та NWS можуть давати й дають хибні прогнози.
• Ризик ШІ — Торгові рекомендації Claude та Gemini ґрунтуються на зіставленні шаблонів і міркуванні, а не на впевненості. ШІ може помилятися в судженнях.
• Ризик виконання — Угоди можуть не виконатися через недостатню ліквідність, перевантаження мережі, мертві книги ордерів або помилки API.
• Ризик смарт-контрактів — Взаємодія зі смарт-контрактами Polymarket у Polygon несе властиві блокчейну ризики, включно з багами, експлойтами та збоями мережі.
• Програмний ризик — WeatherBot — це експериментальне програмне забезпечення. Баги, збої чи неочікувана поведінка можуть призвести до фінансових втрат.

4. Жодних фінансових порад

WeatherBot не надає фінансових, інвестиційних чи торгових порад. Автоматизовані сигнали, ШІ-аналіз, обчислення edge та виконання угод — це алгоритмічні виходи, а не рекомендації. Ви несете одноосібну відповідальність за свої торгові рішення та їхні фінансові наслідки. Минулі показники бота, його моделей або відстежуваних трейдерів не гарантують майбутніх результатів.

5. Право участі

Ви заявляєте та гарантуєте, що:

• Ви досягли повноліття у своїй юрисдикції для прийняття цих умов
• Ви не перебуваєте в юрисдикції, де торгівля на ринках прогнозів заборонена
• Ви прочитали та погоджуєтесь з Умовами обслуговування Polymarket
• Ви розумієте ризики криптовалютної торгівлі та взаємодії з блокчейном
• Кошти, які ви використовуєте для торгівлі, не походять із незаконної діяльності

6. Обов'язки користувача

Ви несете відповідальність за:

• Захист вашого пристрою і середовища браузера, де працює WeatherBot
• Захист вашого приватного ключа та облікових даних гаманця
• Моніторинг активності й позицій вашого бота
• Забезпечення достатньої кількості POL для газу і USDC для торгівлі
• Налаштування відповідних параметрів bankroll, maxPerTrade та minEdge під вашу толерантність до ризику
• Дотримання всіх застосовних законів і нормативних актів у вашій юрисдикції

7. Обмеження відповідальності

WeatherBot надається «як є» і «у міру доступності» без жодних явних чи неявних гарантій. У максимальних межах, дозволених законом, розробники WeatherBot не несуть відповідальності за прямі, непрямі, випадкові, особливі, побічні чи штрафні збитки, що випливають із використання вами Сервісу, включаючи, але не обмежуючись, фінансові втрати від угод, компрометацію гаманця, збої смарт-контрактів або помилки програмного забезпечення.

8. Інтелектуальна власність

Вихідний код WeatherBot, його алгоритми (включаючи модулі EdgeCalculator, ForecastEngine, StreamEngine, AIAnalyzer та Trader), документація і дизайн сайту є інтелектуальною власністю команди WeatherBot. Назва та брендинг polymarket weather trading bot — пропрієтарні.

9. Припинення

Ви можете в будь-який час припинити користуватися WeatherBot, відключивши гаманець і зупинивши бота. Ми залишаємо за собою право змінювати, призупиняти або припиняти Сервіс у будь-який час без попередження.

10. Зміни

Ці Умови обслуговування можуть оновлюватися в будь-який час. Подальше використання polymarket weather trading bot після змін означає згоду з оновленими умовами. Суттєві зміни буде позначено на цій сторінці з оновленою датою.

11. Застосовне право

Ці умови регулюються та тлумачаться відповідно до застосовного права, без урахування принципів колізії законів. Будь-які спори, що випливають із цих умов або вашого використання WeatherBot, вирішуються шляхом обов'язкового арбітражу.

12. Контакт

З питань щодо цих Умов надання послуг, будь ласка, зв'яжіться з нами за адресою [email protected].

Останнє оновлення: березень 2026