# USGS Recent Earthquakes Feed

> USGS Recent Earthquakes Feed is a paid API for AI agents from x402-seller.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns significant earthquakes worldwide from the past 7 days, sourced from USGS, filtered by minimum magnitude and result count.

## Facts

- Endpoint: GET https://x402-seller.onrender.com/earthquakes/recent
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-recent-earthquakes-feed-9c4f8eaf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d58Sjbdi41NVhe5zY0_pe

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-9c4f8eaf
```

Example prompt: Show me the 20 most recent significant earthquakes worldwide from the past 7 days, only include ones magnitude 5.0 or higher.

## When to prefer this

Use this endpoint when you need a quick, up-to-date global list of recent significant earthquakes sourced authoritatively from USGS, with simple filtering by magnitude and count. Prefer this over general web search when you need structured seismic data rather than news articles.

## Known failure modes

- Invalid minmagnitude value (non-numeric string) may return an error or empty results
- limit exceeding 50 will be capped or rejected
- USGS upstream unavailable may cause 5xx or empty data
- No earthquakes matching the magnitude filter in the past 7 days returns an empty list

## How this service works

Check for recent significant earthquakes, quakes, or seismic activity anywhere in the world, from the past 7 days, sourced from USGS (US Geological Survey). Answers questions like "was there an earthquake near me", "how strong was the recent quake in X", or "list major earthquakes this week". Optional 'minmagnitude' filters by minimum magnitude (default 4.5), and 'limit' caps the number of results (default 10, max 50).

## Output

Returns a JSON object containing the count of results, the source (USGS), and an array of earthquake records — each including magnitude, location, date/time, and other seismic details — filtered to the requested minimum magnitude and limited to the requested number of results.

## 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",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Max number of results (max 50)"
      },
      "minmagnitude": {
       "type": "string",
       "description": "Minimum earthquake magnitude"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "source": {
       "type": "string"
      },
      "earthquakes": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## More

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