# Natur Halowerk Earthquake Sequence Clustering

> Natur Halowerk Earthquake Sequence Clustering is a paid API for AI agents from natur.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Clusters earthquake events close in space and time into sequences using single-link clustering, returning the strongest event, preceding and following events, duration, spatial extent, magnitude range, and daily event rate.

## Facts

- Endpoint: POST https://natur.halowerk.com/v1/quake-sequence
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/natur-halowerk-earthquake-sequence-clustering-c798375b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Us6coaXOF_wDXe6JuCxLi

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 natur-halowerk-earthquake-sequence-clustering-c798375b -d '<json body>'
```

Example prompt: Cluster these recent California earthquakes into sequences using a distance threshold of 50 km and a time window of 7 days, and tell me the strongest event, how many came before and after it, the magnitude range, and the daily rate for each sequence.

## When to prefer this

Choose this endpoint when you need to group raw earthquake event data into meaningful temporal-spatial sequences and characterize each cluster by its strongest event, event ordering, duration, and rate. It is preferable over a single-event lookup when you need swarm or sequence-level analysis rather than individual event detail, and over generic clustering tools when you specifically need seismological output fields like before_strongest/after_strongest, spatial extent, and daily rate.

## Known failure modes

- Insufficient events provided to form meaningful clusters
- Distance or time thresholds too tight — no sequences formed
- Invalid or missing threshold parameters
- Malformed event data causing parsing errors
- Events with missing magnitude or coordinate data excluded silently

## How this service works

Clusters earthquakes that are close in space and time into sequences, using a single-link approach with an explicit distance and time threshold that both appear in the result. For each sequence you get the strongest event, the events that preceded it and those that followed, the duration, the spatial extent, the magnitude range and the rate of events per day. The naming is deliberate: the fields are before_strongest and after_strongest, not foreshocks and aftershocks.

## Output

Returns one or more earthquake sequences, each containing: the strongest event in the sequence, the list of events that occurred before the strongest (before_strongest) and after it (after_strongest), the total sequence duration, the spatial extent in kilometers, the magnitude range from smallest to largest, and the rate of events per day. Distance and time thresholds used for clustering are also reflected in the result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "lon": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  },
  "days": {
   "type": "integer",
   "default": 30,
   "maximum": 365,
   "minimum": 1
  },
  "radius_km": {
   "type": "number",
   "default": 200,
   "maximum": 1500,
   "minimum": 10
  },
  "cluster_km": {
   "type": "number",
   "default": 50,
   "maximum": 200,
   "minimum": 5,
   "description": "Events closer than this and within cluster_hours are joined."
  },
  "cluster_hours": {
   "type": "integer",
   "default": 72,
   "maximum": 720,
   "minimum": 1
  },
  "min_magnitude": {
   "type": "number",
   "default": 2.5,
   "maximum": 8,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/natur-halowerk-earthquake-sequence-clustering-c798375b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from natur.halowerk.com](https://www.zero.xyz/host/natur.halowerk.com/llms.txt)
