POST/api/astro/chart/1 क्रेडिट

जन्म कुंडली

कुंडली का मुख्य एंडपॉइंट: किसी क्षण और स्थान के लिए ग्रहों की स्थितियाँ, भाव विभाजन और लग्न। सामान्य जन्म कुंडली के लिए राशि कुंडली (D-1) माँगें, या नाम देकर तीस से ज़्यादा वर्ग कुंडलियों में से कोई भी — नवांश, दशमांश, द्वादशांश, षष्ट्यंश आदि। नामों का ऐरे भेजें, तो एक ही कॉल में कई कुंडलियाँ मिल जाती हैं, जिनकी keys कुंडलियों के नाम होते हैं। हर कुंडली में तीन खंड आते हैं। `celestial` की keys पिंडों के नाम हैं (sun, moon, … northtruenode), और इसमें हर पिंड का भोगांश, शर, नक्षत्र और पद, कक्ष्या, राशि का नाम और भाव संख्या होती है। `houses` की keys 1 से 12 हैं, और हर भाव का `start`, `cusp` और `end` दिया जाता है। `ascendant` में लग्न का अंश और उसकी राशि होती है। `notation` पूरे उत्तर की इकाइयाँ तय करता है: दशमलव अंशों के लिए 'degree', और राशि के साथ अंश, कला, विकला के लिए 'astrological'। बारीकी वैकल्पिक फ़ील्ड में है। `ayanamsa` निरयन की परिभाषा चुनता है, और `apply_correction` के साथ `correction_deg`, `correction_min`, `correction_sec` और `correction_direction` से उसे हाथ से आगे-पीछे किया जा सकता है। `rahu` स्पष्ट पात, मध्यम पात या दोनों चुनता है। `extended_bodies` क्षुद्रग्रह, यूरेनियन काल्पनिक पिंड या ग्रहों के चंद्रमा जोड़ता है; जिनकी एफ़ेमेरिस फ़ाइलें मौजूद नहीं, उन्हें बिना बताए छोड़ देता है। `ascendant_pos` तय करता है कि लग्न भाव के कस्प, आरंभ या अंत पर पढ़ा जाए — ध्यान दें कि 'start' या 'end' के सिवा कोई भी वैल्यू, टाइपो भी, बिना कोई त्रुटि दिए कस्प पर लौट आती है। इस एंडपॉइंट पर तारीख़ वाले फ़ील्ड का नाम `datetime` है, `date_time` नहीं। SVG रेंडरिंग, चाहें तो। render को 'svg' सेट करें, तो उत्तर में दो फ़ील्ड और जुड़ जाते हैं, ऊपर के चारों की जगह नहीं, उनके साथ: `layout` ज्यामिति है — हर भाव या राशि सेल के बहुभुज के बिंदु, लेबल की जगह, और उसमें कौन-से पिंड हैं — ताकि आप React, Canvas, Flutter या SwiftUI में अपना डायग्राम ख़ुद बना सकें। `svg` उसी ज्यामिति से बना, सीधे लगाने लायक मार्कअप है। chart_style से उत्तर भारतीय (हीरे का आकार, स्थिर भाव, घूमती राशियाँ) या दक्षिण भारतीय (स्थिर राशियों का ग्रिड, घूमते भाव) शैली चुनी जाती है; svg_size, theme, label_style, show_degrees और चारों *_color फ़ील्ड से रेंडरिंग तय होती है। ये सारे फ़ील्ड डिफ़ॉल्ट रूप से बंद हैं, इसलिए जिस अनुरोध में render का ज़िक्र नहीं, उस पर कोई असर नहीं पड़ता — उत्तर ठीक वैसा ही रहता है जैसा हमेशा से था।

https://api.occultapi.com/api/astro/chart/

अनुरोध आज़माएँ

