Open-Meteo Marine Weather APIs API

The Marine Weather APIs API from Open-Meteo — 1 operation(s) for marine weather apis.

Operations 1

GET /v1/marine Hourly marine weather forecast

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/open-meteo-marine-weather-apis-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

open-meteo-marine-weather-apis-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Open-Meteo Air Quality Air Quality Marine Weather APIs API
  description: Hourly air quality forecasts for PM2.5, PM10, ozone, nitrogen dioxide, pollen, and other pollutants from the Copernicus Atmosphere Monitoring Service (CAMS).
  version: '1.0'
  contact:
    name: Open-Meteo
    url: https://open-meteo.com
    email: info@open-meteo.com
  license:
    name: Attribution 4.0 International (CC BY 4.0)
    url: https://creativecommons.org/licenses/by/4.0/
  termsOfService: https://open-meteo.com/en/features#terms
servers:
- url: https://api.open-meteo.com
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Marine Weather APIs
paths:
  /v1/marine:
    servers:
    - url: https://marine-api.open-meteo.com
    - url: https://customer-marine-api.open-meteo.com
    get:
      tags:
      - Marine Weather APIs
      summary: Hourly marine weather forecast
      description: Marine weather forecasts with wave conditions, ocean currents, and sea surface temperature.
      parameters:
      - name: latitude
        in: query
        required: true
        schema:
          type: string
      - name: longitude
        in: query
        required: true
        schema:
          type: string
      - name: hourly
        in: query
        description: A list of marine weather variables.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - wave_height
            - wave_direction
            - wave_period
            - wave_peak_period
            - wind_wave_height
            - wind_wave_direction
            - wind_wave_period
            - wind_wave_peak_period
            - swell_wave_height
            - swell_wave_direction
            - swell_wave_period
            - swell_wave_peak_period
            - secondary_swell_wave_height
            - secondary_swell_wave_period
            - secondary_swell_wave_direction
            - tertiary_swell_wave_height
            - tertiary_swell_wave_period
            - tertiary_swell_wave_direction
            - sea_level_height_msl
            - sea_surface_temperature
            - ocean_current_velocity
            - ocean_current_direction
      - name: daily
        in: query
        description: A list of daily marine weather variables.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - wave_height_max
            - wave_direction_dominant
            - wave_period_max
            - wind_wave_height_max
            - wind_wave_direction_dominant
            - wind_wave_period_max
            - wind_wave_peak_period_max
            - swell_wave_height_max
            - swell_wave_direction_dominant
            - swell_wave_period_max
            - swell_wave_peak_period_max
      - name: current
        in: query
        description: A list of variables for the current marine conditions.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - wave_height
            - wave_direction
            - wave_period
            - wind_wave_height
            - wind_wave_direction
            - wind_wave_period
            - wind_wave_peak_period
            - swell_wave_height
            - swell_wave_direction
            - swell_wave_period
            - swell_wave_peak_period
            - sea_surface_temperature
            - ocean_current_velocity
            - ocean_current_direction
      - name: minutely_15
        in: query
        description: A list of marine variables at 15-minute intervals.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - ocean_current_velocity
            - ocean_current_direction
            - sea_level_height_msl
      - name: temperature_unit
        in: query
        schema:
          type: string
          default: celsius
          enum:
          - celsius
          - fahrenheit
      - name: wind_speed_unit
        in: query
        schema:
          type: string
          default: kmh
          enum:
          - kmh
          - ms
          - mph
          - kn
      - name: length_unit
        in: query
        description: Wave height and sea level unit.
        schema:
          type: string
          default: metric
          enum:
          - metric
          - imperial
      - name: timeformat
        in: query
        schema:
          type: string
          default: iso8601
          enum:
          - iso8601
          - unixtime
      - name: timezone
        in: query
        schema:
          type: string
      - name: past_days
        in: query
        schema:
          type: integer
          default: 0
          minimum: 0
          maximum: 92
      - name: forecast_days
        in: query
        schema:
          type: integer
          default: 7
          minimum: 0
          maximum: 16
      - name: start_date
        in: query
        description: Start date in ISO 8601 format.
        schema:
          type: string
          format: date
      - name: end_date
        in: query
        description: End date in ISO 8601 format.
        schema:
          type: string
          format: date
      - name: cell_selection
        in: query
        schema:
          type: string
          enum:
          - land
          - sea
          - nearest
      - name: models
        in: query
        description: Manually select one or more weather models.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - best_match
            - meteofrance_wave
            - meteofrance_currents
            - ewam
            - gwam
            - ecmwf_wam
            - ecmwf_wam025
            - ncep_gfswave025
            - ncep_gfswave016
            - era5_ocean
      - name: apikey
        in: query
        description: Only required for commercial subscriptions.
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  latitude:
                    type: number
                    format: float
                  longitude:
                    type: number
                    format: float
                  elevation:
                    type: number
                    format: float
                  generationtime_ms:
                    type: number
                    format: float
                  utc_offset_seconds:
                    type: integer
                  timezone:
                    type: string
                  timezone_abbreviation:
                    type: string
                  hourly:
                    type: object
                    properties:
                      time:
                        type: array
                        items:
                          type: string
                      wave_height:
                        type: array
                        items:
                          type: number
                          format: float
                      wave_direction:
                        type: array
                        items:
                          type: number
                          format: float
                      wave_period:
                        type: array
                        items:
                          type: number
                          format: float
                      wave_peak_period:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_height:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_direction:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_period:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_peak_period:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_height:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_direction:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_period:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_peak_period:
                        type: array
                        items:
                          type: number
                          format: float
                      secondary_swell_wave_height:
                        type: array
                        items:
                          type: number
                          format: float
                      secondary_swell_wave_period:
                        type: array
                        items:
                          type: number
                          format: float
                      secondary_swell_wave_direction:
                        type: array
                        items:
                          type: number
                          format: float
                      tertiary_swell_wave_height:
                        type: array
                        items:
                          type: number
                          format: float
                      tertiary_swell_wave_period:
                        type: array
                        items:
                          type: number
                          format: float
                      tertiary_swell_wave_direction:
                        type: array
                        items:
                          type: number
                          format: float
                      sea_level_height_msl:
                        type: array
                        items:
                          type: number
                          format: float
                      sea_surface_temperature:
                        type: array
                        items:
                          type: number
                          format: float
                      ocean_current_velocity:
                        type: array
                        items:
                          type: number
                          format: float
                      ocean_current_direction:
                        type: array
                        items:
                          type: number
                          format: float
                  hourly_units:
                    type: object
                    properties:
                      time:
                        type: string
                      wave_height:
                        type: string
                      wave_direction:
                        type: string
                      wave_period:
                        type: string
                      wave_peak_period:
                        type: string
                      wind_wave_height:
                        type: string
                      wind_wave_direction:
                        type: string
                      wind_wave_period:
                        type: string
                      wind_wave_peak_period:
                        type: string
                      swell_wave_height:
                        type: string
                      swell_wave_direction:
                        type: string
                      swell_wave_period:
                        type: string
                      swell_wave_peak_period:
                        type: string
                      secondary_swell_wave_height:
                        type: string
                      secondary_swell_wave_period:
                        type: string
                      secondary_swell_wave_direction:
                        type: string
                      tertiary_swell_wave_height:
                        type: string
                      tertiary_swell_wave_period:
                        type: string
                      tertiary_swell_wave_direction:
                        type: string
                      sea_level_height_msl:
                        type: string
                      sea_surface_temperature:
                        type: string
                      ocean_current_velocity:
                        type: string
                      ocean_current_direction:
                        type: string
                  daily:
                    type: object
                    properties:
                      time:
                        type: array
                        items:
                          type: string
                      wave_height_max:
                        type: array
                        items:
                          type: number
                          format: float
                      wave_direction_dominant:
                        type: array
                        items:
                          type: number
                          format: float
                      wave_period_max:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_height_max:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_direction_dominant:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_period_max:
                        type: array
                        items:
                          type: number
                          format: float
                      wind_wave_peak_period_max:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_height_max:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_direction_dominant:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_period_max:
                        type: array
                        items:
                          type: number
                          format: float
                      swell_wave_peak_period_max:
                        type: array
                        items:
                          type: number
                          format: float
                  daily_units:
                    type: object
                    properties:
                      time:
                        type: string
                      wave_height_max:
                        type: string
                      wave_direction_dominant:
                        type: string
                      wave_period_max:
                        type: string
                      wind_wave_height_max:
                        type: string
                      wind_wave_direction_dominant:
                        type: string
                      wind_wave_period_max:
                        type: string
                      wind_wave_peak_period_max:
                        type: string
                      swell_wave_height_max:
                        type: string
                      swell_wave_direction_dominant:
                        type: string
                      swell_wave_period_max:
                        type: string
                      swell_wave_peak_period_max:
                        type: string
                  current:
                    type: object
                    properties:
                      time:
                        type: string
                      interval:
                        type: integer
                      wave_height:
                        type: number
                        format: float
                      wave_direction:
                        type: number
                        format: float
                      wave_period:
                        type: number
                        format: float
                      wind_wave_height:
                        type: number
                        format: float
                      wind_wave_direction:
                        type: number
                        format: float
                      wind_wave_period:
                        type: number
                        format: float
                      wind_wave_peak_period:
                        type: number
                        format: float
                      swell_wave_height:
                        type: number
                        format: float
                      swell_wave_direction:
                        type: number
                        format: float
                      swell_wave_period:
                        type: number
                        format: float
                      swell_wave_peak_period:
                        type: number
                        format: float
                      sea_surface_temperature:
                        type: number
                        format: float
                      ocean_current_velocity:
                        type: number
                        format: float
                      ocean_current_direction:
                        type: number
                        format: float
                  current_units:
                    type: object
                    properties:
                      time:
                        type: string
                      wave_height:
                        type: string
                      wave_direction:
                        type: string
                      wave_period:
                        type: string
                      wind_wave_height:
                        type: string
                      wind_wave_direction:
                        type: string
                      wind_wave_period:
                        type: string
                      wind_wave_peak_period:
                        type: string
                      swell_wave_height:
                        type: string
                      swell_wave_direction:
                        type: string
                      swell_wave_period:
                        type: string
                      swell_wave_peak_period:
                        type: string
                      sea_surface_temperature:
                        type: string
                      ocean_current_velocity:
                        type: string
                      ocean_current_direction:
                        type: string
                  minutely_15:
                    type: object
                    properties:
                      time:
                        type: array
                        items:
                          type: string
                      ocean_current_velocity:
                        type: array
                        items:
                          type: number
                          format: float
                      ocean_current_direction:
                        type: array
                        items:
                          type: number
                          format: float
                      sea_level_height_msl:
                        type: array
                        items:
                          type: number
                          format: float
                  minutely_15_units:
                    type: object
                    properties:
                      time:
                        type: string
                      ocean_current_velocity:
                        type: string
                      ocean_current_direction:
                        type: string
                      sea_level_height_msl:
                        type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                  reason:
                    type: string