Solar Return API
एक चुने हुए साल में सूरज के अपने जन्म डिग्री पर वापस आने के ठीक पल का चार्ट बनाओ - ज्योतिषीय जन्मदिन. एक जन्म चार्ट और साल पास करो, उस चक्र का सोलर रिटर्न चार्ट पाओ. ट्रॉपिकल, Sun-to-natal-Sun, Swiss Ephemeris प्रिसीजन, JSON आउट.
Solar Return API
solar-return endpoint पहले सप्लाई किए गए जन्म डेटा से जन्म सूर्य की ठीक ज़ोडियाक लंबाई पढ़ता है, फिर दिए गए साल में उस सटीक पल को ढूँढता है जब ट्रांज़िटिंग सूरज उसी लंबाई पर वापस आता है - आमतौर पर कैलेंडर जन्मदिन के एक दिन के भीतर. यह रिटर्न पल को जूलियन डे में बदलता है, Swiss Ephemeris इंजन से जियोसेंत्रिक पोजीशन और स्पीड लेता है, और उसके लिए पूरा चार्ट बनाता है: रिटर्न ग्रहों के साइन और हाउस प्लेसमेंट, हाउस कुस्प्स, और पूरा एस्पेक्ट ग्रिड जिसमें एप्लाइंग और सेपरेटिंग फ्लैग्स और सटीक ऑर्ब्स होते हैं. मैच ट्रॉपिकल और Sun-to-natal-Sun है, डिफ़ॉल्ट रूप से प्रीसेशन-करेक्टेड नहीं, इसलिए रिटर्न सूरज जन्म सूर्य के ट्रॉपिकल डिग्री पर रहता है. परिणामी चार्ट को साल के प्रमुख थीम मैप के रूप में पढ़ा जाता है, जो एक जन्मदिन से अगले तक चलता है.
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
सोलर रिटर्न को सालाना फोरकास्टिंग के लिए इस्तेमाल करो - 'एक साल आगे' रिपोर्ट, जन्मदिन-चार्ट फीचर, या AI फ्लो जो एक डेटेड चार्ट से बारह महीने का आउटलुक बनाता है. यह रिटर्न-बेस्ड प्रेडिक्शन का वर्कहॉर्स है: एंगल्स, वह हाउस जहाँ रिटर्न सूरज पड़ता है, और सबसे टाइट एस्पेक्ट्स को साल की मुख्य थीम्स के रूप में पढ़ा जाता है. इसे ट्रांज़िट्स और प्रोग्रेशन के साथ जोड़ो गहराई के लिए, लेकिन सोलर रिटर्न अकेले एक साफ़, सेल्फ-कंटेन्ड सालाना स्नैपशॉट देता है जो व्यक्ति के अपने जन्मदिन से जुड़ा होता है, कैलेंडर से नहीं. क्योंकि तुम सिर्फ जन्म डेटा और साल पास करते हो, यह एनीवर्सरी ट्रिगर्स और शेड्यूल्ड वार्षिक ईमेल में आसानी से फिट हो जाता है - हर साल फिर से कंप्यूट करो ताकि फोरकास्ट आगे बढ़े.
Notes
रिटर्न ट्रॉपिकली, Sun to natal Sun से मैच किया जाता है, और डिफ़ॉल्ट रूप से प्रीसेशन-करेक्टेड नहीं है, इसलिए यह पारंपरिक वेस्टर्न सोलर रिटर्न को दर्शाता है, न कि सिडेरियल-करेक्टेड वेरिएंट को. यह सप्लाई किए गए जन्म स्थान के लिए कास्ट किया जाता है; री-लोकेटेड सोलर रिटर्न को अलग जगह पर री-कास्ट की जरूरत होगी. पूरे में ट्रॉपिकल ज़ोडियाक और Swiss Ephemeris.
Try the सोलर रिटर्न API
Grab a key and make your first call in under a minute.