Open-Meteo Marine

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/marine?latitude=52.52&longitude=13.41' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/openmeteo/marine', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/marine",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/openmeteo/marine"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/openmeteo/marine")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

GET

https://api.aisa.one

apis

openmeteo

marine

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/marine?latitude=52.52&longitude=13.41' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/openmeteo/marine', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/marine",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/openmeteo/marine"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/openmeteo/marine")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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

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: per call, metered per request. Current prices are on aisa.one/api. 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.

Request contract

Method and path: GET /apis/v1/openmeteo/marine
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/openmeteo/marine
cell_selection: query; optional
current: query; optional
daily: query; optional
end_date: query; optional
forecast_days: query; optional
hourly: query; optional
latitude: query; required
length_unit: query; optional
longitude: query; required
past_days: query; optional
start_date: query; optional
timeformat: query; optional
timezone: query; optional
Runtime facts: sha256:36f55c225a89aa6e29290270a8eeed85c6f6224160884d7fa3a086ea2ad602ef

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_openmeteo_marine",
  "method": "GET",
  "path": "/apis/v1/openmeteo/marine",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Grid-cell preference for the coordinate. Default `sea`.",
      "in": "query",
      "name": "cell_selection",
      "required": false,
      "schema": {
        "default": "sea",
        "enum": [
          "land",
          "sea",
          "nearest"
        ],
        "type": "string"
      }
    },
    {
      "description": "Comma-separated list of current-condition variables to return. Same variable set as `hourly`.",
      "in": "query",
      "name": "current",
      "required": false,
      "schema": {
        "example": "wave_height,wave_period",
        "type": "string"
      }
    },
    {
      "description": "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`.",
      "in": "query",
      "name": "daily",
      "required": false,
      "schema": {
        "example": "wave_height_max",
        "type": "string"
      }
    },
    {
      "description": "End of the interval, `yyyy-mm-dd` (ISO 8601).",
      "in": "query",
      "name": "end_date",
      "required": false,
      "schema": {
        "example": "2024-01-07",
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Number of forecast days to return (0-8). Default 5.",
      "in": "query",
      "name": "forecast_days",
      "required": false,
      "schema": {
        "default": 5,
        "example": 7,
        "type": "integer"
      }
    },
    {
      "description": "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`.",
      "in": "query",
      "name": "hourly",
      "required": false,
      "schema": {
        "example": "wave_height,wave_direction,wave_period",
        "type": "string"
      }
    },
    {
      "description": "WGS84 latitude of the location. Multiple coordinates can be comma-separated.",
      "in": "query",
      "name": "latitude",
      "required": true,
      "schema": {
        "example": "52.52",
        "type": "string"
      }
    },
    {
      "description": "Unit for wave heights. Default `metric`.",
      "in": "query",
      "name": "length_unit",
      "required": false,
      "schema": {
        "default": "metric",
        "enum": [
          "metric",
          "imperial"
        ],
        "type": "string"
      }
    },
    {
      "description": "WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.",
      "in": "query",
      "name": "longitude",
      "required": true,
      "schema": {
        "example": "13.41",
        "type": "string"
      }
    },
    {
      "description": "Number of past days to include (0-92). Default 0.",
      "in": "query",
      "name": "past_days",
      "required": false,
      "schema": {
        "default": 0,
        "type": "integer"
      }
    },
    {
      "description": "Start of the interval, `yyyy-mm-dd` (ISO 8601).",
      "in": "query",
      "name": "start_date",
      "required": false,
      "schema": {
        "example": "2024-01-01",
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Time output format. Default `iso8601`.",
      "in": "query",
      "name": "timeformat",
      "required": false,
      "schema": {
        "default": "iso8601",
        "enum": [
          "iso8601",
          "unixtime"
        ],
        "type": "string"
      }
    },
    {
      "description": "IANA time zone name (e.g. `Europe/Berlin`) or `auto` to resolve from coordinates. Defaults to `GMT`.",
      "in": "query",
      "name": "timezone",
      "required": false,
      "schema": {
        "example": "Europe/Berlin",
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.0001,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.0001
Cost contract: fixed_success
Settlement evidence source: request_snapshot

Authorizations

Authorization

string

header

required

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

Query Parameters

cell_selection

enum<string>

default:sea

Grid-cell preference for the coordinate. Default sea.

Available options:

land,

sea,

nearest

current

string

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

Example:

"wave_height,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"

end_date

string<date>

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

Example:

"2024-01-07"

forecast_days

integer

default:5

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

Example:

7

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"

latitude

string

required

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

Example:

"52.52"

length_unit

enum<string>

default:metric

Unit for wave heights. Default metric.

Available options:

metric,

imperial

longitude

string

required

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

Example:

"13.41"

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"

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"

Response

Marine forecast for the coordinate.

The response is of type object.

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Open-Meteo Marine

Request contract

Cost and request rules

Authorizations

Query Parameters

Response

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Request contract

Cost and request rules