# Vextorium Recent Earthquakes (USGS)

> Vextorium Recent Earthquakes (USGS) 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-16).

Returns recent worldwide earthquake data from USGS, filterable by magnitude, time period, and proximity to coordinates, including PAGER alerts, tsunami flags, and felt reports.

## Facts

- Endpoint: POST https://api.vextorium.com/terremotos-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-recent-earthquakes-usgs-fc360370
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qo2VRzZvJZkE5v6m42jUZ

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-recent-earthquakes-usgs-fc360370 -d '<json body>'
```

Example prompt: Show me all earthquakes of magnitude 4.5 or higher from the past day within 1000 km of Tokyo (35.6895° N, 139.6917° E), up to 50 results — including any tsunami warnings and PAGER alerts.

## When to prefer this

Choose this endpoint when you need structured, filterable earthquake data from the authoritative USGS source, especially when proximity filtering (radius around coordinates), PAGER damage alert levels, or tsunami flags are important. Prefer it over raw USGS feeds when you want a clean JSON response with distance calculations, Spanish-language period enums, and a pay-per-call model without API key management.

## Known failure modes

- No earthquakes match the filter criteria — returns empty terremotos array with encontrados: 0
- Invalid period value (not one of hora/dia/semana/mes) — likely returns validation error
- lat/lon provided without radio_km or vice versa may return unfiltered or error results
- limite out of range (must be 1-200) may cause validation failure
- USGS upstream unavailability could cause timeout or empty response
- Very restrictive magnitude + short period combo may yield zero results

## 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: source attribution (USGS), the queried period, total count found, minimum magnitude filter applied, and an array of earthquake events each with magnitude, place name, latitude/longitude, depth in km, UTC timestamp, tsunami boolean, PAGER alert color code, number of felt reports, distance from query coordinates (if provided), and a link to the USGS event page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "limite": {
   "type": "integer",
   "description": "1-200 (default 20)"
  },
  "periodo": {
   "enum": [
    "hora",
    "dia",
    "semana",
    "mes"
   ],
   "type": "string"
  },
  "radio_km": {
   "type": "number"
  },
  "magnitud_min": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": "USGS Earthquake Hazards Program (dominio público)",
  "periodo": "dia",
  "terremotos": [
   {
    "lat": -8.9326,
    "lon": 158.0215,
    "fecha": "2026-10-02T04:44:53+00:00",
    "lugar": "159 km SE of Gizo, Solomon Islands",
    "enlace": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tyzl",
    "tsunami": false,
    "magnitud": 5.1,
    "sentido_por": null,
    "alerta_pager": null,
    "distancia_km": null,
    "profundidad_km": 10
   },
   {
    "lat": -11.6728,
    "lon": 167.0918,
    "fecha": "2026-10-01T20:00:34+00:00",
    "lugar": "176 km SE of Lata, Solomon Islands",
    "enlace": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tyx0",
    "tsunami": false,
    "magnitud": 5.1,
    "sentido_por": null,
    "alerta_pager": null,
    "distancia_km": null,
    "profundidad_km": 10
   },
   {
    "lat": -11.7706,
    "lon": 166.961,
    "fecha": "2026-10-01T19:38:01+00:00",
    "lugar": "171 km SE of Lata, Solomon Islands",
    "enlace": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tywu",
    "tsunami": false,
    "magnitud": 5.1,
    "sentido_por": null,
    "alerta_pager": null,
    "distancia_km": null,
    "profundidad_km": 10
   },
   {
    "lat": 39.8778,
    "lon": 143.1734,
    "fecha": "2026-10-01T17:17:20+00:00",
    "lugar": "108 km ENE of Miyako, Japan",
    "enlace": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tyw6",
    "tsunami": false,
    "magnitud": 5.1,
    "sentido_por": 1,
    "alerta_pager": null,
    "distancia_km": null,
    "profundidad_km": 35
   },
   {
    "lat": -39.1598,
    "lon": 174.2598,
    "fecha": "2026-10-02T13:57:15+00:00",
    "lugar": "6 km E of Inglewood, New Zealand",
    "enlace": "https://earthquake.usgs.gov/earthquakes/eventpage/us6000tz1c",
    "tsunami": false,
    "magnitud": 5,
    "sentido_por": null,
    "alerta_pager": "green",
    "distancia_km": null,
    "profundidad_km": 10
   }
  ],
  "encontrados": 14,
  "magnitud_min": 4.5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-recent-earthquakes-usgs-fc360370/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)