Start building

Open-Meteo Marine Forecast API docs

Open Playground →

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/open-meteo/marine
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/open-meteo/marine" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "daily": "wave_height_max",
  "hourly": "wave_height",
  "current": "wave_height,wave_period",
  "end_date": "2024-01-07",
  "latitude": "54.54",
  "timezone": "Europe/Berlin",
  "longitude": "10.23",
  "past_days": 0,
  "start_date": "2024-01-01",
  "timeformat": "iso8601",
  "length_unit": "metric",
  "forecast_days": 1,
  "cell_selection": "sea"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

latitudestringrequired

WGS84 latitude of the location. Multiple coordinates can be comma-separated.

longitudestringrequired

WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.

cell_selectionstring

Grid-cell preference for the coordinate. Default `sea`.

Default: "sea"

Possible values: land, sea, nearest

currentstring

Comma-separated list of current-condition variables to return. Same variable set as `hourly`.

dailystring

Comma-separated list of daily aggregation variables to return. Requires `timezone`. Common values: `wave_height_max`, `wave_direction_dominant`, `wave_period_max`, `wind_wave_height_max`, `swell_wave_height_max`.

end_datestring

End of the interval, `yyyy-mm-dd` (ISO 8601).

forecast_daysinteger

Number of forecast days to return (0-8). Default 5.

Default: 5

hourlystring

Comma-separated list of hourly variables to return. Common values: `wave_height`, `wave_direction`, `wave_period`, `wind_wave_height`, `wind_wave_direction`, `wind_wave_period`, `swell_wave_height`, `swell_wave_direction`, `swell_wave_period`, `ocean_current_velocity`, `ocean_current_direction`, `se

length_unitstring

Unit for wave heights. Default `metric`.

Default: "metric"

Possible values: metric, imperial

past_daysinteger

Number of past days to include (0-92). Default 0.

Default: 0

start_datestring

Start of the interval, `yyyy-mm-dd` (ISO 8601).

timeformatstring

Time output format. Default `iso8601`.

Default: "iso8601"

Possible values: iso8601, unixtime

timezonestring

IANA time zone name (e.g. `Europe/Berlin`) or `auto` to resolve from coordinates. Defaults to `GMT`.

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.