POSThttps://api.occultapi.com/api/astro/kalsarp/

काल सर्प योग

अनुरोध बॉडीJSON

भेजने के लिए ऊपर API कुंजी पेस्ट करें।

कोड

curl -X POST https://api.occultapi.com/api/astro/kalsarp/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

कुंडली में काल सर्प योग बनता है या नहीं — यानी सूर्य से शनि तक के सातों ग्रह उन दो अर्धवृत्तों में से किसी एक में घिरे हैं या नहीं, जिनमें राहु–केतु अक्ष राशिचक्र को बाँटता है — और अगर बनता है, तो वह बारह नाम वाले रूपों में से कौन-सा है। ज़्यादातर कुंडलियों में काल सर्प नहीं बनता: अक्ष के दूसरी ओर एक भी ग्रह हो, तो योग टूट जाता है। इसलिए यह सिर्फ़ हाँ या ना नहीं लौटाता। `between_rahu_and_ketu` और `between_ketu_and_rahu` बताते हैं कि कौन-सा ग्रह किस ओर पड़ा। इससे आप देख सकते हैं कि उत्तर ऐसा क्यों आया — और यह भी कि कुंडली एक ग्रह से चूकी या चार से। बारह नाम (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag) इस पर निर्भर हैं कि राहु किस भाव में है, और `name` तभी भरा जाता है जब योग सचमुच बनता हो — जो कुंडली बस करीब आकर रह गई, उसके लिए कभी नहीं। जो ग्रह किसी भी पात से एक अंश के भीतर हो, वह किसी भी ओर का नहीं माना जाता। ऐसे ग्रह `conjunct_a_node` में दिए जाते हैं और `partial` सेट करते हैं; फ़ैसला निकालने के लिए उन्हें ज़बरदस्ती किसी एक ओर नहीं रखा जाता। स्थितियाँ /api/astro/planet-positions/ वाले इंजन से ही आती हैं, इसलिए भोगांश हूबहू एक जैसे होते हैं।

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
date_time	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
ayanamsa	string	वैकल्पिक
timezone_as_float	number (double)	वैकल्पिक	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14

इस एंडपॉइंट का पूरा संदर्भ