# USGS Earthquake Search by Magnitude

> USGS Earthquake Search by Magnitude is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Search USGS earthquake records by minimum magnitude and optional start time, returning matching seismic events with magnitude, location, timestamp, and coordinates, sorted newest first.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-quakes-search
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-earthquake-search-by-magnitude-df2aef3c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cM40WDLrmQh0xKzSAFRKO

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-earthquake-search-by-magnitude-df2aef3c -d '<json body>'
```

Example prompt: Can you pull all earthquakes with a magnitude of 5.0 or higher that have occurred since January 1, 2025, and show me the location, time, and exact magnitude for each one?

## When to prefer this

Choose this endpoint when you need on-demand, keyless access to USGS earthquake data filtered by minimum magnitude and/or start time, especially in agentic workflows where no API key management is desired. Prefer this over direct USGS API calls when operating within an x402 micropayment context or when you need a simple, consistent interface that returns pre-sorted seismic events without additional query complexity.

## Known failure modes

- Invalid or missing minimum magnitude parameter causes request rejection
- Malformed start time format may return no results or an error
- Very low magnitude thresholds may return extremely large result sets
- USGS upstream unavailability may cause degraded or empty responses
- Payment (x402) failure will block access before the query is executed

## How this service works

Search USGS earthquakes by minimum magnitude and optional start time, no key. Returns matching events with magnitude, place, time, and coordinates, newest first. For AI agents querying seismic history on demand.

## Output

Returns a list of matching earthquake events sorted newest first. Each event includes the earthquake's magnitude (numeric), descriptive place name (e.g. '15km NE of Tokyo'), UTC timestamp of the event, and geographic coordinates (latitude and longitude). The response reflects USGS data filtered to the requested minimum magnitude and optional start time.

## 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": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/usgs-earthquake-search-by-magnitude-df2aef3c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)