# Recent Earthquakes (USGS)

> Recent Earthquakes (USGS) is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Returns recent earthquake data worldwide or within a radius of a point, including magnitude, location, time, depth, tsunami flag, PAGER alert, and felt reports.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/geo/earthquakes?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/recent-earthquakes-usgs-18b124d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K5E6chVw-cee9s85JFO0y

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 recent-earthquakes-usgs-18b124d5
```

Example prompt: Can you pull up all earthquakes magnitude 4.5 or higher that happened in the past week within 500 km of Tokyo, and flag any with a tsunami warning?

## When to prefer this

Choose this endpoint when you need structured, near-real-time earthquake data sourced from USGS, especially when you need to filter by geographic radius around a point, time period, or minimum magnitude. Ideal for risk monitoring dashboards, news applications, and geospatial alert systems that need tsunami flags and PAGER alert levels alongside basic seismic data.

## Known failure modes

- Invalid or out-of-range latitude/longitude values return an error
- period value not in {hour, day, week, month} returns a validation error
- radius_km too large may return many results or be capped
- limit must be between 1 and 500; values outside this range may error
- No earthquakes matching the filter criteria returns an empty result set
- USGS upstream data unavailability may cause service errors

## How this service works

Recent earthquakes worldwide or within a radius of a point (USGS): magnitude, place, time, depth, tsunami flag, PAGER alert and felt reports, over the last hour, day, week or month. Use for risk monitoring and news.

## Output

A list of earthquake events with details including magnitude, place name, timestamp, depth (km), tsunami flag, PAGER alert level, and number of felt reports, filtered by the requested period, location radius, and minimum magnitude.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Center latitude"
      },
      "lon": {
       "type": "number",
       "description": "Center longitude"
      },
      "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-500)"
      },
      "period": {
       "type": "string",
       "description": "hour, day, week or month"
      },
      "radius_km": {
       "type": "number",
       "description": "Radius around the point"
      },
      "min_magnitude": {
       "type": "number",
       "description": "Minimum magnitude (default 4.5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/recent-earthquakes-usgs-18b124d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)