# USGS Recent Earthquake Feed

> USGS Recent Earthquake Feed is a paid API for AI agents from eltociear-skill-audit.hf.space, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns recent USGS earthquake events worldwide or near a named location, including magnitude, depth, tsunami flag, and felt reports

## Facts

- Endpoint: POST https://eltociear-skill-audit.hf.space/world/earthquakes
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-recent-earthquake-feed-255f7d2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TxlNPDL-DAxQZ-p2FF2I4

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-earthquake-feed-255f7d2f -d '<json body>'
```

Example prompt: What earthquakes of magnitude 4.5 or higher happened in the last 3 days near Istanbul, within 300 km — include any tsunami flags and felt reports?

## When to prefer this

Choose this endpoint when you need near-real-time USGS earthquake data filtered by geography, recency, and magnitude. It is ideal for disaster monitoring, safety checks near a named city or region, or generating seismic briefings. Prefer it over static geological databases when freshness (events within the last 30 days) and felt-report data matter. It covers global events and supports place-name-based radius queries without requiring the caller to supply coordinates.

## Known failure modes

- Location name not recognized or geocodable — returns error or falls back to global search
- days parameter out of range (>30) — returns validation error
- radius_km too large may return noisy global results
- USGS data feed temporarily unavailable — upstream timeout
- No events match the filter criteria — returns empty list
- limit exceeded (>100) — clamped or rejected

## How this service works

Which earthquakes have just happened? Recent USGS events worldwide or within a radius of a named place, with magnitude, depth, tsunami flag and felt reports

## Output

A list of recent earthquake events from USGS data, each including event time, location name, latitude/longitude, magnitude, depth in kilometers, tsunami flag (boolean), and number of felt reports. Results are filtered by the requested time window, geographic center and radius, magnitude threshold, and capped at the requested event limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "description": "1-30 days back (default 1)"
  },
  "limit": {
   "type": "integer",
   "description": "1-100 events (default 20)"
  },
  "location": {
   "type": "string",
   "description": "Centre the search on a place name"
  },
  "radius_km": {
   "type": "number",
   "description": "Radius around location (default 500)"
  },
  "min_magnitude": {
   "type": "number",
   "description": "Lower magnitude bound (default 4.5)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 7,
  "count": 2,
  "centre": "Tokyo, Japan",
  "earthquakes": [
   {
    "time": "2026-07-27T11:02:14Z",
    "place": "off the east coast of Honshu, Japan",
    "tsunami": false,
    "depth_km": 42,
    "magnitude": 6.1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-recent-earthquake-feed-255f7d2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-skill-audit.hf.space](https://www.zero.xyz/host/eltociear-skill-audit.hf.space/llms.txt)