# USGS Recent Earthquakes Feed

> USGS Recent Earthquakes Feed is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-15).

Returns recent earthquake events from the USGS GeoJSON feed filtered by time window and minimum magnitude, including location, depth, tsunami flag, and felt reports.

## Facts

- Endpoint: POST https://x402.agentutility.ai/earthquakes-recent?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-recent-earthquakes-feed-35057e90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g5G5AhYq544cDrI99Ezm2

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 usgs-recent-earthquakes-feed-35057e90 -d '<json body>'
```

Example prompt: Pull the USGS earthquake feed for the past day and show me all quakes above magnitude 4.0 — include location, depth, and whether any triggered a tsunami warning.

## When to prefer this

Use this endpoint when you need structured, near-real-time earthquake data from the authoritative USGS source without managing USGS API keys or GeoJSON parsing. Ideal for agents that need to monitor seismic activity, generate disaster briefings, or check for tsunami-flagged events across flexible time windows. Prefer this over direct USGS GeoJSON access when operating in an x402/MCP payment-gated agent environment.

## Known failure modes

- Invalid time window value (not one of: hour, day, week, month) returns an error
- Magnitude threshold outside USGS feed range may return empty results
- USGS upstream feed unavailability causes fetch failure
- No earthquakes matching the criteria returns an empty list

## How this service works

Earthquake / recent earthquakes API / USGS earthquake feed. Returns recent earthquakes from USGS for any time window (hour, day, week, month) above a magnitude threshold. Includes location, magnitude, depth, tsunami flag. Each quake includes magnitude + type, depth (km), place, ISO8601 time, lat/lon, tsunami flag, USGS event URL, and felt-report count when available. Wraps USGS GeoJSON summary feeds - public domain, no auth.

## Output

A list of recent earthquake events from the USGS GeoJSON summary feed, each containing: magnitude and type, depth in kilometers, human-readable place name, ISO8601 timestamp, latitude/longitude coordinates, tsunami flag (0 or 1), link to the USGS event detail page, and felt-report count where available.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "bounds": {
       "type": "object",
       "properties": {
        "east": {
         "type": "number"
        },
        "west": {
         "type": "number"
        },
        "north": {
         "type": "number"
        },
        "south": {
         "type": "number"
        }
       },
       "description": "Optional geographic bounding box { north, south, east, west } in decimal degrees. Antimeridian-crossing boxes (west > east) supported."
      },
      "time_range": {
       "enum": [
        "hour",
        "day",
        "week",
        "month"
       ],
       "type": "string",
       "description": "Time window for the feed. Default 'day'."
      },
      "min_magnitude": {
       "type": "number",
       "description": "Lower bound on quake magnitude (Richter/moment). Default 2.5."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "range": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "earthquakes": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "url": {
          "type": "string"
         },
         "felt": {
          "type": "integer"
         },
         "time": {
          "type": "string"
         },
         "place": {
          "type": "string"
         },
         "tsunami": {
          "type": "boolean"
         },
         "depth_km": {
          "type": "number"
         },
         "latitude": {
          "type": "number"
         },
         "longitude": {
          "type": "number"
         },
         "magnitude": {
          "type": "number"
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 12,
  "range": "day",
  "source": "https://earthquake.usgs.gov",
  "earthquakes": [
   {
    "id": "us7000n3xy",
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000n3xy",
    "felt": 3,
    "time": "2026-05-06T11:42:18.000Z",
    "place": "120 km SW of Adak, Alaska",
    "tsunami": false,
    "depth_km": 35.7,
    "latitude": 51.1234,
    "longitude": -177.8765,
    "magnitude": 5.2,
    "magnitude_type": "mww"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-recent-earthquakes-feed-35057e90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)