# Steward Earthquake Feed (USGS ComCat)

> Steward Earthquake Feed (USGS ComCat) is a paid API for AI agents from pay.brianbooms.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-02).

Returns recent earthquake events from the USGS ComCat feed, filterable by minimum magnitude, geographic circle, and date range.

## Facts

- Endpoint: GET https://pay.brianbooms.com/api/v1/data/earthquakes?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/steward-earthquake-feed-usgs-comcat-62cbf6c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VCTE39L5D8eqSIFaz0wMm

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 steward-earthquake-feed-usgs-comcat-62cbf6c8
```

Example prompt: Pull the last 20 earthquakes of magnitude 4.5 or higher within 500 km of Los Angeles (34.05, -118.24) from September 1 to October 1 2026, and flag any with tsunami warnings.

## When to prefer this

Choose this endpoint when your agent needs structured, filterable earthquake data sourced directly from the authoritative USGS ComCat feed, especially when you need geographic circle filtering, magnitude thresholds, or date-range scoping in a single paid API call without managing USGS API keys. It is well-suited for real-time hazard monitoring, disaster-response pipelines, and geospatial enrichment workflows. Avoid when you need authoritative (non-preliminary) final reviewed data, historical bulk downloads, or raw feed redistribution.

## Known failure modes

- Invalid date format returns a 400 error
- Latitude or longitude out of range causes a 400 error
- maxradiuskm exceeding 20000 may be rejected
- minmagnitude outside 0–10 range may be rejected
- No events matching the filters returns an empty result set
- USGS ComCat upstream outage may cause 502 or timeout
- limit outside 1–100 range may be clamped or rejected

## How this service works

Use when an agent needs recent earthquakes — magnitude, place, time, depth, and tsunami flags from the USGS ComCat feed (US public domain). Filter by minimum magnitude, a lat/lon + radius circle, and a date range. Preliminary data — the response says so. Use permitted: build it into your products and services, paid or free. Raw redistribution of the feed itself is prohibited.

## Output

A list of earthquake events (up to the requested limit) each containing: magnitude, descriptive place name, UTC event time, depth in km, and a tsunami flag. Data is labeled as preliminary per USGS ComCat policy.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max events, 1-100. Default 10."
  },
  "endtime": {
   "type": "string",
   "description": "End date YYYY-MM-DD. Example: 2026-10-01"
  },
  "latitude": {
   "type": "string",
   "description": "Circle center latitude, -90 to 90. Example: 30.27"
  },
  "longitude": {
   "type": "string",
   "description": "Circle center longitude, -180 to 180. Example: -97.74"
  },
  "starttime": {
   "type": "string",
   "description": "Start date YYYY-MM-DD. Example: 2026-09-01"
  },
  "maxradiuskm": {
   "type": "string",
   "description": "Circle radius in km, up to 20000. Example: 500"
  },
  "minmagnitude": {
   "type": "string",
   "description": "Minimum magnitude 0-10. Example: 4.5"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/steward-earthquake-feed-usgs-comcat-62cbf6c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pay.brianbooms.com](https://www.zero.xyz/host/pay.brianbooms.com/llms.txt)