Sūrya-siddhānta · Drik · TantraGurukul

Two Vedic Engines. One API Key. The Complete Stack.

Panchanga, Muhurta, Kundali, Vargas, Dasha and Matching — classical Sūrya-siddhānta by default, Drik when you switch. One production-ready Vedic Astrology API. No separate products. No monthly stack of add-ons.

Full Commercial Access — ₹36,000 / year ₹3,000/month for the complete Vedic stack — not ₹12,500/month in pieces.

Built on our independently developed calculation engines, without per-deployment third-party ephemeris licensing costs. Sūrya-siddhānta powers the classical panchanga.

  • Sūrya-siddhānta
  • Drik · Lahiri
  • REST JSON · X-API-Key
  • Hindi Display Fields
  • White-label Commercial Use
नवग्रह — TantraGurukul
GET /v1/surya/panchangaSample request
curl -H "X-API-Key: YOUR_KEY" \
  "https://astro.tantragurukul.org/v1/surya/panchanga\
?date=2026-08-22&place=Kushinagar"
import json, urllib.parse, urllib.request

url = "https://astro.tantragurukul.org/v1/surya/panchanga?" + \
    urllib.parse.urlencode({"date": "2026-08-22", "place": "Kushinagar"})
req = urllib.request.Request(url, headers={"X-API-Key": "YOUR_KEY"})
with urllib.request.urlopen(req) as r:
    print(json.load(r))
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create(
        "https://astro.tantragurukul.org/v1/surya/panchanga"
        + "?date=2026-08-22&place=Kushinagar"))
    .header("X-API-Key", "YOUR_KEY")
    .GET()
    .build();
HttpResponse<String> res = HttpClient.newHttpClient()
    .send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());
JSON200 OK
{
  "success": true,
  "engine": "surya_siddhanta",
  "calendar": {
    "kalpa_soochana_sa": "ब्रह्मणो द्वितीयपरार्द्धे श्रीश्वेतवाराहकल्पे सप्तमे वैवस्वतमन्वन्तरे",
    "vikram_samvat": 2083
  },
  "limbs": { "tithi": { "name_sa": "दशमी" } }
}

Four APIs, one key

Built for apps, temples, and matrimonial products. Every route below is JSON — see /v1/vedic and API docs.

Daily JSON

Panchanga API

Full daily snapshot: angas, months, eras, rise/set, śāstra-kāla, Bhadra, vāsa, grahas, festivals, grahaṇa.

GET /v1/vedic/panchanga

Electional JSON

Muhurta API

Daily windows plus kārya-muhūrta for house, travel, saṃskāra, and vivāha.

GET /v1/vedic/karya-muhurta

Natal JSON

Kundali API

Lagna, vargas, dashas, phala, varṣaphala, six life reports, yogas, doshas, and gochara.

GET /v1/vedic/kundali

Pair JSON

Matching API

Ashtakoot out of 36, printed bhaṅga, Nadi, and paired Manglik with cancellation.

GET /v1/vedic/match/ashtakoot

What the API returns

The Panchanga tab is the daily JSON snapshot — every block /v1/vedic/panchanga returns. Slice routes still let an app fetch only tithi, only Navamsha, or only matching scores.

Daily angas

Tithi (name, number, paksha, class, fraction, elongation, end clock, transition list, tithi-nirṇaya), nakṣatra (pada, fraction, end), yoga, karaṇa (kind, remaining degrees, end), weekday, and paksha — at sunrise or the clock you send.

Months

Amanta and Purnimanta māsa, adhika flag, pūrṇimā date, and solar month (saur māsa / rāśi) at sunrise.

Eras and saṃvatsara

Vikram, Shaka, Kali; Yudhiṣṭhira and Paraśurāma; Bārhaspatya (Guru-madhyama) and Chandra-krama names; era new year on amānta Caitra śukla pratipadā.

Rise and set

Sunrise, sunset, next sunrise, solar noon (madhyāhna), moonrise, moonset, moon transit; dinamāna and rātrimāna in hours and ghaṭī.

Sankranti and ṛtu

Current rāśi, degrees in rāśi, degrees to next, gati, last and next sankranti clocks with nirṇaya; ṛtu and ayana.

Śāstra-kāla

Pūrvāhṇa, madhyāhna, aparāhṇa, kutapa, dvitīya prahara, pradoṣa, niśītha / mahāniśā, aruṇodaya; the six day-ṛtus (din-ṛtu).

Daily muhurta

