Duaer

Get started

Marine forecast in Duaer

In Duaer: Daily wave height, swell height, wave period, and direction for a coast or a point at sea, up to eight days, from Open-Meteo marine models. One successful search uses 1 credit.

What you get

Duaer Marine forecast returns daily wave conditions from the Open-Meteo marine models. Inland points have no waves, so the search returns no rows and uses no credit.

Pick Duaer Data → Marine forecast in the node creator, or open the data market. Related: Weather forecast, River flow.

When to use it

  • Plan boat trips, port work, offshore maintenance, or surf and beach events.
  • Add sea-state context to a shipping or tourism report.

When not to use it

  • Navigation safety decisions. Check official marine warnings too.
  • Rivers and floods. Use River flow.

Search on the canvas

  1. Open the node creator and pick Duaer Data → Marine forecast.
  2. Fill Place (such as Honolulu). Optional: Latitude, Longitude, Days.
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/marine?place=Honolulu&days=5
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-marine
description: >-
  Duaer Marine forecast. Daily wave height, swell height, wave period, and direction for a coast or a point at sea, up to eight days, from Open-Meteo marine models.
  One successful search uses 1 Duaer credit.
---

# Duaer Marine forecast

Duaer Marine forecast returns daily wave conditions from the Open-Meteo marine models. Inland points have no waves, so the search returns no rows and uses no credit.

## When to use

- Plan boat trips, port work, offshore maintenance, or surf and beach events.
- Add sea-state context to a shipping or tourism report.

## When not to use

- Navigation safety decisions. Check official marine warnings too.
- Rivers and floods. Use https://skills.duaer.com/river-flow.md.

## Call

`GET https://api.duaer.com/v1/data/marine?place=Honolulu&days=5`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `place`, or `latitude` and `longitude`, at a coast or at sea.

- `place` — City or place name. Leave empty when you enter latitude and longitude.
- `latitude` — Optional. Decimal degrees from -90 to 90. Use with longitude instead of a place.
- `longitude` — Optional. Decimal degrees from -180 to 180.
- `days` — Optional. Forecast days from 1 to 8. Default 7.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/marine?place=Honolulu&days=5` — five days off Honolulu.
- `GET https://api.duaer.com/v1/data/marine?latitude=22.2&longitude=114.3` — a point off Hong Kong.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `place`, `latitude`, `longitude` — where the rows are for.
- `date` — local day.
- `waveHeightMaxM` — highest significant wave height in m.
- `swellHeightMaxM` — highest swell wave height in m.
- `wavePeriodMaxS` — longest wave period in s.
- `waveDirectionDeg` — dominant direction the waves come from, degrees.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/weather.md — Duaer Weather forecast
- https://skills.duaer.com/river-flow.md — Duaer River flow

Questions

How many credits does a Marine forecast search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Why does a Duaer marine search return nothing?

The point is probably inland. Duaer returns no rows and charges no credit. Move the point to the coast or out to sea.

In this section

Get started

Weather forecast in Duaer

In Duaer: Daily forecast for any city or coordinates, up to 16 days: conditions, high and low, rain amount and chance, and peak wind, from Open-Meteo. One successful search uses 1 credit.

Get started

River flow in Duaer

In Duaer: Daily river discharge in m³/s near a point, forecast up to three months plus recent past, from the GloFAS flood model via Open-Meteo. One successful search uses 1 credit.