जन्म कुंडली का नतीजा, एक इंटरफ़ेस में — इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
ascendant_pos	string	ज़रूरी	`cuspstartend` 'start' पर भाव का आरंभ और 'end' पर भाव का अंत लिया जाता है; बाकी कोई भी वैल्यू - ख़ुद 'cusp' और कोई भी टाइपो भी - else शाखा में चली जाती है और भाव कस्प लिया जाता है। यानी असली डिफ़ॉल्ट 'cusp' है, और गलत वर्तनी पर त्रुटि नहीं आती, बस चुपचाप कस्प मान लिया जाता है। केस-संवेदी।
ayanamsa	string	ज़रूरी	`FAGAN_BRADLEYLAHIRIDELUCERAMANUSHASHASHIKRISHNAMURTIDJWHAL_KHULYUKTESHWARJN_BHASINBABYL_KUGLER1BABYL_KUGLER2BABYL_KUGLER3` केस-असंवेदी - लुकअप के लिए name.upper इस्तेमाल होता है। /api/astro/ayanamsa_value/ से अलग, यहाँ 'USER' अस्वीकार नहीं होता। अनजान वैल्यू पर 400 "Undefined ayanamsa: <name>" मिलता है। ध्यान दें कि apply_correction=true होने पर यह चुनाव रद्द हो जाता है और अंदर का मोड USER पर चला जाता है।
chart_name	string	ज़रूरी	`BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChart` केस-संवेदी, और वर्तनी ठीक वैसी ही जैसी सूची में है। एक नाम भेजें, या एक ही कॉल में कई कुंडलियाँ चाहिए तो नामों का ऐरे - तब उत्तर की keys कुंडलियों के नाम होती हैं। अनजान नाम पर 400 मिलता है।
datetime	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है। इसका अर्थ date_time जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं। यह फ़ॉर्मैट की शर्त है, enum नहीं। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)। ध्यान दें कि इस एंडपॉइंट पर फ़ील्ड का नाम `datetime` है, `date_time` नहीं।
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -180 · max 180
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
notation	string	ज़रूरी	`astrologicaldegree` केस-संवेदी, छोटे अक्षरों में। 'astrological' पर राशि/अंश/कला/विकला अलग-अलग मिलते हैं; 'degree' पर कच्चे दशमलव अंश। कुछ और भेजने पर 400 "Invalid notation: <x>" मिलता है।
aberration	boolean	वैकल्पिक
apply_correction	boolean	वैकल्पिक
background_color	string	वैकल्पिक	SVG की पृष्ठभूमि का हेक्स रंग।
chart_style	string	वैकल्पिक	render='svg' होने पर चार्ट की शैली। 'north' हीरे के आकार वाला लेआउट है, जिसमें भाव अपनी जगह रहते हैं और राशियाँ घूमती हैं; 'south' ग्रिड वाला लेआउट है, जिसमें राशियाँ अपनी जगह रहती हैं और भाव घूमते हैं। `northsouth`
correction_deg	integer	वैकल्पिक	min 0
correction_direction	string	वैकल्पिक	`addsubtract` डिफ़ॉल्ट 'add'। इसका असर तभी होता है, जब apply_correction=true हो और correction_deg/min/sec में से कम से कम एक शून्य न हो।
correction_min	integer	वैकल्पिक	min 0 · max 59
correction_sec	integer	वैकल्पिक	min 0 · max 59
extended_bodies	array	वैकल्पिक	किन पिंड-समूहों को शामिल करना है: 'asteroids', 'planetary_moons', 'fictitious_bodies'। `asteroidsplanetary_moonsfictitious_bodies` स्ट्रिंग का ऐरे, डिफ़ॉल्ट []। 'asteroids' से chiron, pholus, ceres, pallas, juno, vesta जुड़ते हैं; 'fictitious_bodies' से cupido, hades, zeus, kronos, apollon, admetos, vulkanus, poseidon, selena; 'planetary_moons' से phobos, deimos, io, europa, ganymede, callisto, titan, triton, charon। जिन पिंडों की एफ़ेमेरिस फ़ाइलें मौजूद नहीं, वे उत्तर से बिना बताए हटा दिए जाते हैं।
label_style	string	वैकल्पिक	ग्रहों के लेबल किस रूप में हों: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) या 'symbol' (☉, ☽, ...)। `englishsanskritsymbol`
line_color	string	वैकल्पिक	चार्ट की ग्रिड रेखाओं का हेक्स रंग।
nutation	boolean	वैकल्पिक
planet_color	string	वैकल्पिक	ग्रहों के लेबल का हेक्स रंग, जैसे '#111827'। डिफ़ॉल्ट रूप से थीम का अपना रंग।
rahu	string	वैकल्पिक	कौन-सा पात शामिल करना है। 'true' देने पर केवल स्पष्ट पात, 'mean' पर केवल मध्यम पात, और 'both' पर दोनों मिलते हैं। `truemeanboth` डिफ़ॉल्ट 'true'। 'true' पर केवल स्पष्ट पात, 'mean' पर केवल मध्यम पात, और 'both' पर चारों मिलते हैं।
refraction	boolean	वैकल्पिक
render	string	वैकल्पिक	'svg' दें, तो साथ में रेंडर किया हुआ चार्ट डायग्राम (chart_style देखें) और उसकी ज्यामिति भी मिलती है। इसे न भेजें, तो उत्तर में कोई बदलाव नहीं होता। `nonesvg`
show_degrees	boolean	वैकल्पिक	हर पिंड के लेबल के पास, उसकी राशि में उसका अंश भी दिखाएँ।
sign_color	string	वैकल्पिक	राशि संख्याओं/संक्षिप्त नामों का हेक्स रंग।
svg_size	integer	वैकल्पिक	वर्गाकार SVG viewBox की चौड़ाई और ऊँचाई, पिक्सेल में। min 100 · max 2000
theme	string	वैकल्पिक	`lightdark`
true_mean	string	वैकल्पिक	`TrueMean` केस-संवेदी, पहला अक्षर बड़ा। डिफ़ॉल्ट 'Mean'। ग्रहों की वास्तविक या मध्यम स्थिति में से एक चुनता है (वास्तविक, यानी दृश्य नहीं)।
use_28_nakshatras	boolean	वैकल्पिक

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/astro/chart/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_name":"NavamsaChart","datetime":"2026-04-09T15:35:00+05:30","longitude":75.76861133842026,"latitude":26.849874414615,"notation":"degree","ayanamsa":"lahiri","ascendant_pos":"cusp","rahu":"true","true_mean":"Mean","refraction":false,"apply_correction":false,"correction_direction":"add","correction_deg":0,"correction_min":0,"correction_sec":0}'

