सामग्री पर जाएँ
VedicSpace इंजन एपीआईapi@vedicspace.com
डेवलपर सन्दर्भ

वेदिकस्पेस इंजन एपीआई

एक ही सन्दर्भ-सहित वैदिक-ज्योतिष इंजन — पञ्चाङ्ग, कुण्डली, दशा, मुहूर्त, दोष, मिलान और बहुत कुछ में फैले 172 एपीआई एंडपॉइंट। स्विस एफ़ेमेरिस, लाहिरी अयनांश। प्रत्येक पाठ या तो स्विस एफ़ेमेरिस से गणित है या अपने शास्त्रीय स्रोत से सन्दर्भित — अध्याय, श्लोक और संस्करण, सीधे उत्तर में — और जहाँ ग्रन्थ मौन हैं, वहाँ हम भी मौन रहते हैं। निःशुल्क। पूरा का पूरा। न कार्ड, न श्रेणियाँ; एक वैकल्पिक निःशुल्क कुंजी आपकी दर-सीमा 4 गुना बढ़ा देती है।

शुरुआत कैसे करें

बेस यूआरएलhttps://vedicspace.com
CORSखुला (Access-Control-Allow-Origin: *) — सीधे ब्राउज़र से कॉल करें।
प्रमाणीकरणपढ़त के लिए कुछ नहीं चाहिए। निजी कोश के लिए ही वैकल्पिक ईमेल-ओटीपी।
तुरन्त लगने वाला एसडीके<script src="https://vedicspace.com/vedicspace-sdk.js"> जोड़िए, फिर new VedicSpace().kundli(birth)। न कोई बिल्ड, न कुंजी — पूरा इंजन एक ही टैग में। स्रोत →
मूल्यनिःशुल्क — हर एंडपॉइंट, न कार्ड, न श्रेणियाँ। उचित-उपयोग सीमाएँ GET /api/v2/limits पर प्रकाशित हैं; एक निःशुल्क कुंजी 4 गुना छूट देती है।
स्थितिसजीव जाँच /status पर · आपके मॉनिटर के लिए: GET /api/health। ईमानदार बात: पूर्वावलोकन अवधि में अभी कोई औपचारिक एसएलए नहीं है।
विशिष्टिपूरा OpenAPI /openapi.json पर (मशीन-पठनीय)।

उत्तर का लिफ़ाफ़ा — हमारी असली खाई

  • prove_refs — हर निर्णय के पीछे के शास्त्रीय सन्दर्भों की सूची, सत्यापित या लम्बित चिह्न सहित। इन्हें भरोसे की परत की तरह दिखाइए। हर सन्दर्भ अध्याय, श्लोक और संस्करण बताता है, ताकि पाठक दावे को स्वयं जाँच सके।
  • engine_status — इंजन का अपना ईमानदारी-संकेत: LIVE (गणना की गई), REFERENCE (परम्परा-तालिकाएँ), या PARTIAL (स्वयं घोषित अधूरी)। इसका सम्मान कीजिए।
  • “कुछ नहीं गढ़ना” का नियम ही यहाँ का अनुबन्ध है — जो इंजन न गणना कर सके, न उद्धृत कर सके, उसे वह गढ़ने के बजाय साफ़ कह देता है। किसी pending सन्दर्भ को कभी पुष्ट जैसा मत दिखाइए।

अनुरोध के पाँच रूप

// 1 · Canonical kundli body (most chart engines) — place omitted, tz derived from lat/lon
{ "name": "…", "gender": "Male", "date": "1990-05-21", "time": "14:30",
  "latitude": 26.85, "longitude": 80.95 }

// 2 · birth_* variant (sadesati, gochar, dosha/annual engines)
{ "birth_date": "1990-05-21", "birth_time": "14:30", "birth_latitude": 26.85, "birth_longitude": 80.95 }

// 3 · Matchmaking — flat boy_/girl_ keys
{ "boy_date": "…", "boy_time": "06:00", "boy_latitude": 0, "boy_longitude": 0, "girl_date": "…", … }

// 4 · Marriage suite — nested bride/groom (+ ceremony moment)
{ "bride": { "date":"…","time":"06:00","latitude":0,"longitude":0 }, "groom": { … }, "muhurta_date": "…" }

