Mediterranean marine weather API for AI agents
Get the sea state before committing a boat, a crew or a port operation: this endpoint returns an hourly marine forecast - wave height, direction and period, wind waves and swell - from Open-Meteo Marine wave models (ECMWF, MeteoFrance, DWD; CC-BY 4.0), up to 7 days ahead in UTC. Twelve named presets sit just off the harbour mouth of Mediterranean ports (marseille, toulon, nice, cannes, ajaccio, bastia, calvi, porto-vecchio, genoa, barcelona, palma, naples), or pass any latitude/longitude. A summary block gives the max wave height over the next 24 hours and over the full horizon.
It is built for autonomous agents: no account, no API key - the agent pays $0.005 per forecast in USDC. If the point resolves to land and no wave data exists, the call fails and is never billed.
Endpoint
GET /v1/sea/state — $0.005 per call (USDC on Base, x402).
Parameters
| Param | Description |
|---|---|
port | Preset Mediterranean port name, e.g. marseille, ajaccio, genoa (optional) |
latitude | Marine point latitude (if no port given) |
longitude | Marine point longitude (if no port given) |
days | Forecast days 1-7 (default 2) |
Example
curl -i "https://data.greeneris.io/v1/sea/state?port=marseille&days=2"
# HTTP/1.1 402 Payment Required + machine-readable quote
# (any x402 client pays the quote and retries automatically)Response after payment:
{"ok": true, "data": {"location": {"latitude": 43.25, "longitude": 5.375, "port": "marseille"}, "summary": {"max_wave_height_m_24h": 0.62, "max_wave_height_m_all": 0.88, "first_hours_wave_m": [0.38, 0.4, 0.44, 0.5, 0.54, 0.58]}, "hourly_units": {"wave_height": "m", "wave_period": "s", "wave_direction": "\u00b0"}, "forecast_days": 2, "source": "Open-Meteo Marine (wave models ECMWF/MeteoFrance/DWD, CC-BY 4.0)"}}What agents use it for
- Sailing go/no-go: gate a charter or crossing on max wave height over the next 24h
- Port operations: schedule pilot boarding, bunkering or diving work in calm windows
- Route planning: compare sea state across several ports before picking a landing
How payment works
Call the endpoint: you get HTTP 402 with a signed quote (price, receiving address, network). Your agent pays a few tenths of a cent in USDC on Base (gasless, EIP-3009) and retries - one round trip, no account, no API key. Settlement only happens after a successful answer. Full catalog: llms.txt.