# Suverse Marine Wave Forecast

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

Returns hourly marine wave height, direction, and period forecasts for any coastal coordinate for up to 7 days, sourced from Open-Meteo.

## Facts

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

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-marine-wave-forecast-372ba27c -d '<json body>'
```

Example prompt: Can you get me the hourly wave height, direction, and period forecast for the next 7 days at latitude 51.5, longitude 1.8 — that's off the coast of the Thames Estuary?

## When to prefer this

Choose this endpoint when you need structured hourly marine wave data (height, direction, period) for any coastal or open-ocean coordinate, especially in agentic workflows for shipping, offshore energy, fishing, or coastal risk assessment. Prefer it over general weather APIs when sea state specifics are required rather than atmospheric conditions.

## Known failure modes

- Invalid or inland coordinates return no data or an error from Open-Meteo
- forecast_days exceeding 7 may be rejected or capped
- Missing required latitude/longitude fields cause a validation error
- Network or upstream Open-Meteo outages result in a 5xx error
- Coordinates with no marine coverage (deep inland) return empty or null wave arrays

## How this service works

Hourly marine wave forecast for any coastal latitude and longitude from Open-Meteo: wave height, direction, and period. For AI agents in shipping, maritime logistics, offshore energy, fishing, and coastal risk needing sea state data.

## Output

Returns a JSON object with hourly arrays of wave height (meters), wave direction (degrees), and wave period (seconds) aligned to ISO 8601 timestamps, plus metadata including resolved latitude, longitude, and timezone. Coverage spans up to 7 days ahead at hourly resolution.

## Example request

```json
{
 "latitude": 0,
 "location": "Pacific Ocean",
 "longitude": 0,
 "forecast_days": 7
}
```

## 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-marine-wave-forecast-372ba27c/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)