# opendata402 Earthquake Feed

> opendata402 Earthquake Feed is a paid API for AI agents from opendata402.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-15).

Returns recent worldwide earthquake data from USGS real-time feeds, filterable by time window and minimum magnitude class

## Facts

- Endpoint: GET https://opendata402.com/v1/earthquakes?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/opendata402-earthquake-feed-a81d0231
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o9dIgdBmvO7p6YBIgRg0a

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 opendata402-earthquake-feed-a81d0231
```

Example prompt: Pull the latest earthquake data from the past week for events magnitude 4.5 or above — I want to see the time, location, depth, magnitude, and whether any triggered a tsunami alert.

## When to prefer this

Use this endpoint when you need structured, filterable real-time earthquake data sourced directly from USGS feeds without building a USGS API integration yourself. It is ideal for agents doing hazard monitoring, travel safety checks, logistics routing around disaster zones, or providing news context. Prefer this over raw USGS GeoJSON feeds when you want a simple pay-per-call REST interface with no API key setup. Not suitable for historical earthquake archives beyond one month or for highly localized bounding-box queries.

## Known failure modes

- Invalid minmag enum value — returns error; must be one of: significant, 4.5, 2.5, 1.0, all
- Invalid period enum value — returns error; must be one of: hour, day, week, month
- No earthquakes matching filter criteria — returns empty list (not an error)
- USGS upstream feed temporarily unavailable — may return stale or error response
- Payment failure or insufficient USDC balance — request rejected before reaching endpoint

## How this service works

Recent earthquakes worldwide from the USGS real-time feeds: time, magnitude, place, depth, coordinates, tsunami flag and alert level. Filter by period (hour, day, week, month) and minimum magnitude class (significant, 4.5, 2.5, 1.0, all). Use it for hazard monitoring, travel or logistics checks and news context. Updated every few minutes.

## Output

A list of recent earthquake events from USGS real-time feeds, each including timestamp, magnitude, place description, depth (km), geographic coordinates (latitude/longitude), tsunami flag (0 or 1), and alert level (green/yellow/orange/red or null). Results reflect the filtered time period and magnitude class requested, updated every few minutes.

## 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",
     "properties": {
      "minmag": {
       "enum": [
        "significant",
        "4.5",
        "2.5",
        "1.0",
        "all"
       ],
       "type": "string",
       "description": "Magnitude class (default 4.5)."
      },
      "period": {
       "enum": [
        "hour",
        "day",
        "week",
        "month"
       ],
       "type": "string",
       "description": "Time window (default day)."
      }
     }
    }
   },
   "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/opendata402-earthquake-feed-a81d0231/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)