# x402 DataShop Sea State Forecast

> x402 DataShop Sea State Forecast is a paid API for AI agents from x402-datashop-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns hourly sea-state forecasts (wave height, direction, period, wind waves, swell) for Mediterranean ports or any lat/lon, up to 7 days ahead.

## Facts

- Endpoint: GET https://x402-datashop-production.up.railway.app/v1/sea/state
- 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/x402-datashop-sea-state-forecast-59d2e108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h3TkEVZ4-U8hHzz67gtwy

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 x402-datashop-sea-state-forecast-59d2e108
```

Example prompt: Can you pull the sea-state forecast for Marseille for the next 3 days — I need wave height, swell direction, and the maximum wave height in the next 24 hours to decide whether to depart tomorrow?

## When to prefer this

Use this endpoint when you need structured, hourly marine wave and swell forecasts for Mediterranean sailing, port operations, or routing decisions. It is ideal when you need a named preset port (e.g. marseille, ajaccio, nice, genoa) or a specific lat/lon marine coordinate, with a concise summary of maximum wave conditions. Prefer this over generic weather endpoints when wave period, swell direction, or go/no-go sailing data is explicitly needed.

## Known failure modes

- Invalid port name returns an error — only the 12 preset Mediterranean port names are accepted
- Both port and latitude/longitude omitted results in a missing-parameter error
- days parameter outside range 1–7 returns a validation error
- Payment not included or insufficient USDC balance results in 402 Payment Required
- Upstream Open-Meteo unavailability may cause 502/503 responses

## How this service works

Hourly sea-state forecast from Open-Meteo Marine wave models: wave height/direction/period, wind waves and swell, up to 7 days, UTC. Query: ?port=marseille|ajaccio|nice|... (12 Mediterranean presets) or ?latitude=43.3&longitude=5.4, plus ?days=1-7 (default 2). Includes a summary block (max wave height next 24h / full horizon). 1h cache. For sailing go/no-go, port ops and routing.

## Output

Hourly sea-state data for the requested location covering wave height, direction, period, wind wave components, and swell, over the requested number of days (1–7). Also includes a summary block with the maximum wave height over the next 24 hours and over the full forecast horizon. Data is sourced from Open-Meteo marine models, cached for 1 hour, in UTC timestamps.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "integer",
       "default": 2,
       "description": "Forecast days 1-7"
      },
      "port": {
       "type": "string",
       "description": "Preset Mediterranean port name (e.g. marseille, ajaccio, genoa)"
      },
      "latitude": {
       "type": "number",
       "description": "Marine point latitude (if no port given)"
      },
      "longitude": {
       "type": "number",
       "description": "Marine point longitude (if no port given)"
      }
     }
    }
   },
   "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/x402-datashop-sea-state-forecast-59d2e108/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-datashop-production.up.railway.app](https://www.zero.xyz/host/x402-datashop-production.up.railway.app/llms.txt)