{"name":"PURP Oracle API","version":"3.2.0","description":"Real-time climate data and Solana oracle state for the PURP DePIN network","network":"solana-devnet","program":"BxmrngNp9m6f6jwTJZwdFAvaKMLUWxbjDmSZpTFeJyBm","oracle_pda":"AJTionGHLiBCAfPDWhifTmwBF3CuXopyNRRApRLwCcRd","endpoints":{"/":"API documentation (this response)","/oracle":"Current oracle state from Solana devnet","/oracle/emissions":"Current PURP/PURPN emission rates derived from climate data","/oracle/history":"Last 100 readings from KV store","/climate":"Full PURP Climate Index (live from 40+ sources including planetary, AI forecast, risk factors)","/climate/sst":"Sea Surface Temperature from all NDBC stations (includes regional breakdown)","/climate/sst/regions":"SST by ocean region (Florida, Gulf, Atlantic, Pacific, Caribbean). ?region=pacific to filter","/climate/air":"Air temperature, humidity, pressure, and UV from Open-Meteo","/climate/index":"Composite climate index score (10 weighted components)","/climate/coral":"NOAA Coral Reef Watch data (DHW, bleaching alerts)","/climate/marine":"Open-Meteo Marine data (wave height, period, ocean current)","/climate/uv":"UV Index and air quality data","/climate/satellite":"All satellite data (NASA FIRMS, EONET, EPIC, DONKI, GOES SST)","/climate/fires":"Active fire hotspots near Florida (NASA FIRMS VIIRS)","/climate/planetary":"All 10 planetary data sources (CO2, temp anomaly, storms, geomagnetic, etc.)","/climate/co2":"CO2 levels + global temperature anomaly + carbon context","/climate/storms":"NHC active hurricanes + US drought conditions + pollen levels","/climate/forecast":"NVIDIA Earth-2 AI-Enhanced predictions (3-day SST, 7-day trend, storm probability, anomaly detection)","/climate/risk-factors":"Tomorrow.io risk factors (fire, flood, lightning, soil, pollen, aviation, precipitation)","/climate/ai-enhanced":"Full climate data enriched with NVIDIA AI predictions + Tomorrow.io risk factors (40+ sources)","/climate/advanced":"Advanced weather intelligence — ensemble model confidence (ICON/GFS/ECMWF), flood forecast, soil/agriculture, Visual Crossing, WeatherAPI.com","/risk":"Property climate risk score (0-100). ?lat=25.76&lng=-80.19 or ?address=Miami+Beach+FL","/tokens":"Token registry (PURP family across all chains)","/treasury":"Treasury holdings across Solana and 14 EVM chains","/health":"API health check","/status":"Detailed health status — source-level monitoring, quality score, degraded service detection","/market":"Real-time crypto + commodity prices (CoinGecko, Open-Meteo)","/market/correlation":"Climate-market correlation matrix (8 pairs, Pearson r)","POST /webhooks/subscribe":"Register a webhook URL with trigger conditions (SST > 28, hurricane alert, etc.)","DELETE /webhooks/:id":"Unsubscribe a webhook by ID","GET /webhooks":"List all active webhook subscriptions","/alpha":"[PREMIUM] Full alpha signal — climate-financial correlations, trade signals, risk (X-API-Key required)","/alpha/correlations":"[PREMIUM] Correlation matrix: climate signal vs financial assets","/alpha/signals":"[PREMIUM] Actionable trade signals based on climate data","/alpha/risk":"[PREMIUM] Composite climate risk score with z-scores","/alpha/backtest":"[ENTERPRISE] Backtested results summary — 38/49 significant pairs, top strategies, key correlations (2020-2026)","POST /auth/register":"Register for an API key (body: { email })","POST /auth/upgrade":"Upgrade API key tier (body: { key, tier })","GET /auth/status":"Check API key status, tier, and usage","GET /admin/analytics":"Admin analytics dashboard (?key=ADMIN_KEY)","/forecast":"7-day climate + emission forecast (today vs prediction, signals, regional SST)","/forecast/16day":"16-day extended forecast with daily PURP/PURPN emission projections","/forecast/seasonal":"6-month seasonal outlook with monthly emission forecasts"},"tiers":{"observer":{"purp_staked":0,"rate_limit":"10 req/min","access":"health, oracle, sst, tokens, forecast"},"analyst":{"purp_staked":1000,"rate_limit":"60 req/min","access":"All climate + forecast endpoints"},"trader":{"purp_staked":10000,"rate_limit":"300 req/min","access":"Climate + alpha signals"},"enterprise":{"purp_staked":100000,"rate_limit":"1000 req/min","access":"Everything + backtest + webhooks"}},"data_sources":["NOAA NDBC (8 FL stations + 19 regional: Gulf, Atlantic, Pacific, Caribbean — SST)","NOAA CO-OPS (Miami Biscayne Bay — water temperature)","Open-Meteo (Miami — air temp, humidity, pressure, wind, UV)","Open-Meteo Air Quality (Miami — AQI, PM2.5, PM10)","NOAA Coral Reef Watch (Florida Keys — degree heating weeks)","USGS Water Services (Miami Canal — gage height)","NOAA Tides (Miami — predicted tide level)","Sunrise/Sunset API (Miami — day length, solar position)","USGS Earthquakes (Florida coast — seismic activity)","Open-Meteo Marine (Miami — wave height, period, ocean current)","NASA FIRMS (active fire hotspots — VIIRS satellite)","NASA EONET (natural events — storms, wildfires, volcanoes)","NASA EPIC (Earth Polychromatic Camera — daily Earth images)","NASA DONKI (space weather — solar flares, geomagnetic storms)","NOAA GOES-16 MUR SST (satellite-derived sea surface temperature)","NOAA CO2 Daily (Mauna Loa Observatory — atmospheric CO2 ppm)","ERDDAP MODIS Chlorophyll-a (SE Florida ocean productivity)","NHC Current Summaries (active Atlantic hurricane tracking)","USDM US Drought Monitor (Miami-Dade county drought levels)","NASA GISS Global Temperature Anomaly (monthly/annual anomaly)","NOAA SWPC Kp Geomagnetic Index (planetary magnetic activity)","NOAA SWPC Solar Cycle Prediction (sunspot number forecast)","ERDDAP Sea Level Anomaly (satellite altimetry, SE Florida)","Open-Meteo Pollen (6 pollen types for Miami)","NSIDC Arctic Sea Ice Extent (Northern Hemisphere)","NVIDIA NIM AI Forecast (Llama 3.3 70B — SST prediction, storm probability, anomaly detection)","Tomorrow.io Weather (fire index, flood risk, lightning, soil, pollen, aviation)","Tomorrow.io Realtime (temperature, humidity, wind, pressure, cloud cover, UV)","Solana devnet RPC (oracle on-chain state)"],"rate_limit":"100 requests/minute per IP","cache_ttl":"60 seconds","response_headers":["X-PURP-Oracle-Epoch — total oracle updates (on-chain epoch)","X-PURP-SST — latest median SST in degrees Celsius","X-Response-Time — request processing time in milliseconds","X-PURP-Sources — online/total data source count (e.g. 27/35)","X-PURP-Quality — data quality score 0-100"],"links":{"explorer":"https://explorer.solana.com/address/AJTionGHLiBCAfPDWhifTmwBF3CuXopyNRRApRLwCcRd?cluster=devnet","program":"https://explorer.solana.com/address/BxmrngNp9m6f6jwTJZwdFAvaKMLUWxbjDmSZpTFeJyBm?cluster=devnet","github":"https://github.com/purple-squirrel-network","website":"https://purplesquirrel.media"}}