// 5 · Panchanga GET query params
GET /api/v2/panchang/glance?lat=26.85&lon=80.95&date=2026-07-03

निःशुल्क एपीआई कुंजियाँ — तुरन्त, न कार्ड, न कोई पेच

कुंजी पहचान है, दीवार नहीं — हर एंडपॉइंट बिना कुंजी के भी चलता है। कुंजी लेने पर आपको दर-सीमा में 4 गुना छूट मिलती है और गिनती आईपी के बजाय प्रति-कुंजी होती है, जो साझा नेटवर्क और सर्वरलेस के लिए कहीं बेहतर है। वही ईमेल और ऐप दोबारा दर्ज करने पर वही कुंजी लौटती है।

# Or from the terminal:
curl -X POST https://vedicspace.com/api/v2/keys/register \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","app_name":"my-app"}'
# → { "success": true, "api_key": "vsk_…" }
# Then:  -H 'X-API-Key: vsk_…'  on any request.

एसडीके, पोस्टमैन और एमसीपी सर्वर

बिना किसी निर्भरता वाले क्लाइंट — एक फ़ाइल डाउनलोड कीजिए और चल पड़िए। और एमसीपी सर्वर इसे ऐसा ज्योतिष-उपकरण बनाता है जिसे कोई एआई सहायक उद्धृत कर सके: उसका हर निर्णय अपना शास्त्रीय श्लोक साथ लाता है।

पायथनvedicspace.py — केवल स्टैंडर्ड लाइब्रेरी। VedicSpace().dashakoot(groom, bride)
जावास्क्रिप्टvedicspace.js (browser/CJS) · vedicspace.mjs (ESM, Node 18+)
पोस्टमैनकलेक्शन — सभी 177 एपीआई अनुरोध, फ़ोल्डरों में, चलने योग्य नमूना बॉडी सहित।
एमसीपी सर्वरvedicspace-mcp.mjs — बिना किसी निर्भरता के, Node 18+। Claude / ChatGPT / किसी भी एमसीपी क्लाइंट के लिए 8 सन्दर्भ-सहित उपकरण।
// claude_desktop_config.json
{ "mcpServers": { "vedicspace": {
    "command": "node", "args": ["/path/to/vedicspace-mcp.mjs"] } } }

// Tools: get_panchang · get_kundli · match_ashtakoot · match_dashakoot
//        check_manglik · check_kalasarpa · check_pitra_dosha · get_bphs_chapter
// Every verdict arrives with prove_refs — the AI can quote the verse.

1पञ्चाङ्ग एवं कैलेण्डर

दैनिक और पञ्चाङ्ग-सम्बन्धी। v2 पञ्चाङ्ग रूट prove_refs के साथ आते हैं; पुराने GET रूट दिखाने में तेज़ हैं पर अधिकतर बिना सन्दर्भ के।

GET/api/v2/panchang/glance

सबसे हल्की दैनिक “आज” की झलक — तिथि + नक्षत्र + दिन का निर्णय-बैंड।

अनुरोध · query: lat, lon, date (सभी वैकल्पिक; डिफ़ॉल्ट दिल्ली/आज)

{ "success": true, "engine_status": "LIVE", "date": "2026-07-03",
  "verdict": { "day_band": "inauspicious", "headline": "Krishna Tritiya · Shravana" },
  "evidence": { "glance": { "tithi": { "label": "Krishna Tritiya", "ends": "…" },
    "nakshatra": { "label": "Shravana", "pada": 4 } },
    "prove_refs": [ { "ref_id": "PANCHANG-INTERP.tithi-nature", "tier": "T2" } ] } }
POST/api/v2/panchanga

मुख्य दैनिक पञ्चाङ्ग — पाँच अंग + समाप्ति-समय + सूर्य/चन्द्र की निरयण स्थिति।

अनुरोध · date*, time (डिफ़ॉल्ट 06:00), latitude*, longitude*

{ "success": true, "date": "2026-07-03",
  "panchanga": { "tithi": "Krishna Tritiya", "paksha": "Krishna", "vara": "Friday",
    "nakshatra": "Shravana", "yoga": "Vishkambha", "karana": "Vishti",
    "sunrise": "05:27:00", "sunset": "19:23:00" },
  "moon": { "sign": "Capricorn", "nakshatra": "Shravana" }, "prove_refs": [ … ] }
