NatalChart.AI
hi
मुफ़्त कुंडली

डेवलपर्स

जन्म कुंडली API

JSON में ज्योतिष गणनाएँ, Swiss Ephemeris से की गईं: वही इंजन जो NatalChart.AI में हर कुंडली बनाता है, बस व्याख्या की परत के बिना। कोई AI कॉल नहीं होती, इसलिए एक ही इनपुट पर हमेशा वही संख्याएँ मिलती हैं।

✦ Swiss Ephemeris✦ हर दिन 10 अनुरोध मुफ़्त✦ अनुरोध की सामग्री कभी संग्रहीत नहीं होती
API कुंजी पाएँOpenAPI दस्तावेज़

अपडेट: · अगली समीक्षा:

बेस URL: https://api.natalchart.ai। हर अनुरोध के साथ एक API कुंजी जाती है, हर उत्तर JSON में आता है, और हर भोगांश राशि में बदले जाने से पहले अंश के चार दशमलव स्थानों तक दिया जाता है। कुंजी मुफ़्त है: NatalChart.AI खाते से साइन इन करें और एक कुंजी बनाएँ।

जल्दी शुरू करें

curl https://api.natalchart.ai/v1/chart/short \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'

इस पूरी साइट पर इस्तेमाल होने वाले डेमो जन्म विवरण (1991-09-06, 18:30, कीव) के लिए उत्तर। पिंडों में से पाँच दिखाए गए हैं:

{
  "sun": {
    "sign": "Virgo",
    "degreeInSign": 13.55,
    "house": 7
  },
  "moon": {
    "sign": "Leo",
    "degreeInSign": 19.02,
    "house": 7
  },
  "ascendant": {
    "sign": "Aquarius",
    "degreeInSign": 14.9898
  },
  "signs": {
    "Sun": "Virgo",
    "Moon": "Leo",
    "Mercury": "Leo",
    "Venus": "Leo",
    "Mars": "Libra"
  },
  "retrograde": [
    "Venus",
    "Saturn",
    "Uranus",
    "Neptune",
    "TrueNode",
    "Lilith",
    "Juno"
  ]
}

AI सहायकों के लिए MCP सर्वर

यही गणनाएँ https://www.natalchart.ai/mcp पर MCP सर्वर के रूप में उपलब्ध हैं, Claude, ChatGPT, Cursor और VS Code के लिए। यह वही कुंजी लेता है और उसी दैनिक कोटे से ख़र्च करता है, हर टूल कॉल पर एक अनुरोध। हर क्लाइंट के लिए सेटअप: AI सहायकों के लिए MCP सर्वर।

प्रमाणीकरण

कुंजी को Authorization: Bearer nc_live_... के रूप में भेजें (X-API-Key हेडर भी काम करता है)। पूरी कुंजी सिर्फ़ एक बार दिखाई जाती है, जब आप उसे बनाते हैं; हम उसका सिर्फ़ हैश रखते हैं। एक खाते में ज़्यादा से ज़्यादा पाँच सक्रिय कुंजियाँ हो सकती हैं, और खाता उनमें से किसी को भी तुरंत निरस्त कर सकता है। कुंजियाँ सर्वर पर रखें: ब्राउज़र या ऐप के कोड में भेजी गई कुंजी कोई भी पढ़ सकता है।

जन्म विवरण

कुंडली की गणना करने वाले एंडपॉइंट एक ऑब्जेक्ट लेते हैं:

{
  "birth": {
    "date": "1991-09-06",
    "time": "18:30",
    "latitude": 50.4501,
    "longitude": 30.5234,
    "timezone": "Europe/Kyiv"
  }
}
फ़ील्डज़रूरीअर्थ
dateहाँजन्म तिथि, YYYY-MM-DD, 1800 से 2399 तक।
timeनहींस्थानीय समय, HH:mm, 24 घंटे वाला। अज्ञात हो तो null।
latitude, longitudeहाँदशमलव अंशों में, उत्तर और पूर्व धनात्मक।
timezoneनहींIANA समय क्षेत्र। न दिया जाए, तो उसे निर्देशांकों से, उस तारीख़ के डेलाइट सेविंग टाइम के नियमों के साथ तय किया जाता है।

