# SALT19 USGS Earthquake Feed

> SALT19 USGS Earthquake Feed is a paid API for AI agents from api.salt19.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieves recent USGS earthquake events filtered by time window, count limit, and minimum magnitude

## Facts

- Endpoint: POST https://api.salt19.com/v1/usgs-earthquakes
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/salt19-usgs-earthquake-feed-78f5a940
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qnUyai6PcAH-wU_YscFD7

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 salt19-usgs-earthquake-feed-78f5a940 -d '<json body>'
```

Example prompt: Pull the last 48 hours of USGS earthquake data, give me up to 25 events, and only show ones with a magnitude of 3.5 or higher.

## When to prefer this

Choose this endpoint when you need a pay-per-call, agent-friendly USGS earthquake feed with built-in filtering by recency, count, and magnitude — ideal for AI agents that want structured JSON output without setting up direct USGS API access or managing rate limits. Prefer this over direct USGS GeoJSON feeds when operating inside an x402 micropayment workflow.

## Known failure modes

- Invalid hours value outside 1–168 range returns validation error
- Limit exceeding 50 or below 1 returns validation error
- min_magnitude outside 0–10 returns validation error
- USGS upstream data unavailability may cause timeout or empty response
- Malformed POST body returns 400 bad request

## How this service works

Query recent USGS earthquake events by lookback window and minimum magnitude and return compact live event state.

## Output

A JSON object containing a count of matching events and an array of earthquake records, each with a UTC timestamp, a human-readable place description, and a numeric magnitude value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hours": {
   "type": "integer",
   "maximum": 168,
   "minimum": 1
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "min_magnitude": {
   "type": "number",
   "maximum": 10,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "events": [
   {
    "time": "2026-08-28T12:00:00.000Z",
    "place": "example",
    "magnitude": 3.1
   }
  ]
 }
}
```

## More

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