Skip to content
HALOWERK

Weltwerk

buoy observations

Reads the NDBC latest-observations file (all stations reporting within the last hours, cached 10 minutes) and the station table (names, owners, platform type, cached daily), selects stations within the radius whose observation is not older than max_age_hours, sorts by distance and returns the measurements with units (wind m/s, waves m and s, pressure hPa, temperatures °C, visibility nautical miles, tide feet) with observation time and age. Missing values are null. Coverage is global for.

POST https://welt.halowerk.com/v1/buoy-observations

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesLatitude in decimal degrees (WGS84).
lonnumberYesLongitude in decimal degrees.
radius_kmnumberNoSearch radius in km (default 200).
limitintegerNoMaximum stations (default 5).
max_age_hoursnumberNoIgnore observations older than this (default 6).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lat",
    "lon"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (WGS84)."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees."
    },
    "radius_km": {
      "type": "number",
      "minimum": 10,
      "maximum": 1000,
      "description": "Search radius in km (default 200)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum stations (default 5)."
    },
    "max_age_hours": {
      "type": "number",
      "minimum": 1,
      "maximum": 72,
      "description": "Ignore observations older than this (default 6)."
    }
  }
}

Open original schema

Published input example

{
  "lat": 35.2,
  "lon": -75.6,
  "radius_km": 300
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →