Sugra Earth direction

The physical world as an API - weather, climate, disasters, energy, satellite - and the infrastructure that moves through it.

Sugra Earth covers worldwide weather and climate, natural hazards, air quality, energy systems, and marine and aviation transport. Upstreams in this direction are sovereign, intergovernmental or academic institutions, so sources are named openly: NOAA, USGS, NASA, ECMWF, EUMETSAT, Copernicus, EIA, ENTSO-E, Open-Meteo and more. Responses share the standard data + meta envelope; meta.source identifies the upstream, and the /api/v2 surfaces add per-field provenance and a machine-readable attribution block with license and citation.

What data lives here

API Reference category	Endpoints	Coverage
Environment	142	Worldwide weather: current conditions, 16-day forecast and multi-decade history (Open-Meteo), plus the `/api/v2/weather` spine best-matched across sovereign models (ECMWF Open Data, NOAA GFS, DWD ICON, ECCC GEM); NOAA NWS US forecasts, alerts and station observations; climate history and CMIP6 projections; marine forecasts, sea level and floods; NOAA tide stations; earthquakes, volcanoes, fires and space weather (USGS, NASA FIRMS, NOAA SWPC); Climate TRACE emissions; NASA GIBS satellite imagery layers
Transportation	14	Aviation weather - METAR, TAF and SIGMET advisories (NOAA Aviation Weather Center); tide predictions (NOAA CO-OPS); ocean wave point forecasts (NOAA GFS-Wave); EU vessel-density aggregates (EMODnet) and US port activity (NOAA MarineCadastre)
Energy	12	Grid demand, fuel mix and interchange for the US, Great Britain, Denmark, six EU zones and Australia (EIA-930, Elexon BMRS, NESO, Energinet, ENTSO-E, AEMO); observed solar radiation (EUMETSAT CM SAF SARAH-3); Sugra-derived wind and PV potential; US retail electricity prices and utility tariffs (EIA, NREL OpenEI URDB); power infrastructure from OpenStreetMap
Disasters & Hazards	8	The `/api/v2/hazards` family in one normalized event schema: USGS earthquakes, NOAA NHC tropical cyclones, EUMETSAT lightning, NASA FIRMS wildfires, tsunami warnings, volcanic ash advisories, Copernicus EMS mapping activations and GDACS multi-hazard alerts
Air Quality	1	Composite point air quality: Sentinel-5P TROPOMI satellite columns plus CAMS global and European surface models (Copernicus)

Counts reflect the live catalog as of 2026-07-18.

Flagship endpoints

Point weather, multi-model

GET /api/v2/weather returns current conditions for any coordinate worldwide, best-matched across sovereign forecast models on a unified 0.25-degree grid. Every value carries its source model. Forecast and history live at /api/v2/weather/forecast and /api/v2/weather/history.

Response (truncated):

{
  "data": {
    "location": {"requested": {"lat": 52.52, "lon": 13.405}, "grid_point": {"lat": 52.5, "lon": 13.5}, "tile": "50N_010E"},
    "weather": {"temperature_c": 19.62, "wind_speed_ms": 0.91, "pressure_hpa": 1009.11, "relative_humidity_pct": 92.3,
                "cloud_cover_pct": 89.1, "apparent_temperature_c": 21.92, "precipitation_mm": 0.0},
    "forecast": {"name": "ECMWF Open Data (IFS)", "cycle": "2026071800", "resolution_deg": 0.25},
    "provenance": {"temperature": {"institution": "ecmwf", "model": "ifs-open"}, "gust": {"institution": "noaa", "model": "gfs"}}
  }
}

Earthquakes and the hazards family

GET /api/v2/hazards/earthquakes returns recent USGS events in the normalized hazard-event schema shared by all /api/v2/hazards endpoints, so lightning, cyclones, wildfires, tsunami and volcanic ash parse the same way.

Response (truncated):

