# SYNTHORA USGS Elevated Volcano Alerts

> SYNTHORA USGS Elevated Volcano Alerts is a paid API for AI agents from usgs-volcano-alerts.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns all US volcanoes currently at elevated alert level, including observatory, volcano name, aviation color code, and alert notice from the USGS HANS public API.

## Facts

- Endpoint: POST https://usgs-volcano-alerts.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-usgs-elevated-volcano-alerts-02101dd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YWDp4Zpq9KgFe5_OrdPDa

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 synthora-usgs-elevated-volcano-alerts-02101dd5 -d '<json body>'
```

Example prompt: Pull the current USGS HANS elevated volcano alerts for all US volcanoes and tell me which ones have a red or orange aviation color code right now.

## When to prefer this

Use this endpoint when you need a single, zero-configuration call to retrieve all currently elevated US volcano alerts in one response, without needing a USGS API key. Prefer it over direct USGS API integration when operating in an agent-to-agent (A2A) micropayment context via x402, or when you need aviation color codes and observatory data combined in one structured response for automated hazard monitoring pipelines.

## Known failure modes

- USGS HANS upstream API unavailable — empty result or error propagated
- No volcanoes currently at elevated alert — result object may be empty (not an error)
- Network timeout to hergertsynthora.com proxy — connection error
- Invalid request body format — POST body must be valid JSON with required input envelope
- x402 payment failure — 402 response if USDC payment not processed correctly

## How this service works

Returns all US volcanoes currently at elevated alert level with observatory, volcano name, color code and alert notice from the USGS HANS public API, keyless. Autonomous aviation, disaster-response, insurance and travel agents consume it for A2A volcanic-hazard monitoring and agent-to-agent risk alerting. Ranking surface: volcano alert API, USGS HANS, volcanic activity, aviation color code, eruption warning.

## Output

A JSON object containing ok: true, a niche identifier ('usgs-volcano-alerts'), and a result object listing all US volcanoes currently at elevated alert level, each with their observatory, volcano name, aviation color code, and alert notice text sourced from the USGS HANS API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "ok": {
      "type": "boolean"
     },
     "type": "object",
     "niche": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "usgs-volcano-alerts",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-usgs-elevated-volcano-alerts-02101dd5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from usgs-volcano-alerts.hergertsynthora.com](https://www.zero.xyz/host/usgs-volcano-alerts.hergertsynthora.com/llms.txt)