# Datakoot Earthquake Lookup

> Datakoot Earthquake Lookup is a paid API for AI agents from x402.datakoot.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Retrieves recent earthquakes from USGS filtered by magnitude, time window, and optional geographic radius

## Facts

- Endpoint: POST https://x402.datakoot.com/api/earthquakes?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datakoot-earthquake-lookup-5dd2a672
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sUGoU4oaIiSSNA8YD7SIL

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 datakoot-earthquake-lookup-5dd2a672 -d '<json body>'
```

Example prompt: Show me all earthquakes with magnitude 5.0 or higher that happened within 300 km of Tokyo in the last 10 days.

## When to prefer this

Use this endpoint when you need structured, filterable earthquake data from USGS with geospatial radius search and magnitude thresholds — especially when paying per-call via x402 on Base for programmatic access, or when you need recent seismic events in a specific region rather than manually scraping USGS feeds. Prefer this over raw USGS API when you want a clean JSON response without parsing Atom/GeoJSON feeds yourself.

## Known failure modes

- No earthquakes match the criteria — returns count 0 with empty array
- lat/lon provided without radius_km or vice versa — may return global results or error
- days exceeds 30 maximum — request rejected or capped
- Payment of $0.002 USDC not fulfilled via x402 — 402 response returned before data
- USGS upstream data unavailable — service may return 503 or empty result

## How this service works

48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) for AI agents. $0.002 USDC per call on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at <server>.datakoot.com/mcp.

## Output

Returns a JSON object with count, source attribution (USGS public domain), the query criteria used, and an array of earthquake events each containing magnitude, depth in km, latitude/longitude, human-readable place name, UTC timestamp, and a direct USGS event page URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number",
   "description": "Optional center latitude for a radius search."
  },
  "lon": {
   "type": "number",
   "description": "Optional center longitude for a radius search."
  },
  "days": {
   "type": "integer",
   "default": 7,
   "description": "Look back this many days (default 7, max 30)."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "description": "Maximum number of quakes to return."
  },
  "radius_km": {
   "type": "number",
   "description": "Radius in km around lat/lon (requires lat+lon)."
  },
  "min_magnitude": {
   "type": "number",
   "default": 4.5,
   "description": "Only return quakes at or above this magnitude."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "source": "USGS (public domain)",
  "criteria": {
   "days": 3,
   "min_magnitude": 4.5
  },
  "earthquakes": [
   {
    "lat": 29.221,
    "lon": 130.6125,
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzb5",
    "time": "2026-10-03T06:05:21.157Z",
    "place": "112 km S of Koshima, Japan",
    "depth_km": 37.466,
    "magnitude": 4.8
   },
   {
    "lat": 52.0836,
    "lon": 160.4217,
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tzal",
    "time": "2026-10-03T02:59:06.296Z",
    "place": "163 km SE of Petropavlovsk-Kamchatsky, Russia",
    "depth_km": 10,
    "magnitude": 5
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datakoot-earthquake-lookup-5dd2a672/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.datakoot.com](https://www.zero.xyz/host/x402.datakoot.com/llms.txt)