Lunar Return API
Találd meg a következő pillanatot, amikor a Hold visszatér a születési hosszúságához a megadott dátumon vagy azt követően – nagyjából 27,3 naponta – és készítsd el a horoszkópot egy általad választott helyen. Add meg a születési adatokat és egy kezdő dátumot, kapod a lunar return chart-ot. Swiss Ephemeris pontosság, JSON kimenet.
Lunar Return API
Az lunar-return endpoint a születési adatokból kiolvassa a Hold pontos hosszúságát, majd a megadott kezdő dátumtól keres előre az első pillanatot, amikor a tranzitáló Hold visszatér ugyanarra a hosszúságra. Mivel a Hold körülbelül 27,3 nap alatt befejezi a sziderális ciklust, ez a visszatérés nagyjából havonta történik. Az endpoint a megtalált pillanatot Julian napra konvertálja, a Swiss Ephemeris motorból lekéri a geocentrikus pozíciókat és sebességeket, és teljes chart-ot készít – visszatérő bolygók jelzésekkel és házhelyzetekkel, házcsúcsokkal, valamint a teljes aspektusrácsot alkalmazó és elváló jelzésekkel és pontos orbokkal. Alapértelmezésben a chart a születési helyen készül, de megadhatsz más földrajzi szélességet és hosszúságot, hogy áthelyezd a visszatérést, ami átalakítja a szögeket és házakat, miközben azonos pillanatot tart. Az eredmény az elkövetkező holdhónap érzelmi-ritmikus tématérképe.
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
Használd a lunar return-t rövidciklusú, nagyjából havi előrejelzéshez – egy „következő holdhónap” funkcióhoz, érzelmi-ritmus nyomon követőhöz, vagy a éves solar return finomabb kiegészítőjeként. Míg a solar return egy egész évet fed le, a lunar return a következő négy hetet, így jól illik az ismétlődő havi jelentésekhez és szokás- vagy hangulatszakaszokhoz. Add meg a kezdő dátumot annak a pontnak a jelzésére, amely után a következő visszatérést szeretnéd – gyakran ma, vagy az előző visszatérés dátuma – és az endpoint előre lép a közelgőre. Az opcionális hely felülírás lehetővé teszi, hogy a visszatérést abban a helyen készítsd el, ahol a személy az adott hónapban valójában van, nem csak a születési helyén, ami fontos a szög-érzékeny házaknál. Sorozatos hívásokkal építs fel egy gördülő sorozatot havi chartokból.
Notes
Az endpoint a megadott dátumon vagy azt követően a következő egyetlen visszatérést adja vissza, nem egy sorozatot – hívd többször, a kezdő dátumot előre léptetve, hogy sorozatot építs. A ~27,3-napos érték a sziderális hónap, ezért a visszatérések eltolódnak a naptárhoz képest. Ha nincs megadva hely, a chart a születési helyen készül; a felülírás csak a szögeket és házakat helyezi át. Trópusi zodiákus és Swiss Ephemeris mindenhol.
Try the Lunar Return API
Grab a key and make your first call in under a minute.