Lunar Return API
Vind het volgende moment dat de Maan terugkeert naar zijn geboortelongitude op of na een gekozen datum – ongeveer elke 27,3 dag – en maak de kaart daarvoor op een locatie die je kiest. Geef geboortedata en een startdatum door, krijg de lunar return-kaart. Swiss Ephemeris-precisie, JSON-output.
Lunar Return API
De lunar-return endpoint leest de exacte longitude van de geboortemaan uit de meegeleverde geboortegegevens, en zoekt daarna vanaf de opgegeven startdatum naar het eerste moment dat de passerende Maan terugkeert naar diezelfde longitude. Omdat de Maan een siderische cyclus van ongeveer 27,3 dag voltooit, valt die terugkeer ongeveer maandelijks. De endpoint zet het gevonden moment om naar een Julian-dag, haalt geocentrische posities en snelheden op uit de Swiss Ephemeris-engine, en maakt er een volledige kaart van – terugkerende planeten met tekens en huisposities, huiscusp-punten, en het volledige aspect-rooster met aan- en afnemende vlaggen en exacte orbs. Standaard wordt de kaart gemaakt voor de geboortelocatie, maar je kunt een andere latitude en longitude opgeven om de terugkeer te verplaatsen, waardoor de hoeken en huizen opnieuw worden gevormd terwijl hetzelfde terugkeermoment behouden blijft. Het resultaat leest als de emotionele en ritmische themakaart voor de komende lunarmand.
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": [
"…"
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| afterDate | string (YYYY-MM-DD) | yes | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | no | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | no | Optional UTC offset for the start point, in hours. |
| locationLat | number | no | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | no | Optional longitude in decimal degrees to relocate the return chart, east positive. |
When to use it
Gebruik de lunar return voor korte-cyclus, ongeveer maandelijkse voorspellingen – een ‘lunar month ahead’-functie, een emotie-ritme-tracker, of een fijnmaziger aanvulling op de jaarlijkse solar return. Waar de solar return een heel jaar afbakent, geeft de lunar return de komende vier weken weer, waardoor hij perfect is voor terugkerende maandelijkse rapporten en gewoontes- of stemmingscycli. Geef de startdatum op als het punt waarna je de volgende terugkeer wilt – meestal vandaag, of de datum van de laatste terugkeer – en de endpoint loopt vooruit naar de komende. De optionele locatie-override laat je de terugkeer casten voor waar de persoon die maand daadwerkelijk is, in plaats van zijn geboorteplaats, wat belangrijk is voor de hoek-gevoelige huizen. Koppel opeenvolgende calls om een rollende reeks maandelijkse kaarten op te bouwen.
Notes
De endpoint geeft de volgende enkele terugkeer op of na de opgegeven datum terug, niet een reeks – roep herhaaldelijk aan, waarbij je de startdatum verschuift, om een sequentie op te bouwen. Het ~27,3-dag-cijfer is de siderische maand, dus terugkeringen drijven ten opzichte van de kalender. Als er geen locatie wordt opgegeven, wordt de kaart gemaakt op de geboortelocatie; een override verplaatst alleen de hoeken en huizen. Tropical zodiac en Swiss Ephemeris doorlopend.
Try the Lunar Return API
Grab a key and make your first call in under a minute.