GET/api/choghadiya

दिन/रात का चौघड़िया (8+8), वार के अनुसार घूमता हुआ, गुणवत्ता और कर्म-निर्देश सहित।

अनुरोध · query: lat*, lon*, date*

{ "success": true, "weekday": "Friday",
  "day_choghadiya": [ { "name": "Laabh", "lord": "Mercury", "start": "07:11 AM",
    "end": "08:56 AM", "status": "Auspicious", "karma": "Gain — business, trade" } ],
  "prove_refs": [ { "ref_id": "PANCHANG.choghadiya", "tier": "T3" } ] }
GET/api/hora

वार-स्वामी + 24 होरा का चक्र (12 दिन + 12 रात), वर्तमान होरा चिह्नित।

अनुरोध · query: lat*, lon*, date*

GET/api/v2/eclipses

आगामी सूर्य/चन्द्र ग्रहण — स्पर्श-समय और स्थान-अनुसार सूतक सहित।

अनुरोध · query: count (डिफ़ॉल्ट 3), latitude, longitude

{ "success": true, "engine_status": "LIVE",
  "next": { "date": "2026-08-12", "sign": "Cancer", "nakshatra": "Ashlesha",
    "locally_visible": false, "sutak": { "applies": false } } }
POST/api/v2/vrata/ekadashi

सन्दर्भ-सहित व्रत इंजन और हमारा प्रमुख “कारण देखें” पृष्ठ — स्मार्त बनाम वैष्णव भेद, चरण-दर-चरण तर्क-शृंखला के साथ।

अनुरोध · date*, time, latitude/longitude, tradition (smarta|vaishnava), end_date (→ अवधि-स्कैन)

▸ तर्क-शृंखला (why_this_date) हमारा सबसे प्रबल सन्दर्भ-प्रमाण पृष्ठ है।

2कुण्डली एवं चक्र

हर POST वही मानक 6-खाने वाला बॉडी लेता है। /api/v2/kundli मुख्य कुण्डली-स्रोत है।

POST/api/v2/kundli

मुख्य जन्म-कुण्डली निर्माण — कुण्डली, ग्रह, भाव, नवांश, पञ्चाङ्ग, विंशोत्तरी दशा, और व्याख्या (prove_refs सहित)।

{ "success": true, "engine": "vedicspace.v2",
  "chart": { "lagna": { "sign": "Pisces", "lord": "Jupiter", "nakshatra": "P.Bhadrapada" },
    "planets": { "Moon": { "sign": "Leo", "house": 6, "dignity": "friend" } },
    "dashas": { "current": { "maha": "Rahu", "antar": "Jupiter" } } },
  "interpretation": { "prove_refs": [ … ] } }
POST/api/divisional-charts

एक ही उत्तर में सभी 16 पराशरी वर्ग (D1…D60) + वर्गोत्तम। एक वर्ग के लिए: POST /api/divisional/{code}।

POST/api/v2/bhavabala

भाव-बल — सबसे प्रबल और सबसे क्षीण भाव अलग से चिह्नित। सन्दर्भ सहित।

{ "engine_status": "LIVE",
  "houses": [ { "house": 1, "lord": "Jupiter", "total_score": 91.7, "band": "strong" } ],
  "strongest": { "house": 10, "total_score": 112.18 },
  "prove_refs": [ "SRC-BPHS-BHAVABALA" ] }
POST/api/v2/jaimini

चर कारक, कारकांश, आरूढ़ पद, चर दशा। स्तर-वार सन्दर्भ।

POST/api/yog

योग-पहचान, ईमानदार बल-श्रेणियों (प्रबल/मध्यम/क्षीण/भंग) और भंग सहित। भंग हुए योग भंग ही दिखाए जाते हैं — यही ईमानदारी हमारा अन्तर है।

{ "success": true, "yogas": { "summary": { "strong": 0, "moderate": 4, "cancelled": 1 },
  "active": [ { "id": "gajakesari", "famous": true, "status": "cancelled",
    "strength_label": "Cancelled by classical rules" } ] } }
POST/api/kp-chart

