# USGS Real-Time Earthquake Catalog

> USGS Real-Time Earthquake Catalog is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves global real-time earthquake data from the USGS live seismic catalog, including magnitude, location, and depth.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/usgs-quake
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-real-time-earthquake-catalog-d9664ed7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_004L_bjDeciS68irMY_KO

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-catalog-d9664ed7
```

Example prompt: Pull the latest global earthquake data from the USGS real-time catalog and show me recent seismic events with their magnitudes, locations, and depths.

## When to prefer this

Choose this endpoint when you need immediate, no-registration access to live global earthquake data proxied from USGS, especially in agentic or automated workflows that require micropayment-based access. Prefer over direct USGS API calls when you need a consistent paid-API wrapper compatible with x402 payment flows. Not suitable if you need historical archives, custom time-range filtering, or advanced geospatial queries beyond the basic catalog feed.

## Known failure modes

- USGS upstream source unavailable or rate-limited — proxy may return 502 or timeout
- No recent earthquake events to report — empty result set
- Payment not processed or x402 authentication failure — 402 response
- Malformed request or unsupported HTTP method — 400/405 error

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

Returns structured earthquake event data from the USGS live catalog, including each event's magnitude, geographic location (latitude/longitude, region name), depth in kilometers, and event timestamp. Typically returns the most recent seismic events globally as a list of records.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "bbox": [
    -93.1385,
    -93.1385
   ],
   "type": "FeatureCollection",
   "features": [
    {
     "id": "us7000t1bu",
     "type": "Feature",
     "geometry": {
      "type": "Point",
      "coordinates": [
       -92.8969,
       -92.8969
      ]
     },
     "properties": {
      "tz": null,
      "cdi": 7.4,
      "gap": 51,
      "ids": ",attibqh8,us7000t1bu,usauto7000t1bu,",
      "mag": 7.3,
      "mmi": 7.027,
      "net": "us",
      "nst": 249,
      "rms": 1.09,
      "sig": 1032,
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000t1bu",
      "code": "7000t1bu",
      "dmin": 3.109,
      "felt": 287,
      "time": 1784299720227,
      "type": "earthquake",
      "alert": "yellow",
      "place": "52 km W of Puerto Madero, Mexico",
      "title": "M 7.3 - 52 km W of Puerto Madero, Mexico",
      "types": ",dyfi,finite-fault,general-text,ground-failure,internal-moment-tensor,losspager,moment-tensor,origin,phase-data,shakemap",
      "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us7000t1bu&format=geojson",
      "status": "reviewed",
      "magType": "mww",
      "sources": ",at,us,usauto,",
      "tsunami": 0,
      "updated": 1785178940562
     }
    },
    {
     "id": "us7000t1bu",
     "type": "Feature",
     "geometry": {
      "type": "Point",
      "coordinates": [
       -92.8969,
       -92.8969
      ]
     },
     "properties": {
      "tz": null,
      "cdi": 7.4,
      "gap": 51,
      "ids": ",attibqh8,us7000t1bu,usauto7000t1bu,",
      "mag": 7.3,
      "mmi": 7.027,
      "net": "us",
      "nst": 249,
      "rms": 1.09,
      "sig": 1032,
      "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000t1bu",
      "code": "7000t1bu",
      "dmin": 3.109,
      "felt": 287,
      "time": 1784299720227,
      "type": "earthquake",
      "alert": "yellow",
      "place": "52 km W of Puerto Madero, Mexico",
      "title": "M 7.3 - 52 km W of Puerto Madero, Mexico",
      "types": ",dyfi,finite-fault,general-text,ground-failure,internal-moment-tensor,losspager,moment-tensor,origin,phase-data,shakemap",
      "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us7000t1bu&format=geojson",
      "status": "reviewed",
      "magType": "mww",
      "sources": ",at,us,usauto,",
      "tsunami": 0,
      "updated": 1785178940562
     }
    }
   ],
   "metadata": {
    "api": "2.7.0",
    "url": "https://earthquake.usgs.gov/fdsnw
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-real-time-earthquake-catalog-d9664ed7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)