Lunar-Return-API
Finden Sie den nächsten Moment, in dem der Mond an oder nach einem gewählten Datum zu seiner natalen Länge heimkehrt — etwa alle 27,3 Tage — und berechnen Sie das Horoskop dafür an einem Ort Ihrer Wahl. Übergeben Sie natale Daten und ein Startdatum und erhalten Sie das Lunarrückkehr-Horoskop. Swiss-Ephemeris-Präzision, JSON als Ausgabe.
Lunar-Return-API
Der lunar-return-Endpunkt liest die exakte Länge des natalen Mondes aus den übergebenen Geburtsdaten und durchsucht dann vom angegebenen Startdatum an vorwärts nach dem ersten Augenblick, in dem der transitierende Mond zu eben dieser Länge zurückkehrt. Da der Mond einen siderischen Zyklus in etwa 27,3 Tagen vollendet, fällt diese Rückkehr ungefähr monatlich. Der Endpunkt löst den gefundenen Augenblick zu einem julianischen Datum auf, holt geozentrische Positionen und Geschwindigkeiten aus der Swiss-Ephemeris-Engine und berechnet ein vollständiges Horoskop dafür — Rückkehrplaneten mit Zeichen und Hausstellungen, Häuserspitzen und das vollständige Aspektgitter mit applikativen und separativen Markierungen und exakten Orben. Standardmäßig wird das Horoskop für den Geburtsort berechnet, aber Sie können eine andere Standortbreite und -länge angeben, um die Rückkehr zu relozieren, was die Achsen und Häuser umformt, während derselbe Rückkehrmoment erhalten bleibt. Das Ergebnis liest sich als emotionale und rhythmische Themenkarte für den kommenden Mondmonat.
POST/v1/lunar-return
curl -X POST https://api.astroway.info/v1/lunar-return \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"afterDate": "2026-06-15"
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Moon",
"longitude": 282.7,
"sign": "Capricorn",
"house": 6
}
],
"houses": {
"ascendant": 201.5,
"mc": 110.3,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}Parameter
| name | type | Erforderlich | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | ja | Birth date. |
| time | string (HH:MM:SS) | ja | Local clock time at birth. |
| timezoneOffset | number (hours) | ja | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | ja | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | ja | Birth-place longitude, decimal degrees (east positive). |
| afterDate | string (YYYY-MM-DD) | ja | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | nein | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | nein | Optional UTC offset for the start point, in hours. |
| locationLat | number | nein | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | nein | Optional longitude in decimal degrees to relocate the return chart, east positive. |
Wann verwenden
Verwenden Sie die Lunarrückkehr für kurzzyklische, etwa monatliche Prognosen — eine Funktion „Der Mondmonat voraus“, einen Tracker für emotionalen Rhythmus oder eine feinkörnigere Ergänzung zur jährlichen Solarrückkehr. Während die Solarrückkehr ein ganzes Jahr rahmt, rahmt die Lunarrückkehr die nächsten vier Wochen, was sie gut für wiederkehrende Monatsberichte sowie Gewohnheits- oder Stimmungszyklen geeignet macht. Übergeben Sie das Startdatum als den Punkt, ab dem Sie die nächste Rückkehr wünschen — oft heute oder das Datum der letzten Rückkehr — und der Endpunkt schreitet zur kommenden voran. Die optionale Standortüberschreibung lässt Sie die Rückkehr für den Ort berechnen, an dem sich die Person in jenem Monat tatsächlich befindet, statt für ihren Geburtsort, was für die achsensensiblen Häuser von Bedeutung ist. Verketten Sie aufeinanderfolgende Aufrufe, um eine fortlaufende Folge von Monatshoroskopen zu erstellen.
Hinweise
Der Endpunkt gibt die nächste einzelne Rückkehr an oder nach dem angegebenen Datum zurück, keine Serie — rufen Sie ihn wiederholt auf und schieben Sie das Startdatum vor, um eine Folge aufzubauen. Der Wert von ~27,3 Tagen ist der siderische Monat, sodass die Rückkehren gegenüber dem Kalender driften. Wird kein Standort angegeben, wird das Horoskop am Geburtsort berechnet; eine Überschreibung reloziert nur die Achsen und Häuser. Tropischer Tierkreis und Swiss Ephemeris durchgängig.
Lunarrückkehr-API ausprobieren
Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.