# Sea State by Coordinates

> Sea State by Coordinates is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns current wave height, wave period, swell height, and sea surface temperature for any open-ocean latitude/longitude as structured JSON.

## Facts

- Endpoint: POST https://x402.forgemesh.io/sea-state-by-coordinates
- 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/sea-state-by-coordinates-ea0eef52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_36Pbm7htD90WqiGiHiXTw

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 sea-state-by-coordinates-ea0eef52 -d '<json body>'
```

Example prompt: What are the current wave height, wave period, swell height, and sea surface temperature at latitude 36.5, longitude -122.8 in the open Pacific?

## When to prefer this

Use this endpoint when you need real-time open-ocean sea state data — wave height, period, swell, and SST — at a specific coordinate for route planning, offshore work-window assessment, or sailing/surf condition checks. Prefer this over general weather APIs when marine-specific parameters (wave period, swell, SST) are required rather than just wind or precipitation.

## Known failure modes

- Point is inland or near-coast and outside model coverage — no data returned
- Invalid or missing latitude/longitude — input validation error
- Coordinates are on land rather than open water — model returns no coverage
- Payment failure or x402 authentication issue — request rejected
- Temporary upstream model data unavailability — service error

## How this service works

Current sea state at any latitude/longitude over open water — wave height, wave period, swell height, and sea surface temperature — as structured JSON. Use for route planning, offshore work-window checks, and surf or sailing condition agents. Inland and near-coast points may return no data if outside model coverage.

## Output

A structured JSON object containing current sea state metrics at the requested coordinates: significant wave height, dominant wave period, swell wave height, and sea surface temperature. May return no data if the point is inland or outside model coverage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "latitude": {
   "type": "string",
   "description": "Latitude, e.g. 40.71"
  },
  "longitude": {
   "type": "string",
   "description": "Longitude, e.g. -74.00"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "current": {
    "time": "2026-07-16T08:30",
    "wave_height": 0.12,
    "wave_period": 8.2,
    "swell_wave_height": 0.08,
    "sea_surface_temperature": 23.6
   },
   "current_units": {
    "wave_height": "m",
    "wave_period": "s",
    "sea_surface_temperature": "°C"
   }
  },
  "attribution": "Open-Meteo.com (CC BY 4.0)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sea-state-by-coordinates-ea0eef52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)