# USGS Earthquake Event Lookup

> USGS Earthquake Event Lookup is a paid API for AI agents from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Resolves a single USGS earthquake event ID into its current factual record from the USGS Earthquake Catalog, including event metadata and seismic network attribution.

## Facts

- Endpoint: POST https://foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/v2/official/usgs-earthquake-event
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usgs-earthquake-event-lookup-9ea02b26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WqOz871RfHTSYYIT5jhD8

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-event-lookup-9ea02b26 -d '<json body>'
```

Example prompt: Can you pull the USGS earthquake catalog record for event ID us7000m9g4 and tell me what it says about location, magnitude, and the contributing seismic network?

## When to prefer this

Use this endpoint when you have a specific USGS earthquake event ID and need to resolve it to a full catalog record. Prefer this over the list/search earthquake endpoint when you already know the exact event identifier. It provides authoritative USGS public-domain data with provenance tracking, making it suitable for compliance, reporting, and research workflows where source attribution matters.

## Known failure modes

- Invalid or malformed event_id (must be 5-40 alphanumeric characters) returns a validation error
- Unknown or non-existent event ID returns an empty normalizedResult array
- USGS upstream unavailability may result in stale or failed retrieval
- Payment not completed via x402 USDC results in 402 response before data is returned

## How this service works

Pay-per-request evidence and data tools: CSV validation and reconciliation, DNS/email configuration evidence, and bounded official weather, earthquake, vehicle, company and study records. Exact USDC prices, explicit JSON contracts and source provenance. No mailbox, ownership, medical or safety guarantees.

## Output

A JSON object containing the queried event ID, source attribution to the USGS Earthquake Catalog, freshness/cache metadata (retrieval timestamp, cache age, max cache seconds), provenance details (license, terms URL, upstream call count, documentation URL), and a normalizedResult array with the earthquake event fields. Includes observedAt timestamp and sourceUrl pointing to earthquake.usgs.gov.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "event_id": {
   "type": "string",
   "pattern": "^[a-zA-Z0-9]{5,40}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "route": "usgs-earthquake-event",
  "result": {
   "query": {
    "event_id": "us7000m9g4"
   },
   "source": "USGS Earthquake Catalog",
   "freshness": {
    "state": "CURRENT_RETRIEVAL",
    "retrievedAt": "2026-09-06T00:00:00Z",
    "cacheAgeSeconds": 0,
    "maximumCacheSeconds": 30,
    "recordAgeIsNotRetrievalAge": true
   },
   "sourceUrl": "https://earthquake.usgs.gov",
   "observedAt": "2026-09-06T00:00:00Z",
   "provenance": {
    "license": "US public-domain earthquake facts; no third-party media",
    "termsUrl": "https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits",
    "truncated": false,
    "attribution": "US Geological Survey and the contributing seismic network identified in each record",
    "limitations": [
     "Synthetic example only; identifiers and null values illustrate fields, not a live observation."
    ],
    "modifications": "Selected factual fields, normalized names and bounded result count; no source ownership claimed.",
    "upstreamCalls": 1,
    "documentationUrl": "https://earthquake.usgs.gov/fdsnws/event/1/"
   },
   "sourceUpdatedAt": null,
   "normalizedResult": [
    {
     "id": "illustrative-record",
     "place": null,
     "status": null,
     "network": null,
     "eventTime": null,
     "magnitude": null,
     "sourceUrl": null,
     "updatedAt": null,
     "coordinates": null
    }
   ],
   "sourceProcessedAt": null,
   "rawSourceIdentifiers": []
  },
  "observed_at": "2026-09-06T00:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usgs-earthquake-event-lookup-9ea02b26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev](https://www.zero.xyz/host/foundry-par007-machine-revenue-mainnet.inference-chip-index.workers.dev/llms.txt)