# USGS Earthquake Data via AgentToll

> USGS Earthquake Data via AgentToll is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches recent USGS earthquake data filtered by minimum magnitude and result count limit

## Facts

- Endpoint: POST https://agenttoll.dev/paid/osint/usgs-quake
- 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/usgs-earthquake-data-via-agenttoll-f1b639ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__lekISnguVcKLLytuyRxG

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 usgs-earthquake-data-via-agenttoll-f1b639ee -d '<json body>'
```

Example prompt: Pull the 20 most recent USGS earthquakes with a magnitude of at least 4.5 and show me a summary.

## When to prefer this

Choose this endpoint when you need structured, pay-per-call access to USGS earthquake data without managing your own USGS API integration. It is ideal for AI agents operating on the x402 micropayment protocol (USDC on Base) that need seismic data on demand without subscription overhead. Prefer this over raw USGS API calls when you want a normalized, agent-friendly JSON response with metadata like cache status and generation time.

## Known failure modes

- Invalid min_mag value (non-numeric) returns validation error
- limit exceeding API maximum may return partial results or error
- USGS upstream outage may cause failure or stale cached response
- Missing or malformed JSON body returns 400-level error
- Payment failure via x402 protocol blocks the call

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns a JSON object with a 'data' field containing an array of earthquake event records from USGS, a 'meta' object with count, source name, and generation timestamp, a 'cached' boolean indicating whether the response is from cache, and a 'success' boolean.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "min_mag": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "oneOf": [
    {
     "type": "array"
    },
    {
     "type": "object"
    }
   ]
  },
  "meta": {
   "type": "object",
   "properties": {
    "count": {
     "type": "integer"
    },
    "source": {
     "type": "string"
    },
    "generated_at": {
     "type": "string",
     "format": "date-time"
    }
   }
  },
  "cached": {
   "type": "boolean"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-earthquake-data-via-agenttoll-f1b639ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)