Abhijit (Wednesday tyājya), Brahma, Godhuli, Rahu, Gulika, Yamaganda; 15 day + 15 night muhurtas with prahara; planetary hora (Drik snapshot); chaughadiya. Dedicated routes: /muhurta, /hora, /chaughadiya.

Bhadra

Vishti / Bhadra — sarpiṇī or vṛścikī, sthāna, bhūtal, parts with tyājya, start / end / duration.

Vāsa and diśā

Agni vāsa / agni-cakra periods, śiva vāsa, diśā-śūla, yoginī vāsa (dik and mukha).

Special yogas

Sarvartha siddhi, Amrit siddhi (with bādhaka tithi), Ravi yoga, Krakacādi — present flag and time spans.

Saṅkalpa

Mukhya and Gaṇapati strings, kṣetra for the place. Paid keys also get Hindi in display.

Spaṣṭa grahas

Nine grahas plus Lagna (and madhyāhna Lagna): rāśi, aṃśa, nakṣatra, pada, gati, daily motion, dignity, visibility, dagdha, avasthā, bhāva; graha yuddha.

Asta, udaya, grahaṇa

Upcoming asta / udaya (Śukra, Guru, …), asta-niṣedha, and grahaṇa if it falls on the instant. Year list: /v1/vedic/grahan.

Instant and ayanāṃśa

JD, ahargaṇa, local / ISO clock, sunrise vs calculation instant. Drik uses Lahiri; Sūrya is already nirayana (mean + spaṣṭa, tri-praśna, yuti, pāta, śṛṅgonnati, bhūgola on that engine).

Festival and year JSON

Paid: /v1/vedic/festivals/{id} and /v1/vedic/grahan. Purāṇa day notes on the snapshot. संयोग and संवत् remain Enterprise.

Two engines

Default is Sūrya-siddhānta on /v1/surya/panchanga. Drik (Lahiri, sunrise) is /v1/vedic/panchanga or engine=drik. Commercial unlocks the full stack on both.

Daily windows

Abhijit, Brahma, Godhuli, Rahu, Gulika, Yamaganda via /v1/vedic/muhurta.

15 + 15 muhurtas

Day and night slots, with prahara, on the same daily call.

Hora

Planetary horas for the civil day: /v1/vedic/hora.

Chaughadiya

Eight watches: /v1/vedic/chaughadiya.

Kārya-muhūrta

House-entry, bhūmi-pūjan, trade, yātrā, nāmakaraṇa, vehicle, vidyārambha, pūjā, śalya — Muhūrta-cintāmaṇi and Dharma-sindhu. /v1/vedic/karya-muhurta.

Vivāha milan

Wedding-place panchanga, tri-bala, lagna-śuddhi, and latta: /v1/vedic/vivaha-milan.

Lagna kundali and chalit

Whole-sign D1 (rāśi, aṃśa, nakṣatra, avasthā, gati) and Sripati bhāva-chalit with sandhi, bhāva-madhya, and house strength.

Sixteen vargas

D1–D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60. Each chart is a whole-sign table from the varga Lagna (rāśi, aṃśa, nakṣatra, bhāva), same as the printed kundali. Varga tulana is the D1–D60 sign grid.

Vimshottari dasha

Mahadasha, antardasha, and pratyantardasha from the Moon, with the full 120-year timeline. Dasha-phala grades the next 10 years of mahā–antar pairs from BPHS (dignity, bhāva, maitri) — not 81 fixed paragraphs, and not an invented event.

Yogini dasha

36-year udu cycle of eight Yoginis from the Moon nakṣatra, with mahadasha, antardasha, and three cycles from birth. Yogini-phala grades the next 10 years from the Yogini’s lord (dignity, bhāva, maitri) — BPHS wheel, Jātaka-pārijāta cross-check, not 64 fixed paragraphs.

Yogas and doshas

Selected Parashari yogas (including Harsha, Sarala, Vimala, and Nīcabhaṅga) with D9 confirmation and ṣaḍbala on the yoga grahas, Kuja / Māṅgalika with Phaladeepika 10 verses and bhaṅga yogas, Kaal Sarpa type and house, and Sāḍhe-sātī / ḍhaiyā from the natal Moon with upcoming Saturn gati and Phaladeepika 26 verses.

Āyurdāya

Piṇḍāyu, Naisargikāyu, and Aṃśāyu from BPHS, Phaladeepika selection, then the three-pair yoga-khaṇḍa and māraka daśā (BPHS 44). A working span — not a death-date.

Bhāva-phala

