usgs-earthquakes

Query recent USGS earthquake events by lookback window and minimum magnitude and return compact live event state.

Price: $0.01 USDC equivalent
Endpoint: POST /v1/usgs-earthquakes
Network: Base mainnet · eip155:8453
Asset: USDC
MCP tool: usgs-earthquakes
External payability: PASS · 2026-10-08T19:55:01.298Z

When an agent should use it

recent USGS earthquakes
fresh earthquake feed for an agent
live seismic events without API credentials

Input schema

{
  "type": "object",
  "properties": {
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 168
    },
    "min_magnitude": {
      "type": "number",
      "minimum": 0,
      "maximum": 10
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [],
  "additionalProperties": false
}

Example request

{
  "hours": 24,
  "min_magnitude": 2.5,
  "limit": 20
}

Example output

{
  "count": 1,
  "events": [
    {
      "magnitude": 3.1,
      "place": "example",
      "time": "2026-08-28T12:00:00.000Z"
    }
  ]
}

x402 flow

POST /v1/usgs-earthquakes
→ HTTP 402 + PAYMENT-REQUIRED
→ buyer authorizes locally
→ retry same request with PAYMENT-SIGNATURE
→ one governed execution + machine-readable JSON

Discovery: OpenAPI · x402 · llms.txt

A valid 402/payability probe is operational evidence, not proof of independent demand, future settlement, or semantic correctness.