
ClimateSmartWeather Docs
Complete technical reference for the ClimateSmartWeather platform — covering the planetary intelligence APIs, Climate Protocol smart contracts, data sources, and integration guides.
Platform Overview
ClimateSmartWeather is a real-time planetary intelligence platform that aggregates data from over 1,200 global sensors, satellites, and scientific agencies to deliver a unified view of Earth's climate, weather, natural hazards, and space weather. The platform is built on three pillars:
Live feeds from NOAA, NASA, USGS, ESA, and ECMWF covering weather, seismic activity, wildfires, hurricanes, volcanoes, and space weather — all unified in a single command center.
The world's first climate-indexed token system. CLM, HOT, and COLD tokens are priced by a composite of 12 real-time climate metrics, creating a direct financial link between Earth's conditions and on-chain value.
Multi-source data validation, automatic oracle fallback during satellite outages, and on-chain governance ensure the platform remains accurate and trustworthy even during extreme events.
Data Sources & Update Frequency
| Source | Data Type | Update Frequency | Coverage |
|---|---|---|---|
| NOAA SWPC | Space weather, Kp index, solar wind, X-ray flux | 1–5 minutes | Global |
| NASA DONKI | Solar flares, CMEs, geomagnetic storms | Real-time | Heliosphere |
| NASA SDO | Solar imagery (EUV, HMI magnetogram) | 12 minutes | Solar disk |
| NASA FIRMS | Wildfire hotspots (MODIS + VIIRS) | 3 hours | Global |
| NASA EONET | Natural events (fires, storms, floods, volcanoes) | Real-time | Global |
| USGS Earthquake | Seismic events M1.0+ | Real-time | Global |
| Open-Meteo | Weather forecasts, historical climate, AQI | 1 hour | Global |
| OpenWeatherMap | Current conditions, 5-day forecasts | 10 minutes | 200,000+ cities |
| NOAA Mauna Loa | Atmospheric CO₂ concentration | Annual/monthly | Global baseline |
| GNews API | Climate & weather news articles | 15 minutes | Global media |
| ESA/NASA SOHO | Coronagraph imagery (LASCO C3) | 30 minutes | Solar corona |
| ECMWF ERA5 | Historical reanalysis climate data | Monthly updates | 1940–present |
Platform API Reference
All platform data is served via a tRPC API over /api/trpc. The following procedures are available to authenticated clients.
weather.getCurrentparams: city: string→ WeatherDataCurrent conditions for a city (temperature, humidity, wind, pressure, UV index, visibility)
weather.getForecastparams: lat: number, lon: number→ ForecastData[]5-day hourly forecast from Open-Meteo
weather.getAlertsparams: lat: number, lon: number→ WeatherAlert[]Active severe weather alerts for a location
weather.getRadarparams: lat: number, lon: number, zoom: number→ RadarTileSetAnimated precipitation radar tile URLs
weather.getAQIparams: lat: number, lon: number→ AQIDataAir quality index and pollutant breakdown
Climate Protocol — CLM, HOT & COLD Tokens
The governance and base liquidity token. CLM price is derived from a weighted composite of all 12 climate metrics. Holders vote on oracle parameters, fee splits, and protocol upgrades.
Tracks global temperature anomaly above the 1951–1980 baseline. HOT appreciates when heat records are broken and depreciates during cooling periods. Driven by NOAA GHCN and NASA GISS data.
Tracks Arctic sea ice extent and polar vortex strength. COLD appreciates during polar vortex disruptions and Arctic amplification events. Driven by NSIDC and ECMWF reanalysis data.
Getting Started with the Protocol
Install the Climate Protocol SDK:
npm install ethers @climate-protocol/sdkConnect to the CLM token contract and read the current composite score:
import { ethers } from "ethers";
import { ClimateProtocol } from "@climate-protocol/sdk";
const provider = new ethers.BrowserProvider(window.ethereum);
const signer = await provider.getSigner();
// Initialize the Climate Protocol SDK
const protocol = new ClimateProtocol({ provider, signer, network: "polygon" });
// Read the current CLM composite score (0–100 scale)
const composite = await protocol.clm.getCurrentComposite();
console.log("CLM Composite Score:", composite.toString());
// Read current HOT token heat anomaly index
const heatIndex = await protocol.hot.getHeatAnomalyIndex();
console.log("Global Heat Anomaly:", heatIndex.toFixed(2), "°C above baseline");
// Read COLD token polar vortex strength
const polarIndex = await protocol.cold.getPolarVortexIndex();
console.log("Polar Vortex Index:", polarIndex.toString());Subscribe to oracle updates (emitted every 15 minutes on-chain):
// Listen for composite score updates
protocol.clm.on("CompositeUpdated", (newScore, timestamp, sources) => {
console.log(`New CLM score: ${newScore} at ${new Date(timestamp * 1000).toISOString()}`);
console.log(`Active data sources: ${sources.join(", ")}`);
});
// Listen for oracle pause events (triggered by G5 geomagnetic storms)
protocol.clm.on("OraclePaused", (reason, kpIndex) => {
console.warn(`Oracle paused: ${reason} (Kp=${kpIndex})`);
});CLM Composite Score Formula
The CLM token price is derived from a weighted average of 12 real-time climate metrics. Each metric is normalised to a 0–100 scale before weighting. The composite is recalculated every 15 minutes on-chain.
| Metric | Data Source | Weight | Update Interval |
|---|---|---|---|
| Global Temperature Anomaly | NASA GISS / NOAA GHCN | 20% | Monthly |
| CO₂ Concentration (Mauna Loa) | NOAA GML | 15% | Annual |
| Arctic Sea Ice Extent | NSIDC | 12% | Daily |
| Global Sea Level Rise | NASA Altimetry | 10% | 10 days |
| Active Wildfire Count (FRP > 50 MW) | NASA FIRMS | 10% | 3 hours |
| Tropical Cyclone Activity Index | NOAA NHC / JTWC | 8% | 6 hours |
| Kp Geomagnetic Index | NOAA SWPC | 8% | 3 hours |
| Extreme Precipitation Anomaly | ECMWF ERA5 | 7% | 6 hours |
| Drought Monitor Index | USDA / NOAA | 5% | Weekly |
| Ocean Heat Content (0–700m) | NOAA NCEI | 3% | Monthly |
| Stratospheric Aerosol Optical Depth | NASA GISS | 1% | Monthly |
| Solar Irradiance Anomaly | SORCE / LASP | 1% | Daily |
Oracle Resilience & Fallback Mechanisms
All 12 data sources are polled every 15 minutes. Each metric is validated against a 3σ outlier threshold before inclusion in the composite. A minimum of 8 active sources is required for a standard composite update.
When 5–6 sources are unavailable (e.g., during satellite outages), the oracle switches to a 6-hour rolling average. Token price volatility is dampened by ±5% to prevent manipulation during data gaps.
When NOAA SWPC reports Kp ≥ 7 sustained for >30 minutes (G3+ geomagnetic storm), the oracle automatically extends to a 12-hour average. Satellite-dependent metrics are temporarily excluded from the composite.
Extreme G5 geomagnetic storms (Kp ≥ 9) trigger a full oracle pause. Token prices are frozen at the last valid composite until sensor integrity is confirmed. The pause requires a multi-sig governance vote to lift.
Platform Pages & Features
//weather/radar/hazards/wildfires/space-weather/analytics/climate/about/contact/docs/terms/privacyExternal Resources & Data Portals
CLI Tools & Integration
The ClimateSmartWeather CLI provides command-line access to all platform data endpoints and Climate Protocol interactions.
# Install the CLI globally
npm install -g @climate-protocol/cli
# Authenticate with your wallet
csw auth --wallet 0xYourWalletAddress
# Fetch current space weather dashboard
csw space-weather --format json
# Get latest wildfire hotspots within 500km of a location
csw wildfires --lat 34.05 --lon -118.24 --radius 500
# Stream real-time Kp index updates
csw kp-watch --threshold 5 --notify
# Query CLM composite score
csw protocol composite --token CLM
# Simulate oracle update with custom metric values
csw protocol simulate --temp-anomaly 1.5 --co2 425 --kp 3