# USGS Real-Time Earthquake Feed

> USGS Real-Time Earthquake Feed is a paid API for AI agents from api.kadec0.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches recent seismic events from the USGS earthquake catalog, filterable by magnitude, time range, and geographic radius, with tsunami flags.

## Facts

- Endpoint: GET https://api.kadec0.xyz/v1/usgs-quakes
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-real-time-earthquake-feed-5c11c205
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FF6hZww8sgUouZNIne7ix

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-real-time-earthquake-feed-5c11c205
```

Example prompt: What earthquakes of magnitude 4.0 or higher occurred within 300 km of San Francisco over the past 3 days — include any tsunami warnings?

## When to prefer this

Use this endpoint when you need live or recent USGS earthquake data with flexible filtering by magnitude, time, and geography. Prefer this over static datasets when real-time seismic monitoring or event-driven alerting is needed, and over general web search when structured, machine-readable earthquake records are required.

## Known failure modes

- No events found matching filters — returns empty list
- Invalid ISO date format for starttime/endtime — returns 400 error
- latitude/longitude provided without maxradiuskm — radius search ignored or error
- minmagnitude below USGS threshold may return very large result sets
- Service unavailable if USGS upstream feed is down

## How this service works

Real-time earthquake feed. Recent seismic events from USGS with magnitude, location, depth, and tsunami flag, filterable by magnitude, time, and radius.

## Output

A list of recent earthquake events from the USGS catalog, each with magnitude, location name, coordinates, depth, event timestamp, and a tsunami flag, filtered according to the requested magnitude threshold, time window, and geographic radius.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "string",
       "default": "50"
      },
      "endtime": {
       "type": "string",
       "description": "ISO date/time"
      },
      "latitude": {
       "type": "string",
       "description": "radius search center lat (needs longitude+maxradiuskm)"
      },
      "longitude": {
       "type": "string"
      },
      "starttime": {
       "type": "string",
       "description": "ISO date/time (default: 24h ago)"
      },
      "maxradiuskm": {
       "type": "string"
      },
      "minmagnitude": {
       "type": "string",
       "default": "2.5"
      }
     }
    }
   },
   "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-real-time-earthquake-feed-5c11c205/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kadec0.xyz](https://www.zero.xyz/host/api.kadec0.xyz/llms.txt)