# SYNTHORA USGS Earthquake Event Query

> SYNTHORA USGS Earthquake Event Query is a paid API for AI agents from usgs-earthquake-events.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Queries the USGS FDSN earthquake catalog and returns recent seismic events as GeoJSON, filtered by time window and minimum magnitude.

## Facts

- Endpoint: POST https://usgs-earthquake-events.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-usgs-earthquake-event-query-1351fab4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lLw0uxisaLvKyLdx6FAeQ

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 synthora-usgs-earthquake-event-query-1351fab4 -d '<json body>'
```

Example prompt: Pull all earthquakes of magnitude 5.0 or greater from the USGS catalog for the past 7 days — give me up to 50 events with their location, depth, and magnitude.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call access to USGS earthquake catalog data without managing USGS API authentication or rate limits yourself. It is ideal for autonomous agents, A2A pipelines, and polling loops in disaster-response, insurance-risk, or infrastructure-monitoring workflows that need structured GeoJSON-ready earthquake data ranked by magnitude within a specific time window.

## Known failure modes

- Invalid or malformed date strings for starttime/endtime return an error response
- No earthquakes matching the filters return a result with count 0 and empty array
- Upstream USGS FDSN service outage causes failed or delayed responses
- Extremely broad time windows or low magnitude thresholds may hit result limits or time out
- Non-integer minmagnitude or limit values may cause schema validation errors

## How this service works

Returns seismic events as GeoJSON from the USGS FDSN service (earthquake.usgs.gov/fdsnws/event/1/query): magnitude, place, time, depth and coordinates filtered by time window and minimum magnitude. Autonomous agents and agent-to-agent (A2A) disaster-response, insurance-risk and infrastructure-monitoring systems poll it for recent quakes. Ranking surface: region/time to magnitude-ranked events. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns a JSON object with a success flag, a count of matching events, and an array of earthquake records each containing event ID, Unix timestamp, depth in km, place name, latitude, longitude, and magnitude. Provenance metadata (source URL and label) is included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "limit"
  },
  "endtime": {
   "type": "string",
   "description": "endtime"
  },
  "starttime": {
   "type": "string",
   "description": "starttime"
  },
  "minmagnitude": {
   "type": "integer",
   "description": "minmagnitude"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "usgs-earthquake-events",
  "result": {
   "count": 1,
   "earthquakes": [
    {
     "id": "us6000pgy5",
     "time": 1735766861595,
     "depth": 10,
     "place": "southern Mid-Atlantic Ridge",
     "latitude": -42.4343,
     "longitude": -16.0574,
     "magnitude": 5.2
    }
   ]
  },
  "provenance": {
   "url": "https://earthquake.usgs.gov/fdsnws/event/1/query",
   "source": "USGS Earthquake Event Query"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-usgs-earthquake-event-query-1351fab4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from usgs-earthquake-events.hergertsynthora.com](https://www.zero.xyz/host/usgs-earthquake-events.hergertsynthora.com/llms.txt)