# PolyNimbus — Polymarket Weather Markets Dashboard

## About
PolyNimbus is a free, real-time dashboard for Polymarket highest-temperature weather prediction markets. It provides live odds, CLOB order book data, METAR aviation weather observations, and ensemble weather forecasts for 35+ cities worldwide.

## URL
https://www.polynimbus.club

## Features
- Real-time Polymarket odds and mid-price curve for every temperature bin
- Full CLOB order book with best bid, ask, spread and last trade price
- Live METAR weather observations from airport stations worldwide
- Open-Meteo ensemble forecasts with min/mean/max uncertainty bands
- 1-day and 7-day temperature forecast charts with METAR history overlay
- Interactive 3D world map to navigate between city markets
- Opportunity scanner comparing METAR vs model during peak hours
- Today and tomorrow market switching for all cities
- Supports both Fahrenheit and Celsius temperature display

## Cities Covered
London, New York, Tokyo, Seoul, Shanghai, Shenzhen, Beijing, Singapore, Hong Kong, Taipei, Wellington, Chicago, Dallas, Miami, Houston, Atlanta, Denver, Seattle, San Francisco, Los Angeles, Toronto, Paris, Madrid, Milan, Munich, Istanbul, Ankara, Warsaw, Tel Aviv, Austin, Lucknow, Buenos Aires, São Paulo, Chengdu, Chongqing, Wuhan

## How Weather Markets Work
Each Polymarket weather market asks: "What will be the highest temperature in [city] on [date]?" Traders buy and sell shares on temperature bins (e.g. 66-67°F). Markets resolve using official data from Weather Underground, specifically the highest temperature recorded at the city's airport weather station. Shares in the correct bin pay out $1.00; all others pay $0.

## Data Sources
- Polymarket Gamma API: Market odds, order book, volume
- Polymarket CLOB WebSocket: Real-time order book updates
- aviationweather.gov: METAR aviation weather observations
- Open-Meteo: Hourly forecasts and ensemble model data
- Weather Underground: Resolution source for market settlement

## Public HTTP API (supported)
Only this endpoint is documented and rate-limited for external use:

### GET /api/weather/snapshots
- Purpose: Full resolution-day chart payload — model hourly temps, running max, ensemble, METAR, atmospheric fields (cloud cover layers, wind, shortwave radiation), heating-window diagnostics.
- Access: Public, free JSON. This is the only `/api/*` route intended for external programmatic use.
- Query params:
  - city=<city-key> (optional; omit for all cities — large response)
  - day=today|tomorrow (optional; local to each city)
  - date=YYYY-MM-DD (optional; overrides day)
- Rate limits: Rolling per-IP window on this path only. HTTP 429 with `Retry-After` when exceeded. Success responses may include `X-RateLimit-*` headers.
- Other `/api/*` paths are not available to external API clients (they return HTTP 404); the PolyNimbus site uses them in-browser only.

Response includes:
  - locations[].cityKey, cityLabel, stationCode, timezone
  - locations[].resolutionDate
  - locations[].points[] with isoLocal, label (HH:mm), tempC, tempF
  - locations[].maxTempC and minTempC
  - locations[].chart.runningMaxC / runningMaxF
  - locations[].chart.ensemblePoints[] (min/mean/max in C and F)
  - locations[].chart.metarAlignedC / metarAlignedF (METAR aligned to chart hours)
  - locations[].chart.atmosphericPoints[] (cloud, wind, radiation)
  - locations[].metar.icao
  - locations[].metar.latest (latest METAR point)
  - locations[].metar.observations[] (24h METAR time series)

## Contact
Website: https://www.polynimbus.club
Twitter: https://x.com/NimbusOnPoly