Lunar Return API
Chune hue tareekh ke baad ya usi din Chand ka apne janam ke longitude par wapas aane ka agla pal dhoondho – lagbhag har 27.3 din mein – aur uske liye tum jo jagah chuno, chart banao. Janam data aur shuru ki tareekh do, lunar return chart pao. Swiss Ephemeris ki precision, JSON output.
Lunar Return API
lunar-return endpoint supplied birth data se natal Moon ka exact longitude padhta hai, phir diye gaye start date se aage search karta hai pehla pal jab transiting Moon wahi longitude par wapas aata hai. Kyunki Moon lagbhag 27.3 din mein ek sidereal cycle poora karta hai, ye return lagbhag mahine ke hisaab se hota hai. Endpoint matched instant ko Julian day mein convert karta hai, Swiss Ephemeris engine se geocentric positions aur speeds le aata hai, aur uske liye poora chart banata hai – return planets ke signs aur house placements, house cusps, aur poora aspect grid with applying aur separating flags aur exact orbs. Default roop se chart natal place ke liye cast hota hai, lekin tum alag latitude aur longitude dekar return ko relocate kar sakte ho, jo angles aur houses ko badal deta hai jabki same return moment bana rahta hai. Result lunar month ke liye emotional aur rhythmic theme map ki tarah padhta hai.
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
lunar return ko short-cycle, lagbhag mahine ke forecasting ke liye istemal karo – 'lunar month ahead' feature, emotional-rhythm tracker, ya yearly solar return ka finer-grained companion. Jahan solar return poore saal ko frame karta hai, lunar return agle chaar hafton ko frame karta hai, isliye ye recurring monthly reports aur habit ya mood cycles ke liye bilkul theek hai. Start date ko us point ke roop mein do jahan tum agla return chahte ho – aam tor par aaj, ya last return ki tareekh – aur endpoint aage chal kar agla milta hai. Optional location override se tum return ko us jagah cast kar sakte ho jahan vyakti us mahine actually hai, na ki uske janm sthal par, jo angle-sensitive houses ke liye maayne rakhta hai. Successive calls ko chain karke monthly charts ka rolling sequence banao.
Notes
Endpoint diye gaye date par ya uske baad ka agla single return return karta hai, series nahi – baar-baar call karo, start date ko aage badhakar, ek sequence banao. ~27.3-din ka figure sidereal month hai, isliye returns calendar ke hisaab se drift karte hain. Agar koi location nahi di jati to chart natal place par cast hota hai; override sirf angles aur houses ko relocate karta hai. Pure text mein Tropical zodiac aur Swiss Ephemeris ka istemal hota hai.
Try the Lunar Return API
Grab a key and make your first call in under a minute.