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 모듈은 "What will be the highest temperature in New York on March 15?" 같은 Polymarket 질문을 파싱해 다음과 같은 구조화 데이터로 변환합니다: 도시(67개 도시 맵의 위도/경도), 날짜(4가지 정규식 패턴: "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), AI 분석, 거래 이력, 로그. BotManager 모듈은 사용자마다 별도의 StreamEngine + Trader + AI 사이클을 실행하면서 마켓 데이터는 모든 사용자 간에 공유합니다.

트레이더 추적 작동 방식

이 /api/traders 엔드포인트는 지갑당 4개의 데이터 소스를 병렬로 가져옵니다: Polymarket 리더보드 API(공인 PnL + 거래량), Gamma 프로필 API(사용자명, 아바타), 포지션 API(cashPnL이 포함된 모든 정산 + 활성 포지션), 활동 API(최근 30건 거래). 결과는 총 PnL 내림차순으로 정렬됩니다.

추적 중인 지갑

WeatherBot은 다음에 정의된 상위 10개의 날씨 트레이딩 지갑을 모니터링합니다: cities.js. 이들은 Polymarket의 날씨 마켓에서 가장 수익성이 높은 참가자들이며, 날씨 예측 마켓 전체의 누적 PnL과 승률로 식별됩니다.

트레이더당 데이터 포인트

• 프로필 — 사용자명, 프로필 사진(리더보드 또는 Gamma에서)
• PnL — 리더보드 API의 총 손익(공인 소스)
• 거래량 — USD 기준 총 거래량
• 승률 — 포지션에서 계산됨: (수익 포지션 / 전체 포지션) × 100
• 활성 포지션 — 크기 > 0인 현재 오픈 포지션
• PnL 이력 — endDate가 있는 정렬된 정산 포지션으로 구성된 누적 차트
• 최근 거래 — 시장 제목, 방향, 크기, 가격, 타임스탬프가 포함된 최근 5건 거래

AI 기반 카피 트레이딩

봇이 자동 실행 모드로 작동할 때, Claude와 Gemini는 이 상위 트레이더들이 활동하는 동일한 시장을 분석합니다. AI는 전체 예보 데이터, 엣지 분석, 최근 거래 내역을 받으며, 봇이 이미 포지션을 보유하고 있는지에 대한 정보(이중 진입 방지용)도 포함됩니다. 이는 상위 트레이더의 활동과 Claude와 Gemini의 독립적인 기상학적 분석 모두에 기반하여 거래가 이루어지는 AI 증강 카피 트레이딩 시스템을 만듭니다.

안티 처닝 보호

AI 프롬프트에는 각 시장에 대한 최근 봇 거래 내역이 포함됩니다. 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°(≤6h), 1.0°(≤12h), 1.3°(≤24h), 1.8°(≤48h), 2.2°(≤72h), 3.0°(≤120h), 3.8°(≤168h), 4.5°(≤240h), 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(Abramowitz-Stegun 근사)는 실제 기온이 그 결과 범위 안에 들 확률을 계산합니다:

• 정확한 값 (예: "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. Kelly 기준 사이징

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 클래스는 서명 타입 2(POLY_GNOSIS_SAFE)와 @polymarket/clob-client을 사용해 Polymarket의 CLOB에 연결합니다. 기본 실행: 즉시 체결을 위한 FOK(Fill-Or-Kill) 시장가 주문. 대체 실행: 최고 ask/bid + 2% 슬리피지의 GTC 지정가 주문, 틱 사이즈로 반올림. 죽은 오더북(404/not found)은 캐시되고 건너뜁니다. 같은 tokenId에 대한 동시 실행은 Set 락으로 방지합니다.

7. Claude와 Gemini 프롬프트 엔지니어링

각 시장은 다음을 포함하는 구조화된 프롬프트로 Claude와 Gemini에 의해 분석됩니다: 시장 질문, YES/NO 가격(내재 확률), 4개 모델 예보 전체, 합의 기온, 모델 일치도 수준, 정산까지 남은 시간, 과거 평균, 결과별 엣지 분석, 해당 시장의 최근 봇 거래 내역. 두 가지 규칙 세트: BALANCED 모드(최소 엣지 5%, 5~40¢에서 BUY_YES 선호)와 AGGRESSIVE 모드(최소 엣지 3%, 11¢ 이상에서 BUY_NO 허용). 출력은 정확한 결과 라벨과 함께 JSON으로 강제됩니다.

지갑 및 키 관리

WeatherBot은 모든 지갑 작업을 클라이언트 측에서 처리합니다. 여러분의 프라이빗 키는 로컬에서 사용되어 ClobClient를 통해 지갑 주소와 Polymarket API 자격 증명(key, secret, passphrase)을 도출합니다. 서명 타입 2(POLY_GNOSIS_SAFE)는 프록시를 funder로 사용합니다. 프라이빗 키는 디바이스를 벗어나지 않으며 어떤 서버에도 저장되지 않습니다.

자동 승인된 컨트랙트

잔액 모니터링

지갑 연결 시, 봇은 Polygon RPC(polygon-bor-rpc.publicnode.com)를 통해 POL 잔액(가스용)과 USDC 잔액(프록시 주소, 거래용)을 확인합니다. POL < 0.01 또는 USDC < $1이면 경고가 표시됩니다. 모든 거래 전에 봇은 거래 금액이 가용 USDC 잔액을 초과하지 않는지 확인하고, 각 체결 후 잔액을 로컬에서 추적합니다.

리스크 관리 스택

• Quarter-Kelly 사이징 — 수학적으로 최적인 베팅 크기의 25%를 초과해 위험을 감수하지 않음
• 최대 비율 15% — bankroll 대비 단일 포지션에 대한 하드 캡
• maxPerTrade 캡 — 거래당 설정 가능한 달러 한도(기본값 $50)
• 죽은 오더북 감지 — CLOB에서 404/찾을 수 없음을 반환하는 토큰을 건너뜀
• 동시 실행 락 — Set을 통해 동일한 tokenId에 대한 이중 주문 방지
• 가격 범위 필터 — YES 가격이 2¢ 미만이거나 98¢ 초과인 시장을 건너뜀
• 시간 필터 — 2시간 이내에 정산되는 시장을 건너뜀(의미 있는 거래에는 너무 늦음)
• AI 안티 처닝 — Claude와 Gemini는 최근 거래 내역을 받고 반복 진입을 피하도록 지시받음
• 5단계 청산 시스템 — 수익 목표, 엣지 수렴, 트레일링 스톱, 손절매, 시간 감쇠

사용자 인증

인증은 연결된 지갑을 사용해 클라이언트 측에서 처리됩니다. 세션 관리는 여러분의 브라우저에서 로컬로 이루어지며, 어떤 자격 증명이나 토큰도 원격 서버에 저장되지 않습니다.

면책 조항

WeatherBot은 실험적인 트레이딩 소프트웨어입니다. Polymarket에서의 거래에는 상당한 리스크가 따릅니다 — 투자금의 일부 또는 전부를 잃을 수 있습니다. 날씨 예보는 확률적이며 보장되지 않습니다. AI 분석은 금융 자문이 아닙니다. 모든 지갑 작업은 클라이언트 측에서 이루어집니다 — 여러분의 프라이빗 키는 어떤 서버에도 저장되지 않습니다. 예측 시장 거래와 관련된 현지 법규를 준수할 책임은 본인에게 있습니다. 과거 성과가 미래 결과를 보장하지는 않습니다.

독립성 및 Polymarket과의 무관계

WeatherBot은 독립적인 제3자 소프트웨어 도구입니다. WeatherBot은 Polymarket, 그 모회사, 또는 그 자회사나 계열사와 제휴 관계가 없으며, 이들로부터 보증, 후원, 운영되지 않고, 어떤 식으로도 공식적으로 연결되어 있지 않습니다.

"Polymarket" 및 관련 이름, 마크, 로고, 이미지는 각 소유자의 상표이자 재산이며, 이 사이트에서는 오직 설명 및 상호운용 목적으로만 사용됩니다 — 즉 WeatherBot의 오픈소스 자동화가 사용자를 대신하여 상호작용하는 제3자 플랫폼을 식별하기 위한 목적입니다. 이러한 사용은 어떠한 파트너십, 대리, 후원, 보증도 의미하지 않습니다.

WeatherBot은 사용자 자금을 보관하지 않고, 예측 시장, 거래소, 호가창을 운영하지 않으며, 거래를 매칭, 청산, 정산하지 않습니다. WeatherBot은 전적으로 사용자가 제공하고 통제하는 자격 증명을 사용하여 Polymarket의 공개 API에 연결하는 자동화 소프트웨어입니다. 모든 거래는 Polymarket 자체 인프라에서, Polygon 네트워크를 통해 온체인으로, 사용자 본인의 지갑에 의해 실행됩니다. WeatherBot은 브로커, 딜러, 재무 자문가, 거래소, 또는 자금 서비스 사업자가 아닙니다.

Polymarket 플랫폼 자체와 관련된 모든 질문, 분쟁, 계정 문제, 또는 법적 문의 — 시장 정산, 입금, 출금, 자격, 또는 이용 약관 포함 — 는 Polymarket에 직접 문의해야 합니다. WeatherBot은 Polymarket을 대신하여 행동할 수 없고 그렇게 하지 않으며, 그러한 문제를 해결할 권한이 없습니다.

WeatherBot은 어떠한 종류의 보증도 없이 "있는 그대로" 제공됩니다. 사용자는 WeatherBot 및 Polymarket의 사용이 자신의 관할권에서 적용되는 모든 법률 및 규정을 준수하는지 확인할 단독 책임이 있습니다. 예측 시장 거래는 일부 관할권에서 제한되거나 금지될 수 있으며, 사용 전에 자격을 확인하는 것은 사용자의 책임입니다.

1. 저희가 수집하는 정보

WeatherBot은 전적으로 클라이언트 측에서 동작합니다. 저희는 여러분의 프라이빗 키, 지갑 자격 증명, 개인 데이터를 어떤 서버에도 저장하지 않습니다. 다음 데이터는 여러분의 브라우저나 자체 인프라에서 로컬로 처리됩니다:

• 지갑 데이터 — 귀하의 Polygon 지갑 주소와 프록시(펀더) 주소는 Polymarket의 CLOB를 통한 온체인 거래 실행을 위해 클라이언트 측에서 사용됩니다. 개인 키는 절대 귀하의 기기를 떠나지 않습니다.
• 거래 데이터 — 거래 내역, AI 분석, 오픈 포지션, 엣지 탐지, 구성 설정(bankroll, maxPerTrade, minEdge)은 로컬에서 관리됩니다.
• 사용 지표 — 스캔 수, 거래 수, 가격 업데이트 수, 엣지 탐지 수는 세션별로 로컬에서 추적됩니다.

2. 데이터 사용 방식

수집된 모든 데이터는 Polymarket 날씨 트레이딩 봇 운영에만 사용됩니다:

• 지갑 자격 증명은 Polygon 네트워크를 통해 Polymarket에서 거래를 서명하고 실행하는 데 사용됩니다.
• 트레이딩 설정은 포지션 사이징, 엣지 임계값, 자동화 동작을 결정합니다.
• 거래 내역은 과도한 거래(동일한 결과에 대한 반복 매수/매도)를 방지하기 위해 Claude와 Gemini에 전달됩니다.
• 로그와 메트릭은 대시보드 UI에 표시되어 모니터링할 수 있습니다.

3. 데이터 저장

모든 데이터는 클라이언트 측에서 처리됩니다. WeatherBot은 사용자 데이터를 어떤 원격 서버나 클라우드 데이터베이스에도 저장하지 않습니다. 봇 동작에 필요한 API(아래 명시) 외에는 제3자 분석도, 외부 데이터 전송도 없습니다.

4. 제3자 서비스

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 — GFS, ECMWF, UKMO 모델 데이터를 위한 날씨 예보 API(api.open-meteo.com). 인증 불필요.
• 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건. AI 분석은 최대 20건. 실시간 엣지 감지는 최대 50건. 이 데이터는 서버 데이터 디렉터리를 수동으로 비울 때까지 유지됩니다.

6. 보안

WeatherBot은 클라이언트 측에서 동작합니다 — 여러분의 프라이빗 키는 어떤 서버에도 전송되거나 저장되지 않습니다. 모든 서명과 거래 실행은 여러분의 디바이스에서 로컬로 이루어집니다. 사용자는 자신의 디바이스와 브라우저 환경의 보안을 확보해야 합니다.

7. 여러분의 권리

지갑은 언제든지 대시보드에서 연결 해제할 수 있습니다. 모든 데이터가 클라이언트 측에서 처리되므로, 지갑 연결을 해제하면 세션의 관련 데이터가 모두 지워집니다. 서버 측 데이터 삭제는 필요하지 않습니다.

8. 본 정책의 변경

본 개인정보 처리방침은 WeatherBot의 발전에 따라 업데이트될 수 있습니다. 변경 사항은 본 페이지에 반영됩니다. 변경 이후에도 polymarket weather trading bot을 계속 사용하시면 갱신된 방침에 동의하는 것으로 간주됩니다.

최종 업데이트: 2026년 6월

1. 약관 동의

WeatherBot("본 서비스")에 접근하거나 이를 사용함으로써 여러분은 본 이용약관에 구속됨에 동의합니다. 이 약관에 동의하지 않는 경우 본 서비스를 사용하지 마십시오. WeatherBot은 자동화된 전략으로 Polymarket 예측 마켓에서 거래를 실행하는 polymarket weather trading bot입니다.

2. 서비스 설명

WeatherBot은 실험적인 오픈소스 트레이딩 소프트웨어로, 다음을 수행합니다:

• Gamma API를 통해 Polymarket의 날씨 예측 마켓을 발견합니다
• GFS, ECMWF, UKMO, NWS 기상 모델에서 예보를 가져옵니다
• 베이지안 통계와 정규 CDF 근사를 사용해 확률적 엣지를 계산합니다
• Claude와 Gemini를 사용하여 거래 결정을 위해 시장을 분석합니다
• Polygon 블록체인을 통해 Polymarket의 CLOB에서 거래를 실행합니다
• 자동화된 청산 조건으로 오픈 포지션을 모니터링합니다

3. 위험 공시

Polymarket에서의 거래는 상당한 금융 리스크를 수반합니다. 투자 원금의 일부 또는 전부를 잃을 수 있습니다. WeatherBot을 사용함으로써 다음 위험을 인지하고 수락합니다:

• 시장 리스크 — 날씨 예측 시장은 변동성이 큽니다. 가격은 귀하의 포지션에 불리하게 빠르고 예측 불가능하게 움직일 수 있습니다.
• 모델 리스크 — 날씨 예보는 확률적이며 보장되지 않습니다. GFS, ECMWF, UKMO, NWS 모델은 부정확한 예보를 생성할 수 있고 실제로 생성합니다.
• AI 위험 — Claude와 Gemini의 거래 권장 사항은 패턴 매칭과 추론에 기반하며 확실성이 아닙니다. AI는 판단 오류를 범할 수 있습니다.
• 실행 리스크 — 거래는 유동성 부족, 네트워크 혼잡, 사용 불가능한 호가창, 또는 API 오류로 인해 실패할 수 있습니다.
• 스마트 컨트랙트 리스크 — Polygon에서 Polymarket의 스마트 계약과 상호작용하는 것은 버그, 익스플로잇, 네트워크 장애를 포함한 본질적인 블록체인 위험을 수반합니다.
• 소프트웨어 리스크 — WeatherBot은 실험적 소프트웨어입니다. 버그, 충돌, 또는 예상치 못한 동작이 금전적 손실을 초래할 수 있습니다.

4. 금융 자문 아님

WeatherBot은 금융, 투자 또는 트레이딩 자문을 제공하지 않습니다. 자동화된 시그널, AI 분석, 엣지 계산, 거래 실행은 알고리즘적 산출물이며 — 추천이 아닙니다. 거래 결정과 그로 인한 재정적 결과에 대한 책임은 전적으로 여러분에게 있습니다. 봇, 그 모델, 또는 추적 대상 트레이더의 과거 성과는 미래의 결과를 보장하지 않습니다.

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년 3월