एंडपॉइंट

एंडपॉइंटप्लानक्या लौटाता है
POST /v1/chart/shortमुफ़्तसंक्षिप्त कुंडली: अंशों के साथ सूर्य, चंद्र और लग्न, हर पिंड की राशि, वक्री पिंड, प्रमुख तत्व और स्वभाव।
POST /v1/chart/fullमुफ़्तपूरी कुंडली: हर पिंड भोगांश, राशि, अंश, गति, वक्री फ़्लैग और भाव के साथ; केंद्र बिंदु; प्लेसिडस के बारह कस्प (भाव के आरंभ बिंदु); ऑर्ब के साथ दृष्टियाँ; तत्वों और स्वभावों का संतुलन; स्थिर तारों से संपर्क।
POST /v1/chart/planetsमुफ़्तसिर्फ़ पिंड: भोगांश, राशि, राशि के भीतर अंश, दैनिक गति, वक्री फ़्लैग, भाव।
POST /v1/chart/anglesमुफ़्तलग्न, मध्याकाश, वर्टेक्स और भाग्य भाग।
POST /v1/chart/housesमुफ़्तप्लेसिडस भावों के बारह कस्प।
POST /v1/chart/aspectsमुफ़्तपिंडों के बीच पाँच प्रमुख दृष्टियाँ, हर एक अपने कोण और ऑर्ब के साथ, और इस्तेमाल की गई ऑर्ब तालिका।
POST /v1/chart/elementsमुफ़्ततत्वों और स्वभावों का संतुलन, साथ में प्रमुख तत्व और प्रमुख स्वभाव।
POST /v1/chart/fixed-starsमुफ़्तजन्म कुंडली के पिंडों से 1.5 अंश के भीतर स्थिर तारों की युति।
POST /v1/horoscope/dailyमुफ़्तगणना किया गया दिन: UTC के अनुसार दोपहर 12 बजे का आकाश, चंद्र कला, आने वाले हफ़्ते की आकाशीय घटनाएँ और, जन्म विवरण देने पर, जन्म कुंडली पर हर गोचर अपने ऑर्ब के साथ। तैयार किया गया कोई पाठ नहीं।
GET /v1/skyमुफ़्तकिसी तारीख़ के लिए ग्रह स्थितियाँ, चंद्र कला और आने वाले हफ़्ते की आकाशीय घटनाएँ (?date=YYYY-MM-DD, डिफ़ॉल्ट रूप से आज)।
GET /v1/usageमुफ़्तआपका प्लान, आज की गिनती और कोटा कब दोबारा भरेगा। इसमें कुछ ख़र्च नहीं होता।
POST /v1/transitsAPI Pro92 दिनों तक की अवधि में हर गोचर घटना: तारीख़ के अनुसार जन्म कुंडली पर गोचर की सटीक दृष्टियाँ, राशि प्रवेश और ठहराव।
POST /v1/synastryAPI Proदो कुंडलियों की तुलना: ऑर्ब के साथ कुंडलियों के बीच की दृष्टियाँ, दोनों ओर से एक-दूसरे के भावों में ग्रह और हर जीवन क्षेत्र के लिए एक स्कोर।
POST /v1/solar-returnAPI Proकिसी साल के लिए सोलर रिटर्न कुंडली (वर्ष कुंडली), जन्म स्थान या किसी दूसरे स्थान के लिए बनाई गई।
POST /v1/timingAPI Pro62 दिनों तक की अवधि का हर दिन, एक गतिविधि (general, business, romance, health, creative, travel, home, clarity) के लिए स्कोर किया गया: मदद करने वाले और बाधा डालने वाले गोचर, चंद्र की कला और राशि, वॉइड ऑफ़ कोर्स चंद्र। सबसे अच्छे पाँच दिन सबसे पहले।
POST /v1/locations/scoreAPI Proएक कुंडली के सामने एक स्थान: स्थानांतरित केंद्र बिंदु, उन पर पड़ने वाले ग्रह ऑर्ब के साथ, हर जीवन क्षेत्र के लिए स्कोर और कुल स्कोर।
POST /v1/locations/rankAPI Proबड़े शहरों की सूची, एक कुंडली के लिए क्रम में लगाई गई, कुल मिलाकर या चुने गए जीवन क्षेत्रों के हिसाब से, पूरी दुनिया में या किसी एक भौगोलिक क्षेत्र में।

पूरी कुंडली

POST /v1/chart/full पूरी गणना उसी ढाँचे में लौटाता है जो प्रकाशित डेमो फ़ाइल का है, ताकि कोई भी कोड लिखने से पहले आप किसी उत्तर को एक तय कुंडली से मिलाकर जाँच सकें। यहाँ इसे दो पिंडों, दो कस्प और दो सबसे सटीक दृष्टियों तक छोटा किया गया है:

{
  "input": {
    "date": "1991-09-06",
    "time": "18:30",
    "latitude": 50.4501,
    "longitude": 30.5234,
    "timeKnown": true
  },
  "time": {
    "timezone": "Europe/Kyiv",
    "offsetHours": 3,
    "julianDayUT": 2448506.1458333335
  },
  "planets": [
    {
      "name": "Sun",
      "longitude": 163.5457,
      "sign": "Virgo",
      "degreeInSign": 13.55,
      "speed": 0.9704,
      "retrograde": false,
      "house": 7
    },
    {
      "name": "Moon",
      "longitude": 139.0225,
      "sign": "Leo",
      "degreeInSign": 19.02,
      "speed": 14.5955,
      "retrograde": false,
      "house": 7
    }
  ],
  "angles": {
    "ascendant": {
      "longitude": 314.9898,
      "sign": "Aquarius"
    },
    "midheaven": {
      "longitude": 249.8956,
      "sign": "Sagittarius"
    }
  },
  "houses": [
    {
      "number": 1,
      "cusp": 314.9898,
      "sign": "Aquarius"
    },
    {
      "number": 2,
      "cusp": 13.7492,
      "sign": "Aries"
    }
  ],
  "aspects": [
    {
      "planet1": "Pallas",
      "planet2": "Juno",
      "aspect": "Square",
      "angle": 89.79,
      "orb": 0.21,
      "phase": "separating"
    },
    {
      "planet1": "Pluto",
      "planet2": "TrueNode",
      "aspect": "Sextile",
      "angle": 59.57,
      "orb": 0.43,
      "phase": "separating"
    }
  ],
  "elements": {
    "Fire": 7,
    "Earth": 6,
    "Air": 4,
    "Water": 2
  },
  "qualities": {
    "Cardinal": 6,
    "Fixed": 11,
    "Mutable": 2
  }
}

खंड वाले एंडपॉइंट (planets, angles, houses, aspects, elements, fixed-stars) में से हर एक उसी ऑब्जेक्ट का एक हिस्सा लौटाता है, उन कॉल करने वालों के लिए जिन्हें सिर्फ़ वही हिस्सा चाहिए।

दैनिक राशिफल

POST /v1/horoscope/daily दैनिक राशिफल का वह आधा हिस्सा है जिसकी गणना होती है: UTC के अनुसार दोपहर 12 बजे का आकाश, चंद्र की कला और राशि, आने वाले हफ़्ते की आकाशीय घटनाएँ और, जब आप birth भेजते हैं, उस कुंडली पर हर गोचर, और हर गोचर के साथ उसकी दृष्टि, उसका ऑर्ब, दृष्टि निकट आ रही है या दूर जा रही है, किस क्षण वह सटीक है या थी, और गोचर करने वाला पिंड जन्म कुंडली के किस भाव में है। गोचर के ऑर्ब चंद्र, सूर्य, बुध, शुक्र और मंगल के लिए 2° और धीमे पिंडों के लिए 3° हैं। दो फ़ील्ड खगोल विज्ञान नहीं, बल्कि तय नियम हैं, और उत्तर में यह बताया जाता है: tone (त्रिकोण और षष्ठक के लिए supportive, वर्ग और विरोध के लिए challenging, युति के लिए intensifying) और focus, यानी वे तीन संपर्क जो ग्रह की गति और ऑर्ब की सटीकता के आधार पर सबसे ऊपर आते हैं। कोई लिखा हुआ पाठ नहीं है; वह हिस्सा आपका है।

