# 2s.io Recent Earthquakes Near Coordinate

> 2s.io Recent Earthquakes Near Coordinate is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns recent earthquakes near a given lat/lon, including magnitude, depth, tsunami flag, and distance from query point, sourced from USGS FDSN in real time.

## Facts

- Endpoint: GET https://2s.io/api/quakes/recent
- 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/2s-io-e6526a98
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K0s3a8eJ_2LyhN6p8L8dP

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 2s-io-e6526a98
```

Example prompt: Are there any magnitude 2.5 or higher earthquakes within 300 km of Mexico City in the last 72 hours? Include tsunami flags and how far each one was from the city center.

## When to prefer this

Use this endpoint when you need real-time, post-training-cutoff seismic data near a specific geographic point — especially when the freshness of USGS data matters or when you need structured per-event detail like depth, tsunami flag, and distance. Prefer over general web search when you need structured machine-readable earthquake records.

## Known failure modes

- Missing required lat or lon parameters returns a 400 error
- lat out of range (-90..90) or lon out of range (-180..180) returns validation error
- radius_km outside 1-1000 or hours outside 1-720 returns validation error
- No earthquakes matching criteria returns an empty list (not an error)
- USGS upstream API unavailability may cause 502 or timeout
- Payment not attached or insufficient USDC balance returns 402

## How this service works

Recent earthquakes near a coordinate. Returns each quake with magnitude, place name, time (ISO), latitude/longitude/depth, tsunami flag, USGS event URL, and distance-from-query in km — sorted by time descending. Real-time data, post-LLM-training-cutoff. Backed by USGS FDSN event API (public domain). Query: lat (-90..90), lon (-180..180), radius_km (1-1000, default 500), hours (1-720, default 24), min_magnitude (0-10, default 2.0).

## Output

A list of recent earthquake events sorted by time descending, each containing: magnitude, human-readable place name, ISO timestamp, latitude/longitude/depth, tsunami flag (0/1), USGS event URL, and distance from the queried coordinate in km.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "lat": 37.7749,
   "lon": -122.4194,
   "hours": 24,
   "radius_km": 200,
   "min_magnitude": 2
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180
      },
      "hours": {
       "type": "number",
       "default": 24,
       "maximum": 720,
       "minimum": 1
      },
      "radius_km": {
       "type": "number",
       "default": 500,
       "maximum": 1000,
       "minimum": 1
      },
      "min_magnitude": {
       "type": "number",
       "default": 2,
       "maximum": 10,
       "minimum": 0
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-e6526a98/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)
