गोचर API

अनुरोध

डेमो कुंडली के लिए एक असली अनुरोध, एक महीने का:

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

उत्तर

उस अनुरोध के उत्तर का एक हिस्सा: मुख्य फ़ील्ड, और हर सूची उसके पहले तीन आइटम तक छोटी की गई।

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

उत्तर में क्या आता है

• window: वे तारीख़ें जो आपने माँगीं।
• events: गोचर करने वाले पिंडों की जन्म कुंडली के पिंडों से ज़्यादा से ज़्यादा 60 सटीक दृष्टियाँ, राशि प्रवेश और ठहराव, तारीख़ के क्रम में, हर एक UTC में अपने क्षण, अपनी स्थिति और संबंधित भावों के साथ। जब किसी अवधि में इससे ज़्यादा हों, तो सबसे अहम रखी जाती हैं।
• activeOnFirstDay: वे गोचर जो पहले दिन ही ऑर्ब के भीतर हैं, इस्तेमाल किए गए ऑर्ब के साथ।
• हर घटना के साथ उसका महत्व (high, medium या low) होता है, जो उसमें शामिल पिंडों से तय होता है।

सीमाएँ

• सिर्फ़ API Pro पर, हर अनुरोध में ज़्यादा से ज़्यादा 92 दिन और 60 घटनाएँ। मुफ़्त कुंजी पर एंडपॉइंट 403 लौटाता है, साथ में अपग्रेड करने का लिंक।
• 1800 से 2399 तक के जन्म। गोचर के भावों के लिए जन्म समय चाहिए; उसके बिना भाव छोड़ दिए जाते हैं।
• हर सटीक क्षण Swiss Ephemeris से खोजा जाता है और UTC में दिया जाता है।
• जन्म विवरण पढ़ा जाता है, इस्तेमाल होता है और भुला दिया जाता है: अनुरोध की सामग्री कभी संग्रहीत नहीं होती।

AI सहायक में

https://www.natalchart.ai/mcp पर MCP सर्वर के ज़रिए सहायक किसी अवधि के लिए transits टूल और एक दिन के लिए daily_transits कॉल करते हैं, और गोचर का अनुमान लगाने के बजाय असली गोचर पढ़ते हैं।

API का बाक़ी हिस्सा

यही कुंजी पूरा ज्योतिष API खोलती है: जन्म कुंडलियाँ, दैनिक गोचर, सिनैस्ट्री, किसी अवधि के गोचर, सोलर रिटर्न, सबसे अच्छे दिन और एस्ट्रोकार्टोग्राफी। हर एंडपॉइंट, फ़ील्ड और त्रुटि API दस्तावेज़ में है, और कीमतों वाला पेज बताता है कि अनुरोध किसे गिना जाता है।

प्रश्न