# Vextorium Earthquake Search API

> Vextorium Earthquake Search API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-15).

Returns recent earthquake events near a given location from USGS, filtered by time period, radius, and minimum magnitude.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/earthquakes?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-earthquake-search-api-e7a021fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G-hpwPGQU0nALIdq9utag

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 vextorium-earthquake-search-api-e7a021fb -d '<json body>'
```

Example prompt: Show me all earthquakes of magnitude 4.5 or higher within 200 km of Tokyo (lat 35.6762, lon 139.6503) over the past week, up to 50 results.

## When to prefer this

Use this endpoint when you need structured, queryable earthquake data filtered by geography, time, and magnitude — especially when USGS attribution is required or when building geospatial safety, monitoring, or research workflows. Prefer this over scraping USGS directly since it handles the query formatting, parsing, and filtering, and charges only $0.003 per call via x402.

## Known failure modes

- No earthquakes found matching filters — returns empty array with found:0
- Invalid lat/lon values outside valid ranges may produce unexpected results
- Very large radius or long period with low magnitude threshold may hit result limit (max 200)
- USGS upstream service unavailable — API may return error or empty response
- Invalid period enum value causes request rejection

## How this service works

Recent earthquakes worldwide from the USGS: magnitude, place, depth, time, PAGER damage alert, tsunami flag and felt reports; filter by minimum magnitude, period (hour to month) and distance to coordinates.

## Output

A JSON object containing the number of earthquakes found, the queried time period, the data source attribution (USGS), the minimum magnitude filter applied, and an array of earthquake events each with latitude, longitude, ISO date, magnitude, depth in km, place name, tsunami flag, PAGER alert level, direction from query point, distance in km, and a link to the USGS event page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "limit": {
   "type": "integer",
   "description": "1-200 (default 20)"
  },
  "period": {
   "enum": [
    "hour",
    "day",
    "week",
    "month"
   ],
   "type": "string"
  },
  "radio_km": {
   "type": "number"
  },
  "min_magnitude": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "found": 14,
  "period": "day",
  "source": "USGS Earthquake Hazards Program (public domain)",
  "earthquakes": [
   {
    "lat": -8.9326,
    "lon": 158.0215,
    "date": "2026-10-02T04:44:53+00:00",
    "link": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tyzl",
    "place": "159 km SE of Gizo, Solomon Islands",
    "tsunami": false,
    "depth_km": 10,
    "magnitude": 5.1,
    "distance_km": null,
    "pager_alert": null,
    "direction_by": null
   },
   {
    "lat": -11.6728,
    "lon": 167.0918,
    "date": "2026-10-01T20:00:34+00:00",
    "link": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tyx0",
    "place": "176 km SE of Lata, Solomon Islands",
    "tsunami": false,
    "depth_km": 10,
    "magnitude": 5.1,
    "distance_km": null,
    "pager_alert": null,
    "direction_by": null
   }
  ],
  "min_magnitude": 4.5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-earthquake-search-api-e7a021fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)