Twelve houses from BPHS 12–24: Lagna → bhāveśa → dignity → dṛṣṭi/yuti → kāraka → daśā. Sārāvalī and Phaladeepika confirm the same chain. Not generic rāśi-phala, and not a Bhrigu dump.

Career report

First composite report: 10th house and lord, service vs enterprise, livelihood fields, income (2+11), yogas, SAV, ṣaḍbala, maitri, and the next 10 years of career dasha windows. Not a job-title prediction.

Wealth report

Dhana (2), Labha (11), Bhāgya (9), property (4), Randhra/Vyaya strain — with BPHS adhyāya cites, yogas, SAV, ṣaḍbala, and timing. Capacity, not a windfall amount.

Marriage report

Yuvati (7), saptameśa, Venus/Jupiter, D9 confirmation, Kuja flag to Manglik, yogas, SAV, and timing. Possibility and harmony — not a wedding date.

Health report

Tanu (1), Ari (6), Randhra (8), Sun/Moon/Mars/Saturn, constitution, sensitive zones, yogas, SAV, and timing. Strain and support — not a diagnosis. Longevity math stays in Āyurdāya.

Education report

Bandhu (4), Putra (5), Dharma (9), Mercury/Jupiter, learning style, higher study, fields, yogas, SAV, and timing. Capacity — not an exam result or a named degree.

Children report

Putra (5), Kutumba (2), Bandhu (4), Jupiter/Moon, santāna yogas, home tone, SAV, and timing. Capacity — not a child-count, gender, or birth date.

Dasha timeline

Wrap of Vimśottarī dasha-phala and Yogini-phala: current mahā–antar, next 1 / 3 / 5 years, and change windows. Support — not a new daśā or an event.

Varshaphal

Tajika Nīlakaṇṭhī year-chart: muntha, pañca-adhikārī / varṣeśa, three mudda daśās, Ithasāla, five attested sahams, year windows, and a twelve-month mudda timeline. Drik uses a Lahiri Sun-return; Sūrya uses sphuṭa Sūrya from Sūrya-siddhānta. Capacity for the year — not a job, wedding, or death date.

Strength

BPHS Shadbala, Ashtakavarga tables (śodhana, śodhya piṇḍa), and Ashtakavarga phala — relative house ranks and each graha’s own BAV on gochara, not a “30+ is good” cutoff. Graha garima, graha and bhāva sāraṃśa, and a bala dashboard with CSS bar charts (no Chart.js).

Jaimini and graha dṛṣṭi

Chara karakas, karakamsha, arudha padas, and Jaimini rāśi dṛṣṭi, plus Parāśari graha dṛṣṭi (7th, with special aspects for Mars, Jupiter, Saturn, and the nodes).

Janma vivaran and avakahada

Birth sheet (samvatsara, tithi, janma nakshatra, birth mahadasha) and Moon-nakshatra avakahada with pāya and nāma akṣara.

Maitri

Pañcadhā maitri chakra and graha dṛṣṭi from the same birth data.

Chalit and special charts

Sripati bhāva-chalit with sandhi (Drik: Placidus MC; Sūrya-siddhānta: daśama from RAMC). Chandra and Sūrya kundali use the same D1 table as Lagna, counted from the Moon or the Sun.

Gochara

Current slow-graha transits from natal Lagna and Moon (Phaladeepika 26), natal impact, upcoming sign-ingresses, and each graha’s own Ashtakavarga bindus plus relative SAV. The join of gochara and AV is the distinctive layer — not a “30+ is good” cutoff, and not an event date.

Kundali book PDF

Enterprise only (from ₹1,20,000 / year, unlimited credits). One call prints the full natal book. Pass white_label=1 with name and logo — no watermark. The mobile pack returns the same HTML, a base64 PDF, natal JSON, and ready URLs for planets, dashas, and the life reports. Wiring: /api-docs#mobile-pack.

Ashtakoot milan

Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, and Nadi — total out of 36, with Muhūrta-cintāmaṇi Vivāha verses.

Moon charts

Boy and girl Moon rashi, nakshatra, and the koot that produced each score.

Nadi and bhaṅga

Raw eka-nāḍī flag, plus printed cancellations (Jyotirnibandha, Muhūrta-pradīpa, Kālaprakāśikā, Nārada-saṃhitā).

Paired Manglik

Independent Kuja-doṣa on each chart, plus the printed pair-bhaṅga when both have raw doṣa. /v1/vedic/match/manglik.

Simple inputs

boy_date, boy_time, boy_place and the matching girl_* fields — or coordinates.

Same engine

