# USGS Recent Earthquakes Feed

> USGS Recent Earthquakes Feed is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Returns recent worldwide earthquake data from USGS including magnitude, location, depth, and tsunami flag, filterable by time period and minimum magnitude.

## Facts

- Endpoint: POST https://twin.unykorn.org/geo/earthquakes?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-recent-earthquakes-feed-24395936
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_--PaFt_9TZKwzj52-_xk9

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-24395936 -d '<json body>'
```

Example prompt: Pull the last 100 earthquakes from the past week with a minimum magnitude of 2.5 and tell me which ones had a tsunami flag set.

## When to prefer this

Choose this endpoint when you need structured, filterable earthquake data directly sourced from USGS with control over time window, magnitude threshold, and result count. Prefer this over raw USGS feeds when you want a clean JSON response with tsunami flags and no parsing overhead, and when you need pay-per-call access without managing API keys.

## Known failure modes

- Invalid enum value for period or min_magnitude returns a validation error
- Limit exceeding 200 returns an error
- USGS upstream unavailability may cause timeout or empty response
- Malformed request body returns 400-level error
- x402 payment failure prevents API access

## How this service works

Recent earthquakes worldwide (USGS): magnitude, place, depth, tsunami flag — Genesis402 / UnyKorn Operator Network

## Output

A list of recent earthquake records from USGS, each containing the earthquake's magnitude, human-readable place name, depth (in km), and a tsunami flag indicating whether a tsunami warning was issued. Results are bounded by the specified period, magnitude threshold, and row limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "limit": {
     "type": "integer",
     "maximum": 200,
     "minimum": 1,
     "description": "optional: max rows (default 25, max 200)"
    },
    "period": {
     "enum": [
      "hour",
      "day",
      "week",
      "month"
     ],
     "type": "string",
     "description": "optional: hour | day (default) | week | month"
    },
    "min_magnitude": {
     "enum": [
      "significant",
      "4.5",
      "2.5",
      "1.0",
      "all"
     ],
     "type": "string",
     "description": "optional: significant | 4.5 (default) | 2.5 | 1.0 | all"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-recent-earthquakes-feed-24395936/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)