# Hawaii Conditions Briefing

> Hawaii Conditions Briefing is a paid API for AI agents from hawaii-conditions.vercel.app, paid per call via x402, $2/call, status unknown (last checked 2026-09-16).

Returns a real-time conditions briefing for a specified Hawaiian island, covering weather, surf, ocean safety, volcano status, and sunrise/sunset times.

## Facts

- Endpoint: GET https://hawaii-conditions.vercel.app/gpt/briefing
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hawaii-conditions-briefing-713e2e3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yoWJBU7V034MfWiMxNm-q

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 hawaii-conditions-briefing-713e2e3e
```

Example prompt: What are the current conditions on Maui right now — surf, weather, ocean safety, and any volcanic activity?

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-domain real-time snapshot of Hawaiian island conditions in a single call — especially when surf, ocean safety, volcano status, and weather are all relevant. It aggregates multiple government and commercial data sources (NOAA, USGS, NPS, Open-Meteo, Google Places) so you don't need to call each separately. Prefer this over general weather APIs when Hawaii-specific data like surf ratings, ocean safety flags, or volcanic alerts are required.

## Known failure modes

- Invalid or unrecognized island name returns an error — use values like 'oahu', 'maui', 'kauai', 'big-island'
- Upstream data source (NOAA, USGS, etc.) outage may cause stale or missing fields
- Payment failure (402) if USDC payment is not correctly submitted via x402 protocol
- Rate limiting or server errors if called too frequently

## How this service works

Real-time surf, weather, trails, volcano, ocean safety, and restaurant data for every Hawaiian island. Built for AI agents. Powered by NOAA, USGS, NPS, Open-Meteo and Google Places.

## Output

A structured briefing object containing the island name, a plain-English summary, current weather (temperature, wind speed, conditions), surf data (rating, min/max wave height in feet), ocean safety (flag color, rip current risk level), volcano status (alert level, lava flow hazard boolean), sun times (sunrise and sunset), and a timestamp of when the data was last updated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "island"
 ],
 "properties": {
  "island": {
   "enum": [
    "oahu",
    "maui",
    "kauai",
    "big-island",
    "molokai",
    "lanai"
   ],
   "type": "string",
   "description": "Island name (e.g. oahu, maui, kauai, big-island)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "island",
  "summary",
  "weather",
  "surf",
  "ocean_safety",
  "volcano",
  "sun",
  "updated_at"
 ],
 "properties": {
  "sun": {
   "type": "object",
   "properties": {
    "sunset": {
     "type": "string"
    },
    "sunrise": {
     "type": "string"
    }
   }
  },
  "surf": {
   "type": "object",
   "properties": {
    "rating": {
     "type": "string"
    },
    "wave_height_ft": {
     "type": "object",
     "properties": {
      "max": {
       "type": "number"
      },
      "min": {
       "type": "number"
      }
     }
    }
   }
  },
  "island": {
   "type": "string"
  },
  "summary": {
   "type": "string"
  },
  "volcano": {
   "type": "object",
   "properties": {
    "alert_level": {
     "type": "string"
    },
    "lava_flow_hazard": {
     "type": "boolean"
    }
   }
  },
  "weather": {
   "type": "object",
   "properties": {
    "wind_mph": {
     "type": "number"
    },
    "conditions": {
     "type": "string"
    },
    "temperature_f": {
     "type": "number"
    }
   }
  },
  "updated_at": {
   "type": "string",
   "format": "date-time"
  },
  "ocean_safety": {
   "type": "object",
   "properties": {
    "flag_color": {
     "type": "string"
    },
    "rip_current_risk": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hawaii-conditions-briefing-713e2e3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hawaii-conditions.vercel.app](https://www.zero.xyz/host/hawaii-conditions.vercel.app/llms.txt)