Matching uses the same Lahiri longitudes as the kundali routes. No second ephemeris.

Coverage by plan

Access is keyed. Developer and Pro unlock the full engine for non-commercial work. Production apps need Commercial or Enterprise. Quotas follow the Drik-API License 1.0.

What you getFree BasicDeveloper / ProCommercialEnterprise
Panchanga
Tithi, nakshatra, yoga, karana, vāra — transitions + nirṇayaYesYesYesYes
Sunrise, sunset, noon, moonrise / set / transitYesYesYesYes
Spaṣṭa grahas, Lagna, yuddhaYesYesYesYes
Amanta / Purnimanta, solar month, eras, saṃvatsara—YesYesYes
Hindi display, saṅkalpa, Bhadra—YesYesYes
Sankranti, ṛtu, ayana, śāstra-kāla—YesYesYes
Agni / śiva / yoginī vāsa, diśā-śūla—YesYesYes
Muhurta, hora, chaughadiya (on the daily snapshot)—YesYesYes
Kārya-muhūrta · vivāha-milan—YesYesYes
Asta / udaya · festivals · grahaṇa JSON—YesYesYes
Sūrya-siddhānta — same slice as this planBasic sliceBasic sliceFullFull
Kundali
Planets, houses, lagna—YesYesYes
16 vargas (D1–D60)—YesYesYes
Vimshottari maha / antar / pratyantra—YesYesYes
Yogini maha / antar—YesYesYes
Yogas, Manglik, Kaal Sarpa, Sade Sati (ḍhaiyā, gati)—YesYesYes
Dasha-phala · Yogini-phala · timeline—YesYesYes
Varṣaphala (Tajika)—YesYesYes
Āyurdāya · bhāva-phala—YesYesYes
Career · wealth · marriage · health · education · children—YesYesYes
Shadbala, Ashtakavarga, Jaimini—YesYesYes
Avakahada, maitri, chalit, gochara—YesYesYes
Kundali book PDF / mobile pack———White-label
Matching
Ashtakoot (36 points) · printed bhaṅga · Nadi—YesYesYes
Paired Manglik with cancellation—YesYesYes
Access
Monthly API credits1,00010,000 / 50,000250,000Unlimited
Commercial productionNoNoYesYes
White-labelAttributionAttributionDefaultDefault
पर्वाणि—YesYesYes
संयोग scanner · संवत् पञ्चाङ्ग———Yes
Range, kala, month (bulk)———Custom license
Named domains / SLA———Yes
Ticket support——YesYes
Phone support———Yes

Panchanga, in detail

  • Place, civil date, JD, ahargaṇa, sunrise vs calculation instant
  • Tithi — name, number, paksha, class, fraction, elongation, end, transitions, nirṇaya
  • Nakṣatra (pada), yoga, karaṇa (kind, remaining degrees), weekday, paksha
  • Amanta and Purnimanta māsa, adhika, pūrṇimā date; solar month (saur māsa / rāśi)
  • Vikram, Shaka, Kali; Yudhiṣṭhira and Paraśurāma; Bārhaspatya and Chandra-krama saṃvatsara; era new year
  • Sunrise, sunset, next sunrise, solar noon, moonrise, moonset, moon transit
  • Dinamāna / rātrimāna (hours and ghaṭī)
  • Ṛtu, ayana; current rāśi, degrees in rāśi, degrees to next, gati, last / next sankranti + nirṇaya
  • Śāstra-kāla — pūrvāhṇa, madhyāhna, aparāhṇa, kutapa, dvitīya prahara, pradoṣa, niśītha / mahāniśā, aruṇodaya; din-ṛtu
  • Abhijit (Wednesday tyājya), Brahma, Godhuli, Rahu, Gulika, Yamaganda
  • 15 day + 15 night muhurtas, prahara, planetary hora, chaughadiya
  • Vishti / Bhadra — sarpiṇī / vṛścikī, sthāna, bhūtal, parts, tyājya
  • Agni vāsa / cakra, śiva vāsa, diśā-śūla, yoginī vāsa
  • Sarvartha, Amrit siddhi (bādhaka tithi), Ravi yoga, Krakacādi
  • Mukhya and Gaṇapati saṅkalpa, kṣetra; Hindi display on paid keys
  • Spaṣṭa grahas + Lagna (and madhyāhna Lagna): rāśi, aṃśa, nakṣatra, pada, gati, dignity, visibility, dagdha, avasthā, bhāva; yuddha
  • Upcoming asta / udaya, asta-niṣedha, near-instant grahaṇa
  • Festival nirṇaya — /v1/vedic/festivals/{id}; year grahaṇa — /v1/vedic/grahan
  • Sūrya snapshot also: madhyama, spaṣṭa, tri-praśna, yuti, udayāsta, śṛṅgonnati, pāta, bhūgola

