Marine Weather

Wave height/direction/period, ocean currents and sea-surface temperature forecast.

GET https://api.aisa.one/apis/v1/openmeteo/marine

Marine Weather

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/openmeteo/marine \
  --header 'Authorization: Bearer <token>'

200

{
  "latitude": 54.5,
  "longitude": 10.25,
  "generationtime_ms": 0.2,
  "utc_offset_seconds": 0,
  "timezone": "GMT",
  "hourly_units": {
    "time": "iso8601",
    "wave_height": "m",
    "wave_direction": "°",
    "wave_period": "s"
  },
  "hourly": {
    "time": [
      "2024-01-01T00:00"
    ],
    "wave_height": [
      0.6
    ],
    "wave_direction": [
      212
    ],
    "wave_period": [
      4.1
    ]
  }
}

Fetch a marine and ocean-wave forecast for a coastal or open-ocean coordinate. Request variables with hourly, daily and/or current lists — e.g. wave_height, wave_direction, wave_period, the wind_wave_* and swell_wave_* families, ocean_current_velocity/ocean_current_direction, and sea_surface_temperature. Use length_unit=imperial for feet, and forecast_days (up to 8) / past_days for the horizon.

The response returns grid-cell metadata and the requested resolution blocks, each with a time array, one array per variable, and a matching *_units object.

Example: GET /apis/v1/openmeteo/marine?latitude=54.54&longitude=10.23&hourly=wave_height,wave_direction,wave_period&daily=wave_height_max&forecast_days=7&timezone=Europe/Berlin.

Billing: $0.00015 per call (150 micros USD), metered per request. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

latitude · string · required

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

Example:

"52.52"

longitude · string · required

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

Example:

"13.41"

hourly · string

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, sea_surface_temperature.

Example:

"wave_height,wave_direction,wave_period"

daily · string

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.

Example:

"wave_height_max"

current · string

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

Example:

"wave_height,wave_period"

forecast_days · integer · default: 5

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

Example:

7

past_days · integer · default: 0

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

start_date · string<date>

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

Example:

"2024-01-01"

end_date · string<date>

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

Example:

"2024-01-07"

length_unit · enum<string> · default: metric

Unit for wave heights. Default metric.

Available options: metric, imperial

timeformat · enum<string> · default: iso8601

Time output format. Default iso8601.

Available options: iso8601, unixtime

timezone · string

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

Example:

"Europe/Berlin"

cell_selection · enum<string> · default: sea

Grid-cell preference for the coordinate. Default sea.

Available options: land, sea, nearest

Response

200 - application/json

Marine forecast for the coordinate.

The response is of type object.