Weltwerk
satellite position
Resolves the object via CelesTrak GP data (by NORAD catalogue number or an exact object name; ambiguous names return the candidate list), caches the element set for 2.5 hours and propagates it with SGP4 to the requested time (default now, within ±7 days). Returns latitude, longitude, altitude, speed, footprint radius, sunlit flag, element epoch and age, and optionally look angles from an observer. Works for all objects CelesTrak publishes (active satellites, rocket bodies, debris).
POST https://welt.halowerk.com/v1/satellite-positionInputs
| Field | Type | Required | Description |
|---|---|---|---|
| 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. |
| time | string | No | |
| observer | object | No |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"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."
},
"time": {
"type": "string",
"format": "date-time"
},
"observer": {
"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)."
}
}
}
}
}Published input example
{
"norad_id": 20580
}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