Weltwerk
iss position
Fetches the latest two-line element set of the ISS (NORAD 25544) from CelesTrak (cached 2.5 hours per CelesTrak usage rules) and propagates it with SGP4 (satellite.js) to the requested time (default now). Returns geodetic position, altitude, orbital speed, footprint radius, whether the station is sunlit (cylindrical Earth shadow model), the element epoch and its age, optionally a ground track with configurable step for up to 180 minutes ahead, and, if an observer is given, elevation, azimuth.
POST https://welt.halowerk.com/v1/iss-positionInputs
| Field | Type | Required | Description |
|---|---|---|---|
| time | string | No | UTC time to evaluate (default now; within ±7 days of now). |
| track_minutes | integer | No | Length of the ground track ahead in minutes (default 0 = none). |
| track_step_minutes | integer | No | Step of the ground track in minutes (default 5). |
| observer | object | No |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"time": {
"type": "string",
"format": "date-time",
"description": "UTC time to evaluate (default now; within ±7 days of now)."
},
"track_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 180,
"description": "Length of the ground track ahead in minutes (default 0 = none)."
},
"track_step_minutes": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Step of the ground track in minutes (default 5)."
},
"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
{
"track_minutes": 30,
"observer": {
"lat": 52.21,
"lon": 7.02
}
}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