Live sky API
Read-only live sky endpoints, backed by the Scientific Data Engine.
The registry of external providers the live-sky layer is designed to integrate. Every provider reports its integration status honestly (currently all planned).
Returns
{ count, connected, providers: Provider[] }
The computed Moon (method: computed — not a live provider feed), with its own honesty envelope. WITHOUT latitude/longitude: the global Moon phase and illuminated fraction. WITH latitude and longitude: location-aware moonrise, moonset, transit, topocentric position, phase, and horizon status for the date (polar and no-rise/no-set cases handled honestly). Location is only ever what you pass in — never inferred, geolocated, or stored.
| Parameter | In | Type | Description |
|---|---|---|---|
| date | query | string | Compute for a specific date (YYYY-MM-DD or ISO-8601). Defaults to the current instant / today. |
| latitude | query | string | Observer latitude, −90 to 90. When given (with longitude), returns location-aware moonrise/moonset/position. |
| longitude | query | string | Observer longitude, −180 to 180. Required together with latitude. |
| timezone | query | string | IANA timezone id for local event times (e.g. Europe/Prague). Defaults to UTC. |
Returns
MoonData & { envelope } | MoonPositionData & { envelope }
Sunrise, sunset, solar noon, civil/nautical/astronomical twilight, day length, and a solar summary for an EXPLICIT location and date, deterministically COMPUTED from the public-domain NOAA Solar Calculator algorithm (method: computed — not a live provider feed). Polar day/night is handled honestly (null events + a status). Location is only ever what you pass in — never inferred, geolocated, or stored.
| Parameter | In | Type | Description |
|---|---|---|---|
| latitude* | query | string | Observer latitude as a decimal number, −90 to 90. |
| longitude* | query | string | Observer longitude as a decimal number, −180 to 180. |
| date | query | string | Civil date (YYYY-MM-DD). Defaults to today (UTC). |
| timezone | query | string | IANA timezone id for local times (e.g. Europe/Prague). Defaults to UTC. |
Returns
SunData & { envelope }
Computed, location-aware visibility for the naked-eye planets (Mercury–Saturn; Uranus/Neptune via ?planet): rise, set, transit, topocentric position, approximate magnitude, and conservative honest observing rules (method: computed — not a live provider feed). Positions use the public-domain NASA/JPL approximate planetary elements. Location is only ever what you pass in — never inferred, geolocated, or stored.
| Parameter | In | Type | Description |
|---|---|---|---|
| latitude* | query | string | Observer latitude as a decimal number, −90 to 90. |
| longitude* | query | string | Observer longitude as a decimal number, −180 to 180. |
| date | query | string | Civil date (YYYY-MM-DD). Defaults to today. |
| timezone | query | string | IANA timezone id for local times (e.g. Europe/Prague). Defaults to UTC. |
| planet | query | string | One planet (mercury|venus|mars|jupiter|saturn|uranus|neptune). Default is the five naked-eye planets. |
Returns
PlanetVisibilityData & { envelope }
A computed COMPOSITE of the Sun & Twilight, Moon, and Planet engines (method: computed_composite — not a live provider feed): twilight/darkness summary and night type, Moon phase/rise/set/position and moonlight impact, ranked naked-eye planet visibility, and best observing windows for an EXPLICIT location and date. It invents no weather, cloud, seeing, ISS, aurora, meteor, or comet data; a sub-engine failure yields a null section plus a limitation. Location is only ever what you pass in — never inferred, geolocated, or stored.
| Parameter | In | Type | Description |
|---|---|---|---|
| latitude* | query | string | Observer latitude as a decimal number, −90 to 90. |
| longitude* | query | string | Observer longitude as a decimal number, −180 to 180. |
| date | query | string | Civil date (YYYY-MM-DD). Defaults to today. |
| timezone | query | string | IANA timezone id for local times (e.g. Europe/Prague). Defaults to UTC. |
Returns
TonightObservingData & { envelope }
Planned. Requires a connected external provider; no provider is connected yet, so no live data is served. The provider registry above is real.
| Parameter | In | Type | Description |
|---|---|---|---|
| provider* | path | string | Provider key. |
Returns
Live observation data (not available)