API Retour Lunaire
Trouvez le prochain moment où la Lune retourne à sa longitude natale à partir d'une date choisie - environ tous les 27,3 jours - et calculez le thème pour cet instant à un lieu de votre choix. Fournissez les données natales et une date de départ, obtenez le thème du retour lunaire. Précision Swiss Ephemeris, sortie en JSON.
API Retour Lunaire
Le point de terminaison de retour lunaire lit la longitude exacte de la Lune natale à partir des données de naissance fournies, puis recherche à partir de la date de départ donnée le premier instant où la Lune en transit retourne à cette même longitude. Comme la Lune complète un cycle sidéral en environ 27,3 jours, ce retour se produit environ tous les mois. Le point de terminaison convertit l'instant correspondant en jour julien, extrait les positions et vitesses géocentriques du moteur Swiss Ephemeris, et calcule un thème complet pour cet instant - planètes de retour avec signes et positions dans les maisons, cusps des maisons, et la grille complète des aspects avec indicateurs d'application et de séparation et orbites exactes. Par défaut, le thème est calculé pour le lieu de naissance, mais vous pouvez fournir une latitude et longitude différentes pour relocaliser le retour, ce qui redessine les angles et les maisons tout en conservant le même instant de retour. Le résultat se lit comme une carte thématique émotionnelle et rythmique pour le mois lunaire à venir.
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
Utilisez le retour lunaire pour des prévisions à court terme, environ mensuelles - une fonction 'mois lunaire à venir', un suivi du rythme émotionnel, ou un compagnon plus fin au retour solaire annuel. Si le retour solaire encadre une année entière, le retour lunaire encadre les quatre prochaines semaines, le rendant bien adapté aux rapports mensuels récurrents et aux cycles d'habitudes ou d'humeur. Passez la date de départ comme le point après lequel vous voulez le prochain retour - souvent aujourd'hui, ou la date du dernier retour - et le point de terminaison avance jusqu'au prochain. Le paramètre de lieu optionnel vous permet de calculer le retour pour l'endroit où la personne se réellement ce mois-là plutôt que son lieu de naissance, ce qui est important pour les maisons sensibles aux angles. Chaînez les appels successifs pour construire une séquence continue de thèmes mensuels.
Notes
Le point de terminaison renvoie le prochain retour unique à partir de la date donnée, pas une série - appelez-le en répétant, en avançant la date de départ, pour construire une séquence. La valeur d'environ 27,3 jours correspond au mois sidéral, donc les décalages de retour par rapport au calendrier. Si aucun lieu n'est fourni, le thème est calculé au lieu de naissance ; un paramètre de remplacement ne relocalise que les angles et les maisons. Zodiaque tropical et Swiss Ephemeris tout au long.
Try the Retour Lunaire API
Grab a key and make your first call in under a minute.