astroAPI

← Zurück zur Übersicht

GET /v1/planets API-Key noetig Berechnung

Ekliptikale Positionen und Geschwindigkeiten aller Standardpunkte fuer einen Zeitpunkt.

Beschreibung

Liefert Laenge, Breite, Distanz und die drei Geschwindigkeitskomponenten fuer Sonne, Mond, Merkur, Venus, Mars, Jupiter, Saturn, Uranus, Neptun, Pluto, Mean/True Node, Mean/Osculating Apogee (Lilith), Earth und Chiron. Default geozentrisch-tropisch; per Beobachtungs-Optionen siderisch bzw. helio-/bary-/topo-/planetozentrisch.

Parameter

NameInTypPflichtBeschreibung
datetime query string ja ISO 8601, UTC (z.B. "2026-04-15T12:00:00Z")
zodiac query string nein "tropical" (Default) oder "sidereal".
ayanamsa query string nein Nur bei zodiac=sidereal. Default "lahiri". Katalog = SE_SIDM-Namen der Swiss Ephemeris (z.B. lahiri, fagan_bradley, krishnamurti, raman, true_citra).
center query string nein "geocentric" (Default), "heliocentric", "barycentric", "topocentric" oder "planet:<name>" (planetozentrisch, sun..pluto). Bei nicht-geozentrischen Zentren entfaellt das Zentrum aus der Koerperliste; "earth" wird zum regulaeren Faktor.
observer_latitude / observer_longitude / observer_altitude query number nein Beobachter-Ort, Pflicht bei center=topocentric.

Beispiel-Aufruf

Variante: Direkter HTTP-Aufruf, keine Abhaengigkeit.
curl -sS \
  -H "X-API-Key: ak_test_<DEIN_KEY>" \
  "https://astroapi.services/v1/planets?datetime=2026-04-20T12%3A00%3A00Z"