केपी (कृष्णमूर्ति पद्धति) — ग्रहों के नक्षत्र/उप/उप-उप स्वामी, 12 भाव-स्फुट उप-स्वामी, चतुर्विध कारक।

{ "success": true,
  "planets": [ { "planet": "Sun", "nakshatra_lord": "Moon", "sub_lord": "Venus", "house": 10 } ],
  "cusps": [ { "cusp": 1, "sign": "Scorpio", "sub_lord": "Rahu" } ],
  "significators": [ { "planet": "Sun", "star_lord": "Moon", "signifies": [6,10,9] } ] }

3दशा

समय-निर्धारण की पूरी परत। सभी POST रूट वही मानक 6-खाने वाला बॉडी लेते हैं।

POST/api/dasha/tree

पूरा नेस्टेड विंशोत्तरी वृक्ष: महा → अन्तर → प्रत्यन्तर → सूक्ष्म, विस्तार में जाने के लिए।

POST/api/dasha/current

आज की सजीव 5-स्तरीय शृंखला (महा→अन्तर→प्रत्यन्तर→सूक्ष्म→प्राण) — “आप यहाँ हैं” वाली पट्टी।

{ "success": true, "current_levels": [
  { "level": "Mahadasha", "planet": "Rahu", "end_date": "05-Nov-2040" },
  { "level": "Antardasha", "planet": "Jupiter", "end_date": "12-Dec-2027" } ] }
POST/api/dasha/yogini

योगिनी दशा (8 योगिनी, 36 वर्ष का चक्र) — तीन चक्रों तक।

▸ नाम→स्वामी की सूची एक निश्चित शास्त्रीय स्थिरांक है; इसे क्लाइंट की ओर से लें (इंजन का यह खाना अभी ठीक किया जा रहा है)।

GET/api/dasha/meanings

स्थिर स्वामी-फल — /current या /tree के ग्रह से जोड़कर बिना किसी एलएलएम कॉल के व्याख्या दिखाएँ।

POST/api/v2/pindayu

फलदीपिका अध्याय 13 की अनुपाती आयु-श्रेणी (प्रमाण पहले; यह मृत्यु की भविष्यवाणी नहीं है)। पूर्णतः सन्दर्भ सहित।

{ "engine_status": "LIVE",
  "verdict": { "total_years": 54.48, "band": "Madhyayu (32–70 years band)" },
  "story": { "summary": "A proportional band indicator, not a death prediction." },
  "evidence": { "prove_refs": [ { "citation": "Phaladeepika Ch.13 Sh.8–12" } ] } }

4मुहूर्त

मुहूर्त-चयन इंजन — किसी क्षण को अंक दें या N दिन स्कैन करें। अधिकतर में prove_refs और एक गुणवत्ता-चिह्न रहता है।

POST/api/v2/muhurta-finder

किसी कर्म के लिए अगले N दिनों में शुभ तिथियाँ खोजें।

अनुरोध · latitude*, longitude*, karma (vivah|yatra|griha_pravesh|upanayana|general), days_ahead (डिफ़ॉल्ट 30, 1–90), only_shubha, start_date

{ "success": true, "karma": "vivah", "match_count": 6,
  "results": [ { "date": "2026-08-03", "weekday": "Monday", "nakshatra": "U.Bhadrapada",
    "quality": "shubha", "benefits": ["Tithi favourable"], "issues": [] } ] }
POST/api/v2/muhurta-complete

किसी निश्चित क्षण का पूरा मुहूर्त-चिन्तामणि मूल्यांकन — day_quality, karma_muhurtas (हर कार्य के लिए, लाभ और बाधाएँ सहित), अंग, विशेष योग।

अनुरोध · date*, time*, latitude*, longitude*, activity

POST/api/v2/muhurta-intelligence

कई व्यक्तियों वाला निर्णय-इंजन: 9 शास्त्रीय परतों पर अशुभ दिन छाँटकर हटाता है, और शीर्ष 3 दिन अस्वीकृति-ब्योरे के साथ लौटाता है (“ये क्यों, वे क्यों नहीं”)।

अनुरोध · event_type*, users[] (हर एक में birth_*), latitude*, longitude*, start_date*, end_date*, max_results (1–3)

POST/api/v2/travel-muhurta

