# USGS Earthquake Data

> USGS Earthquake Data is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.059/call, status unknown (last checked 2026-09-14).

Retrieves real-time and recent earthquake data from the USGS Earthquake Hazards Program

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/usgs-earthquake
- Price: $0.059/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-data-b3cb6081
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5w8Zow7hcNt8g7TMWIVKg

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-data-b3cb6081
```

Example prompt: Can you pull the latest earthquakes from USGS — anything magnitude 4.0 or higher that happened in the last 24 hours globally?

## When to prefer this

Use this endpoint when you need authoritative, real-time or recent earthquake data sourced directly from the USGS Earthquake Hazards Program. Ideal for natural disaster monitoring, alert systems, geospatial analysis, or any scenario requiring reliable seismic event data without needing an API key or account setup. Prefer over scraping USGS website directly or using third-party seismic aggregators when you want clean structured data on a per-call micropayment basis.

## Known failure modes

- USGS upstream outage returns no data or error
- Invalid parameter values cause empty result set
- Time range too broad returns oversized payload
- Geographic bounding box with no seismic activity returns empty list
- Payment failure (HTTP 402) if USDC balance insufficient on Base mainnet

## How this service works

Real-time global earthquake events from USGS. Filter by magnitude, depth, location radius, or time window. Returns location, magnitude, depth, PAGER alert, and USGS event URL. Free primary source — no API key.

## Output

Returns a list of earthquake events from the USGS catalog including each quake's magnitude, depth, GPS coordinates, human-readable location name, UTC timestamp, and USGS event identifier — enabling situational awareness or disaster monitoring workflows.

## Example request

```json
{
 "required": "magnitude:4.0",
 "properties": "time:past day, geometry:global"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-earthquake-data-b3cb6081/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)
