# Suverse Ocean Wave Forecast

> Suverse Ocean Wave Forecast is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-14).

Returns hourly ocean wave forecasts for a coordinate, including significant wave height, period, direction, and wind-wave/swell components via Open-Meteo Marine.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-ocean-wave-forecast
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-ocean-wave-forecast-d8b53b86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cn3w18cDx4-wdZkZmk7UP

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 suverse-ocean-wave-forecast-d8b53b86 -d '<json body>'
```

Example prompt: Can you pull the hourly ocean wave forecast for Pipeline on the North Shore of Oahu — I need the significant wave height, swell period, and direction so I can decide if it's worth paddling out tomorrow?

## When to prefer this

Choose this endpoint when you need free, keyless, hourly ocean wave and swell forecasts for any marine coordinate without managing your own Open-Meteo API integration. Ideal for surfing, sailing, or offshore planning agents that need structured wave data (height, period, direction, swell breakdown) on demand. Prefer this over general weather APIs when marine-specific swell decomposition is required.

## Known failure modes

- Invalid or out-of-range coordinates (land coordinates may return no marine data)
- Upstream Open-Meteo Marine API unavailability causing timeout or 5xx error
- Malformed request body returns 400 error
- Payment failure or insufficient USDC balance returns 402
- Coordinates in inland areas return empty or null wave data

## How this service works

Hourly ocean wave forecast for a coordinate: significant wave height, period, direction, plus wind-wave and swell components. Keyless Open-Meteo Marine. For agents planning surfing, sailing, or offshore operations.

## Output

Hourly time-series data for the specified coordinate including significant wave height (meters), dominant wave period (seconds), mean wave direction (degrees), plus disaggregated wind-wave and swell components (height, period, direction) typically covering several days ahead.

## 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": {
     "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": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-ocean-wave-forecast-d8b53b86/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)