AstroWay/api v2.201.6 · hi
सभी सिस्टम सामान्य हैं
// astrology api · POST /v1/profections

वार्षिक प्रोफेक्शन API

वार्षिक प्रोफेक्शन सबसे आसान टाइमिंग तकनीक है हेल्लेनिस्टिक टूलकिट में और बहुत इस्तेमाल होती है: चार्ट हर साल एक घर आगे बढ़ता है, और उस घर के साइन का शासक साल का लॉर्ड बन जाता है। एक नंबर इन, एक ग्रह आउट, और पूरे साल की एक सिग्नेचर बनती है।

Endpoint
POST /v1/profections
Cost
20 credits
Latency
~48 ms
Tier
Tier 2
// 01 / What it computes

वार्षिक प्रोफेक्शन API

Endpoint जन्म डेटा और लक्ष्य तिथि लेता है, जन्म क्षण से पूरे साल गिनता है, और प्रत्येक के लिए ascendant से एक पूरा साइन आगे बढ़ाता है। Response गिनी हुई age, उस साल जिस साइन पर आता है उसका zero-based index, और उस साइन को शासित करने वाला ग्रह को lordOfYear के रूप में रिपोर्ट करता है, साथ ही natal ascendant, MC, Sun और Moon भी देता है ताकि तुम chart के खिलाफ साल को बिना दूसरा कॉल किए रेंडर कर सको। House नंबर सीधे age से मिलता है: चक्र बारह साल का है, इसलिए profected house = age modulo twelve, प्लस एक। Age 36 पहले घर पर वापस आता है और इसलिए ascendant के अपने साइन पर, इसलिए sample chart में, जहाँ ascendant Virgo में 169.97 डिग्री है, signIndex 5 और Mercury को उस साल का lord दिखाता है। क्योंकि गिनती जन्म क्षण से शुरू होती है, प्रोफेक्शन साल जन्मदिन पर बदलता है, जनवरी की पहली तारीख पर नहीं।

// 02 / Live request

POST/v1/profections

curl -X POST https://api.astroway.info/v1/profections \
  -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"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
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 whose profection year you want. Age is counted from the birth moment, so the year turns on the birthday, not on January 1.
// 04 / When to use it

When to use it

जब तुम्हें एक टाइमिंग लेयर चाहिए जिसे रीडर बिना ephemeris के फॉलो कर सके, तब प्रोफेक्शन इस्तेमाल करो। हर साल एक शासक ग्रह होता है, इसलिए सालाना फोरकास्ट, जन्मदिन रिपोर्ट या AI कथा एक ही स्पष्ट बयान पर बन सकती है, न कि ट्रांज़िट की टेबल पर। यह transits और returns के साथ खासा अच्छा काम करता है: यहाँ साल का lord ढूँढो, फिर उस ग्रह के ट्रांज़िट से क्या हो रहा है देखो, और तुम्हें दो कॉल में क्लासिकल two-step रीडिंग मिलती है। यह solar return के साथ भी जुड़ता है, जो उसी साल को अलग angle से कवर करता है। तकनीक जानबूझकर मोटी है। यह बताता है कि जीवन का कौन सा विभाग सक्रिय है और उसका कौन जिम्मेदार है, न कि किसी दोपहर में क्या होता है, इसलिए इसे उस फ्रेम की तरह मानो जिस पर तुम finer timing लटकाते हो।

// 05 / Notes

Notes

ascendant से whole-sign प्रोफेक्शन, प्रत्येक पूरे साल पर एक साइन, पारंपरिक domicile rulers साल का lord देते हैं। उम्र जन्म क्षण से गिनी जाती है, इसलिए साल जन्मदिन पर बदलता है। natal ascendant, MC, Sun और Moon Swiss Ephemeris इंजन से tropical zodiac में आते हैं और डिग्री में लौटते हैं।

Try the वार्षिक प्रोफेक्शन API

Grab a key and make your first call in under a minute.

99.9% SLA · पेड प्लान · 30 दिन स्थिति →