# Vibesprings Marine Forecast API

> Vibesprings Marine Forecast API is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns high-resolution daily marine weather projections including wave heights, wave periods, wave directions, and swell data for coastal or open ocean locations up to 7 days ahead.

## Facts

- Endpoint: GET https://vibesprings.net/api/marine
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibesprings-net-b1618e7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GhOez3GbrPJJ8f67C1Cuw

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 vibesprings-net-b1618e7c
```

Example prompt: Can you pull the marine wave forecast for Malibu for the next 5 days — I need wave heights, swell heights, wave periods, and directions so I can plan a surf trip?

## When to prefer this

Choose this endpoint when you need structured daily marine forecast data — wave heights, swell heights, wave periods, and directions — for coastal cities or open ocean coordinates. It is purpose-built for marine use cases (surfing, shipping, offshore construction, coastal intelligence) and returns richer ocean-specific metrics than a general weather API. Prefer it over generic weather endpoints when wave period, swell separation, or directional ocean data is required.

## Known failure modes

- Unknown or ambiguous location name returns an error or empty forecast
- Days parameter outside 1-7 range may be rejected or clamped
- Open ocean coordinates outside data coverage may return no results
- Payment failure (402) if x402 USDC payment is not processed
- Network timeout if processing exceeds expected latency

## How this service works

Marine meteorological and oceanographic conditions database. Access high-resolution daily projections for wave heights (max, wind waves, swells), wave directions, ocean wave periods, and dominant sea surface swells for coastal or open ocean locations. Critical for shipping route optimization, marine construction, surfing forecasting, and coastal geointelligence.

## Output

Returns a JSON object with a per-day forecast array covering: maximum wave height (meters), maximum wave period (seconds), wave direction (degrees), maximum wind wave height (meters), and maximum swell wave height (meters). Also includes resolved latitude, longitude, timezone, location name, and processing time.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "days": 5,
   "location": "Malibu"
  }
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "location"
     ],
     "properties": {
      "days": {
       "type": "number",
       "description": "Forecast length in days, ranging from 1 to 7 days (default is 3)"
      },
      "location": {
       "type": "string",
       "description": "Coastal city name or open ocean coordinates (e.g. 'Sydney', 'Malibu', '-33.8688,151.2093')"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "forecast": [
   {
    "date": "2026-05-24",
    "wave_height_max_m": 1.8,
    "wave_period_max_s": 8.5,
    "wave_direction_deg": 145,
    "wind_wave_height_max_m": 0.8,
    "swell_wave_height_max_m": 1.2
   }
  ],
  "latitude": -33.8,
  "location": "Sydney, Australia",
  "timezone": "Australia/Sydney",
  "longitude": 151.2,
  "forecast_days": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibesprings-net-b1618e7c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibesprings.net](https://www.zero.xyz/host/vibesprings.net/llms.txt)