2026-09-18 के लिए डेमो कुंडली का एक असली उत्तर, जिसमें सूचियाँ दो-दो आइटम तक छोटी की गई हैं:

{
  "date": "2026-09-18",
  "computedFor": "2026-09-18T12:00:00.000Z",
  "moon": {
    "phase": "First Quarter",
    "illumination": 46.5,
    "elongation": 86.04,
    "sign": "Sagittarius",
    "longitude": 261.6344,
    "degreeInSign": 21.63,
    "theme": "Decision + Action",
    "nextNewMoon": {
      "utc": "2026-10-10T15:50:05.436Z",
      "sign": "Libra",
      "degreeInSign": 17.36,
      "absoluteDegree": 197.36
    },
    "nextFullMoon": {
      "utc": "2026-09-26T16:49:02.781Z",
      "sign": "Aries",
      "degreeInSign": 3.62,
      "absoluteDegree": 3.62
    }
  },
  "positions": [
    {
      "name": "Sun",
      "longitude": 175.5994,
      "sign": "Virgo",
      "degreeInSign": 25.6,
      "speed": 0.9761,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 261.6344,
      "sign": "Sagittarius",
      "degreeInSign": 21.63,
      "speed": 11.8869,
      "retrograde": false
    }
  ],
  "events": [
    {
      "kind": "ingress",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    },
    {
      "kind": "equinox",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    }
  ],
  "transits": [
    {
      "transit": "Vesta",
      "natal": "Mercury",
      "aspect": "Trine",
      "angle": 119.93,
      "orb": 0.07,
      "phase": "applying",
      "exactAt": "2026-09-18T21:43:39.997Z",
      "tone": "supportive",
      "transitHouse": 2,
      "houseTheme": "Money & Possessions"
    },
    {
      "transit": "Uranus",
      "natal": "Lilith",
      "aspect": "Trine",
      "angle": 119.86,
      "orb": 0.14,
      "phase": "separating",
      "exactAt": null,
      "tone": "supportive",
      "transitHouse": 3,
      "houseTheme": "Communication & Learning"
    }
  ],
  "focus": [
    {
      "transit": "Pluto",
      "natal": "Mars",
      "aspect": "Trine",
      "angle": 119.78,
      "orb": 0.22,
      "phase": "separating",
      "exactAt": "2026-09-03T17:58:04.996Z",
      "tone": "supportive",
      "transitHouse": 12,
      "houseTheme": "Spirituality & Subconscious"
    },
    {
      "transit": "Neptune",
      "natal": "Mars",
      "aspect": "Opposition",
      "angle": 179.74,
      "orb": 0.26,
      "phase": "separating",
      "exactAt": "2026-09-09T00:24:29.005Z",
      "tone": "challenging",
      "transitHouse": 1,
      "houseTheme": "Identity & Self"
    },
    {
      "transit": "Jupiter",
      "natal": "Moon",
      "aspect": "Conjunction",
      "angle": 1.77,
      "orb": 1.77,
      "phase": "applying",
      "exactAt": "2026-09-27T20:40:07.004Z",
      "tone": "intensifying",
      "transitHouse": 7,
      "houseTheme": "Partnerships & Marriage"
    }
  ]
}

API Pro के एंडपॉइंट

छह एंडपॉइंट, जो मिलकर वह सब हैं जिसकी गणना ऐप करता है। नीचे का हर उदाहरण डेमो कुंडली के लिए एक असली उत्तर है, छोटा किया हुआ; अनुरोध में "..." ऊपर दिखाए गए जन्म विवरण वाले ऑब्जेक्ट की जगह है।

किसी अवधि के गोचर

POST /v1/transits birth, from और to (ज़्यादा से ज़्यादा 92 दिन) लेता है और उस अवधि में तारीख़ के अनुसार जन्म कुंडली पर गोचर की हर सटीक दृष्टि, हर राशि प्रवेश और हर ठहराव लौटाता है, साथ ही पहले दिन सक्रिय संपर्क, उनके चरण और सटीक क्षण के साथ।

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "date": "2026-09-19",
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "date": "2026-09-22",
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "date": "2026-09-23",
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "date": "2026-09-26",
      "body": "Sun",
      "target": "Mars",
      "aspect": "Conjunction",
      "exactness": 0,
      "significance": "low"
    }
  ]
}