Muhurta, in detail

  • Abhijit, Brahma, Godhuli, Rahu, Gulika, Yamaganda
  • 15 day + 15 night muhurtas, with prahara
  • Planetary hora — /v1/vedic/hora
  • Eight chaughadiya watches — /v1/vedic/chaughadiya
  • Kārya-muhūrta: gṛha-praveśa, bhūmi-pūjan, vyavasāya, yātrā, nāmakaraṇa, vāhana, vidyārambha, pūjā, śalya
  • Muhūrta-cintāmaṇi (mūla) · Dharma-sindhu / Nirṇayasindhu (saṃskāra)
  • Day span or full year; yātrā direction; nava / jīrṇa house
  • Vivāha-milan JSON — place panchanga, tri-bala, lagna-śuddhi, latta
  • Same routes on /v1/surya/… for the classical engine

Kundali, in detail

  • Grahas: rāśi, aṃśa, nakṣatra, pada, avasthā, gati
  • Lagna kundali (whole-sign D1) and Sripati bhāva-chalit (sandhi, madhya, house strength)
  • Chandra and Sūrya kundali from the same D1 table
  • D1–D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60 — each from the varga Lagna; D1–D60 tulana grid
  • Vimśottarī maha, antar, and pratyantra (120-year Moon timeline)
  • Yogini maha and antar (36-year cycle, three cycles from birth)
  • Dasha-phala and Yogini-phala — BPHS mahā–antar for the next 10 years (dignity, bhāva, maitri)
  • Dasha timeline — current plus 1 / 3 / 5 year slices and change windows
  • Varṣaphala — Tajika Nīlakaṇṭhī Sun-return, muntha, varṣeśa, three mudda daśās, year windows, monthly mudda
  • Yogas (Harsha, Sarala, Vimala, Nīcabhaṅga, …), Kuja / Māṅgalika (Phaladeepika 10, bhaṅga), Kaal Sarpa, Sade Sati (ḍhaiyā, Saturn gati, Phaladeepika 26)
  • Āyurdāya — Piṇḍāyu, Naisargikāyu, Aṃśāyu; yoga-khaṇḍa; māraka daśā (BPHS 43–44)
  • Bhāva-phala — BPHS house / lord chain (12–24), Sārāvalī and Phaladeepika as checks
  • Career, Wealth, Marriage, Health, Education, Children — BPHS house / lord / kāraka reports
  • Shadbala, Ashtakavarga (śodhana, śodhya piṇḍa, BPHS phala, BAV + SAV on gochara)
  • Jaimini chara karakas, karakamsha, ārūḍha, rāśi dṛṣṭi; Parāśari graha dṛṣṭi
  • Janma vivaraṇa, avakahada (pāya, nāma akṣara), pañcadhā maitri
  • Gochara — slow grahas from Lagna and Moon, ingresses, own BAV and relative SAV
  • Kundali book PDF and mobile pack JSON — Enterprise

Matching, in detail

  • Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi
  • Total out of 36, Jyotirnibandha band, raw and effective Nadi
  • Muhūrta-cintāmaṇi Vivāha verses on each koot
  • Printed bhaṅga (2/12, 5/9, 6/8, eka-nāḍī, gaṇa) — Jyotirnibandha, Muhūrta-pradīpa, Kālaprakāśikā, Nārada-saṃhitā
  • Boy / girl Moon rāśi, nakṣatra, gaṇa, nāḍī, yoni
  • Paired Manglik with printed pair-bhaṅga when both have raw Kuja-doṣa
  • Same Lahiri longitudes as the kundali routes

One key. Not a monthly stack.

Hosted Vedic APIs often sell panchanga, kundali, and matching as separate monthly products. Drik Commercial is one yearly license — ₹36,000 / year, which is ₹3,000 / month — on an independently developed engine. The 250,000 figure is API credits, not unlimited CPU. Quotas are typical; the operator may adjust.

Monthly — same period, both sides