दिशा-सजग यात्रा मुहूर्त: दिशा-शूल + यात्रा-दोष समूह + परिहार। सन्दर्भ सहित।

अनुरोध · date*, time, latitude/longitude, direction (डिफ़ॉल्ट North)

5दोष एवं परिहार

दोष-इंजन, ईमानदार भंग-नियमों और परिहार सहित। अधिकतर birth_* बॉडी लेते हैं; परिहार-संग्रह एक GET सन्दर्भ है।

POST/api/v2/sadesati

जन्म राशि से शनि साढ़ेसाती की स्थिति — चल रही है या नहीं, चरण, कण्टक। ध्यान दें: janma_rashi/saturn_rashi 0 से गिनी जाने वाली राशि-संख्याएँ हैं।

अनुरोध · birth_date*, birth_time*, birth_latitude*, birth_longitude*

{ "success": true, "janma_rashi": 1, "saturn_rashi": 11,
  "sadesati": { "in_sadesati": false, "phase": "Shubha Shani (11th house)",
    "saturn_house_from_janma": 11, "duration_years": 2.5 } }
POST/api/v2/mangal-dosha

लग्न, चन्द्र और शुक्र से मंगल/मांगलिक दोष — भंग-नियमों और परिहार सहित।

{ "mangal_dosha": { "present": true, "from_venus": true, "severity": "Mild",
  "cancellations": [], "parihaar": "Match with another Mangalik OR Kumbh Vivah" } }
POST/api/v2/kalasarpa

राहु–केतु अक्ष पर कालसर्प का बनना (उपस्थित/आंशिक), प्रकार और परिहार सहित।

POST/api/lal-kitab

लाल किताब की पढ़त — ऋण, सरल टोटके, भावों में ग्रह, भाव-फल।

GET/api/v2/reference/remedy-corpus

सन्दर्भ-सहित परिहार-तालिकाएँ — राशि अनुसार रत्न, मुखी अनुसार रुद्राक्ष, दिशा अनुसार वास्तु। engine_status: REFERENCE।

▸ कोई जन्म-विवरण नहीं — यह शुद्ध सन्दर्भ है। इसे REFERENCE ही लिखें, LIVE कभी नहीं।

6मिलान एवं विवाह

उत्तर भारत का अष्टकूट, दक्षिण का दशकूट/पोरुत्तम, और थोक छँटाई — हर निर्णय अपना सन्दर्भ साथ लाता है, भकूट अपवादों पर प्रश्न मार्ग अध्याय 21 सहित।

POST/api/v2/matchmaking

आठ कूटों पर अष्टकूट गुण-मिलान (36 गुण) — अंक, व्याख्या और सन्दर्भ सहित।

अनुरोध · boy_name, boy_date, boy_time, boy_latitude, boy_longitude, girl_* (वही)

POST/api/v2/koota-extended

अष्टकूट + विस्तारित कूट (महेन्द्र, स्त्री-दीर्घ, रज्जु, वर्ण, वेध) + सन्दर्भ-सहित भकूट-अपवाद निर्णय + मांगलिक जाँच।

अनुरोध · groom { date, time, latitude, longitude }, bride { वही }, love_marriage

POST/api/v2/dashakoot

दस दक्षिण-भारतीय पोरुत्तम (दिन, गण, महेन्द्र, स्त्री-दीर्घ, योनि, राशि, राश्यधिपति, वश्य, रज्जु, वेध) — हर पोरुत्तम की श्रेणी सहित; रज्जु/वेध अनिवार्य माने गए, राशि-निर्णय सन्दर्भ सहित।

अनुरोध · groom { date, time, latitude, longitude }, bride { वही }

{ "success": true, "dashakoot": { "matched_count": 9, "total": 10,
  "essentials_ok": true, "verdict": "Uttama (excellent)",
  "poruthams": [ { "porutham": "Rajju", "matched": true, "grade": "uttama",
    "weight": "essential", "detail": { "bride": "Siras (Head)", "groom": "Nabhi (Navel)" } } ] } }
POST/api/v2/match/batch

वैवाहिक छँटाई: एक ही कॉल में एक प्रोफ़ाइल बनाम अधिकतम 50 उम्मीदवार, गुण-अंक से क्रमबद्ध, दोष-चिह्नों सहित (और चाहें तो दशकूट सारांश)। निःशुल्क।

