# US Volcano Hazard Status Monitor

> US Volcano Hazard Status Monitor is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a live snapshot of all US volcanoes currently at elevated hazard status, including alert level, aviation color code, and notice timing for each.

## Facts

- Endpoint: POST https://x402.forgemesh.io/volcano-hazard-status
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-volcano-hazard-status-monitor-7f2695f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MMczj2_tK_c37W4OCWcCY

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 us-volcano-hazard-status-monitor-7f2695f8 -d '<json body>'
```

Example prompt: What US volcanoes are currently at an elevated hazard level right now — show me each one's alert level and aviation color code.

## When to prefer this

Use this endpoint when you need a real-time, consolidated snapshot of all elevated US volcano hazard statuses in a single call, especially for risk-monitoring dashboards, aviation route planning, insurance underwriting workflows, or automated hazard-alert agents. Prefer this over scraping individual USGS observatory pages when you need machine-readable structured data with alert levels and color codes in one response.

## Known failure modes

- Payment not included or invalid — 402 response, no data returned
- No elevated volcanoes at time of call — returns empty list (not an error)
- Upstream USGS data temporarily unavailable — may return stale or error response
- Network timeout if observatory data feeds are slow

## How this service works

Live snapshot of elevated volcano hazard status across US observatories — alert level, color code, and notice timing for each volcano currently above normal background activity. For risk-monitoring dashboards, insurance and aviation planning, and hazard-alert agents. Returns an empty list when no volcanoes are elevated.

## Output

A list of US volcanoes currently above normal background activity, each with its alert level (e.g. WARNING, WATCH, ADVISORY), aviation color code (e.g. RED, ORANGE, YELLOW), observatory source, and the timing of the most recent notice. Returns an empty list when no volcanoes are elevated.

## 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",
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "obs_abbr": "avo",
    "color_code": "ORANGE",
    "alert_level": "WATCH",
    "volcano_name": "Great Sitkin"
   }
  ],
  "attribution": "U.S. Geological Survey Volcano Hazards Program / HANS (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-volcano-hazard-status-monitor-7f2695f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)