# Earthquake Radius Search API

> Earthquake Radius Search API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns all earthquakes above a minimum magnitude within a specified radius of a given latitude/longitude, sourced from the official government seismic real-time catalog, as normalized JSON.

## Facts

- Endpoint: POST https://x402.forgemesh.io/earthquake-radius-search
- 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/earthquake-radius-search-api-732d9434
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PCsN3ABzFCVQ9nYuIj7G1

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 earthquake-radius-search-api-732d9434 -d '<json body>'
```

Example prompt: Are there any earthquakes above magnitude 2.5 within 100 km of San Francisco (37.77, -122.42) in the recent seismic catalog?

## When to prefer this

Use this endpoint when you need site-specific seismic risk data for a precise location — such as a facility, property, or asset — rather than a broad global or regional earthquake feed. It is ideal for point-in-time risk checks, insurance assessments, or logistics routing where you need magnitude, depth, and tsunami flags for a defined geographic radius.

## Known failure modes

- Invalid or out-of-range latitude/longitude values result in an error or empty response
- Radius too large may return excessive results or timeout
- No earthquakes above minimum magnitude in the specified radius returns an empty array
- Invalid magnitude threshold (non-numeric or negative) causes a request error
- Payment failure (insufficient USDC) blocks the request

## How this service works

Earthquake radius search API: every earthquake above a minimum magnitude within a given radius of any latitude/longitude, from the official government seismic real-time seismic catalog — magnitude, depth, location, time, and tsunami flag — as normalized JSON. Built for site-specific risk checks (a facility, a shipment, a property) rather than a global feed.

## Output

A normalized JSON array of earthquake events matching the search criteria, each containing magnitude, depth, geographic location, timestamp, and a tsunami flag, sourced from the official government real-time seismic catalog.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "string",
   "description": "Latitude of the search center, e.g. 37.77"
  },
  "longitude": {
   "type": "string",
   "description": "Longitude of the search center, e.g. -122.42"
  },
  "radius_km": {
   "type": "string",
   "description": "Search radius in kilometers, default 100"
  },
  "min_magnitude": {
   "type": "string",
   "description": "Minimum magnitude, default 2.5"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "type": "FeatureCollection",
   "features": [
    {
     "properties": {
      "mag": 2.56,
      "place": "1 km NNW of Angwin, CA",
      "tsunami": 0
     }
    }
   ]
  },
  "attribution": "U.S. Geological Survey (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/earthquake-radius-search-api-732d9434/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)