सिनैस्ट्री

POST /v1/synastry personA और personB लेता है और ऑर्ब के साथ कुंडलियों के बीच की दृष्टियाँ, हर व्यक्ति के ग्रह दूसरे के किन भावों में पड़ते हैं, और जीवन के छह क्षेत्रों में से हर एक के लिए स्कोर लौटाता है। यहाँ दूसरा व्यक्ति भी काल्पनिक है (1989-03-14, 07:45, न्यूयॉर्क)।

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

सोलर रिटर्न

POST /v1/solar-return birth, year और वैकल्पिक location लेता है और वह सटीक क्षण लौटाता है जब सूर्य अपने जन्म के भोगांश पर लौटता है, उस क्षण के लिए बनी पूरी कुंडली के साथ। इसके लिए जन्म समय चाहिए: उसके बिना जन्म के सूर्य में आधे अंश की अनिश्चितता रहती है, जिससे रिटर्न का क्षण लगभग बारह घंटे खिसक जाता है।

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

किसी गतिविधि के लिए सबसे अच्छे दिन

POST /v1/timing birth, एक activity (general, business, romance, health, creative, travel, home या clarity), from और to (ज़्यादा से ज़्यादा 62 दिन) और एक वैकल्पिक timezone लेता है, जो तय करता है कि हर दिन कब शुरू होता है। हर दिन को गोचर की सटीक ज्यामिति से 0 से 100 तक स्कोर मिलता है, जिसमें उस गतिविधि के लिए अहम ग्रहों को ज़्यादा भार दिया जाता है, और सबसे अच्छे पाँच दिन सबसे पहले आते हैं। यह आकाश का वर्णन करता है; किसी दिन के बारे में कोई वादा नहीं करता।

{
  "activity": "business",
  "best": [
    {
      "date": "2026-10-12",
      "score": 69.5,
      "rating": "good",
      "moonPhase": "New Moon",
      "moonSign": "Scorpio",
      "voidOfCourse": false,
      "favorableAspects": [
        "Transit Sun Sextile Moon (0.2°)",
        "Transit Mercury Sextile Sun (0.3°)",
        "Transit Mercury Sextile Neptune (0.2°)"
      ],
      "challengingAspects": [
        "Transit Saturn Square Uranus (0.8°)"
      ]
    },
    {
      "date": "2026-10-14",
      "score": 63.5,
      "rating": "good",
      "moonPhase": "Waxing Crescent",
      "moonSign": "Sagittarius",
      "voidOfCourse": false,
      "favorableAspects": [
        "Transit Sun Sextile Venus (1.1°)",
        "Transit Moon Sextile Saturn (0.7°)",
        "Transit Jupiter Conjunction Venus (0.1°)"
      ],
      "challengingAspects": [
        "Transit Saturn Square Uranus (0.7°)",
        "Transit Saturn Square Uranus (0.6°)"
      ]
    }
  ]
}

एक कुंडली के सामने एक स्थान

POST /v1/locations/score birth और निर्देशांकों के साथ एक location लेता है। कुंडली को वहाँ स्थानांतरित किया जाता है, और उत्तर में ये आते हैं: स्थानांतरित केंद्र बिंदु, उन पर पड़ने वाले ग्रह उनके ऑर्ब के साथ, हर जीवन क्षेत्र के लिए 0 से 10 तक का स्कोर (5 तटस्थ है), और यह कि कुंडली उस जगह पर कुल मिलाकर कितनी तीव्रता से प्रतिक्रिया करती है: तीव्र, जब कोई प्रमुख ग्रह किसी केंद्र बिंदु से 2° के भीतर हो, मध्यम, जब 4° के भीतर हो, और बाक़ी स्थितियों में हल्की।

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

किसी कुंडली के लिए सबसे अच्छे शहर

