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	21	Aviation weather - METAR, TAF and SIGMET advisories (NOAA Aviation Weather Center); US air-traffic delay programs (FAA NAS Status); airport search and lookup; a Sugra-derived weather-disruption-risk index at a point, along a route and across the forecast; tide predictions (NOAA CO-OPS); ocean wave point forecasts (NOAA GFS-Wave); EU vessel-density aggregates (EMODnet), US port activity (NOAA MarineCadastre), Northern Europe vessel positions, port calls and port congestion; road-disruption events on French national roads (Bison Fute)
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-09-27.

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"}
    ]
  }
}

Road disruption events in France

GET /api/v2/transport/road/events returns closures, roadworks, obstructions, accidents and weather-related road conditions on the French non-concessioned national road network, from the Bison Fute open DATEX II feed under the Licence Ouverte 2.0. Tolled motorways and local roads are not covered, and location descriptions are in French. Filter by category (a DATEX II record class such as Accident, MaintenanceWorks or EnvironmentalObstruction), by weather_related, or by a bounding box (min_lat, max_lat, min_lon, max_lon); limit defaults to 200 and goes up to 2,000. The feed is cached for three minutes.

Response (truncated):

{
  "data": {
    "total_matched": 4,
    "count": 2,
    "events": [{
      "id": "260924-003380-1", "category": "Accident", "weather_related": false,
      "location_description": "situé 50 m à l'ouest de La Penne-sur-Huveaune",
      "lat": 43.285725, "lon": 5.5119557, "direction": "eastBound",
      "start_time": "2026-09-24T08:23:58.914+02:00", "end_time": "2026-09-24T09:10:55.627+02:00",
      "source": "Direction interdépartementale des routes/DIR Méditerranée"
    }],
    "coverage": "France non-concessioned national road network only (Bison Fute / DIR); tolled motorway concessions and local roads are not included."
  },
  "meta": {"endpoint": "/api/v2/transport/road/events", "source": "bison_fute_datex2"}
}

The events are informational, not an official traffic or driving advisory.

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#

Road disruption events in France#

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

Road disruption events in France

Typical workflows

Where to go next