# Hawaii Conditions – Real-time Surf Report

> Hawaii Conditions – Real-time Surf Report is a paid API for AI agents from hawaii-conditions.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Returns real-time surf conditions for a specified Hawaiian island, including wave height, swell direction and period, wind, and a surf quality rating.

## Facts

- Endpoint: GET https://hawaii-conditions.vercel.app/gpt/surf
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hawaii-conditions-real-time-surf-report-e57519b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dtMipldiRu90PvBp1_7XR

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-real-time-surf-report-e57519b3
```

Example prompt: What are the current surf conditions on Maui — wave height, swell direction, and is it rated as a good day to surf?

## When to prefer this

Use this endpoint when you need real-time, structured surf condition data for a specific Hawaiian island — including wave height, swell, wind, and a surf quality rating — and want a single low-cost per-call API rather than scraping surf forecast websites. Prefer it over generic weather APIs when ocean-specific metrics like swell period and surf rating are required for Hawaii.

## Known failure modes

- Invalid or unsupported island name returns a validation error
- Data source (NOAA/Open-Meteo) outage may result in stale or missing data
- Rate limiting or payment failure (x402) if USDC payment is not completed
- Network timeout if the upstream data provider is slow to respond

## 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 JSON object containing the island name, min/max wave height in feet, swell direction (compass bearing or cardinal), swell period in seconds, wind description, a human-readable surf quality rating (e.g. 'good', 'fair', 'poor'), and an ISO 8601 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",
  "wave_height_ft",
  "swell_direction",
  "swell_period_s",
  "wind",
  "rating",
  "updated_at"
 ],
 "properties": {
  "wind": {
   "type": "string"
  },
  "island": {
   "type": "string"
  },
  "rating": {
   "type": "string"
  },
  "updated_at": {
   "type": "string",
   "format": "date-time"
  },
  "swell_period_s": {
   "type": "number"
  },
  "wave_height_ft": {
   "type": "object",
   "required": [
    "min",
    "max"
   ],
   "properties": {
    "max": {
     "type": "number"
    },
    "min": {
     "type": "number"
    }
   }
  },
  "swell_direction": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hawaii-conditions-real-time-surf-report-e57519b3/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)