Solar Return API
Buat bagan untuk momen tepat ketika Matahari kembali ke derajat natalnya di tahun pilihan - ulang tahun astrologi. Berikan bagan natal dan tahun, dapatkan bagan solar return untuk siklus itu. Tropikal, Sun-to-natal-Sun, presisi Swiss Ephemeris, output JSON.
Solar Return API
Endpoint solar-return pertama membaca longitude zodiak tepat Matahari natal dari data kelahiran yang diberikan, lalu mencari tahun yang dipilih untuk momen tepat ketika Matahari yang transit kembali ke longitude yang sama - biasanya dalam satu hari atau kurang dari ulang tahun kalender. Ia mengonversi momen kembali itu ke hari Julian, mengambil posisi dan kecepatan geosentrik dari mesin Swiss Ephemeris, dan membuat bagan lengkap: planet-planet kembali dengan tanda dan penempatan rumah, cusp rumah, serta grid aspek lengkap dengan tanda menerapkan dan memisahkan serta orb tepat. Kecocokan bersifat tropikal dan Sun-to-natal-Sun, tidak dikoreksi presesi secara default, jadi Matahari kembali berada pada derajat tropikal Matahari natal. Bagan yang dihasilkan dibaca sebagai peta tema dominan untuk tahun dari satu ulang tahun ke berikutnya.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-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,
"year": 2026
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"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). |
| year | number | yes | Required integer year in which to find the Sun's return to its natal longitude. |
When to use it
Gunakan solar return untuk perkiraan tahunan - laporan 'tahun ke depan', fitur bagan ulang tahun, atau alur AI yang membangun outlook dua belas bulan dari satu bagan bertanggal. Ini adalah mesin utama prediksi berbasis return: sudut, rumah tempat Matahari kembali berada, dan aspek terketat dibaca sebagai tema utama tahun solar itu. Padukan dengan transits dan progressions untuk kedalaman, tapi solar return saja memberi snapshot tahunan yang bersih dan mandiri, berpatokan pada ulang tahun orang tersebut bukan kalender. Karena kamu hanya memberikan data natal plus tahun, ia cocok masuk ke pemicu anniversary dan email tahunan terjadwal - hitung ulang tiap tahun untuk melanjutkan perkiraan.
Notes
Return dicocokkan secara tropikal, Sun ke Sun natal, dan tidak dikoreksi presesi secara default, jadi mencerminkan solar return Barat konvensional bukan varian yang dikoreksi sidereal. Bagan dibuat untuk lokasi natal yang diberikan; solar return yang dipindahkan memerlukan pembuatan ulang di tempat lain. Zodiak tropikal dan Swiss Ephemeris digunakan sepanjang proses.
Try the Solar Return API
Grab a key and make your first call in under a minute.