v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB

Disasters & Hazards

Recent earthquakes (USGS)

Recent earthquakes from the USGS Earthquake Hazards Program public-domain feeds, normalized to the Sugra CAP-aligned hazard event schema. Filter by time window, bounding box, minimum magnitude and time range. Sugra retransmits authoritative USGS events and does not issue earthquake warnings.

get/api/v2/hazards/earthquakes

Query parameters

window'hour' | 'day' | 'week' | 'month'

Ingested time window to read: hour/day carry all magnitudes; week/month carry M2.5+.

min_magnitudenumber nullable

Minimum magnitude (inclusive).

min_latnumber nullable

Bounding-box south edge.

max_latnumber nullable

Bounding-box north edge.

min_lonnumber nullable

Bounding-box west edge.

max_lonnumber nullable

Bounding-box east edge.

startstring nullable

Lower bound on event time, ISO 8601 UTC (e.g. 2026-07-01T00:00:00Z).

endstring nullable

Upper bound on event time, ISO 8601 UTC.

limitinteger

Maximum events returned (newest first).

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "window": "hour",
      "min_magnitude": 2.5,
      "limit": 100
    },
    "events": [
      {
        "schema_version": "hazard-event/2",
        "event_id": "us7000abcd",
        "event_type": "earthquake",
        "source_event_time": "2026-07-03T12:00:00Z",
        "geometry": {
          "lat": 34.1,
          "lon": -118.2,
          "depth_km": 8
        },
        "place": "10km SW of Testville",
        "metrics": {
          "magnitude": 4.2,
          "mag_type": "ml",
          "alert": "green",
          "significance": 271
        },
        "severity": {
          "severity": "Moderate",
          "certainty": "Observed",
          "urgency": "Past",
          "derivation": "sugra-computed"
        },
        "source": {
          "institution": "USGS",
          "tier": "S"
        },
        "disclaimer": "Magnitudes are preliminary and subject to revision."
      }
    ],
    "attribution": {
      "sources": [
        {
          "registry_key": "usgs/earthquake",
          "source_name": "USGS Earthquake",
          "licence": "public-domain",
          "citation": "U.S. Geological Survey Earthquake Hazards Program",
          "disclaimer": "Magnitudes are preliminary and subject to revision."
        }
      ],
      "effective_reexport": "allowed"
    },
    "disclaimer": "Magnitudes are preliminary and subject to revision."
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}