# Earthquake Intelligence – Recent Seismic Events

> Earthquake Intelligence – Recent Seismic Events is a paid API for AI agents from earthquakes.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-16).

Returns the most recent USGS earthquake events within a rolling UTC time window, filtered by minimum magnitude, newest-first, with freshness and provenance metadata.

## Facts

- Endpoint: GET https://earthquakes.use.x402atlas.com/recent
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/earthquake-intelligence-recent-seismic-events-475c8d3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c-n825t57JyvQ3PbvHjvz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability earthquake-intelligence-recent-seismic-events-475c8d3c
```

Example prompt: Show me the most recent earthquakes from USGS in the past 48 hours with a minimum magnitude of 3.5, returning up to 50 events.

## When to prefer this

Use this endpoint when you need the most recent earthquake events globally from USGS, queried by a rolling time window and minimum magnitude threshold, with built-in freshness signaling and provenance. Prefer this over the sibling 'significant earthquakes' endpoint when you want raw magnitude-based filtering rather than USGS significance-score filtering, or when recency and newest-first ordering is the primary concern.

## Known failure modes

- Source unavailability: USGS feed unreachable — endpoint may serve a stale validated snapshot (stale: true) or return an error
- No events found: valid query but zero earthquakes match the magnitude/time criteria — returns empty events array with count 0
- Invalid parameters: hours outside 1–720, limit outside 1–200, or magnitude outside -2–10 — returns validation error
- Rate limiting or payment failure: x402 payment not processed — request rejected before data is returned

## How this service works

Recent earthquakes — search newest-first USGS seismic events by rolling time window and minimum magnitude, with revision, freshness, and provenance.

## Output

A JSON object containing: a normalized list of earthquake events (up to 200) sorted newest-first, each with USGS event details and preferred magnitude; a count of returned events; the effective query window (start/end timestamps, hours, min_magnitude, limit); a staleness flag indicating whether a cached snapshot was served due to source failure; provenance/source metadata; and a retrieval timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "hours": {
       "type": "integer",
       "default": 24,
       "maximum": 720,
       "minimum": 1,
       "description": "Rolling UTC window in hours"
      },
      "limit": {
       "type": "integer",
       "default": 100,
       "maximum": 200,
       "minimum": 1,
       "description": "Maximum normalized events returned"
      },
      "min_magnitude": {
       "type": "number",
       "default": 2.5,
       "maximum": 10,
       "minimum": -2,
       "description": "Minimum USGS preferred magnitude"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "operation",
      "schema_version",
      "query",
      "count",
      "events",
      "source",
      "retrieved_at",
      "stale",
      "warnings"
     ],
     "properties": {
      "count": {
       "type": "integer",
       "maximum": 200,
       "minimum": 0,
       "description": "Number of normalized events returned"
      },
      "query": {
       "type": "object",
       "required": [
        "window_start",
        "window_end",
        "hours",
        "min_magnitude",
        "limit"
       ],
       "properties": {
        "hours": {
         "type": "integer",
         "maximum": 720,
         "minimum": 1,
         "description": "Applied rolling hours"
        },
        "limit": {
         "type": "integer",
         "maximum": 200,
         "minimum": 1,
         "description": "Applied event limit"
        },
        "window_end": {
         "type": "string",
         "format": "date-time",
         "description": "Inclusive UTC end bucket used for source query and cache identity"
        },
        "window_start": {
         "type": "string",
         "format": "date-time",
         "description": "Inclusive UTC start of the effective bucketed window"
        },
        "min_magnitude": {
         "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/earthquake-intelligence-recent-seismic-events-475c8d3c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from earthquakes.use.x402atlas.com](https://www.zero.xyz/host/earthquakes.use.x402atlas.com/llms.txt)