# US Volcano Alert Levels API

> US Volcano Alert Levels API 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 all US volcanoes currently at elevated alert levels or aviation color codes, with alert level, color code, notice type, and issue time as normalized JSON.

## Facts

- Endpoint: POST https://x402.forgemesh.io/volcano-alert-levels
- 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-alert-levels-api-ac3adc33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VZkU7mylfgyNJDZNRbnlR

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-alert-levels-api-ac3adc33 -d '<json body>'
```

Example prompt: Can you check which US volcanoes are currently at elevated alert levels or aviation color codes — including Alaska, Hawaii, the Cascades, Yellowstone, and the Mariana Islands — and give me a summary of the current hazard status for each?

## When to prefer this

Use this endpoint when you need a consolidated, normalized view of all currently elevated US volcano hazard statuses across all major US observatory regions in a single call. Prefer this over manually polling USGS pages or region-specific feeds when building hazard dashboards, aviation risk tools, or travel safety agents that need machine-readable volcano alert data without scraping.

## Known failure modes

- No elevated volcanoes at time of call — returns empty array or zero-result response
- Upstream observatory data feed unavailable — may return stale or error response
- Payment failure — returns 402 if USDC micropayment not processed
- Request body malformed — returns 400 if input object is missing or invalid

## How this service works

Current volcano alert levels API: every US volcano currently at an elevated alert level or aviation color code (Alaska, Hawaii, Cascades, Yellowstone, Mariana Islands) — alert level, color code, notice type, and issue time — as normalized JSON. Built for hazard-monitoring dashboards and travel/aviation risk agents.

## Output

A normalized JSON array of all US volcanoes currently at elevated alert or aviation color code status, each entry including the volcano name, alert level (e.g. WATCH, ADVISORY, WARNING), aviation color code (e.g. ORANGE, RED), notice type, issue time, and observatory region.

## 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-alert-levels-api-ac3adc33/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)