# SYNTHORA USGS Earthquake Advanced Query

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

Queries USGS FDSN event service for earthquake data filtered by time range, magnitude, depth, and bounding box, returning results as GeoJSON

## Facts

- Endpoint: POST https://usgs-earthquake-query.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-advanced-query-e9f5fe1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y7tChFTLRYiz6iuh3UNBl

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-advanced-query-e9f5fe1c -d '<json body>'
```

Example prompt: Pull all earthquakes magnitude 4.5 or greater from January 1 to January 31 2024 in GeoJSON format so I can run a seismic risk assessment.

## When to prefer this

Choose this endpoint when you need richly filtered earthquake data beyond what a static RSS or Atom feed provides — specifically when filtering by magnitude threshold, custom time windows, or spatial bounding boxes is required. It is ideal for autonomous agents doing seismic risk scoring, insurance underwriting, infrastructure hazard analysis, or research pipelines that need machine-readable GeoJSON rather than human-readable feeds. Prefer this over the standard USGS public feed when programmatic, parameterized access with per-call pricing is acceptable.

## Known failure modes

- Invalid or missing starttime/endtime causes query rejection
- Magnitude value out of accepted USGS range returns empty or error result
- Overly broad time range or low magnitude threshold may time out or return excessively large payloads
- Malformed format parameter causes response format error
- Network or upstream USGS FDSN service downtime yields a failed or empty result

## How this service works

Returns detailed earthquake events as GeoJSON filtered by time range, magnitude, depth and bounding box from the USGS FDSN event service, keyless — far richer than a fixed feed. Autonomous seismic-risk, insurance, infrastructure and research agents consume it for A2A quake analytics and agent-to-agent hazard scoring. Ranking surface: earthquake API, USGS FDSN, seismic query, magnitude filter, quake GeoJSON.

## Output

Returns a GeoJSON FeatureCollection of earthquake events matching the query filters, where each feature includes event geometry (longitude, latitude, depth), magnitude, event time, place description, and USGS event ID. The response envelope wraps this in an ok/result structure.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "format": {
   "type": "string",
   "description": "format"
  },
  "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-query",
  "result": {}
 }
}
```

## More

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