# USGS Earthquake Feed

> USGS Earthquake Feed is a paid API for AI agents from agent402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns real-time USGS earthquake data including magnitude, location, depth, and coordinates for a specified time period and minimum magnitude threshold.

## Facts

- Endpoint: GET https://agent402.tools/api/earthquakes?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-earthquake-feed-d24ce08a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_45jL4UN2NT--4g7sIcN8s

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-feed-d24ce08a
```

Example prompt: What earthquakes of magnitude 4.5 or higher happened in the past day? Give me their location, depth, and exact time.

## When to prefer this

Use this endpoint when you need real-time, authoritative earthquake data from the US government (USGS) without requiring an API key. It is ideal for monitoring seismic activity, alerting workflows, or enriching geospatial applications with live earthquake feeds. It covers global earthquakes and is the authoritative source for US geological events.

## Known failure modes

- Invalid minMag value returns an error or empty results
- Invalid period value returns an error
- USGS upstream feed outage causes failure or stale data
- No earthquakes matching the filter criteria returns an empty result set

## How this service works

Real-time USGS earthquake feed: magnitude, place, time, depth, coordinates. Live government data, no key.

## Output

A JSON array of earthquake events from the USGS feed, each containing magnitude, place name, timestamp, depth, and geographic coordinates (latitude/longitude). Results are filtered by the specified minimum magnitude and time period.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "minMag": "4.5",
   "period": "day"
  }
 }
}
```

## 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": {
       "type": "string",
       "description": "significant, 4.5, 2.5, 1.0, or all (default 4.5)"
      },
      "period": {
       "type": "string",
       "description": "hour, day, week, or month (default day)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "count",
      "quakes"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "quakes": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "lat": {
          "type": "number"
         },
         "lon": {
          "type": "number"
         },
         "mag": {
          "type": "number"
         },
         "url": {
          "type": "string"
         },
         "time": {
          "type": "string"
         },
         "place": {
          "type": "string"
         },
         "depthKm": {
          "type": "integer"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 6,
  "quakes": [
   {
    "lat": -16.9,
    "lon": -173.9,
    "mag": 5.2,
    "url": "https://earthquake.usgs.gov/…",
    "time": "2026-06-12T03:14:00.000Z",
    "place": "120 km SSE of Hihifo, Tonga",
    "depthKm": 10
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-earthquake-feed-d24ce08a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)