{
  "data": {
    "total_matched": 41, "count": 2,
    "events": [{
      "event_id": "us7000t1jy", "event_type": "earthquake", "source_event_time": "2026-07-18T06:51:50Z",
      "geometry": {"lat": 14.3804, "lon": -93.1511, "depth_km": 35}, "place": "87 km WSW of Puerto Madero, Mexico",
      "metrics": {"magnitude": 5.3, "mag_type": "mww", "significance": 432, "tsunami": 0},
      "severity": {"severity": "Moderate", "certainty": "Observed", "derivation": "sugra-computed"},
      "source": {"institution": "USGS", "tier": "S"}
    }]
  }
}

Grid operating data

GET /api/v2/energy/grid returns demand, day-ahead forecast, net generation, fuel mix and interchange series. Regions span the US (EIA-930), Great Britain, Denmark, six EU bidding zones and Australia; region selects the grid, metric the series.

Response (truncated):

{
  "data": {
    "region": "US48", "region_name": "United States Lower 48",
    "metric": "demand", "unit": "megawatthours",
    "series": [
      {"period": "2026-07-18T17", "value": 623658.0},
      {"period": "2026-07-18T16", "value": 607670.0}
    ]
  },
  "meta": {"endpoint": "/api/v2/energy/grid", "source": "eia"}
}

Point air quality

GET /api/v2/air-quality composes Sentinel-5P TROPOMI satellite column observations with CAMS global and European surface-concentration models at any coordinate. Satellite products and model layers are reported separately, each with its own timestamp.

Response (truncated):

{
  "data": {
    "location": {"requested": {"lat": 48.85, "lon": 2.35}, "cell": {"lat": 48.875, "lon": 2.375}},
    "products": {"co": {"value": 0.032514, "units": "mol m-2", "observed_at": "2026-07-18T12:11:17Z"}},
    "model": {"cams_global": {"pm2p5": {"value": 14.54, "units": "ug m-3"}},
              "cams_european": {"no2": {"value": 24.862, "units": "ug m-3"}, "o3": {"value": 63.167, "units": "ug m-3"}}}
  }
}

Tide predictions

GET /api/v2/transport/tides resolves the nearest NOAA CO-OPS station to a coordinate and returns astronomical tide predictions - high/low by default, hourly or 6-minute on request. Wave conditions for the same point live at /api/v2/transport/marine.

Response (truncated):

{
  "data": {
    "station": {"id": "9447130", "name": "SEATTLE (Madison St.), Elliott Bay", "state": "WA", "distance_km": 0.3},
    "interval": "hilo", "datum": "MLLW", "units": "metric",
    "predictions": [
      {"time": "2026-07-18 03:51", "value": 3.746, "type": "H"},
      {"time": "2026-07-18 09:52", "value": 1.412, "type": "L"}
    ]
  }
}

Typical workflows

AI agents answering physical-world questions with citable provenance: every /api/v2 response names the upstream institution, license and data timestamp, so an agent can ground a claim about weather, a quake or grid load without scraping.

Risk and logistics teams joining active hazards with the infrastructure they threaten: cyclone positions against port activity and vessel density, wildfire detections against power assets, aviation weather along a route.

Energy analysts combining grid demand and fuel mix with observed solar radiation, wind potential and US utility tariffs for site screening and market monitoring.

Where to go next

Sources: the Sugra Earth sources page lists every upstream institution with tier and license.

API Reference: the sidebar categories Environment, Transportation, Energy, Disasters & Hazards and Air Quality document every endpoint with parameters and schemas.

Quickstart covers authentication, the response envelope and rate-limit headers.

Sugra Earth direction

What data lives here#

Flagship endpoints#

Point weather, multi-model#

Earthquakes and the hazards family#

Grid operating data#

Point air quality#

Tide predictions#

Typical workflows#

Where to go next#

What data lives here

Flagship endpoints

Point weather, multi-model

Earthquakes and the hazards family

Grid operating data

Point air quality

Tide predictions

Typical workflows

Where to go next