API Ritorno Lunare
Trova il prossimo momento in cui la Luna torna alla sua longitudine natale sulla o dopo una data scelta - circa ogni 27.3 giorni - e traccia il grafico per quella posizione che scegli. Passa i dati natali e una data di inizio, ottieni il grafico del ritorno lunare. Precisione Swiss Ephemeris, output in JSON.
API Ritorno Lunare
L'endpoint del ritorno lunare legge la longitudine esatta della Luna natale dai dati di nascita forniti, poi cerca in avanti dalla data di inizio per il primo istante in cui la Luna transitoria torna alla stessa longitudine. Poiché la Luna completa un ciclo siderale in circa 27.3 giorni, quel ritorno cade circa mensilmente. L'endpoint risolve l'istante corrispondente a un giorno giuliano, estrae posizioni e velocità geocentriche dal motore Swiss Ephemeris, e traccia un grafico completo per esso - pianeti di ritorno con posizioni di segni e case, cuspidi di casa, e la griglia completa degli aspetti con bandiere di applicazione e separazione e orbite esatte. Per impostazione predefinita il grafico è tracciato per il luogo natale, ma puoi fornire una latitudine e longitudine diverse per spostare il ritorno, che ridisegna gli angoli e le case mantenendo lo stesso momento di ritorno. Il risultato si legge come mappa tematica emotiva e ritmica per il mese lunare imminente.
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
Usa il ritorno lunare per previsioni a breve ciclo, circa mensili - una funzione 'mese lunare avanti', un tracciatore di ritmo emotivo, o un compaglio più granulare del ritorno solare annuale. Dove il ritorno solare delinea un anno intero, il ritorno lunare delinea le prossime quattro settimane, rendendolo adatto a report mensili ricorrenti e cicli di abitudini o umore. Passa la data di inizio come punto dopo cui vuoi il prossimo ritorno - spesso oggi, o la data dell'ultimo ritorno - e l'endpoint procede in avanti al prossimo. L'override opzionale di posizione ti permette di tracciare il ritorno per dove la persona si trova effettivamente quel mese anziché il suo luogo di nascita, il che è importante per le case sensibili agli angoli. Concatena chiamate successive per costruire una sequenza rotativa di grafici mensili.
Notes
L'endpoint restituisce il singolo ritorno successivo sulla o dopo la data fornita, non una serie - chiama ripetutamente, avanzando la data di inizio, per costruire una sequenza. La cifra di ~27.3 giorni è il mese siderale, quindi i ritorni si spostano rispetto al calendario. Se non viene fornita alcuna posizione, il grafico è tracciato nel luogo natale; un override sposta solo gli angoli e le case. Zodiaco tropicale e Swiss Ephemeris in tutto.
Try the Ritorno Lunare API
Grab a key and make your first call in under a minute.