Weltwerk
satellite pass
Fetches the element set from CelesTrak (by NORAD number or exact name, cached 2.5 hours), propagates with SGP4 in 20-second steps over the requested window and detects passes whose maximum elevation reaches the requested minimum (default 10°). Each pass reports rise, culmination and set (UTC time, azimuth, elevation), range at culmination, duration, whether the satellite is sunlit while the observer is in darkness (sun below -6°), which marks optically visible passes for bright objects such.
POST https://welt.halowerk.com/v1/satellite-passInputs
| Field | Type | Required | Description |
|---|---|---|---|
| lat | number | Yes | Observer latitude in decimal degrees (WGS84). |
| lon | number | Yes | Observer longitude in decimal degrees. |
| alt_m | number | No | Observer altitude above sea level in metres (default 0). |
| norad_id | integer | No | NORAD catalogue number, e.g. 25544 for the ISS. |
| name | string | No | Object name as listed by CelesTrak, e.g. "HST". Must match exactly one object. |
| hours | integer | No | Search window from now in hours (default 24). |
| min_elevation_deg | number | No | Minimum culmination elevation to report (default 10). |
| visible_only | boolean | No | Only passes that are optically visible (observer dark, satellite sunlit). |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"lat",
"lon"
],
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Observer latitude in decimal degrees (WGS84)."
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Observer longitude in decimal degrees."
},
"alt_m": {
"type": "number",
"minimum": -500,
"maximum": 9000,
"description": "Observer altitude above sea level in metres (default 0)."
},
"norad_id": {
"type": "integer",
"minimum": 1,
"maximum": 999999,
"description": "NORAD catalogue number, e.g. 25544 for the ISS."
},
"name": {
"type": "string",
"minLength": 2,
"maxLength": 60,
"pattern": "^[A-Za-z0-9 ()./+_-]+$",
"description": "Object name as listed by CelesTrak, e.g. \"HST\". Must match exactly one object."
},
"hours": {
"type": "integer",
"minimum": 1,
"maximum": 72,
"description": "Search window from now in hours (default 24)."
},
"min_elevation_deg": {
"type": "number",
"minimum": 0,
"maximum": 85,
"description": "Minimum culmination elevation to report (default 10)."
},
"visible_only": {
"type": "boolean",
"description": "Only passes that are optically visible (observer dark, satellite sunlit)."
}
}
}Published input example
{
"lat": 52.21,
"lon": 7.02,
"norad_id": 25544,
"hours": 48
}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
- Weltwerk0.004 USDC
aircraft nearby
POSThttps://welt.halowerk.com/v1/aircraft-nearbyQueries the adsb.lol v2 API for all aircraft within the radius (converted to nautical miles, maximum 250 nm) of the point, as currently received by volunteer ADS-B/MLAT feeders, and returns each aircraft with ICAO 24-bit address, callsign,
- Weltwerk0.004 USDC
buoy observations
POSThttps://welt.halowerk.com/v1/buoy-observationsReads 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
- Weltwerk0.01 USDC
business day window
POSThttps://welt.halowerk.com/v1/business-day-windowReturn weekdays excluding the selected German national or TARGET holidays. Free official sources; fee covers HALOWERK processing. 2025–2027; DE nationwide or TARGET, excluding regional and exchange calendars. Source failures are not charged