# tokenguard Recent Earthquake Lookup

> tokenguard Recent Earthquake Lookup is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches recent USGS earthquake events worldwide or near a named location, returning magnitude, depth, tsunami flag, and felt reports

## Facts

- Endpoint: GET https://eltociear-tokenguard.hf.space/world/earthquakes
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-recent-earthquake-lookup-e5a11d7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dTcxTNNBWAY_rmdxvB6hJ

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 tokenguard-recent-earthquake-lookup-e5a11d7e
```

Example prompt: Can you pull up any earthquakes from the past 3 days within 400 km of Tokyo with a magnitude of at least 4.5, and flag any that triggered a tsunami warning?

## When to prefer this

Use this endpoint when you need structured, near-real-time earthquake data enriched with tsunami flags and felt reports, especially when filtering by a named geographic place rather than raw coordinates. Prefer it over generic news APIs when you need quantitative seismic attributes (magnitude, depth) rather than narrative coverage.

## Known failure modes

- Location name cannot be geocoded — returns error or falls back to global search
- Radius too small for the region yields zero results
- Days parameter out of 1-30 range returns validation error
- Limit exceeding 100 is rejected
- USGS data feed temporarily unavailable returns upstream error

## How this service works

Which earthquakes have just happened? Recent USGS events worldwide or within a radius of a named place, with magnitude, depth, tsunami flag and felt reports

## Output

A list of recent earthquake events from USGS data, each including magnitude, depth, geographic coordinates, tsunami flag, and felt report counts, filtered by the specified time window, location, radius, and magnitude threshold.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "description": "1-30 days back (default 1)"
  },
  "limit": {
   "type": "integer",
   "description": "1-100 events (default 20)"
  },
  "location": {
   "type": "string",
   "description": "Centre the search on a place name"
  },
  "radius_km": {
   "type": "number",
   "description": "Radius around location (default 500)"
  },
  "min_magnitude": {
   "type": "number",
   "description": "Lower magnitude bound (default 4.5)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 7,
  "count": 2,
  "centre": "Tokyo, Japan",
  "earthquakes": [
   {
    "time": "2026-07-27T11:02:14Z",
    "place": "off the east coast of Honshu, Japan",
    "tsunami": false,
    "depth_km": 42,
    "magnitude": 6.1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-recent-earthquake-lookup-e5a11d7e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)