POST /v1/locations/rank birth, एक वैकल्पिक focus (identity, love, body, money, home, mind में से कोई भी), एक वैकल्पिक region और 3 से 12 तक का limit लेता है, और 61 बड़े शहरों की सूची को क्रम में लगाता है। धरती के हर शहर की तुलना नहीं की जाती; किसी भी दूसरी जगह को ऊपर वाले एंडपॉइंट से स्कोर किया जा सकता है।

{
  "comparedCities": 61,
  "top": [
    {
      "city": "New York",
      "country": "United States",
      "overall10": 7.4,
      "focus10": 8.3,
      "strength": "strong",
      "contacts": [
        "Venus MC 0.6°",
        "Moon MC 2.3°"
      ]
    },
    {
      "city": "Tbilisi",
      "country": "Georgia",
      "overall10": 7.4,
      "focus10": 8.2,
      "strength": "moderate",
      "contacts": [
        "Sun DSC 3.3°"
      ]
    },
    {
      "city": "Montreal",
      "country": "Canada",
      "overall10": 7.4,
      "focus10": 8.1,
      "strength": "strong",
      "contacts": [
        "Venus MC 0.1°",
        "Moon MC 2.8°",
        "Mercury MC 3.8°"
      ]
    }
  ]
}

सीमाएँ और कीमतें

प्लानकीमतअनुरोधएंडपॉइंट
मुफ़्त$0हर दिन 10कुंडलियाँ, खंड, दैनिक राशिफल, आकाश
API Pro$6.99 प्रति माहहर दिन 1,000सब कुछ: गोचर, सिनैस्ट्री, सोलर रिटर्न, सबसे अच्छे दिन, स्थान

अनुरोध प्रति खाता गिने जाते हैं, उसकी सभी कुंजियों को मिलाकर, और कोटा 00:00 UTC पर दोबारा भरता है। हर उत्तर में X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset होते हैं। अमान्य मानकर अस्वीकार किया गया अनुरोध नहीं गिना जाता, हमारी ओर से विफल हुई गणना कोटे में लौटा दी जाती है, और GET /v1/usage हमेशा मुफ़्त है। API Pro ऐप के प्लान से अलग सदस्यता है: इसमें ऐप का Premium शामिल नहीं है, और ऐप के Premium में यह शामिल नहीं है। दोनों कोटे भी अलग हैं: ऐप AI उत्तरों को हफ़्ते के हिसाब से गिनता है, यह API गणनाओं को UTC दिन के हिसाब से गिनता है, और कोई भी दूसरे के कोटे से ख़र्च नहीं करता।

त्रुटियाँ

हर त्रुटि का ढाँचा एक ही है: { "error": { "code", "message", "details"?, "docs" } }।

स्टेटसकोडकब
400invalid_requestअनुरोध की सामग्री मान्य नहीं है। details हर समस्या की सूची देता है। गिना नहीं जाता।
401missing_api_key, invalid_api_keyकुंजी नहीं है, अज्ञात कुंजी है या निरस्त की गई कुंजी है।
403plan_requiredमुफ़्त प्लान पर API Pro का एंडपॉइंट कॉल किया गया।
429daily_limit_reachedदिन का कोटा ख़त्म हो गया है। यह 00:00 UTC पर दोबारा भरता है।
500internal_errorहमारी ओर से विफलता। अनुरोध गिना नहीं जाता।

गणना की सेटिंग्स

ये तय हैं, और ये ख़ुद ऐप की सेटिंग्स हैं, जिनका पूरा ब्योरा अपनी कुंडली जाँचें पेज पर है और जिन्हें सटीकता रिपोर्ट में NASA के JPL Horizons से मिलाकर जाँचा जाता है। Swiss Ephemeris की डेटा फ़ाइलें, गति वाला फ़्लैग चालू। सायन (ट्रॉपिकल) राशिचक्र, भूकेंद्रीय, आभासी स्थितियाँ। प्लेसिडस भाव। स्पष्ट चंद्र नोड। लिलिथ, चंद्र के तात्कालिक अपभू के रूप में। भाग्य भाग, लग्न + चंद्र − सूर्य के रूप में, दिन और रात की कुंडलियों में एक जैसा। सिर्फ़ पाँच प्रमुख दृष्टियाँ: युति 8°, षष्ठक 6°, वर्ग 8°, त्रिकोण 8°, विरोध 8°। जन्म कुंडली और गोचर की हर दृष्टि बताती है कि वह निकट आ रही है या दूर जा रही है, जिसे दोनों पिंडों की गति से आँका जाता है, वक्री गति समेत।

