Base URL & authentication
Base URL: https://neptun.marine-api.com/v1
Every request needs an API key (mapi_…) in the Authorization header (recommended) or as a ?key= parameter:
curl -H "Authorization: Bearer mapi_YOUR_KEY" \
"https://neptun.marine-api.com/v1/tides?lat=54.32&lon=13.10"Quotas
Quotas apply per calendar month (UTC). Every response carries a quota object. When the quota is used up the API answers 429; a short-term per-minute limit applies as well (120/min by default) and returns 429 with a Retry-After header. The free plan also has a daily limit of 100 calls per calendar day (UTC), per key and per connection; once reached, the API answers 429 with Retry-After until 00:00 UTC. /v1/me shows usage (used_month, on free also used_today) and costs no quota.
Attribution (required)
Every response carries an attribution field. Under the data providers' licences this credit must be carried through whenever you display or process the data. Model values — not for navigation.
Which networks and countries are covered?
Example clients (Python, Node)
Endpoints
GET /v1/tides— Tides
Water level, high and low water for any point in the world's oceans.GET /v1/currents— Tidal currents
Set & drift — direction and rate of the tidal stream at a point.GET /v1/currents/stations— Current stations
The nearest official current stations with distance — to choose from.GET /v1/currents-field— Current field
Vector field across an area — for chart overlays.GET /v1/levels— Gauges & measuring stations
Measured water levels, waves and sea temperature from official networks.GET /v1/warnings— Navigational warnings
Official notices to mariners from 106 sources.GET /v1/locks— Locks
3,396 locks with dimensions and operating data.GET /v1/me— Check your key
Plan, scopes and quota status of your own key.
Status
GET /v1/status | Public module status, available without a key. |
GET /v1/levels/status | Gauge networks: coverage and freshness per network. |
GET /v1/warnings/status | Notice sources: yield and freshness per source. |
GET /v1/locks/status | Locks per country. |