# ForgeMesh Marine Conditions API

> ForgeMesh Marine Conditions API 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 wave height, and sea surface temperature for any ocean latitude/longitude worldwide as structured JSON

## Facts

- Endpoint: POST https://x402.forgemesh.io/marine-conditions
- 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/forgemesh-marine-conditions-api-c005a7a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BXVQE2oASInJXTX2joLW5

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 forgemesh-marine-conditions-api-c005a7a8 -d '<json body>'
```

Example prompt: What are the current wave conditions out at coordinates 34.05 latitude, -119.25 longitude — specifically wave height, wave period, swell height, and sea surface temperature?

## When to prefer this

Use this endpoint when you need real-time marine conditions — wave height, wave period, swell, and sea surface temperature — for any open-ocean point worldwide. Prefer this over generic weather APIs when the use case is specifically nautical: vessel routing, surf forecasting, offshore operations planning, or ocean science data collection. Not suitable for freshwater bodies or inland points.

## Known failure modes

- Coordinates are inland or far from any ocean — wave/swell fields return null
- Invalid latitude or longitude format causes a validation error
- Coordinates are at the boundary of model coverage and return partial nulls
- Temporary upstream model unavailability returns a 5xx error
- Malformed JSON request body returns a 400 error

## How this service works

Marine conditions API: current wave height, wave period, swell wave height, and sea surface temperature for any ocean latitude/longitude worldwide, as structured JSON from a global marine weather model. Use for shipping, boating, surf forecasting, and offshore-operations agents. Coverage is open water only — points far from any ocean may return null values. Cached 10 minutes.

## Output

A structured JSON object containing current marine conditions at the requested coordinates: wave height, wave period, swell wave height, and sea surface temperature. Open-water points return valid readings; inland or non-ocean coordinates may return null values. Data is cached for 10 minutes from a global marine weather model.

## 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/forgemesh-marine-conditions-api-c005a7a8/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)