PrompTugal.news· Data
Version v0.1.47data read 2026-11-18 19:18 UTCPay for what you read · free here

IPMA sea forecast

Wave height, period and direction, total sea and sea temperature for each coastal place, today and the next two days.

Three layers: the source (who publishes it, the terms, when it was read), the raw data as the publisher served it, and the processed data, what this site makes of it. The processing is where the value is: named fields, places joined, gaps marked, every value kept with its source and time.

1. The source

At a glance

FieldValue
PublisherIPMA, Instituto Português do Mar e da Atmosfera
Sourcehttps://api.ipma.pt/open-data/forecast/oceanography/daily/
Reader pagehttps://www.ipma.pt/en/maritima/costeira/
Schedulehourly: the Pages workflow (.github/workflows/pages.yml), on a schedule at 17 minutes past each hour, and on every push to dev
Ownerdata@PrompTugal.dinis
Collectorsources/ipma-sea/collect.mjs
Since2026-11-17
Last read2026-11-18 19:17 UTC
Last runok: 4 requests ok, 0 failed
Now12 coastal places
LicenceThe data: the source's terms (IPMA, Instituto Português do Mar e da Atmosfera). This page, the card and the records we add: CC BY 4.0.

Reuse terms

IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source. Reuse: with conditions: attribution to IPMA; no profit-making purpose.

O Utilizador pode copiar, importar ou utilizar gratuitamente informações ou símbolos nacionais existentes neste site para uso pessoal ou público desde que dessa utilização não decorram finalidades lucrativas ou ofensivas. O Utilizador deve referir, sempre, a fonte de informação.

Open question: Whether a paid reading meter on a PrompTugal site counts as a profit-making purpose under these terms is for Dinis to decide (or to ask IPMA). Until then the data site itself carries no meter.

2. The raw data

As IPMA served it at the latest read (2026-11-18 19:17 UTC), unprocessed. The files: sea-day0.json, sea-day1.json, sea-day2.json, sea-locations.json.

IPMA's sea forecast file for today, as served. The data.

3. The processed data

The collector joins the three day files, names the fields and adds each place's name and position. The result: latest.json.

Wave heights by coastal place, lowest to highest, for each day. The data.

More about this source

What runs by code, by agents and by people

Code

Agents

People

Cost

FieldValue
per run tokens0
per run model cost usd0
runnerGitHub Actions on a public repository: no charge (GitHub's terms for public repositories); about 3 minutes a run for all sources together (measured locally, 17 November 2026)
build tokensnot measured: accountant@'s ledger is not running on this account; to be added when it is
noteCode only: no model is called when the data is collected.

API addresses

These addresses stay for the life of v1 (the contract).

FileAddress
Latest readhttps://data.promptugal.news/api/v1/ipma-sea/latest.json
Every readhttps://data.promptugal.news/api/v1/ipma-sea/reads.json
Cardhttps://data.promptugal.news/api/v1/ipma-sea/card.json
OpenAPIhttps://data.promptugal.news/api/v1/ipma-sea/openapi.json
curl -s https://data.promptugal.news/api/v1/ipma-sea/latest.json
curl -s https://data.promptugal.news/api/v1/ipma-sea/reads.json | head -c 600

Vault

FieldValue
Vault id2q3ospco
Public read keysgit_public_read_8278fb5a34066fa4222611d44060d7d5ec12acc1af442ed7dc8877500ad316c4
Clonesgit clone sgit_public_read_8278fb5a34066fa4222611d44060d7d5ec12acc1af442ed7dc8877500ad316c4:2q3ospco
NotePublic read key: the source is public, so anyone may read the vault. A read key is derived one way and cannot write. The write key is never in this repository.

Last runs

Time (UTC)Requests okRequests failedReads with changed bytes
2026-11-18 19:17 UTC400 of 4
2026-11-18 19:12 UTC400 of 4
2026-11-18 19:08 UTC400 of 4
2026-11-18 19:05 UTC400 of 4
2026-11-18 18:57 UTC400 of 4
2026-11-18 18:53 UTC403 of 4
2026-11-18 17:56 UTC400 of 4
2026-11-18 17:41 UTC403 of 4
2026-11-18 16:32 UTC400 of 4
2026-11-18 16:13 UTC400 of 4
2026-11-18 16:09 UTC400 of 4
2026-11-18 16:06 UTC400 of 4
2026-11-18 16:00 UTC400 of 4
2026-11-18 15:57 UTC400 of 4
2026-11-18 15:53 UTC400 of 4
2026-11-18 15:49 UTC400 of 4
2026-11-18 15:45 UTC400 of 4
2026-11-18 15:41 UTC400 of 4
2026-11-18 15:38 UTC403 of 4
2026-11-18 15:34 UTC400 of 4
2026-11-18 15:30 UTC400 of 4
2026-11-18 15:15 UTC400 of 4
2026-11-18 15:10 UTC404 of 4
2026-11-18 15:00 UTC040 of 4

Showing 24 of 48 runs kept. Full detail with sha256: reads.json.

Preview of the values

The first 3 of 3 entries in files, as read 2026-11-18 19:17 UTC. Source: https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-forecast-day{0,1,2}.json. Long values are shortened here; the file has them whole.

ddatesourceSource
02026-11-18https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-foreca...source
12026-11-19https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-foreca...source
22026-11-20https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-foreca...source