Typical hosted Vedic APIDrik Commercial
Panchanga₹1,600 / month · 100k calls₹3,000 / month · 250k credits
Muhurta · kārya · vivāha-milanOften a separate add-onIncluded in ₹3,000
Kundali, vargas, dasha₹6,600 / monthIncluded in ₹3,000
Matching₹6,600–₹12,500 / monthIncluded in ₹3,000
Shadbala, Ashtakavarga, Jaimini₹12,500 / monthIncluded in ₹3,000
Full Vedic stack (one plan)₹12,500 / month₹3,000 / month
If sold as three products₹20,700 / monthStill ₹3,000 / month
OverageAbout ₹20 / 1,000 callsQuoted in the grant

Yearly — same period, both sides

Typical hosted Vedic APIDrik Commercial
Panchanga-only plan₹19,200 / year₹36,000 / year
Kundali plan₹79,200 / year₹36,000 / year
Full Vedic stack₹1,50,000 / year₹36,000 / year
Three-product stack₹2,48,400 / year₹36,000 / year
Third-party ephemeris licenceOften in their unit costNone on this engine

Commercial headline is 250,000 standard API credits / month, subject to reasonable-use limits and the weights below. A tithi slice is 1 credit; Shadbala or a full kundali pack costs more, so one key cannot treat ₹3,000 / month as unlimited CPU.

Route classExamplesCredits
LightTithi, nakshatra, yoga, karana, geocode, catalog1
StandardDaily panchanga, muhurta, hora, chaughadiya2
ChartKundali, planets, dashas, doshas, transits3
Single vargaOne divisional chart4
HeavyShadbala, Ashtakavarga, Jaimini, kundali/full, matching5
Kundali book HTMLkundali-book.html — full natal report for WebView (Enterprise)20
Kundali book PDFkundali-book.pdf — same book, Chrome print (Enterprise)25
Mobile kundali packkundali-pack — HTML + natal JSON (Enterprise)30

Choose a plan

Create a free account and generate a key on the dashboard. Paid plans activate after payment. Enterprise and custom grants: info@tantragurukul.org.

Study

Free Basic

₹0

₹0 / month

Public JSON slice on both engines. A Free key does not open पर्व. संयोग · संवत् are Enterprise.

  • Angas, weekday, sunrise, spaṣṭa grahas — Drik and Sūrya-siddhānta
  • 1,000 credits / month — not for paid tools
  • Attribution required
Create free account

Test

Developer

₹4,999 / year

₹417 / month

10,000 API credits / month. Dev/test only — not production.

  • Full engine on a named key
  • Panchanga, muhurta, kundali, matching
  • Attribution required
Buy ₹4,999 / year

Non-commercial

Pro

₹14,999 / year

₹1,250 / month

50,000 API credits / month. Research, classroom, and other non-commercial work.

  • Same full engine as Commercial
  • Classroom, research, open projects
  • Attribution required
Buy ₹14,999 / year

Extra credits

+10,000 credits · ₹499 +50,000 credits · ₹1,999 +200,000 credits · ₹6,999 Buy this plan first. Packs open on the dashboard after Pro is active.

SLA

Enterprise

₹1,20,000 / year

₹10,000 / month

Starts here. Unlimited API credits. Written grant for domains and SLA.

  • Unlimited credits
  • संयोगान्वेषणम् · संवत्पञ्चाङ्गम्
  • Kundali book PDF and mobile HTML+PDF pack (white-label)
  • Range, kala, and month endpoints
  • Named domains and quota
  • Ticket support + phone support
  • Support from Dehradun · contract on paper
Talk to us

Why teams use this API

A Vedic calculation service, not a marketplace of tarot, numerology, and Western synastry.

Same engines as the public panchanga

Classical Sūrya-siddhānta first, then Drik (Lahiri, sunrise) — the methods already published at tantragurukul.org.

Honest catalog

If a route is listed, it computes. KP sub-lords, festival almanacs, and eight-language essays are not claimed.

Ready for a Hindi UI

Paid daily payloads include display fields so an app does not have to transliterate tithi names.

White-label when you pay

Commercial and Enterprise keys may hide the engine name. Free use must credit the engine that computed the page — Drik or Sūrya-siddhānta.

REST, one header

Send X-API-Key. Place as a name or coordinates. Omit time for sunrise; send birth time for kundali.

Indian licence, Dehradun courts

Drik-API License 1.0 is on the site. Keys, grants, and support come from Tantrakulam / Prithvi Foundation Trust.

Integrate in four calls

curl, Python 3, or Java 11+. Catalog: /v1/vedic · written spec: API docs.

curl -H "X-API-Key: YOUR_KEY" \
  "https://astro.tantragurukul.org/v1/vedic/panchanga?date=2026-08-22&place=Kushinagar"

