curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'जन्म कुंडली के आपसी संबंधों का ढाँचा: कौन-सी राशि किस राशि पर दृष्टि डालती है, कौन-सा ग्रह किस ग्रह पर, कौन किसका मित्र है, और शास्त्रीय ग्रंथ किन ग्रहों को कुंडली के बड़े मोड़ों के लिए ख़ास मानते हैं। जैमिनी और पाराशरी फलादेश का ज़्यादातर तंत्र यही है, जो यहाँ एक-एक हिस्से में उपलब्ध है। keys के तीन समूह हैं। भाव-वर्ग वाली keys (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) शुद्ध ज्यामिति हैं: बारह पंक्तियाँ, हर राशि की एक, जिनमें 1 से 12 तक की राशि संख्याएँ होती हैं; इनका कुंडली से कोई लेना-देना नहीं। दृष्टि और संबंध वाली keys (`raasi_drishti_of_the_planet`, तीनों `aspected_*_of_the_planet` keys, दोनों `*_of_the_raasi` keys, `argala`, `associations_of_the_planet`, नैसर्गिक मैत्री वाली तीनों keys और `baadhakas_of_raasi`) बताती हैं कि कुंडली के पिंड एक-दूसरे से कैसे जुड़े हैं। जैमिनी keys (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) उन ग्रहों के नाम बताती हैं, जो आयु और बड़ी घटनाओं के समय के लिए मायने रखते हैं। ग्रह हर जगह इंडेक्स के रूप में आते हैं: 0 सूर्य, 1 चंद्रमा, 2 मंगल, 3 बुध, 4 बृहस्पति, 5 शुक्र, 6 शनि, 7 राहु, 8 केतु। दृष्टि और जैमिनी keys में राशियाँ 0 से गिनी जाती हैं (0 मेष से 11 मीन), पर भाव-वर्ग वाली keys में 1 से (1 से 12), इसलिए देख लें कि आप कौन-सी key पढ़ रहे हैं। `planet` अनुरोध फ़ील्ड में पहला अक्षर बड़ा होता है और यह केस-संवेदी है — 'Sun', 'sun' नहीं — और `raasi` 0 से गिना जाने वाला पूर्णांक है, जिसकी सीमा जाँची नहीं जाती, इसलिए 0–11 से बाहर की वैल्यू पर अनुरोध विफल हो जाता है।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। फ़ॉर्मैट की शर्त। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)। |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasiस्ट्रिंग का ऐरे। '_of_the_planet' पर ख़त्म होने वाली keys और 'associations_of_the_planet' के लिए `planet` ज़रूरी है; '_of_the_raasi' पर ख़त्म होने वाली keys और 'baadhakas_of_raasi' के लिए `raasi`। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| node | string | ज़रूरी | truemeanकेस-संवेदी, छोटे अक्षरों में। 'true' पर स्पष्ट चंद्र पात लिए जाते हैं, 'mean' पर मध्यम पात। बाकी किसी भी वैल्यू पर KeyError -> 400 मिलता है। आगे इंजन को भेजा जाता है। |
| planet | string | ज़रूरी | SunMoonMarsMercuryJupiterVenusSaturnRahuKetuकेस-संवेदी, पहला अक्षर बड़ा - ध्यान दें कि यह /api/astro/chart_analysis/ के छोटे अक्षरों वाले पिंड-नामों से अलग है। |
| raasi | integer | ज़रूरी | 01234567891011पूर्णांक, स्ट्रिंग नहीं। इसे 0 से गिने जाने वाले (0-BASED) राशि इंडेक्स की तरह लिया जाता है: 0 = मेष... 11 = मीन। सीमा जाँची नहीं जाती, इसलिए सीमा से बाहर की वैल्यू पर IndexError -> 400 मिलता है, और ऋणात्मक वैल्यू चुपचाप उल्टी ओर से गिन ली जाती है। |
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| argala | — | पूरी कुंडली के लिए अर्गला और विरोधार्गला, दो आइटम वाली सूची के रूप में। पहला आइटम अर्गला है, यानी किसी भाव का हस्तक्षेप: बारह पंक्तियाँ, लग्न से हर भाव की एक, और हर पंक्ति में उस भाव से 2रे, 4थे, 5वें और 11वें भाव की चार स्ट्रिंग, जिनमें वहाँ बैठे ग्रहों के इंडेक्स '/' से जुड़े होते हैं; जहाँ कोई ग्रह न हो, वहाँ खाली स्ट्रिंग। दूसरा आइटम विरोधार्गला है, यानी उस हस्तक्षेप की रुकावट, उसी ढाँचे में 12वें, 10वें, 9वें और 3रे भाव के लिए — इसी क्रम में, ताकि इसके कॉलम अर्गला के कॉलमों के सामने जोड़ी बनाएँ। | |
| aspected_houses_of_the_planet | planet | `aspected_rasis_of_the_planet` वाली ही ग्रह दृष्टियाँ, पर राशि इंडेक्स के बजाय लग्न से गिनी गई भाव संख्याओं (1 से 12) में। `planet` ज़रूरी है। | |
| aspected_houses_of_the_raasi | raasi | लग्न से गिने गए वे भाव (1 से 12), जिन पर दी गई राशि की राशि दृष्टि पड़ती है — सभी, उनमें कोई ग्रह हो या न हो। `raasi` में 0 से गिना जाने वाला राशि इंडेक्स देना ज़रूरी है। | |
| aspected_planets_of_the_planet | planet | वे ग्रह, जिन पर दिए गए ग्रह की ग्रह दृष्टि पड़ती है — यानी पाराशरी ग्रह दृष्टि, जिसमें हर ग्रह 7वें भाव को देखता है, और मंगल, बृहस्पति व शनि की अतिरिक्त दृष्टियाँ भी होती हैं। ग्रह इंडेक्स की सूची लौटाती है। `planet` ज़रूरी है। | |
| aspected_raasis_of_the_raasi | raasi | `aspected_houses_of_the_raasi` वाला ही राशि दृष्टि संबंध, पर भाव संख्याओं के बजाय 0 से गिने जाने वाले राशि इंडेक्स में, इसलिए यह लग्न पर बिल्कुल निर्भर नहीं करता। `raasi` ज़रूरी है। | |
| aspected_rasis_of_the_planet | planet | वे राशियाँ, जिन पर दिए गए ग्रह की ग्रह दृष्टि पड़ती है, 0 से गिने जाने वाले राशि इंडेक्स की सूची के रूप में: मेष के लिए 0 से मीन के लिए 11 तक। यह `aspected_houses_of_the_planet` का राशि वाला रूप है। `planet` ज़रूरी है। | |
| associations_of_the_planet | planet | वे सभी ग्रह, जिनसे दिया गया ग्रह तीन शास्त्रीय तरीकों में से किसी से भी सच में जुड़ा है: उसके साथ एक ही राशि में होना, उस पर ग्रह दृष्टि डालना, या उसके साथ राशि परिवर्तन (parivartana) में होना। दोहराव हटाकर ग्रह इंडेक्स की सूची लौटाती है। `planet` ज़रूरी है। | |
| baadhakas_of_raasi | raasi | किसी लग्न राशि के लिए बाधक, यानी रुकावट डालने वाला, भाव और उसके स्वामी ग्रह — चर राशियों के लिए 11वाँ, स्थिर के लिए 9वाँ और द्विस्वभाव के लिए 7वाँ। दो आइटम वाली सूची लौटाती है: [0 से गिनी जाने वाली बाधक राशि, उसके स्वामी ग्रहों के इंडेक्स की सूची]। `raasi` ज़रूरी है। | |
| brahma | — | ब्रह्मा, वह ग्रह जिसे जैमिनी जीवन के पालन से जोड़ते हैं। लग्न और सातवें भाव में से जो बलवान हो, उससे 6ठे, 8वें और 12वें भाव के स्वामियों में जो सबसे बलवान है, वही ब्रह्मा माना जाता है; राहु और केतु इसमें नहीं गिने जाते, और बराबरी होने पर फ़ैसला गरिमा, विषम राशि में होने और आधे हिस्से में स्थिति से होता है। एक ग्रह इंडेक्स लौटाती है। | |
| chara_karakas | — | आठ चर कारक, आठ ग्रह इंडेक्स की सूची के रूप में, अपनी राशि में अंश के घटते क्रम में। पहला आत्मकारक है, और बाकी मानक क्रम में आते हैं (अमात्य, भ्रातृ, मातृ, पितृ, पुत्र, ज्ञाति, दारा)। केतु इसमें नहीं है, और शास्त्रीय नियम के अनुसार राहु का क्रम उसके उल्टे भोगांश से तय होता है। | |
| chathusras | — | बारह पंक्तियाँ, हर पंक्ति में 1–12 की दो राशि संख्याएँ। जैसा कोड में बना है, हर पंक्ति राशि से 3री और 5वीं राशि देती है — पंक्ति 1 [3, 5] है — न कि 4थी और 8वीं, जिन्हें शास्त्रों में चतुरस्र कहा जाता है। | |
| dushthanas | — | बारह पंक्तियाँ, हर पंक्ति में 1–12 की तीन राशि संख्याएँ। जैसा कोड में बना है, हर पंक्ति राशि ख़ुद, उससे 3री और उससे 7वीं राशि देती है — पंक्ति 1 [1, 3, 7] है — जो शास्त्रीय 6/8/12 वाले दुःस्थान नहीं हैं। इसलिए इस आउटपुट को किताबी अर्थ में दुःस्थान न मानें; यह वही है जो कोड निकालता है। | |
| kendras | — | हर राशि के केंद्र: बारह पंक्तियाँ, हर राशि की एक, और हर पंक्ति में 1 से 12 तक की चार राशि संख्याओं की सूची। पंक्ति 0 मेष है। कोई आर्ग्युमेंट नहीं लेती। इसका ढाँचा /api/astro/strength/ की `kendras` key से अलग है, जो `asc_house` लेती है और 0 से गिने जाने वाले (ZERO-based) चार इंडेक्स की एक फ़्लैट सूची लौटाती है - दोनों की गिनती में एक का अंतर है, इन्हें आपस में न मिलाएँ। | |
| maheshwara | — | `maheshwara_from_planet_positions` वाली ही वैल्यू — यह key सीधे उसी को बुलाती है और वही एक ग्रह इंडेक्स लौटाती है। दोनों में से कोई एक माँगें। | |
| maheshwara_from_planet_positions | — | महेश्वर, वह ग्रह जिसे जैमिनी मृत्यु के प्रकार से जोड़ते हैं। इसे आत्मकारक से आठवीं राशि का स्वामी माना जाता है; अगर वह स्वामी अपनी ही राशि में हो, या किसी पात के साथ युति या प्रतियुति में हो, तो शास्त्रीय नियमों से उसकी जगह कोई दूसरा ग्रह लिया जाता है। एक ग्रह इंडेक्स लौटाती है; अगर नतीजा राहु या केतु आए, तो उसकी जगह क्रमशः बुध या बृहस्पति दिया जाता है। | |
| marakas | — | `marakas_from_planet_positions` वाले ही मारक ग्रह, बस गणना कुंडली के भाव-से-ग्रह वाले रूप से होती है। नतीजा ग्रह इंडेक्स की वही सूची है, इसलिए दोनों के बजाय कोई एक माँगें। | |
| marakas_from_planet_positions | — | मारक, यानी मृत्यु देने वाले, ग्रह: 2रे और 7वें भाव के स्वामी, और साथ में कोई भी ग्रह जो इन दोनों भावों में से किसी में बैठा हो या इन दोनों स्वामियों में से किसी के साथ हो। ग्रह इंडेक्स की सूची लौटाती है, किसी ख़ास क्रम में नहीं। गणना कुंडली के ग्रह-स्थिति वाले रूप से होती है। | |
| natural_enemies_of_planets | — | मानक शत्रुता तालिका: नौ सूचियों की सूची, ग्रह 0–8 के इंडेक्स से, और हर सूची में उस ग्रह के शत्रु ग्रह। यह तय है और कुंडली पर निर्भर नहीं करती; `natural_neutral_of_planets` इसकी जोड़ीदार है। | |
| natural_friends_of_planets | — | स्थायी ग्रह मैत्री, इसी कुंडली के राशि स्वामित्व से निकाली गई: एक ऑब्जेक्ट, जिसकी keys ग्रह इंडेक्स 0–8 हैं, और हर एक में उसके मित्र ग्रहों के इंडेक्स की सूची। सात शास्त्रीय ग्रहों के लिए मित्र राशियों के स्वामियों के साथ उच्च राशि का स्वामी भी जोड़ा जाता है। | |
| natural_neutral_of_planets | — | मानक सम (तटस्थ) ग्रहों की तालिका: नौ सूचियों की सूची, ग्रह 0–8 के इंडेक्स से, और हर सूची में उस ग्रह के सम ग्रह। `natural_friends_of_planets` से अलग, यह तय शास्त्रीय तालिका है और कुंडली पर बिल्कुल निर्भर नहीं करती। | |
| order_of_planets_by_strength | — | सभी नौ ग्रह, सबसे बलवान पहले, नौ ग्रह इंडेक्स की सूची के रूप में। क्रम इंजन की जोड़ी-दर-जोड़ी बल तुलना से आता है; यही तुलना रुद्र और महेश्वर की गणना में दावेदार स्वामियों के बीच चुनने के लिए भी होती है। | |
| planets_aspecting_the_planet | planet | इसे दिए गए ग्रह पर ग्रह दृष्टि डालने वाले ग्रह, ग्रह इंडेक्स की सूची के रूप में, लौटाने चाहिए। पर अभी यह बड़े अक्षर से शुरू होने वाले ग्रह-नाम की तुलना ग्रह इंडेक्स की सूचियों से करती है, इसलिए हर इनपुट पर खाली सूची लौटाती है। इसके बजाय हर ग्रह के लिए बारी-बारी से `aspected_planets_of_the_planet` इस्तेमाल करें और नतीजे को उलटकर पढ़ें। | |
| quadrants | — | हर राशि के केंद्र: बारह पंक्तियाँ, हर पंक्ति में 1–12 की चार राशि संख्याएँ — राशि ख़ुद, और उससे 4थी, 7वीं और 10वीं राशि। पंक्ति 1 [1, 4, 7, 10] है। इस एंडपॉइंट पर यह `kendras` का दूसरा नाम (alias) है — दोनों का नतीजा कभी अलग नहीं हो सकता, इसलिए दोनों माँगने से उत्तर में बस एक जगह बेकार जाती है। | |
| raasi_drishti_of_the_planet | planet | वे ग्रह, जो उन राशियों में बैठे हैं जिन पर दिए गए ग्रह की राशि की राशि दृष्टि पड़ती है — यानी जैमिनी की राशि-से-राशि दृष्टि, जिसमें चर राशियाँ स्थिर राशियों को देखती हैं और स्थिर राशियाँ चर को, और द्विस्वभाव राशियाँ एक-दूसरे को। ग्रह इंडेक्स की सूची लौटाती है। `planet` ज़रूरी है। | |
| rudra | — | रुद्र, जिसे लग्न से आठवें भाव के स्वामी और सातवें भाव से आठवें भाव के स्वामी में से बलवान ग्रह माना जाता है। [ग्रह इंडेक्स, 0 से गिनी जाने वाली वह राशि जिसमें वह है, उस राशि की 0 से गिनी जाने वाली तीन त्रिकोण राशियाँ] लौटाती है। ध्यान दें कि यह `rudra_based_on_planet_positions` से अलग है, जो दोनों में से दूसरा स्वामी अलग तरीके से निकालती है, इसलिए उसका ग्रह अलग हो सकता है। | |
| rudra_based_on_planet_positions | — | रुद्र, वह ग्रह जिसे जैमिनी कुंडली के विनाशकारी मोड़ से जोड़ते हैं — यहाँ लग्न से आठवीं राशि के स्वामी और सातवें भाव के स्वामी में से बलवान ग्रह। तीन आइटम वाली सूची लौटाती है: [ग्रह इंडेक्स, 0 से गिनी जाने वाली वह राशि जिसमें वह है, उस राशि की 0 से गिनी जाने वाली तीन त्रिकोण राशियाँ]। यह `rudra` से अलग तरीके से निकाली जाती है, और दोनों अलग-अलग ग्रह बता सकती हैं। | |
| trikonas | — | हर राशि के त्रिकोण: बारह पंक्तियाँ, हर पंक्ति में 1–12 की तीन राशि संख्याएँ — राशि ख़ुद, और उससे 5वीं और 9वीं राशि। पंक्ति 1 [1, 5, 9] है। शुद्ध ज्यामिति — हर कुंडली के लिए एक जैसी। | |
| trishoola_rasis | — | त्रिशूल राशियाँ, यानी तीन राशियों का त्रिशूल, जिससे कुंडली की सबसे नुक़सानदेह अवधि का समय देखा जाता है: रुद्र जिस राशि में है, उसकी त्रिकोण राशियाँ। 0 से गिने जाने वाले तीन राशि इंडेक्स लौटाती है। | |
| upachayas | — | बारह पंक्तियाँ, हर पंक्ति में 1–12 की चार राशि संख्याएँ। जैसा कोड में बना है, हर पंक्ति राशि ख़ुद और उससे 4थी, 8वीं और 9वीं राशि देती है — पंक्ति 1 [1, 4, 8, 9] है — न कि 3री, 6ठी, 10वीं और 11वीं, जो शास्त्रों में उपचय कहलाती हैं। |