# AgentsToolsHub Recent Earthquakes (USGS)

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

Returns recent earthquake data from USGS filtered by region (city or lat/lon + radius), minimum magnitude, and time window — including count, largest event, and a magnitude/place/depth table with links.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/live/earthquakes?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstoolshub-recent-earthquakes-usgs-692e6d81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mOoBAPEdBraK5oiITA99e

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 agentstoolshub-recent-earthquakes-usgs-692e6d81
```

Example prompt: Can you pull the latest USGS earthquake data for within 150km of San Francisco over the past 7 days, and show me everything above magnitude 3 — including the biggest quake and a table of events with depth and location?

## When to prefer this

Use this endpoint when an agent needs verified, live seismic data from USGS filtered by geographic region and magnitude — especially when fabricated or cached data would be unacceptable. Prefer this over general web search when structured tabular output (magnitude, depth, place, links) is required, or when programmatic filtering by radius and minimum magnitude is needed.

## Known failure modes

- No earthquakes matching the filters returns an empty result set
- Invalid or unrecognized city name may fail to resolve to coordinates
- Missing both city and lat/lon parameters causes a validation error
- Very large radius or long time window may return a large result set or time out
- USGS upstream outage causes data unavailability

## How this service works

Recent earthquakes from USGS: filter by region (city or coordinates + radius), minimum magnitude and look-back window. Returns count, the largest event and a magnitude/place/depth table with links — live geophysical data agents cannot fabricate. Use this when an agent needs to recent quakes by region and magnitude from USGS.

## Output

Returns the total count of matching earthquakes, details of the single largest event (magnitude, place, depth), and a table of all matching events with magnitude, place name, depth, and a link to the USGS event page — all sourced live from USGS.

## 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": {
      "lat": {
       "type": "number",
       "description": "Latitude"
      },
      "lon": {
       "type": "number",
       "description": "Longitude"
      },
      "city": {
       "type": "string",
       "description": "Optional — or lat/lon"
      },
      "days": {
       "type": "number",
       "description": "Look-back (days)"
      },
      "radiusKm": {
       "type": "number",
       "description": "Radius (km)"
      },
      "minMagnitude": {
       "type": "number",
       "description": "Min magnitude"
      }
     }
    }
   },
   "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/agentstoolshub-recent-earthquakes-usgs-692e6d81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)