curl -H "X-API-Key: YOUR_KEY" \
  "https://astro.tantragurukul.org/v1/vedic/karya-muhurta?karya=griha_pravesha&date=2026-08-22&place=Kushinagar"

curl -H "X-API-Key: YOUR_KEY" \
  "https://astro.tantragurukul.org/v1/vedic/kundali?date=1990-05-15&time=14:30&place=Delhi"

curl -H "X-API-Key: YOUR_KEY" \
  "https://astro.tantragurukul.org/v1/vedic/match/ashtakoot?boy_date=1990-05-15&boy_time=10:15&boy_place=Delhi&girl_date=1992-11-03&girl_time=16:40&girl_place=Varanasi"
import json, urllib.parse, urllib.request

BASE = "https://astro.tantragurukul.org"
KEY = "YOUR_KEY"

def get(path, params):
    url = f"{BASE}{path}?{urllib.parse.urlencode(params)}"
    req = urllib.request.Request(url, headers={"X-API-Key": KEY})
    with urllib.request.urlopen(req) as r:
        return json.load(r)

panchanga = get("/v1/vedic/panchanga", {"date": "2026-08-22", "place": "Kushinagar"})
muhurta = get("/v1/vedic/karya-muhurta", {
    "karya": "griha_pravesha", "date": "2026-08-22", "place": "Kushinagar"})
kundali = get("/v1/vedic/kundali", {
    "date": "1990-05-15", "time": "14:30", "place": "Delhi"})
match = get("/v1/vedic/match/ashtakoot", {
    "boy_date": "1990-05-15", "boy_time": "10:15", "boy_place": "Delhi",
    "girl_date": "1992-11-03", "girl_time": "16:40", "girl_place": "Varanasi"})
HttpClient client = HttpClient.newHttpClient();

HttpResponse<String> get(String path) throws Exception {
    HttpRequest req = HttpRequest.newBuilder()
        .uri(URI.create("https://astro.tantragurukul.org" + path))
        .header("X-API-Key", "YOUR_KEY")
        .GET()
        .build();
    return client.send(req, HttpResponse.BodyHandlers.ofString());
}

get("/v1/vedic/panchanga?date=2026-08-22&place=Kushinagar");
get("/v1/vedic/karya-muhurta?karya=griha_pravesha&date=2026-08-22&place=Kushinagar");
get("/v1/vedic/kundali?date=1990-05-15&time=14:30&place=Delhi");
get("/v1/vedic/match/ashtakoot?boy_date=1990-05-15&boy_time=10:15&boy_place=Delhi"
    + "&girl_date=1992-11-03&girl_time=16:40&girl_place=Varanasi");

Frequently asked questions

What you need to call the API, choose an engine, and stay within your plan.

How do I start using the API?

Create a free account, open the dashboard, and generate a key. Send it as X-API-Key on every JSON request. Catalogs at /v1/ and /v1/vedic need no key. The Basic JSON slice (angas, vāra, sunrise, spaṣṭa grahas) is on both engines. Paid routes — full panchanga, muhurta, kundali, matching, festivals — need a paid key.

What should I send on a request?

Send a civil date (YYYY-MM-DD) and a place name, or lat, lon, and tz. Leave time empty for sunrise of the chosen engine. Kundali also needs the birth clock. Matching uses the same fields twice, with boy_ and girl_ prefixes. Kārya-muhūrta needs karya= (for example griha_pravesha) and optionally span=year. Default place is Dehradun if none is given.

What does each plan unlock?

Free Basic is the public JSON slice and 1,000 credits a month — not for production. That slice is on both paddhati: Drik and Sūrya-siddhānta. Developer (₹4,999 / year) and Pro (₹14,999 / year) open the full Drik engine — panchanga, muhurta, kundali, matching — for non-commercial work; their Sūrya access stays the Basic slice. Commercial (₹36,000 / year) is the production license: those four APIs, white-label JSON, and the full Sūrya-siddhānta engine. Festival JSON opens on any paid plan. संयोग and संवत् JSON are Enterprise only. Enterprise starts at ₹1,20,000 / year with unlimited credits: those two tools, kundali book PDF / pack, bulk date routes, named domains, and an SLA. See coverage and pricing.

When should I use Drik, and when Sūrya-siddhānta?

Use Sūrya-siddhānta for the classical engine (mean and true graha, Chapter 9 asta/udaya, that engine’s own sunrise): /v1/surya/… or engine=surya. Use Drik for Lahiri sidereal longitudes and Drik sunrise: /v1/panchanga and /v1/vedic/…. Free Basic already has the public slice on both. Kundali, matching, and other paid SS routes stay Commercial. The two engines will not return the same clocks or longitudes. Do not mix one engine’s sunrise with the other’s grahas.

