सोलर आर्क डायरेक्शन्स API
सोलर आर्क पूरी कुंडली को एक ही संख्या से आगे बढ़ाता है: वह दूरी जो सूर्य ने सेकेंडरी प्रोग्रेशन से तय की है। हर ग्रह, हर कस्प और दोनों एंगल उसी आर्क से खिसकते हैं, इसलिए जो नैटल आस्पेक्ट सटीक होने से दो डिग्री दूर था, वह लगभग दो साल बाद सटीक हो जाता है। यह endpoint डायरेक्टेड चार्ट और उसे बनाने वाला आर्क लौटाता है।
सोलर आर्क डायरेक्शन्स API
जन्म डेटा और लक्ष्य तारीख से endpoint पहले चार्ट को दिन-प्रति-वर्ष प्रोग्रेस करता है, मापता है कि प्रोग्रेस्ड सूर्य अपनी नैटल स्थिति से कितना आगे बढ़ा है, और उसी दूरी को आर्क मानता है। फिर वह उस आर्क को एक साथ हर नैटल लॉन्गिट्यूड में जोड़ता है: सभी ग्रह, सभी हाउस कस्प, लग्न और MC। रिस्पॉन्स में डायरेक्टेड पोज़िशन data.planets और data.houses के तहत, आर्क डिग्री में data.arc के तहत, और उसे बनाने वाली key data.key के तहत मिलती है। चूँकि एक ही आर्क समान रूप से लागू होता है, नैटल चार्ट की ज्यामिति बनी रहती है और सिर्फ नैटल डिग्री से उसका संबंध बदलता है - यही इस तकनीक को पढ़ने में इतना सरल बनाता है: एक संख्या किसी उम्र में पूरे चार्ट की स्थिति बता देती है। उसी endpoint पर दो और key उपलब्ध हैं। सूर्य की औसत गति 59'08.3" प्रति वर्ष के लिए key को naibod सेट करो, या सीधी एक डिग्री प्रति वर्ष के लिए इसे छोड़ दो। converse true भेजने पर डायरेक्शन जन्म क्षण से आगे की जगह पीछे की ओर चलता है, जिससे आर्क का चिह्न उलट जाता है।
POST/v1/symbolic-directions
curl -X POST https://api.astroway.info/v1/symbolic-directions \
-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,
"targetDate": "2026-05-15",
"key": "solar_arc"
}'{
"ok": true,
"data": {
"arc": 34.5083,
"key": "solar_arc",
"planets": [
{
"id": 0,
"name": "Sun",
"longitude": 88.8843,
"isRetrograde": false
}
],
"houses": {
"system": "P",
"ascendant": 204.4763,
"mc": 111.5826
}
}
}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. 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). |
| targetDate | string (YYYY-MM-DD) | yes | The date the chart is directed to. |
| key | string | no | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| converse | boolean | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
When to use it
सोलर आर्क तब चुनो जब तुम्हें खगोलीय नहीं बल्कि प्रतीकात्मक टाइमिंग चाहिए, और वह भी ऐसे रूप में जिसे पाठक आसानी से समझ सके। चूँकि सब कुछ एक ही गति से चलता है, डायरेक्टेड संपर्क किसी समय-सीमा के बजाय एक निश्चित वर्ष पर आता है - यह लाइफ-टाइमलाइन फीचर, उम्र-आधारित रिपोर्ट, या ऐसे AI नैरेटिव के लिए उपयुक्त है जिसे बताना हो कि कोई वर्ष किस बारे में है। यह सेकेंडरी प्रोग्रेशन के साथ स्वाभाविक रूप से जुड़ता है, क्योंकि आर्क उसी प्रोग्रेस्ड सूर्य से निकलता है: प्रोग्रेशन तुम्हें चलता हुआ आंतरिक चार्ट देता है, सोलर आर्क पूरे चार्ट को आगे खिसका देता है। जब सटीकता तुम्हारे दर्शकों के लिए मायने रखे तो तीनों keys की तुलना करो। सोलर आर्क वास्तविक सूर्य का अनुसरण करता है इसलिए जन्म तारीख के अनुसार थोड़ा बदलता है, Naibod औसत गति इस्तेमाल करता है, और एक डिग्री प्रति वर्ष गोल संख्या वाला परंपरागत तरीका है। मई के मध्य में जन्म के लिए 36 वर्षों में तीनों क्रमशः लगभग 34.5, 35.5 और 36.0 डिग्री निकलते हैं - दशक पर सहमत होने के लिए काफी करीब, और अलग-अलग वर्ष बताने के लिए काफी दूर।
Notes
आर्क सेकेंडरी-प्रोग्रेस्ड सूर्य द्वारा तय की गई दूरी है, दिन-प्रति-वर्ष, जो मानक परिभाषा है; Naibod key सूर्य की औसत दैनिक गति, 59'08.3" प्रति वर्ष, इस्तेमाल करती है। सोलर आर्क में प्रोग्रेस्ड चार्ट आगे की ओर गणना होता है और यात्रा की दिशा एक बार लागू होती है, इसलिए converse डायरेक्शन आर्क को दोगुना करने के बजाय उसका चिह्न उलटकर लौटाते हैं। पोज़िशन Swiss Ephemeris इंजन से ट्रॉपिकल राशि-चक्र में आती हैं, उन्हीं ग्रहों और हाउस सिस्टम पर जो नैटल endpoints में हैं।
Try the सोलर आर्क डायरेक्शन्स API
Grab a key and make your first call in under a minute.