अनुरोध · proband { date, time, latitude, longitude }, proband_role (groom|bride), candidates[] (अधिकतम 50), system (ashtakoota|dashakoot)

POST/api/v2/marriage-timing-matrix

दशा और गोचर से बना, दोनों की कुण्डलियों से मिलाया हुआ विवाह-समय मैट्रिक्स।

अनुरोध · { person: birth_* } (या bride/groom)

POST/api/v2/prasna-marriage

प्रश्न-ज्योतिष: पूछे गए क्षण पर बनी विवाह-सम्बन्धी उत्तर-कुण्डली।

7भविष्यफल एवं जीवन-क्षेत्र

राशि और कुण्डली पर आधारित फल। horoscope बिना जन्म-विवरण वाला GET है; बाकी जन्म-विवरण बॉडी लेते हैं।

GET/api/horoscope

राशि अनुसार राशिफल — अंक, शुभ रंग और अंक, फल, 11 जीवन-क्षेत्रों के अंक, सक्रिय ग्रह।

अनुरोध · query: sign* (अंग्रेज़ी/संस्कृत), period (daily|weekly|monthly|yearly)

{ "sign": "Aries", "period": "daily", "total_score": 65,
  "lucky_color": { "name": "Terracotta Red", "hex": "#D94A3D" }, "lucky_numbers": [9,5,3],
  "prediction": "…", "category_scores": { "Career": 72, "Health": 75 } }
POST/api/v2/fortune-direction

शुभ दिशा (दिक्-स्वामित्व + दिग्बल), स्वदेश बनाम विदेश, और धन की दिशा (सर्वाष्टकवर्ग)। engine_status: LIVE।

अनुरोध · birth_* बॉडी

POST/api/v2/varshaphal

ताजिक वर्षफल — वार्षिक सूर्य-प्रत्यागमन कुण्डली: वर्षेश, मुन्था, मुद्दा दशा, ताजिक योग, सहम। सन्दर्भ सहित (prove_refs)।

POST/api/v2/gochar

जन्म-चन्द्र राशि के सापेक्ष हर ग्रह के गोचर की गुणवत्ता (चन्द्र से भाव + फल)। birth_* बॉडी लेता है।

{ "janma_rashi": "Leo",
  "gochar": { "planets": { "Sun": { "current_sign": "Gemini", "house_from_janma": 11,
    "quality": "shubha", "effect": "Authority, recognition" } } } }

8एआई, अंक-ज्योतिष एवं उपकरण

सन्दर्भ-सहित एआई मार्गदर्शक, और अलग पद्धतियों वाले इंजन (अंक-ज्योतिष केवल नाम और जन्म-तिथि लेता है)।

POST/api/v2/jyotishi/chat

कुण्डली पर आधारित, सन्दर्भ-सहित एआई ज्योतिषी — वहीं उत्तर देता है जहाँ शास्त्र बोलता है, और दायरे से बाहर के प्रश्न ईमानदारी से लौटा देता है।

POST/api/v2/oracle/answer

99 सन्दर्भ-सहित प्रश्न — हर एक में निर्णय, समय-अवधि, तर्क और उद्धृत श्लोक।

POST/api/numerology

कैल्डियन + लो-शू अंक-ज्योतिष — मूलांक, भाग्यांक, नामांक, लो-शू ग्रिड, शुभ वस्तुएँ। कोई जन्म-कुण्डली नहीं।

अनुरोध · first_name*, last_name, day*, month*, year*

{ "success": true, "moolank": 1, "bhagyank": 9, "life_path": 9,
  "lucky_things": { "numbers": [1,9,2], "color": "Red", "ruler": "Sun" },
  "loshu_grid": [ [ { "num": 4, "count": 0 }, … ] ] }

यह सन्दर्भ मुख्य रूटों को समेटता है; पूरी मशीन-पठनीय विशिष्टि /openapi.json है और सजीव इंजन GET /api/catalog पर स्वयं अपना परिचय देता है। सब कुछ निःशुल्क है — छूट के लिए एक निःशुल्क कुंजी ले लीजिए, सजीव स्थिति के लिए /status देखिए, और बाक़ी किसी भी बात के लिए api@vedicspace.com पर लिखिए।