What do panchanga, muhurta, kundali, and matching return?

A daily panchanga call needs a civil date and a place (or lat/lon/tz). It returns the full snapshot: angas with transitions and tithi-nirṇaya; Amanta / Purnimanta and solar months; Vikram / Shaka / Kali plus Yudhiṣṭhira and Paraśurāma; saṃvatsara; rise/set, noon, moon transit, dinamāna; sankranti, ṛtu, ayana; śāstra-kāla; daily muhurta, hora, chaughadiya; Bhadra, agni / śiva / yoginī vāsa, diśā-śūla; Sarvartha / Amrit / Ravi / Krakacādi; saṅkalpa; spaṣṭa grahas, Lagna, yuddha; asta / udaya and near-instant grahaṇa. Muhurta for a named work is a separate call: /v1/vedic/karya-muhurta. Vivāha-milan returns place panchanga, tri-bala, lagna-śuddhi, and latta. A kundali call also needs birth time. It returns lagna, grahas, chalit, sixteen vargas (D1–D60), Vimśottarī and Yogini with phala, a dasha timeline, Varṣaphala, Gochara, six life reports, yogas, Kuja / Māṅgalika, Kaal Sarpa, Sade Sati, Āyurdāya, Bhāva-phala, Shadbala, Ashtakavarga, and Jaimini karakas. Matching returns Ashtakoot scores out of 36 (Muhūrta-cintāmaṇi verses, printed bhaṅga, Nadi) and paired Manglik with pair-bhaṅga. Other dasha systems and Dashakoot are not in this release. Full field list: API docs.

How do I request a muhurta?

Daily windows: GET /v1/vedic/muhurta, /v1/vedic/hora, /v1/vedic/chaughadiya with date and place. For a named work, call GET /v1/vedic/karya-muhurta?karya=griha_pravesha (also bhumi_pujan, vyavasaya, yatra, namakarana, vahana, vidyarambha, puja, shalya). Add span=year for a year scan, direction= for yātrā, and kind=nava|jirna for a house. Wedding-place śuddhi is /v1/vedic/vivaha-milan. Classical engine: the same paths under /v1/surya/….

How do API credits work?

Each successful JSON call spends credits from this month’s allowance. A tithi or geocode call is 1 credit; a daily panchanga is 2; a kundali slice is 3; one varga is 4; Shadbala, Ashtakavarga, dasha-phala, yogini-phala, varṣaphala, gochara-report, Jaimini, kundali/full, or matching is 5. The printable kundali book PDF (25) and the mobile pack (30) are Enterprise only; Enterprise starts at ₹1,20,000 / year with unlimited credits. Commercial’s 250,000 credits are a monthly allowance, not unlimited compute. Multi-day range, kala, and month routes are also Enterprise only. Extra credit packs are on the dashboard after Pro or Commercial is active.

In which language does the API reply?

JSON field names are English. Paid panchanga includes Hindi in display and in saṅkalpa, so an app does not have to transliterate tithi or nakṣatra names. There is no multi-language interpretation or article pack.

May I use this in a production app or under my own brand?

Production and paid apps need a Commercial or Enterprise key. Free, Developer, and Pro keys are not a production license and must keep the engine credit on public pages. Commercial and Enterprise may hide the engine name (white-label). Terms: Drik-API License 1.0 and, for the classical engine, SSP-API License 1.0.

Will the numbers match a printed panchanga or another API?

They follow this host’s Drik or Sūrya-siddhānta implementation, the place you send, and that engine’s sunrise. A regional print, another vendor, or a different ayanamsa will differ. That is expected. License §17 states there is no warranty of identity with any one almanac.

Do you ship a festival calendar or a CMS plugin?

No. This product is a calculation API. Festival JSON is on /v1/vedic/festivals/{id}. WordPress, Shopify, and Wix plugins are not included. Build those on top of the JSON if you need them.

Where do I get help or an Enterprise grant?

Open a ticket from the dashboard. Commercial includes ticket support. Enterprise includes phone support — write to info@tantragurukul.org for the Dehradun line on the grant. Docs stay at API docs and /v1/vedic.

Talk to us

Keys, enterprise grants, and engine questions go to Tantrakulam / Prithvi Foundation Trust.

138, THDC Colony Banjarawala, Dehradun, India

tantragurukul.org

Open a support ticket