Lunar Return API
Temukan momen berikutnya saat Bulan kembali ke longitude natalnya pada atau setelah tanggal yang dipilih – kira-kira tiap 27,3 hari – dan buat chart untuk itu di lokasi yang kamu pilih. Kirim data natal dan tanggal mulai, dapatkan chart lunar return. Presisi Swiss Ephemeris, output JSON.
Lunar Return API
Endpoint lunar-return membaca longitude tepat Bulan natal dari data kelahiran yang diberikan, lalu mencari ke depan dari tanggal mulai yang diberikan untuk momen pertama ketika Bulan yang sedang transit kembali ke longitude yang sama. Karena Bulan menyelesaikan siklus sidereal dalam sekitar 27,3 hari, pengembalian itu terjadi kira-kira tiap bulan. Endpoint mengonversi momen yang cocok ke Julian day, mengambil posisi dan kecepatan geosentrik dari engine Swiss Ephemeris, dan membuat chart lengkap untuknya – planet kembali dengan tanda dan penempatan rumah, cusp rumah, serta grid aspek lengkap dengan flag applying dan separating serta orbs tepat. Secara default chart dibuat untuk tempat natal, tapi kamu bisa memberi latitude dan longitude lokasi lain untuk memindahkan return, yang mengubah sudut dan rumah sambil mempertahankan momen return yang sama. Hasilnya berupa peta tema emosional dan ritmis untuk bulan lunar ke depan.
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
Gunakan lunar return untuk peramalan siklus pendek, kira-kira bulanan – fitur 'bulan lunar ke depan', pelacak emosi-ritme, atau pendamping yang lebih detail untuk solar return tahunan. Saat solar return mencakup setahun penuh, lunar return mencakup empat minggu ke depan, cocok untuk laporan bulanan berulang dan siklus kebiasaan atau mood. Kirim tanggal mulai sebagai titik di mana kamu ingin return berikutnya – biasanya hari ini, atau tanggal return terakhir – dan endpoint melangkah ke depan ke yang akan datang. Override lokasi opsional memungkinkan kamu membuat chart return di tempat orang itu sebenarnya berada bulan itu, bukan tempat lahirnya, yang penting untuk rumah yang sensitif terhadap sudut. Rantai panggilan berurutan untuk membangun urutan chart bulanan yang bergulir.
Notes
Endpoint mengembalikan satu return berikutnya pada atau setelah tanggal yang diberikan, bukan serangkaian – panggil berulang, maju tanggal mulai, untuk membangun urutan. Angka ~27,3 hari adalah bulan sidereal, jadi return bergeser terhadap kalender. Jika tidak ada lokasi yang diberikan chart dibuat di tempat natal; override hanya memindahkan sudut dan rumah. Zodiak tropis dan Swiss Ephemeris sepanjang proses.
Try the Lunar Return API
Grab a key and make your first call in under a minute.