उत्तर

{
  "data": {
    "NavamsaChart": {
      "celestial": {
        "sun": {
          "longitude": 318.0675,
          "latitude": 0,
          "nakshatra": "Satabhishak",
          "pada": 4,
          "kakshya": "venus",
          "zodiac_name": "Aquarius",
          "house": 8
        },
        "moon": {
          "longitude": 150.3425,
          "latitude": -4.343,
          "nakshatra": "Uttara Phalguni",
          "pada": 2,
          "kakshya": "saturn",
          "zodiac_name": "Virgo",
          "house": 3
        },
        "mercury": {
          "longitude": 74.3125,
          "latitude": -2.291,
          "nakshatra": "Aardra",
          "pada": 3,
          "kakshya": "sun",
          "zodiac_name": "Gemini",
          "house": 12
        },
        "venus": {
          "longitude": 159.8475,
          "latitude": -0.081,
          "nakshatra": "Uttara Phalguni",
          "pada": 4,
          "kakshya": "mars",
          "zodiac_name": "Virgo",
          "house": 3
        },
        "mars": {
          "longitude": 139.1825,
          "latitude": -1.01,
          "nakshatra": "Poorva Phalguni",
          "pada": 2,
          "kakshya": "Mercury",
          "zodiac_name": "Leo",
          "house": 2
        },
        "jupiter": {
          "longitude": 19.82499999999999,
          "latitude": 0.377,
          "nakshatra": "Bharani",
          "pada": 2,
          "kakshya": "Mercury",
          "zodiac_name": "Aries",
          "house": 10
        },
        "saturn": {
          "longitude": 201.275,
          "latitude": -2.136,
          "nakshatra": "Visaakha",
          "pada": 1,
          "kakshya": "Mercury",
          "zodiac_name": "Libra",
          "house": 4
        },
        "uranus": {
          "longitude": 314.28,
          "latitude": -0.169,
          "nakshatra": "Satabhishak",
          "pada": 3,
          "kakshya": "sun",
          "zodiac_name": "Aquarius",
          "house": 8
        },
        "neptune": {
          "longitude": 164.6175,
          "latitude": -1.31,
          "nakshatra": "Hasta",
          "pada": 2,
          "kakshya": "sun",
          "zodiac_name": "Virgo",
          "house": 3
        },
        "pluto": {
          "longitude": 10.007499999999991,
          "latitude": -3.973,
          "nakshatra": "Ashwini",
          "pada": 4,
          "kakshya": "mars",
          "zodiac_name": "Aries",
          "house": 10
        },
        "northtruenode": {
          "longitude": 304.65,
          "latitude": 0,
          "nakshatra": "Dhanishtha",
          "pada": 4,
          "kakshya": "jupiter",
          "zodiac_name": "Aquarius",
          "house": 8
        },
        "southtruenode": {
          "longitude": 124.65,
          "latitude": 0,
          "nakshatra": "Makha",
          "pada": 2,
          "kakshya": "jupiter",
          "zodiac_name": "Leo",
          "house": 2
        }
      },
      "houses": {
        "1": {
          "start": 118.24667529991994,
          "cusp": 133.24667529991996,
          "end": 148.24667529991996
        },
        "2": {
          "start": 148.24667529991996,
          "cusp": 163.24667529991996,
          "end": 178.24667529991996
        },
        "3": {
          "start": 178.24667529991996,
          "cusp": 193.24667529991996,
          "end": 208.24667529991996
        },
        "4": {
          "start": 208.24667529991996,
          "cusp": 223.24667529991993,
          "end": 238.24667529991993
        },
        "5": {
          "start": 238.24667529991993,
          "cusp": 253.24667529991993,
          "end": 268.2466752999199
        },
        "6": {
          "start": 268.2466752999199,
          "cusp": 283.2466752999199,
          "end": 298.2466752999199
        },
        "7": {
          "start": 298.2466752999199,
          "cusp": 313.2466752999199,
          "end": 328.2466752999199
        },
        "8": {
          "start": 328.2466752999199,
          "cusp": 343.2466752999199,
          "end": 358.2466752999199
        },
        "9": {
          "start": 358.2466752999199,
          "cusp": 13.246675299919922,
          "end": 28.24667529991992
        },
        "10": {
          "start": 28.24667529991992,
          "cusp": 43.24667529991992,
          "end": 58.24667529991993
        },
        "11": {
          "start": 58.24667529991993,
          "cusp": 73.24667529991993,
          "end": 88.24667529991993
        },
        "12": {
          "start": 88.24667529991993,
          "cusp": 103.24667529991991,
          "end": 118.24667529991994
        }
      },
      "ascendant": {
        "longitude": 133.24667529991996,
        "zodiac_name": "Cancer",
        "nakshatra": "Makha",
        "pada": 4
      },
      "ayanamsa_used": {
        "name": "LAHIRI",
        "corrected": false,
        "value_degrees": 24.224068,
        "formatted": "24°13'27\""
      }
    }
  },
  "message": "successful",
  "is_error": false
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।