# 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

| Field | Value |
|---|---|
| Publisher | IPMA, Instituto Português do Mar e da Atmosfera |
| Source | [https://api.ipma.pt/open-data/forecast/oceanography/daily/](https://api.ipma.pt/open-data/forecast/oceanography/daily/) |
| Reader page | [https://www.ipma.pt/en/maritima/costeira/](https://www.ipma.pt/en/maritima/costeira/) |
| Schedule | hourly: the Pages workflow (.github/workflows/pages.yml), on a schedule at 17 minutes past each hour, and on every push to dev |
| Owner | data@PrompTugal.dinis |
| Collector | [sources/ipma-sea/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/ipma-sea/collect.mjs) |
| Since | 2026-11-17 |
| Last read | 2026-11-18 19:17 UTC |
| Last run | ok: 4 requests ok, 0 failed |
| Now | 12 coastal places |
| Licence | The data: [the source's terms](https://api.ipma.pt/) (IPMA, Instituto Português do Mar e da Atmosfera). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/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.
>
> The publisher's words (pt), from [https://api.ipma.pt/](https://api.ipma.pt/), read on 2026-11-17.

**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](/api/v1/ipma-sea/raw/sea-day0.json), [sea-day1.json](/api/v1/ipma-sea/raw/sea-day1.json), [sea-day2.json](/api/v1/ipma-sea/raw/sea-day2.json), [sea-locations.json](/api/v1/ipma-sea/raw/sea-locations.json).

IPMA's sea forecast file for today, as served. The data: [/api/v1/ipma-sea/raw/sea-day0.json](/api/v1/ipma-sea/raw/sea-day0.json).

## 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](/api/v1/ipma-sea/latest.json).

Wave heights by coastal place, lowest to highest, for each day. The data: [/api/v1/ipma-sea/latest.json](/api/v1/ipma-sea/latest.json).

## More about this source

## What runs by code, by agents and by people

### Code

- the collector reads the source and writes latest.json, reads.json and the vault copy
- GitHub Actions runs it every hour and deploys the site
- the build makes the API, the OpenAPI description and the pages

### Agents

- data@PrompTugal.dinis (Opus) wrote the collector, this card and the pages on 17 November 2026; data.dev@ and data.design@ (Sonnet) wrote parts of the site build and the design variations

### People

- Dinis Cruz instructs; no person has checked the values yet (not reviewed)

## Cost

| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | GitHub 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 tokens | not measured: accountant@'s ledger is not running on this account; to be added when it is |
| note | Code only: no model is called when the data is collected. |

## API addresses

These addresses stay for the life of v1 ([the contract](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/ipma-sea/latest.json](https://data.promptugal.news/api/v1/ipma-sea/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/ipma-sea/reads.json](https://data.promptugal.news/api/v1/ipma-sea/reads.json) |
| Card | [https://data.promptugal.news/api/v1/ipma-sea/card.json](https://data.promptugal.news/api/v1/ipma-sea/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/ipma-sea/openapi.json](https://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

| Field | Value |
|---|---|
| Vault id | 2q3ospco |
| Public read key | `sgit_public_read_8278fb5a34066fa4222611d44060d7d5ec12acc1af442ed7dc8877500ad316c4` |
| Clone | `sgit clone sgit_public_read_8278fb5a34066fa4222611d44060d7d5ec12acc1af442ed7dc8877500ad316c4:2q3ospco` |
| Note | Public 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 ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-18 19:17 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 19:12 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 19:08 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 19:05 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 18:57 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 18:53 UTC | 4 | 0 | 3 of 4 |
| 2026-11-18 17:56 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 17:41 UTC | 4 | 0 | 3 of 4 |
| 2026-11-18 16:32 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 16:13 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 16:09 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 16:06 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 16:00 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:57 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:53 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:49 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:45 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:41 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:38 UTC | 4 | 0 | 3 of 4 |
| 2026-11-18 15:34 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:30 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:15 UTC | 4 | 0 | 0 of 4 |
| 2026-11-18 15:10 UTC | 4 | 0 | 4 of 4 |
| 2026-11-18 15:00 UTC | 0 | 4 | 0 of 4 |

Showing 24 of 48 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/ipma-sea/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](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.

| d | date | source | Source |
|---|---|---|---|
| 0 | 2026-11-18 | https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-foreca... | [source](https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-forecast-day0.json) |
| 1 | 2026-11-19 | https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-foreca... | [source](https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-forecast-day1.json) |
| 2 | 2026-11-20 | https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-foreca... | [source](https://api.ipma.pt/open-data/forecast/oceanography/daily/hp-daily-sea-forecast-day2.json) |

---

Version v0.1.47 · data read 2026-11-18 19:18 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/ipma-sea/