गोपनीयता

जन्म विवरण व्यक्तिगत डेटा है। API उसे पढ़ता है, गणना करता है, उत्तर देता है और उसे भूल जाता है: अनुरोध की कोई सामग्री संग्रहीत नहीं होती, और आप जो भी भेजते हैं, उसका इस्तेमाल उत्तर के अलावा किसी और चीज़ के लिए नहीं होता। हर अनुरोध के लिए हम एंडपॉइंट, स्टेटस कोड और प्रतिक्रिया समय रखते हैं। गोपनीयता नीति देखें।

प्रश्न

क्या API, AI का इस्तेमाल करता है?

नहीं। हर एंडपॉइंट एक गणना है: Swiss Ephemeris से ग्रह स्थितियाँ, भावों के कस्प, दृष्टियाँ, गोचर। कोई पाठ तैयार नहीं किया जाता और किसी भाषा मॉडल को कॉल नहीं किया जाता, इसीलिए एक ही इनपुट पर हमेशा वही संख्याएँ मिलती हैं।

क्या भाव पद्धति या निरयन (साइडरियल) राशिचक्र चुना जा सकता है?

नहीं। हर कुंडली सायन है और उसमें प्लेसिडस भाव हैं, वही सेटिंग्स जो NatalChart.AI ऐप इस्तेमाल करता है। अगर आपको पूर्ण राशि भाव (होल साइन), कॉख़ (Koch) या निरयन राशिचक्र चाहिए, तो यह उसके लिए सही API नहीं है।

जन्म समय अज्ञात हो तो क्या होता है?

time को null के रूप में भेजें। कुंडली की गणना स्थानीय समय 12:00 के लिए होती है, और समय पर निर्भर हर चीज़ अनुमान लगाने के बजाय रोक ली जाती है: केंद्र बिंदु और भावों के कस्प null के रूप में लौटते हैं, पिंडों के साथ कोई भाव नहीं होता, और एक चेतावनी बताती है कि चंद्र की स्थिति कितनी ग़लत हो सकती है।

क्या आप स्थान के नाम से निर्देशांक निकालते हैं?

नहीं। अक्षांश और देशांतर भेजें। समय क्षेत्र निर्देशांकों से, उस तारीख़ के ऐतिहासिक डेलाइट सेविंग टाइम नियमों के साथ तय किया जाता है, जब तक कि आप ख़ुद कोई IANA समय क्षेत्र न भेजें।

क्या आप मेरा भेजा हुआ जन्म विवरण संग्रहीत करते हैं?

नहीं। अनुरोध की सामग्री कहीं भी लिखी नहीं जाती। अनुरोधों का लॉग एंडपॉइंट, स्टेटस कोड और प्रतिक्रिया समय रखता है, जिसकी ज़रूरत उपयोग के काउंटर को होती है।

अनुरोध किसे गिना जाता है?

किसी गणना एंडपॉइंट पर एक सफल कॉल। अमान्य मानकर अस्वीकार किए गए अनुरोध पर कुछ ख़र्च नहीं होता, हमारी ओर से हुई विफलता कोटे में लौटा दी जाती है, और /v1/usage मुफ़्त है। कोटा प्रति खाता है, प्रति कुंजी नहीं, और 00:00 UTC पर दोबारा भरता है: मुफ़्त प्लान पर हर दिन 10, API Pro पर हर दिन 1,000।

क्या इसे किसी व्यावसायिक उत्पाद में इस्तेमाल किया जा सकता है?

हाँ, दोनों में से किसी भी प्लान पर। अपनी कुंजी सर्वर पर रखें: ब्राउज़र या ऐप के कोड में रखी कुंजी को कोई भी कॉपी कर सकता है, जो उस कोड को खोले।

अपनी असली कुंडली देखने के लिए तैयार हैं?

मेरी मुफ़्त कुंडली बनाएँ